ash-encrypt 0.3.0

Encrypt and decrypt files and directories with AES-256-GCM

ash-encrypt

Encrypt and decrypt files and directories with AES-256-GCM.

Features

• AES-256-GCM encryption — authenticated encryption with strong confidentiality and integrity guarantees
• File and directory support — encrypt individual files or entire directories
• Simple CLI — intuitive command-line interface with encrypt/decrypt modes
• Progress bars — visual feedback for large file operations via tqdm
• Streaming encryption — handles large files without loading them entirely into memory
• Cross-platform — works on Linux, macOS, and Windows

Installation

pip install ash-encrypt

Quick Start

Encrypt a file

ash-encrypt e -p <password> -f <file>

This produces a .ash encrypted file. For example:

ash-encrypt e -p mysecretpass -f document.pdf
# Output: document.ash

Decrypt a file

ash-encrypt d -p <password> -f <file.ash>

ash-encrypt d -p mysecretpass -f document.ash
# Output: document.pdf

CLI Flags

Flag	Description
e	Encryption mode
d	Decryption mode
-p	Password
-f	File or directory path

Supported Platforms

• Linux
• macOS
• Windows

Requirements

• Python 3.8+
• pycryptodome >= 3.15
• tqdm >= 4.60

Development

Clone the repository and install with dev dependencies:

git clone https://github.com/shimafallah/ash_encryptor.git
cd ash_encryptor
pip install -e ".[dev]"

License

MIT

Links

• GitHub: https://github.com/shimafallah/ash_encryptor
• PyPI: https://pypi.org/project/ash-encrypt/