Merge pull request #42 from Cyber-Syntax:dev

feat: enhance backup and extraction features with improved CLI and logging

Author: Cyber-Syntax

.gitignore

@@ -1,4 +1,5 @@
 # Custom
+memory-bank/
 examples
 
 # Byte-compiled / optimized / DLL files

AGENTS.md

@@ -4,20 +4,38 @@ This file provides guidance to agents when working with code in this repository.
 
 ## General Guidelines
 
-1. Modern Python First: Use Python 3.12+ features extensively - built-in generics, pattern matching, and dataclasses.
-2. KISS Principle: Aim for simplicity and clarity. Avoid unnecessary abstractions or metaprogramming.
-3. DRY with Care: Reuse code appropriately but avoid over-engineering. Each command handler has single responsibility.
+1. KISS (Keep It Simple, Stupid): Aim for simplicity and clarity. Avoid unnecessary abstractions or metaprogramming.
+2. DRY (Don't Repeat Yourself): Reuse code appropriately but avoid over-engineering. Each command handler has single responsibility.
+3. YAGNI (You Aren't Gonna Need It): Always implement things when you actually need them, never when you just foresee that you need them.
+4. ALWAYS use `ruff check <filepath>` on each Python file you modify to ensure proper linting and formatting:
+    - Use `ruff check --fix <filepath>` to automatically fix any fixable errors.
+    - Use `ruff format path/to/file.py` to format a specific file.
+    - Use `ruff format path/to/code/` to format all files in `path/to/code` (and any subdirectories).
+    - Use `ruff format` to format all files in the current directory.
 
-## Test after any change
+## Testing Instructions
 
-1. Activate venv before any test execution:
+Critical: Run tests after any change to ensure nothing breaks.
 
 ```bash
-source .venv/bin/activate
+# Run all tests:
+uv run pytest
+# Run specific test file:
+uv run pytest tests/test_config.py
+# Run specific test function:
+uv run pytest tests/test_config.py::test_function_name
+# Run with coverage
+uv run pytest tests/python/ --cov=aps.<folder>.<module>
+uv run pytest tests/cli/test_parser.py --cov=my_unicorn.cli.parser
 ```
 
-2. Run pytest with following command to ensure all tests pass:
+## Code Style Guidelines
 
-```bash
-pytest -v -q --strict-markers
-```
+- Use built-in types: `list[str]`, `dict[str, int]`
+- Use `%s` style formatting in logging statements
+- Use `logger.exception("message")` in exception handlers to log stack traces
+
+## Project Overview
+
+**AutoTarCompress** is a Python 3.12+ CLI tool for automating the process of backup and compression.
+It's backup the dirs that user written to config file while ignoring the dirs that user don't need - node_modules, **pycache** - or custom dirs that user want to ignore.

CHANGELOG.md

@@ -1,34 +1,110 @@
 # Changelog
-All notable changes to this project will be documented in this file. Commits automatically generated by github actions.
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.8.0-alpha] - 2026-01-10
+
+### BREAKING CHANGES
+
+- **Metadata Schema Update:** Upgraded metadata.json from v1.0 to v2.0 to support integrity verification hashes. Backward compatible - existing v1.0 metadata will be migrated automatically.
+- **Encryption Migration:** Migrated from OpenSSL subprocess calls to the `cryptography` library with AES-256-GCM authenticated encryption. This is a breaking change - **old .enc files encrypted with OpenSSL will not be decryptable** with the new version. Users should decrypt any existing encrypted backups before upgrading or keep the old version to decrypt legacy files.
+
+### Added
+
+- **SHA256 Integrity Verification:** Added comprehensive file integrity verification system
+    - Calculate and store SHA256 hash of backup archives (.tar.zst)
+    - Calculate and store SHA256 hash of encrypted files (.enc)
+    - Calculate and store SHA256 hash of decrypted files
+    - Verify decrypted file integrity against original backup archive hash
+    - All hashes stored in metadata.json v2.0 with appropriate naming
+    - Added 28 new tests for hash utilities and metadata v2.0
+- Pure Python encryption using the `cryptography` library - no more external OpenSSL binary dependency
+- AES-256-GCM authenticated encryption provides both confidentiality and integrity verification
+- PBKDF2-HMAC-SHA256 key derivation with 600,000 iterations (OWASP recommended)
+- Built-in tamper detection - decryption automatically fails if encrypted file has been modified
+- Improved error handling with Python exceptions instead of subprocess stderr parsing
+- Added comprehensive encryption/decryption tests including tamper detection and round-trip validation
+- Implemented progress bar for extraction process using SimpleProgressBar, calculating total archive size for accurate progress updates
+- Migrated backup to tarfile library with zstd compression and built-in progress bar, supporting both .tar.zst and .tar.xz formats
+- Added global --version option and improved main entry point for consistent package import context
+
+### Changed
+
+- Updated BackupMetadata dataclass to version 2.0 with file_hashes field
+- BackupManager now calculates SHA256 hash after backup creation and stores in metadata
+- EncryptManager calculates SHA256 hash after encryption and stores in metadata
+- DecryptManager calculates SHA256 hash after decryption and verifies against backup hash
+- Encryption file format changed from base64-encoded OpenSSL output to binary format: `[salt(16)][nonce(12)][ciphertext][tag(16)]`
+- Removed hash embedding - GCM mode provides built-in authentication via authentication tag
+- Simplified encryption/decryption managers - removed subprocess complexity
+- Enhanced module structure by adding runner.py, removing deprecated files, and consolidating functionality
+- Updated documentation including AGENTS.md guidelines, README revisions, and added exclude_patterns.md guide
+- Replaced print statements with logging across modules for better traceability
+- Changed backup info file path to .config directory and renamed to metadata.json
+- Improved path handling in backup commands with user path expansion
+- Updated logging path to align with XDG config standards
+- Simplified zsh completion installation for better portability
+- Added installation options for uv tool including development mode and legacy removal
+
+### Removed
+
+- Removed old `save_backup_info()` method in favor of `save_backup_metadata_with_hash()`
+- Removed OpenSSL system dependency (previously required `openssl` command)
+- Removed `_sanitize_logs()` method (no longer needed without subprocess)
+- Removed `_verify_integrity_mandatory()` method (GCM provides automatic integrity verification)
+
+### Fixed
+
+- Fixed ignore pattern matching to properly handle absolute paths and patterns like node_modules, **pycache**, etc.
 
 ## v0.7.1-beta
+
 ## v0.7.0-beta
+
 ### BREAKING CHANGES
+
 This release introduces a new command-line interface (CLI) for AutoTarCompress, enabling users to perform all operations via terminal commands. The previous interactive menu mode still exists but may be deprecated in future releases. Users are encouraged to transition to the CLI for better automation and scripting capabilities. For detailed usage instructions, please refer to the updated documentation in [docs/wiki.md](docs/wiki.md).
 
 ## v0.6.3-beta
+
 ## v0.6.2-beta
+
 ## v0.6.1-beta
+
 ## v0.6.0-beta
+
 ### BREAKING CHANGES
+
 - The configuration file format has been changed from JSON to INI. Now located at `~/.config/autotarcompress/config.conf`. Please migrate your existing configuration accordingly.
 
 #### Migration Steps
+
 Script will create a new config file in the new format if it does not exist. Please manually transfer your settings from the old JSON file to the new INI file, following the comments provided in the new config file for guidance.
 
 ## v0.5.0-beta
+
 ### Changes
+
 This release adds the `info` command to display details about the latest backup, including directories backed up and backup file status.
 
 ## v0.4.0-beta
+
 ## v0.3.1-beta
+
 ### Changes
-# BREAKING CHANGES
+
+### BREAKING CHANGES
+
 Current config file location moved to `~/.config/autotarcompress/config.json`. Please review example config file and update it for your needs.
-  
-  - feat!: Use XDG Base Directory specifications.
-  - fix: endless backup command issue
-  - refactor: make class for context manager
-  - chore: format fix
-  - chore: pytproject.toml and requirements.txt update
-  - refactor!: add command design pattern
+
+- feat!: Use XDG Base Directory specifications.
+- fix: endless backup command issue
+- refactor: make class for context manager
+- chore: format fix
+- chore: pytproject.toml and requirements.txt update
+- refactor!: add command design pattern
+
+[Unreleased]: https://github.com/Cyber-Syntax/AutoTarCompress/compare/v0.7.1-beta...HEAD

README.md

@@ -1,32 +1,33 @@
-Turkish: [README.tr.md](https://github.com/Cyber-Syntax/AutoTarCompress/blob/main/README.tr.md)
-
----
+# **AutoTarCompress**
 
 > [!CAUTION]
 >
 > - This project is in a **beta phase** due to limited testing at this time.
 > - **Important:** Follow the instructions in the **Releases section** when updating the script.
 > - **Supported OS:** Currently, only Linux is supported.
+>
 
----
-
-# **AutoTarCompress**
+## **📖 Overview**
 
 > [!NOTE]
+>
 > AutoTarCompress is a robust backup and archive management tool that provides both command-line interface (CLI) and interactive menu functionality for creating, encrypting, and managing backup archives.
 >
 > - Detailed information: [wiki.md](docs/wiki.md)
 
+Turkish: [README.tr.md](README.tr.md)
+
 ## **✨ Features**
 
-- **Create compressed backups** using tar and xz compression
-- **Encrypt/decrypt backups** with GPG encryption
+- **Create compressed backups** using tar and zstd compression
+- **Encrypt/decrypt backups** with AES-256-GCM authenticated encryption
 - **Extract backup archives** to restore files
 - **Clean up old backups** with configurable retention policies
 - **Backup information display** showing file details and metadata
 - **🆕 Command-line interface** for scriptable automation
 - **Interactive menu** for user-friendly operation
 - **Configurable backup directories** and ignore patterns
+- **Progress bar with ETA** for backup and extraction operations
 - **Logging and error handling** for reliable operation
 
 ---
@@ -39,31 +40,36 @@ Turkish: [README.tr.md](https://github.com/Cyber-Syntax/AutoTarCompress/blob/mai
 git clone https://github.com/Cyber-Syntax/AutoTarCompress.git
 ```
 
-2. Navigate to the project directory:
+1. Navigate to the project directory:
 
 ```bash
 cd AutoTarCompress
 ```
 
-3. Make executable and run the install script:
+1. Make executable and run the install script:
 
 ```bash
-chmod +x install.sh && ./install.sh
+chmod +x install.sh
+
+# for production use
+./install.sh uv-prod
+# for development use
+./install.sh uv-dev
 ```
 
-4. After installation, restart your shell or run:
+1. After installation, restart your shell or run:
 
 ```bash
 source ~/.bashrc   # or ~/.zshrc
 ```
 
-5. Go to configuration file and set your preferences:
+1. Go to configuration file and set your preferences:
 
 ```bash
 vim ~/.config/autotarcompress/config.conf
 ```
 
-6. (Optional) Enable shell autocompletion for bash or zsh:
+1. (Optional) Enable shell autocompletion for bash or zsh:
 
 ```bash
 # Auto detect your shell and install autocomplete

README.tr.md

@@ -1,4 +1,4 @@
-İngilizce: [README.md](https://github.com/Cyber-Syntax/AutoTarCompress/blob/main/README.md)
+İngilizce: [README.md](README.md)
 
 ---
 
@@ -10,28 +10,24 @@
 
 ---
 
-
 # **AutoTarCompress Hakkında**
 
-
 > [!NOTE]
 > AutoTarCompress, önemli dizinlerinizin sıkıştırılmış yedeklerini oluşturma ve yönetme sürecini kolaylaştıran bir Linux komut satırı aracıdır. Sıkıştırma, şifreleme ve şifre çözme gibi özellikler sunar.
 >
 > - Detaylı bilgi: [wiki.md](docs/wiki.md)
 
 ---
 
-
 ## **💡 Nasıl Kullanılır**
 
-
 1. Bir terminal açın ve bu depoyu klonlayın (git'in kurulu olduğundan emin olun):
 
 ```bash
 git clone https://github.com/Cyber-Syntax/AutoTarCompress.git
 ```
 
-2. Proje dizinine geçin:
+1. Proje dizinine geçin:
 
 ```bash
 cd AutoTarCompress
@@ -41,19 +37,19 @@ cd AutoTarCompress
 chmod +x install.sh
 ./install.sh
 
-3. Kurulum dosyasını çalıştırılabilir yapın ve yükleme scriptini çalıştırın:
+1. Kurulum dosyasını çalıştırılabilir yapın ve yükleme scriptini çalıştırın:
 
 ```bash
 chmod +x install.sh && ./install.sh
 ```
 
-4. Kurulumdan sonra shell'i yeniden başlatın veya şunu çalıştırın:
+1. Kurulumdan sonra shell'i yeniden başlatın veya şunu çalıştırın:
 
 ```bash
 source ~/.bashrc   # veya ~/.zshrc
 ```
 
-5. Yapılandırma
+1. Yapılandırma
 
 Örnek yapılandırmayı kopyalayın ve ihtiyacınıza göre düzenleyin:
 
@@ -75,11 +71,10 @@ Yedek oluşturmak, şifrelemek veya çıkarmak için ekrandaki talimatları izle
 
 ---
 
-
 ## **🙏 Bu Projeye Destek Olun**
 
 Bu script işinize yaradıysa:
 
 - **GitHub'da bir yıldız ⭐ vererek** desteğinizi gösterebilir ve kodlama yolculuğumda motive olmamı sağlayabilirsiniz!
 - **💖 Bu Projeye Destek Olun:** Çalışmalarımı desteklemek ve yeni projeler geliştirmeye devam etmemi sağlamak isterseniz, bana sponsor olabilirsiniz:
-    - [![Sponsor Me](https://img.shields.io/badge/Sponsor-💖-brightgreen)](https://github.com/sponsors/Cyber-Syntax)
+    - [![Sponsor Me](https://img.shields.io/badge/Sponsor-💖-brightgreen)](https://github.com/sponsors/Cyber-Syntax)

autotarcompress/__init__.py

@@ -1,4 +1,22 @@
 """AutoTarCompress package.
 
 This package provides a complete backup solution with encryption capabilities.
-"""
+"""
+
+from importlib.metadata import PackageNotFoundError, version
+
+# Expose managers for direct imports
+from autotarcompress.backup_manager import BackupManager
+from autotarcompress.cleanup_manager import CleanupManager
+from autotarcompress.extract_manager import ExtractManager
+from autotarcompress.info_manager import InfoManager
+
+try:
+    # "autotarcompress" should match the 'name' field in your pyproject.toml
+    __version__ = version("autotarcompress")
+except PackageNotFoundError:
+    # This happens if the package isn't installed (e.g., running raw scripts)
+    __version__ = "dev"
+
+
+__all__ = ["BackupManager", "CleanupManager", "ExtractManager", "InfoManager"]