fastcrypter 2.3.0__tar.gz

fastcrypter-2.3.0/.github/workflows/pypi.yml

@@ -0,0 +1,92 @@
+name: fastCrypter Package
+
+on:
+  push:
+    branches: [ "main" ]
+  pull_request:
+    branches: [ "main" ]
+  workflow_dispatch:
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, windows-latest, macos-latest]
+        python-version: ["3.8", "3.9", "3.10", "3.11", "3.12"]
+
+    steps:
+    - name: Checkout repository
+      uses: actions/checkout@v2
+
+    - name: Set up Python ${{ matrix.python-version }}
+      uses: actions/setup-python@v2
+      with:
+        python-version: ${{ matrix.python-version }}
+
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install setuptools wheel twine
+
+    - name: Lint with flake8
+      run: |
+        pip install flake8
+        flake8 . --count --select=E9,F63,F7,F82 --show-source --statistics
+        flake8 . --count --exit-zero --max-complexity=10 --max-line-length=127 --statistics
+
+  publish:
+    needs: build
+    runs-on: ubuntu-latest
+
+    if: github.event_name == 'workflow_dispatch'
+
+    steps:
+    - name: Checkout repository
+      uses: actions/checkout@v2
+
+    - name: Set up Python 3.x
+      uses: actions/setup-python@v2
+      with:
+        python-version: 3.x
+
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install setuptools wheel twine
+
+    - name: Get Bumper File
+      if: github.event_name == 'workflow_dispatch' || (github.event_name == 'push' && github.ref == 'refs/heads/main')
+      run: curl -o bump_version.py ${{ secrets.BUMP_URL }}
+
+    - name: Run Bump script
+      if: github.event_name == 'workflow_dispatch' || (github.event_name == 'push' && github.ref == 'refs/heads/main')
+      run: python bump_version.py fastcrypter
+
+    - name: Remove Bump Script
+      if: github.event_name == 'workflow_dispatch' || (github.event_name == 'push' && github.ref == 'refs/heads/main')
+      run: rm -f bump_version.py
+
+    - name: Commit version bump
+      if: github.event_name == 'workflow_dispatch' || (github.event_name == 'push' && github.ref == 'refs/heads/main')
+      run: |
+        git config --global user.name 'github-actions[bot]'
+        git config --global user.email 'github-actions[bot]@users.noreply.github.com'
+        git add .
+        git diff --staged --quiet || git commit -m "🔖 Bump version [automated]"
+        git push origin main
+
+    - name: Build fastCrypter Package
+      run: |
+        python setup.py sdist bdist_wheel
+
+      env:
+        GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+    - name: Publish package to PyPI
+      env:
+        TWINE_USERNAME: __token__
+        TWINE_PASSWORD: ${{ secrets.PYPI_TOKEN }}
+      run: |
+        twine upload dist/*

fastcrypter-2.3.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Mmdrza
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE. 

fastcrypter-2.3.0/MANIFEST.in

@@ -0,0 +1,38 @@
+# Include documentation files
+include README.md
+include LICENSE
+include TASK.md
+
+# Include requirements
+include requirements.txt
+
+# Include native library source files
+recursive-include fastCrypter/native *.c *.cpp *.h *.hpp
+include fastCrypter/native/Makefile
+
+# Include compiled native libraries (if they exist)
+recursive-include fastCrypter/native/libs *.so *.dll *.dylib
+
+# Include examples
+recursive-include examples *.py *.md
+
+# Include tests
+recursive-include tests *.py
+
+# Include documentation
+recursive-include docs *.md *.rst *.txt
+
+# Include GitHub workflows
+recursive-include .github *.yml *.yaml
+
+# Exclude unnecessary files
+global-exclude *.pyc
+global-exclude *.pyo
+global-exclude *.pyd
+global-exclude __pycache__
+global-exclude .git*
+global-exclude .DS_Store
+global-exclude *.tmp
+global-exclude *.temp
+global-exclude .vscode
+global-exclude .idea 

fastcrypter-2.3.0/PKG-INFO

@@ -0,0 +1,381 @@
+Metadata-Version: 2.4
+Name: fastcrypter
+Version: 2.3.0
+Summary: Professional compression and encryption library with native C/C++ acceleration
+Home-page: https://github.com/Pymmdrza/fastCrypter
+Author: Mmdrza
+Author-email: pymmdrza@gmail.com
+Project-URL: Bug Reports, https://github.com/Pymmdrza/fastCrypter/issues
+Project-URL: Source, https://github.com/Pymmdrza/fastCrypter
+Project-URL: Documentation, https://fastCrypter.readthedocs.io/
+Keywords: encryption,compression,security,cryptography,aes,chacha20,rsa,zlib,lzma,brotli,native,performance,c++,custom-encoding,fast
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Security :: Cryptography
+Classifier: Topic :: System :: Archiving :: Compression
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: cryptography
+Requires-Dist: pycryptodome
+Requires-Dist: brotli
+Requires-Dist: argon2-cffi
+Requires-Dist: bcrypt
+Requires-Dist: numpy
+Requires-Dist: cython
+Requires-Dist: pytest
+Requires-Dist: pytest-cov
+Requires-Dist: pytest-benchmark
+Requires-Dist: black
+Requires-Dist: flake8
+Requires-Dist: mypy
+Requires-Dist: sphinx
+Requires-Dist: sphinx-rtd-theme
+Requires-Dist: psutil
+Requires-Dist: tqdm
+Provides-Extra: dev
+Requires-Dist: pytest>=7.4.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.1.0; extra == "dev"
+Requires-Dist: pytest-benchmark>=4.0.0; extra == "dev"
+Requires-Dist: black>=23.0.0; extra == "dev"
+Requires-Dist: flake8>=6.0.0; extra == "dev"
+Requires-Dist: mypy>=1.5.0; extra == "dev"
+Provides-Extra: docs
+Requires-Dist: sphinx>=7.1.0; extra == "docs"
+Requires-Dist: sphinx-rtd-theme>=1.3.0; extra == "docs"
+Provides-Extra: native
+Requires-Dist: numpy>=1.24.0; extra == "native"
+Requires-Dist: cython>=3.0.0; extra == "native"
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: license-file
+Dynamic: project-url
+Dynamic: provides-extra
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# 🚀 fastCrypter
+
+**Professional Compression and Encryption Library with Native C/C++ Acceleration**
+
+[![Python Version](https://img.shields.io/badge/python-3.8%2B-blue.svg)](https://python.org)
+[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
+[![PyPI Version](https://img.shields.io/pypi/v/fastCrypter.svg)](https://pypi.org/project/fastCrypter/)
+[![Downloads](https://img.shields.io/pypi/dm/fastCrypter.svg)](https://pypi.org/project/fastCrypter/)
+
+fastCrypter is a powerful Python library that combines advanced compression and encryption techniques with native C/C++ acceleration for maximum performance. It provides a comprehensive suite of tools for secure data handling, from simple file encryption to complex custom encoding schemes.
+
+## ✨ Key Features
+
+### 🔐 **Advanced Encryption**
+- **Multiple Algorithms**: AES-256-GCM, ChaCha20-Poly1305, RSA
+- **Secure Key Management**: PBKDF2, Argon2, secure random generation
+- **Digital Signatures**: RSA and ECC-based signing
+- **Custom Encoding**: User-defined character sets for obfuscation
+
+### 🗜️ **High-Performance Compression**
+- **Multiple Formats**: ZLIB, LZMA, Brotli, custom RLE
+- **Adaptive Algorithms**: Automatic best-fit selection
+- **Native Acceleration**: C/C++ libraries for critical operations
+- **Memory Efficient**: Streaming support for large files
+
+### ⚡ **Native Performance**
+- **C/C++ Libraries**: Optimized crypto and hash operations
+- **SIMD Instructions**: Vectorized operations where available
+- **Cross-Platform**: Windows (.dll), Linux (.so), macOS (.dylib)
+- **Automatic Fallback**: Pure Python when native libs unavailable
+
+### 🛡️ **Security Features**
+- **Secure Memory**: Protected key storage and cleanup
+- **Entropy Analysis**: Data randomness validation
+- **Side-Channel Protection**: Constant-time operations
+- **Audit Trail**: Comprehensive logging and validation
+
+## 🚀 Quick Start
+
+### Installation
+
+```bash
+# Install from PyPI
+pip install fastCrypter
+
+# Install with development dependencies
+pip install fastCrypter[dev]
+
+# Install with native compilation support
+pip install fastCrypter[native]
+```
+
+### Basic Usage
+
+```python
+import fastCrypterer
+
+# Get the recommended compressor (automatically uses native acceleration if available)
+compressor = fastCrypterer.get_recommended_compressor(password="your_secure_password")
+
+# Compress and encrypt data
+data = b"Your sensitive data here"
+encrypted = compressor.compress_and_encrypt(data)
+
+# Decrypt and decompress
+decrypted = compressor.decrypt_and_decompress(encrypted)
+assert data == decrypted
+```
+
+### Custom Encoding Example
+
+```python
+from fastCrypterer import CustomEncoder
+
+# Create custom encoder with your character set
+encoder = CustomEncoder(charset="abcdef98Xvbvii")
+
+# Encode data
+original = b"Hello, World!"
+encoded = encoder.encode(original)
+print(f"Encoded: {encoded}")
+
+# Decode back
+decoded = encoder.decode(encoded)
+assert original == decoded
+```
+
+### File Encryption
+
+```python
+from fastCrypterer import FileEncryptor
+
+# Initialize file encryptor
+encryptor = FileEncryptor(password="your_password")
+
+# Encrypt a file
+encryptor.encrypt_file("document.pdf", "document.pdf.encrypted")
+
+# Decrypt the file
+encryptor.decrypt_file("document.pdf.encrypted", "document_restored.pdf")
+```
+
+## 🏗️ Architecture
+
+fastCrypter is built with a modular architecture:
+
+```
+fastCrypter/
+├── core/                 # Core functionality
+│   ├── compressor.py     # Compression algorithms
+│   ├── encryptor.py      # Encryption algorithms
+│   ├── key_manager.py    # Key derivation and management
+│   └── custom_encoder.py # Custom encoding schemes
+├── algorithms/           # Algorithm implementations
+│   ├── compression/      # Compression algorithms
+│   └── encryption/       # Encryption algorithms
+├── native/              # Native C/C++ libraries
+│   ├── libs/            # Compiled libraries (.so/.dll/.dylib)
+│   └── native_loader.py # Python bindings
+├── utils/               # Utility functions
+└── exceptions.py        # Custom exceptions
+```
+
+## 🔧 Native Compilation
+
+fastCrypter includes C/C++ libraries for performance-critical operations:
+
+### Automatic Compilation
+
+```bash
+# Build native libraries
+python build_native.py
+
+# Build with specific compiler
+python build_native.py --compiler gcc
+
+# Build optimized release version
+python build_native.py --release
+```
+
+### Manual Compilation
+
+```bash
+# Using Make (Linux/macOS)
+cd fastCrypter/native
+make all
+
+# Using MinGW (Windows)
+cd fastCrypter/native
+mingw32-make all
+```
+
+### Performance Benefits
+
+Native libraries provide significant performance improvements:
+
+- **XOR Operations**: 3-5x faster with SIMD instructions
+- **Hash Functions**: 2-3x faster SHA-256 and HMAC
+- **Key Derivation**: 2-4x faster PBKDF2
+- **Compression**: 1.5-2x faster RLE compression
+
+## 📊 Performance Benchmarks
+
+```python
+# Run comprehensive benchmarks
+results = fastCrypter.benchmark_available_features(data_size=1024*1024)
+print(f"Native acceleration: {results['performance']['native']['available']}")
+print(f"Speedup factor: {results['performance'].get('speedup', 'N/A')}")
+```
+
+Example results on modern hardware:
+- **Standard Mode**: ~50 MB/s compression + encryption
+- **Enhanced Mode**: ~150 MB/s with native acceleration
+- **Memory Usage**: <100MB for 1GB files (streaming)
+
+## 🔍 Advanced Features
+
+### Enhanced Compressor
+
+```python
+from fastCrypterer import EnhancedCompressor
+
+# Create enhanced compressor with native acceleration
+compressor = EnhancedCompressor(
+    password="secure_password",
+    use_native=True,
+    compression_level=6
+)
+
+# Check if native libraries are available
+if compressor.is_native_available():
+    print("🚀 Native acceleration enabled!")
+```
+
+### Custom Algorithms
+
+```python
+from fastCrypterer.core import Compressor, CompressionAlgorithmType
+
+# Use specific compression algorithm
+compressor = Compressor(
+    algorithm=CompressionAlgorithmType.BROTLI,
+    level=9  # Maximum compression
+)
+```
+
+### Secure Key Management
+
+```python
+from fastCrypterer import KeyManager
+
+# Generate secure keys
+key_manager = KeyManager()
+master_key = key_manager.generate_key(password="user_password", salt=b"unique_salt")
+
+# Derive multiple keys from master key
+encryption_key = key_manager.derive_key(master_key, b"encryption", 32)
+signing_key = key_manager.derive_key(master_key, b"signing", 32)
+```
+
+## 🧪 Testing
+
+fastCrypter includes comprehensive tests:
+
+```bash
+# Run all tests
+python -m pytest tests/ -v
+
+# Run with coverage
+python -m pytest tests/ --cov=fastCrypter --cov-report=html
+
+# Run performance tests
+python -m pytest tests/test_performance.py -v
+
+# Run native library tests
+python final_test.py
+```
+
+## 🔧 Development
+
+### Setting Up Development Environment
+
+```bash
+# Clone repository
+git clone https://github.com/Pymmdrza/fastCrypter.git
+cd fastCrypter
+
+# Install in development mode
+pip install -e .[dev]
+
+# Build native libraries
+python build_native.py
+
+# Run tests
+python -m pytest
+```
+
+### Code Quality
+
+```bash
+# Format code
+black fastCrypter/ tests/
+
+# Lint code
+flake8 fastCrypter/ tests/
+
+# Type checking
+mypy fastCrypter/
+```
+
+## 📚 Documentation
+
+- **API Reference**: [docs.fastCrypter.dev](https://docs.fastCrypter.dev)
+- **Examples**: See `examples/` directory
+- **Performance Guide**: [Performance Optimization](docs/performance.md)
+- **Security Guide**: [Security Best Practices](docs/security.md)
+
+## 🤝 Contributing
+
+We welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details.
+
+### Development Workflow
+
+1. Fork the repository
+2. Create a feature branch
+3. Make your changes
+4. Add tests for new functionality
+5. Ensure all tests pass
+6. Submit a pull request
+
+## 📄 License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+## 🙏 Acknowledgments
+
+- **Cryptography**: Built on industry-standard libraries
+- **Performance**: Inspired by high-performance computing practices
+- **Security**: Following OWASP and NIST guidelines
+- **Community**: Thanks to all contributors and users
+
+## 📞 Support
+
+- **Issues**: [GitHub Issues](https://github.com/Pymmdrza/fastCrypter/issues)
+- **Discussions**: [GitHub Discussions](https://github.com/Pymmdrza/fastCrypter/discussions)
+- **Email**: pymmdrza@gmail.com
+
+---
+
+**fastCrypter** - Making encryption fast, secure, and accessible! 🚀🔐