obfutil 3.4__tar.gz

obfutil-3.4/CHANGELOG.md

@@ -0,0 +1,324 @@
+# Changelog
+
+All notable changes to ObfUtil will be documented in this file.
+
+## V1.0
+
+**Added**
+- First release of obfuscator with limited usage
+
+## V1.1
+
+**Added**
+- .exe executable tool
+- Password hiding with "*" characters
+- File replacement after encryption
+- New console interface
+
+**Changed**
+- Almost fully recoded main.py
+- Flag-based system instead of options
+
+## V1.2
+
+**Added**
+- Raw README.md
+- Python script obfuscation
+- Double obfuscation with marshal
+- Temp file editing with re-encryption
+
+**Changed**
+- Single main script architecture
+
+**Fixed**
+- Password hiding for Windows and Linux
+- Password exception handling
+- Interface invalid flags
+- Reorganized main.py for cleaner code structure
+- Recoded encryption/decryption functions
+
+## V1.3
+
+**Added**
+- New UI with usage, commands, options and examples
+- Configuration system in main script
+- Russian language localization
+- Argument parser for options
+
+**Removed**
+- requirements.txt
+
+## V1.4
+
+**Added**
+- config.ini external configuration
+- More usage examples
+- -v, --version flag
+
+**Changed**
+- Separated config, localization and main files
+
+**Removed**
+- German language from selection
+
+## V1.5
+
+**Added**
+- 12-character password generation
+
+**Fixed**
+- config.ini creation in main script
+
+**Changed**
+- Examples format (removed # symbols)
+
+## V2.0-aes256
+
+**Added**
+- AES-256 encryption support
+- aes.py for Python script obfuscation
+
+**Changed**
+- Project to modular structure
+- Locales separated into JSON files
+
+**Fixed**
+- config.py to properly create config file
+
+**Removed**
+- Legacy code
+
+## V2.0-release
+
+**Added**
+- Advanced Python obfuscation (import rewriter, self-mod code, CFG, junk code)
+- Flexible password generation (>8 symbols)
+
+**Changed**
+- Examples to more compact format
+- Name from CryptoObfuscator to ObfUtil
+- Global reorganization of all code
+
+**Fixed**
+- Main function structure
+
+## V2.1
+
+**Added**
+- "Nuclear" obfuscation method for Python scripts
+
+## V2.2
+
+**Added**
+- Default language recognition
+- Logging via .log file
+- .gitignore
+- Troubleshooting support
+
+**Fixed**
+- --lang flag functionality
+- --gen-key and --gen-pass commands
+- Encryption/decryption/view operations
+- UI formatting and version display
+
+**Changed**
+- Rebranded as "advanced encryption tool"
+
+## V2.3
+
+**Added**
+- HMAC support for tamper detection
+- New commands: encrypt-integrity, decrypt-integrity, verify-integrity
+- File integrity check system with SHA-256 hashing
+- Modular architecture with int_check.py module
+- --cmds command for complete usage examples
+
+**Changed**
+- Better user experience with compact menu
+- Expanded localization with new translations
+- Examples located in module examples.py
+
+**Fixed**
+- Incomplete error handling in file operations
+- Function signature mismatches in main.py
+
+## V3.0-global
+
+**Added**
+- Encrypted vault system for secure file containers
+- Vault operations: create/list/info/add/extract/remove/delete
+- File integrity verification system with HMAC and SHA-256
+- --move option for vault file operations
+- German language support (Deutsch)
+- Real file data storage in vaults with proper offset management
+- Hash verification for file integrity checking
+- File table management with dynamic offset calculations
+- Vault metadata system with creation time and size tracking
+- API support framework for future extensions
+- Comprehensive README.md documentation
+- Password-based and key-file encryption options for vaults
+- Automatic duplicate file name handling in vaults
+- Exponential backoff for failed vault access attempts
+- Vault status tracking (ACTIVE/MISSING/LOCKED)
+- Advanced batch operations for multiple files
+- System status and configuration management commands
+- Structured help system with categorized examples
+- Extended batch statistics with file sizes and processing speed
+- Vault usage analysis with capacity monitoring
+- Enhanced configuration with system environment info
+- Batch operations progress tracking and performance metrics
+- File type analysis for vault content categorization
+- Largest file identification in vault analysis
+
+**Changed**
+- Complete CLI interface redesign with cleaner command structure
+- Multi-language help system with comprehensive examples
+- Improved error messages and user feedback
+- New command-style menu layout with proper tabulation
+- Status/Config/Vault help now use centered header format
+- Examples organized by categories with descriptions
+- Enhanced vault storage architecture with better encryption
+- Enhanced configuration display with key file status
+- Batch operations show detailed size and speed metrics
+- Project structure reorganization for better maintainability
+- Transition from .exe utility to pip-installable plugin
+- Vault container format with optimized data storage
+- Logger integration throughout all modules
+- Updated version to 3.1 in configuration system
+
+**Fixed**
+- File extraction now returns actual file data with integrity checks
+- Hash calculation and verification for vault operations
+- Language selection across all commands and subcommands
+- Argument parsing for complex vault operations
+- File offset management in vault container system
+- Vault info command authentication and data display
+- Used space calculation in KB for better visibility
+- Vault list command formatting and information display
+- Duplicate import conflicts in main.py
+- API reference errors in status and config commands
+- Inconsistent menu formatting and alignment issues
+- Language switching bugs in vault commands
+- Configuration file parsing errors with supported languages
+- Batch operation statistics calculation methods
+
+**Removed**
+- Placeholder file extraction implementation
+- Old vault command format and legacy syntax
+- Unused localization entries and deprecated functions
+- Unsecure temporary file handling methods
+
+## V3.1
+
+**Added**
+- Consistent logger usage replacing print statements for operational messages
+
+**Changed**
+- Print statements to logger calls for system messages
+- Debug prints to appropriate logger levels (INFO, WARNING, ERROR)
+- Function documentation from Russian to English
+
+**Fixed**
+- Duplicate _save_config method in VaultManager class
+- Redundant derive_hmac_key_from_password function in integrity.py
+
+**Removed**
+- Unnecessary debug print statements from encryption operations
+- Redundant logging messages that duplicated functionality
+- Direct console output for system events in favor of logger
+- Excessive file operation logging in vault management
+
+- Duplicate code in password input handling
+
+## V3.2
+
+**Added**
+- Secure memory management with automatic zeroization for sensitive data
+- Quick vault preview command for metadata access without full data loading
+- Vault integrity verification system with deep and quick check modes
+- Vault health status monitoring command
+- Storage usage analysis command for vault capacity tracking
+- Secure vault deletion with guaranteed memory cleanup
+- Enhanced vault listing with health status and file count information
+
+**Changed**
+- Vault container operations to use secure memory management
+- Vault open/close procedures to include automatic memory cleanup
+- Integrity verification to focus on header and file table consistency
+- Configuration display to show all system paths and directory status
+- File integrity verification output to include clear conclusion messages
+
+**Fixed**
+- Quick vault verification status display and messaging
+- Configuration path display in system information
+- Integrity check conclusion reporting for encrypted files
+- Vault health status calculation in listing operations
+
+**Removed**
+- File hash verification from integrity checks (deferred to V3.3)
+- Secure header HMAC implementation (deferred to V3.3)
+- Redundant memory buffers in vault operations
+
+**Security**
+- Implemented secure memory wiping for all decrypted data
+- Added protection against memory forensic analysis
+- Enhanced vault access controls with exponential backoff
+- Improved sensitive data handling throughout operations
+
+**Performance** 
+- Optimized vault preview with metadata-only loading
+- Reduced memory footprint for large vault operations
+- Improved response time for vault health checks
+- Streamlined file addition process
+
+
+## V3.3-fix
+
+**Changed**
+- vault secure-delete renamed to delete
+
+**Fixed**
+- Some duplicates of functions
+- Some interface explanations were incorrect or not complete
+
+**Removed**
+- Health method due to its malfunction
+- Delete method due to its uselesness
+
+## [V3.4] - 2026-03-23
+
+### Added
+- **New vault commands**:
+  - `vault stats` - Detailed vault statistics (file types, sizes, largest files)
+  - `vault du` - Disk usage by folder inside vault
+  - `vault search` - Search files by pattern, extension, or substring
+  - `vault rename` - Rename files inside vault without re-encryption
+- **`--force` flag** for `vault add` to overwrite existing files
+- **Space check** before adding files to vault (previns "vault full" errors)
+- **Search filters**: `--min-size`, `--max-size`, `--case`, `--type`
+- **Progress indicator** for large file extraction (>10MB)
+- **Stored credentials** in open vault for subsequent operations
+
+### Changed
+- `vault delete` now shows file count and size before confirmation
+- Improved error messages with actionable suggestions
+- Better hash verification during rename operations
+- Enhanced `vault info` with fallback date from filesystem
+- `vault preview` now shows formatted file sizes (KB, MB)
+
+### Fixed
+- File hash verification after rename operation
+- `vault stats` now correctly displays file sizes
+- `vault search` with `--min-size` now properly filters files
+- `config --lang` command now works correctly
+- Duplicate `_get_auth_method` in commands.py
+- `deep_integrity_check` duplication in container.py
+
+### Security
+- Store passwords/keys in memory only while vault is open
+- Secure memory cleanup on vault close
+- Proper credential handling for rename/remove operations
+
+### Removed
+- `vault files` (use `vault preview`)
+- `vault health` (non-functional, use `vault verify`)

obfutil-3.4/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 fearvbs
+
+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.

obfutil-3.4/MANIFEST.in

@@ -0,0 +1,6 @@
+include README.md
+include README.ru.md
+include CHANGELOG.md
+include LICENSE
+recursive-include obfutil *.py
+recursive-include obfutil *.*

obfutil-3.4/PKG-INFO

@@ -0,0 +1,364 @@
+Metadata-Version: 2.4
+Name: obfutil
+Version: 3.4
+Summary: Advanced encryption and obfuscation tool with secure vaults
+Author-email: ObfUtil Team <obfutil@example.com>
+License: MIT
+Project-URL: Homepage, https://github.com/fearvbs/obfutil
+Project-URL: Repository, https://github.com/fearvbs/obfutil
+Project-URL: Issues, https://github.com/fearvbs/obfutil/issues
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: cryptography>=3.4
+Requires-Dist: astor>=0.8
+Dynamic: license-file
+
+## README.md (English Version)
+
+# ObfUtil - Advanced File Encryption & Obfuscation Tool
+
+![Version](https://img.shields.io/badge/version-3.4-blue)
+![Python](https://img.shields.io/badge/python-3.9+-green)
+![License](https://img.shields.io/badge/license-MIT-orange)
+![Platform](https://img.shields.io/badge/platform-Windows%20%7C%20Linux%20%7C%20macOS-lightgrey)
+
+[Features](#-features) • [Installation](#-installation) • [Quick Start](#-quick-start) • [Vault Commands](#-vault-commands) • [API](#-python-api) • [Changelog](CHANGELOG.md)
+
+## 📖 Table of Contents
+
+- [Features](#-features)
+- [Installation](#-installation)
+- [Quick Start](#-quick-start)
+- [Encryption Commands](#-encryption-commands)
+- [Vault Commands](#-vault-commands)
+- [Integrity Protection](#-integrity-protection)
+- [Code Obfuscation](#-code-obfuscation)
+- [Python API](#-python-api)
+- [Configuration](#-configuration)
+- [Contributing](#-contributing)
+- [License](#-license)
+
+## ✨ Features
+
+| Category | Features |
+|----------|----------|
+| **Encryption** | AES-256 encryption, Password/Key file support, HMAC integrity verification |
+| **Vaults** | Encrypted containers, File organization, Storage statistics, Disk usage by folder |
+| **Search** | Pattern matching, Extension search, Size filters, Case sensitivity |
+| **Obfuscation** | AST-based obfuscation, Variable renaming, String encryption, Anti-tamper |
+| **Batch Operations** | Multi-file encryption, Progress tracking, Speed statistics |
+| **Multi-language** | English, Russian, German |
+| **Security** | Secure memory cleanup, Brute force protection, Hash verification |
+
+## 📦 Installation
+
+### From GitHub (Recommended)
+
+```bash
+# Clone the repository
+git clone https://github.com/fearvbs/obfutil.git
+cd obfutil
+
+# Install in development mode
+pip install -e .
+```
+
+### From PyPI
+
+```bash
+pip install obfutil
+```
+
+### Verify Installation
+
+```bash
+obfutil --help
+obfutil vault --help
+```
+
+## 🚀 Quick Start
+
+### Basic Encryption
+
+```bash
+# Encrypt with password
+obfutil encrypt secret.txt --password
+
+# Decrypt and edit
+obfutil decrypt secret.txt.enc --password
+
+# View encrypted content
+obfutil view secret.txt.enc --password
+```
+
+### Vault Operations
+
+```bash
+# Create a vault
+obfutil vault create mydocs --size 100 --password
+
+# Add files
+obfutil vault add mydocs document.pdf --password
+
+# List contents
+obfutil vault preview mydocs --password
+
+# Extract file
+obfutil vault extract mydocs document.pdf ./output.pdf --password
+```
+
+## 🔐 Encryption Commands
+
+### Password-Based Encryption
+
+```bash
+# Encrypt
+obfutil encrypt file.txt --password
+
+# Decrypt with editing
+obfutil decrypt file.txt.enc --password
+
+# View only
+obfutil view file.txt.enc --password
+```
+
+### Key File Encryption
+
+```bash
+# Generate key file
+obfutil --gen-key
+
+# Encrypt with key
+obfutil encrypt file.txt --key-file
+
+# Decrypt with key
+obfutil decrypt file.txt.enc --key-file
+```
+
+### Batch Operations
+
+```bash
+# Encrypt all text files
+obfutil batch-encrypt *.txt --password
+
+# Decrypt all encrypted files
+obfutil batch-decrypt *.enc --password
+```
+
+## 📁 Vault Commands
+
+Vaults are encrypted containers that store multiple files with unified access control.
+
+### Vault Management
+
+| Command | Description | Example |
+|---------|-------------|---------|
+| `create` | Create new vault | `obfutil vault create myvault --size 100 --password` |
+| `list` | List all vaults | `obfutil vault list` |
+| `info` | Vault information | `obfutil vault info myvault --password` |
+| `delete` | Securely delete vault | `obfutil vault delete myvault` |
+
+### File Operations
+
+| Command | Description | Example |
+|---------|-------------|---------|
+| `add` | Add file to vault | `obfutil vault add myvault file.txt --password` |
+| `extract` | Extract file from vault | `obfutil vault extract myvault file.txt ./out.txt --password` |
+| `remove` | Remove file from vault | `obfutil vault remove myvault file.txt --password` |
+| `rename` | Rename file in vault | `obfutil vault rename myvault old.txt new.txt --password` |
+
+### Advanced Commands (New in 3.4)
+
+| Command | Description | Example |
+|---------|-------------|---------|
+| `stats` | Detailed statistics | `obfutil vault stats myvault --password` |
+| `du` | Disk usage by folder | `obfutil vault du myvault --password` |
+| `search` | Search files | `obfutil vault search myvault "*.pdf" --password` |
+| `preview` | Quick file list | `obfutil vault preview myvault --password` |
+| `verify` | Integrity check | `obfutil vault verify myvault --deep --password` |
+| `storage` | Storage usage | `obfutil vault storage myvault --password` |
+
+### Add Command Options
+
+```bash
+# Add with custom internal path
+obfutil vault add myvault file.txt docs/file.txt --password
+
+# Add and delete original (move)
+obfutil vault add myvault file.txt --password --move
+
+# Overwrite existing file
+obfutil vault add myvault file.txt --password --force
+```
+
+### Search Filters
+
+```bash
+# Search by pattern
+obfutil vault search myvault "*.pdf" --password
+
+# Search by extension
+obfutil vault search myvault "jpg" --type ext --password
+
+# Search by substring
+obfutil vault search myvault "secret" --type contains --password
+
+# Search with size filters
+obfutil vault search myvault "*.mp4" --min-size 10 --max-size 100 --password
+
+# Case-sensitive search
+obfutil vault search myvault "README" --case --password
+```
+
+### Statistics Output Example
+
+```
+=== Vault Statistics: myvault ===
+==================================================
+Total Files:    47
+Total Size:     128.5 MB
+Average Size:   2.7 MB
+
+Largest File:   video.mp4 (45.2 MB)
+Oldest File:    config.ini (2024-01-15)
+Newest File:    report.pdf (2026-03-23)
+
+File Types:
+  .pdf    12 files   45.2 MB  ████████████████░░░░░░░░░░░░░░
+  .jpg     8 files   32.1 MB  ████████████░░░░░░░░░░░░░░░░░░
+  .txt    15 files    0.8 MB  ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
+  .mp4     1 file    45.2 MB  ████████████████░░░░░░░░░░░░░░
+```
+
+## 🛡️ Integrity Protection
+
+```bash
+# Encrypt with integrity check
+obfutil encrypt-int sensitive.doc --password
+
+# Verify file integrity
+obfutil verify-int sensitive.doc.enc --password
+
+# Decrypt with integrity verification
+obfutil decrypt-int sensitive.doc.enc --password
+```
+
+## 🔧 Code Obfuscation
+
+```bash
+# Obfuscate Python script
+obfutil obfuscate script.py
+
+# Output: script_obf.py
+```
+
+Obfuscation features:
+- Variable name randomization
+- String encryption
+- Code shredding
+- Anti-tamper protection
+- Junk code injection
+
+## 🐍 Python API
+
+```python
+from obfutil.core.api import api
+
+# File encryption
+result = api.encrypt_file("document.txt", password="secret")
+if result['success']:
+    print(f"Encrypted: {result['output_path']}")
+
+# Vault operations
+api.create_vault("myvault", size_mb=100, password="vaultpass")
+api.add_file_to_vault("myvault", "file.txt", password="vaultpass")
+
+# Get statistics
+stats = api.get_vault_statistics("myvault", password="vaultpass")
+print(f"Files: {stats['total_files']}, Size: {stats['total_size_mb']} MB")
+
+# Search files
+files = api.search_files_in_vault("myvault", "*.pdf", password="vaultpass")
+for file in files:
+    print(f"Found: {file['path']} ({file['size_kb']} KB)")
+
+# Batch operations
+result = api.encrypt_files_batch(["file1.txt", "file2.txt"], password="secret")
+print(f"Processed: {result['successful']}/{result['processed']} files")
+```
+
+## ⚙️ Configuration
+
+All data is stored in `~/.obfutil/`:
+
+```
+~/.obfutil/
+├── config.ini          # User configuration
+├── vaults/             # Encrypted vault files
+│   ├── myvault.obfvault
+│   └── vaults.json     # Vault registry
+├── logs/               # Operation logs
+│   └── program.log
+└── secret.key          # Encryption key (if generated)
+```
+
+### Configuration Commands
+
+```bash
+# Show current configuration
+obfutil config --show
+
+# Change language
+obfutil config --lang ru     # Russian
+obfutil config --lang de     # German
+obfutil config --lang en     # English
+
+# Generate password
+obfutil --gen-pass 16
+
+# Generate key file
+obfutil --gen-key
+```
+
+## 🖥️ System Requirements
+
+- **Python**: 3.9 or higher
+- **Dependencies**: cryptography, astor
+- **Platform**: Windows, Linux, macOS
+- **Storage**: ~/.obfutil/ directory with write permissions
+
+## 🤝 Contributing
+
+1. Fork the repository
+2. Create feature branch (`git checkout -b feature/amazing-feature`)
+3. Commit changes (`git commit -m 'Add amazing feature'`)
+4. Push to branch (`git push origin feature/amazing-feature`)
+5. Open Pull Request
+
+## 📄 License
+
+MIT License - see [LICENSE](LICENSE) file for details.
+
+---
+
+## 🌟 Version 3.4 Highlights
+
+- 📊 **`vault stats`** - Detailed file statistics and type distribution
+- 🔍 **`vault search`** - Powerful search with size and type filters
+- 📁 **`vault du`** - Disk usage analysis by folder
+- ✏️ **`vault rename`** - Rename files inside vaults
+- ⚡ **`--force`** - Overwrite existing files
+- 🛡️ **Improved hash verification** - Fixed after rename operations
+- 🌐 **Better error messages** - Actionable suggestions
+
+---
+
+*For full changelog, see [CHANGELOG.md](CHANGELOG.md)*