Metadata-Version: 2.1
Name: b_aws_dynamodb_backup
Version: 1.1.1
Summary: DynamoDB.
Home-page: https://github.com/biomapas/B.AwsDynamoDbBackup.git
Author: Laimonas Sutkus
Author-email: laimonas.sutkus@biomapas.com
License: Apache License 2.0
Description: # B.AwsDynamoDbBackup
        
        A python based package that allows you to back up, restore, and seed dynamodb database tables.
        
        ### Description
        
        Sometimes you want to make a small modification to your dynamodb table, however it usually requires
        destruction of the table itself. This library allows you to do those small modifications without 
        any headache. You can easily backup all your data to your local computer, delete the table, create
        a new one with desired modifications, and then simply restore it!
        
        ### Remarks
        
        [Biomapas](https://biomapas.com) aims to modernise life-science 
        industry by sharing its IT knowledge with other companies and 
        the community. This is an open source library intended to be used 
        by anyone. Improvements and pull requests are welcome.
        
        ### Related technology
        
        - Python 3
        - DynamoDB
        - Boto3
        
        ### Assumptions
        
        The project assumes the following:
        
        - You have basic knowledge in python programming.
        - You have basic knowledge in DynamoDB.
        
        ### Useful sources
        
        - Read more DynamoDB:<br>
        https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Programming.SDKOverview.html
        
        ### Install
        
        The project is built and uploaded to PyPi. Install it by using pip.
        
        ```
        pip install b_aws_dynamodb_backup
        ```
        
        Or directly install it through source.
        
        ```
        pip install .
        ```
        
        ### Usage & Examples
        
        The library uses boto3 AWS SDK for interacting with AWS environment. Hence,
        environmental credentials (such as `aws_access_key_id`, `aws_secret_access_key`, and `region_name`)
        are required.
        
        The library exposes cli commands. Read more about them down below.
        
        ##### dyseed
        
        Seeds your table with random data.
        
        ```shell
        > dyseed TableName
        ```
        
        ##### dyback
        
        Backups your whole table(s).
        
        ```shell
        # Single table.
        > dyback TableName
        
        # All tables.
        > dyback 
        ```
        
        ##### dyrest
        
        Restores your whole table(s).
        
        ```shell
        # Single table.
        > dyrest TableName
        
        # All tables.
        > dyrest
        ```
        
        ### Testing
        
        This project currently has no tests.
        
        ### Contribution
        
        Found a bug? Want to add or suggest a new feature?<br>
        Contributions of any kind are gladly welcome. You may contact us 
        directly, create a pull-request or an issue in github platform.
        Lets modernize the world together.
        
        
        # Release history
        
        ### 1.1.1
        * Fix DynamoDB backup chunks all being written in the same file.
        
        ### 1.1.0
        * Handle byte types.
        
        ### 1.0.0
        * Allow to back up all tables.
        * Allow to restore all tables.
        
        ### 0.0.2
        * Cleanup.
        
        ### 0.0.1
        * Initial build.
        
Keywords: DynamoDB
Platform: UNKNOWN
Description-Content-Type: text/markdown
