Skip to content

JonathanInTheClouds/pycryptic

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

16 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

PyCryptic

PyCryptic is a Python-based command-line tool for encrypting and decrypting files and directories using AES encryption. It ensures data security by allowing users to provide their own passwords for encryption and decryption. Designed to be simple, robust, and efficient, PyCryptic is a great solution for securing sensitive information.


Features

  • File Encryption: Encrypt single files securely using AES.
  • Directory Encryption: Recursively encrypt all files within a directory.
  • File Decryption: Decrypt encrypted files with the correct password.
  • Cross-Platform: Works seamlessly on Linux, macOS, and Windows.
  • Custom Passwords: Users can specify their own password for encryption and decryption.

Installation

Prerequisites

  • Python 3.10 or later
  • pip (Python package manager)

Steps

  1. Clone the repository:

    git clone https://github.com/JonathanInTheClouds/pycryptic.git
    cd pycryptic
  2. Install the dependencies:

    pip install -r requirements.txt
  3. (Optional) Install PyCryptic in editable mode:

    pip install -e .

Usage

Basic Syntax

python -m pycryptic.cli <action> <input_path> <output_path> --password <password>

Arguments

  • <action>: encrypt or decrypt
  • <input_path>: Path to the file or directory to process
  • <output_path>: Path to the output file or directory
  • --password: Password for encryption or decryption

Examples

Encrypt a File

python -m pycryptic.cli encrypt myfile.txt myfile.enc --password mypassword

Decrypt a File

python -m pycryptic.cli decrypt myfile.enc myfile.txt --password mypassword

Encrypt a Directory

python -m pycryptic.cli encrypt myfolder encrypted_folder --password mypassword

Decrypt a Directory

python -m pycryptic.cli decrypt encrypted_folder decrypted_folder --password mypassword

Testing

PyCryptic includes a comprehensive test suite to ensure reliability.

  1. Run all tests:

    pytest
  2. Generate a code coverage report:

    pytest --cov=.

Contributing

Contributions are welcome! To contribute:

  1. Fork the repository.
  2. Create a new branch for your feature or bugfix.
  3. Submit a pull request with a clear explanation of your changes.

License

This project is licensed under the MIT License.


Thank you for using PyCryptic! 🔒

About

A Python-based command-line tool for encrypting and decrypting files and directories using AES encryption. Secure your sensitive data with ease. Cross-platform, simple to use, and fully customizable. 🔒✨

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages