Merge pull request #39 from Cyber-Syntax:feat/cli

Add CLI functionality and cleanup options

Author: Cyber-Syntax

AGENTS.md

@@ -5,9 +5,8 @@ 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. Type Safety: Full type annotations on all functions including return types. Use modern syntax (`dict[str, int]`, `str | None`).
-3. KISS Principle: Aim for simplicity and clarity. Avoid unnecessary abstractions or metaprogramming.
-4. DRY with Care: Reuse code appropriately but avoid over-engineering. Each command handler has single responsibility.
+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.
 
 ## Test after any change
 

CHANGELOG.md

@@ -1,6 +1,10 @@
 # Changelog
 All notable changes to this project will be documented in this file. Commits automatically generated by github actions.
 
+## 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

README.md

@@ -10,16 +10,28 @@ Turkish: [README.tr.md](https://github.com/Cyber-Syntax/AutoTarCompress/blob/mai
 
 ---
 
-# **About AutoTarCompress**
+# **AutoTarCompress**
 
 > [!NOTE]
-> AutoTarCompress is a command-line tool for Linux that simplifies the process of creating and managing compressed backups of your important directories. It offers features like compressing, encryption, decryption.
+> 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)
 
+## **✨ Features**
+
+- **Create compressed backups** using tar and xz compression
+- **Encrypt/decrypt backups** with GPG 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
+- **Logging and error handling** for reliable operation
+
 ---
 
-## **💡 How to Use**
+## **💡 Installation**
 
 1. Open a terminal and clone this repo (make sure you have git installed):
 
@@ -33,10 +45,6 @@ git clone https://github.com/Cyber-Syntax/AutoTarCompress.git
 cd AutoTarCompress
 ```
 
-cd AutoTarCompress
-chmod +x install.sh
-./install.sh
-
 3. Make executable and run the install script:
 
 ```bash
@@ -49,28 +57,95 @@ chmod +x install.sh && ./install.sh
 source ~/.bashrc   # or ~/.zshrc
 ```
 
-5. Configure
+5. Go to configuration file and set your preferences:
+
+```bash
+vim ~/.config/autotarcompress/config.conf
+```
+
+---
+
+## **🚀 Usage**
+
+AutoTarCompress now offers two ways to use it:
+
+### **🔥 New: Command-Line Interface (Recommended for automation)**
 
-Copy the example config and edit as needed:
+The CLI provides scriptable access to all backup operations:
 
 ```bash
-mkdir -p ~/.config/autotarcompress
-cp config_files_example/config.json ~/.config/autotarcompress/config.json
-# Edit ~/.config/autotarcompress/config.json to match your needs
+# Show all available commands
+autotarcompress --help
+
+# Create a backup
+autotarcompress backup
+
+# Encrypt the latest backup
+autotarcompress encrypt --latest
+
+# Encrypt a backup from a specific date
+autotarcompress encrypt --date 15-01-2024
+
+# Encrypt a specific backup file
+autotarcompress encrypt backup_15-01-2024_10-30-45.tar.xz
+
+# Decrypt the latest encrypted backup
+autotarcompress decrypt --latest
+
+# Extract the latest backup
+autotarcompress extract --latest
+
+# Clean up old backups (uses config defaults)
+autotarcompress cleanup
+
+# Clean up keeping only 5 most recent backups
+autotarcompress cleanup --keep 5
+
+# Show last backup information
+autotarcompress info
 ```
 
-Or, just run the tool and follow the prompts to generate a config interactively.
+### **📋 Interactive Menu (Original experience)**
 
-## Run the script
+For users who prefer an interactive experience:
 
 ```bash
-autotarcompress
+autotarcompress interactive
 ```
 
-Follow the on-screen instructions to create, encrypt, or extract backups.
+Or simply run without arguments (default behavior):
+
+```bash
+autotarcompress
+```
 
 ---
 
+## **📚 CLI Commands Overview**
+
+AutoTarCompress provides the following commands:
+
+- `backup` — Create a backup archive
+- `encrypt` — Encrypt a backup file
+- `decrypt` — Decrypt an encrypted backup file
+- `extract` — Extract a backup archive
+- `cleanup` — Remove old backups
+- `info` — Show information about the last backup
+- `interactive` — Launch the interactive menu (legacy mode)
+
+For detailed options, usage examples, configuration, and migration notes, see [docs/wiki.md](docs/wiki.md).
+
+### Quick Example
+
+```bash
+autotarcompress backup
+autotarcompress encrypt --latest
+autotarcompress cleanup --keep 7
+autotarcompress info
+```
+
+See the [wiki](docs/wiki.md) for advanced usage and full documentation.
+
 ## **🙏 Support This Project**
 
 If this script has been helpful: