Metadata-Version: 2.1
Name: opencrypt
Version: 0.5.1
Summary: Symmetric encryption and decryption compatible with openSSL.
Home-page: https://github.com/EbryxLabs/opencrypt
Author: Rana Awais
Author-email: rana.awais@ebryx.com
License: UNKNOWN
Description: # Installation
        You can grab the latest .whl file from repository and install it via pip or just simply type:
        ```
        pip install opencrypt
        ```
        If you want build from source code, then.
        ```
        git clone https://github.com/EbryxLabs/opencrypt
        cd opencrypt/
        python setup.py install
        ```
        You will have a package named **`opencrypt`** installed for your python.
        
        # Encryption / Decryption
        You can encrypt / decrypt data using `ebcrypt` tool. **(AES-256 Encryption)**
        
        For example, to encrypt you can do following:
        ```
        ebcrypt <my-file.json> -e --new
        # encrypts myfile.json using newly created crypto-secure key. Keys will be written to _keys file.
        
        ebcrypt <my-file.json> -e
        # encrypts using keys in AES_KEY, AES_IV environment variable.
        ```
        
        For decryption, you'll need to have `AES_KEY` and `AES_IV` keys in your environment variables.
        ```
        ebcrypt <my-file.json> -d
        ```
        > This is an optional step in case you want to decode your encrypted data explicitly for manual checking. Program decrypts your encrypted config file automatically.
        
        You can get detailed help on crypto tool by typing.
        ```
        ebcrypt -h
        ```
        
        ## OpenSSL compatibility
        Encryption done by openssl utility can be decrypted by `ebcrypt` utility and vice versa. For example, you can encrypt using openssl as follows.
        ```
        openssl aes-256-cbc -a -e -K <hex-key> -iv <hex-iv> -in <input-file> -out <output-file>
        ```
        `hex-key` and `hex-iv` should be replaced with actual keys in hex format. Using the same keys you used in openssl, you can decrypt using `ebcrypt` as follows.
        ```
        ebcrypt <encrypted-file> -d
        # AES_KEY environment variable should hold <hex-key>.
        # AES_IV environment variable should hold <hex-iv>.
        ```
        Similarly, you can encrypt using `ebcrypt` and decrypt the content using openssl, given that you're using the same keys.
        
        # Code Usage
        You can also use it in your own code by importing the appropriate module.
        ```
        import opencrypt
        opencrypt.encrypt_file(filename, new_keys=False)
        opencrypt.decrypt_file(filename, write_to_file=True, is_ciphertext=False)
        ```
        
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Description-Content-Type: text/markdown
