allykit 1.1.2__tar.gz → 1.2.2__tar.gz

allykit-1.2.2/PKG-INFO

@@ -0,0 +1,299 @@
+Metadata-Version: 2.4
+Name: allykit
+Version: 1.2.2
+Summary: A comprehensive Python toolkit for security engineering, cryptography, web scraping, filesystem auditing, DFIR, command-line automation, Git, PowerShell, and reusable developer utilities.
+Author-email: allykit Developer <hossein.moradian.ir@outlook.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/hosssein193m-ai/
+Project-URL: Repository, https://github.com/hosssein193m-ai/allykit
+Project-URL: Issues, https://github.com/hosssein193m-ai/allykit/
+Keywords: security,cryptography,hashing,password,password-generator,password-security,web-scraping,selenium,beautifulsoup,filesystem,filesystem-audit,digital-forensics,dfir,integrity,checksum,metadata,utilities,automation,command-line,cmd,powershell,git,python,pip,terminal,developer-tools,devops,shell,persian,iran,country-data
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Information Technology
+Classifier: Intended Audience :: System Administrators
+Classifier: Intended Audience :: Science/Research
+Classifier: Topic :: Security
+Classifier: Topic :: Security :: Cryptography
+Classifier: Topic :: Internet :: WWW/HTTP
+Classifier: Topic :: Internet :: WWW/HTTP :: Indexing/Search
+Classifier: Topic :: System :: Filesystems
+Classifier: Topic :: System :: Systems Administration
+Classifier: Topic :: System :: Shells
+Classifier: Topic :: Software Development
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Utilities
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+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: Typing :: Typed
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.31.0
+Requires-Dist: beautifulsoup4>=4.12.3
+Requires-Dist: selenium>=4.24.0
+Requires-Dist: tenacity>=9.0.0
+Requires-Dist: deepdiff>=8.0.1
+Requires-Dist: pyautogui>=0.9.54
+Requires-Dist: pyperclip>=1.9.0
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0; extra == "dev"
+Requires-Dist: pytest-cov>=5.0; extra == "dev"
+Requires-Dist: black>=24.0; extra == "dev"
+Requires-Dist: ruff>=0.6; extra == "dev"
+Requires-Dist: mypy>=1.10; extra == "dev"
+Provides-Extra: docs
+Requires-Dist: mkdocs>=1.6; extra == "docs"
+Requires-Dist: mkdocs-material>=9.5; extra == "docs"
+Provides-Extra: web
+Requires-Dist: selenium>=4.24.0; extra == "web"
+Provides-Extra: all
+Requires-Dist: allykit[dev,docs,web]; extra == "all"
+Dynamic: license-file
+
+# allykit Library Documentation (Full & Updated Version)
+
+The `allykit` library is a comprehensive toolkit designed for security engineers, backend developers, DevOps engineers, system administrators, and digital forensics specialists. It integrates advanced cryptographic operations, automated web interaction, intelligent filesystem auditing, command-line automation, robust password management, language and geographic data, and cookie management into a unified framework.
+
+**Important Note**: Versions prior to 1.1.0 do not meet our standards, so please use the newer versions and enjoy.
+
+---
+
+## Modules Overview
+
+### 1. Password Generation & Security Kit (Security Kit)
+
+A high-level suite for managing credentials. It supports the generation of complex, randomized strings and time-sensitive passwords with expiration logic.
+
+**Core Capabilities**:
+- Customizable password generation (length, character constraints, prefixes/suffixes)
+- Time-based validity (GTP/WPWT)
+- Granular security auditing (Complexity Scoring and validation engines)
+- **`Time_Password` class** for complete time-based password management
+- **`Review_Password` class** for password validation and scoring
+- Secure hashing, integrity verification, and authentication utilities
+
+**Usage Examples**:
+- Basic and strong password generation
+- Password generation with prefix/suffix
+- Time-limited password generation (with `generating_password` function)
+- Password complexity validation (character checks, length, repetition)
+- Entropy scoring (strength evaluation)
+- Hashing with various algorithms (SHA256, SHA512, SHA3, BLAKE2)
+- Salted hashing (for secure storage)
+- Double hashing (Hash-in-Hash) for increased difficulty
+- Hash algorithm detection
+- Hash comparison
+- **Professional time-based password management with `Time_Password` class** (expiry check, remaining time, full status report)
+
+**Use Cases**: Automated credential management, secure token generation, password auditing, integrity verification, security strength evaluation, and one-time password authentication systems.
+
+---
+
+### 2. Web Kit & Scrapers (Web Kit)
+
+A specialized module for seamless web interaction, data extraction, cookie management, and web monitoring.
+
+**Core Capabilities**:
+- **Web Interaction**: Advanced HTML fetching (mimicking real browsers to bypass detection), DOM traversal via BeautifulSoup integration, Selenium automation, intelligent HTTP requests, and memory-efficient streaming for large remote file downloads.
+- **Cookie Management**: Saving, loading, managing expired cookies, switching between cookie files, and integration with WebAutomation.
+- **Caching**: Disk-based caching with TTL support for HTML and JavaScript content.
+- **Web Monitoring**: Change detection, data caching, and monitoring of web pages.
+
+**Usage Examples**:
+- URL normalization and validation
+- HTTP requests with retry logic
+- Extracting links, images, and text from HTML
+- JavaScript rendering with headless browsers
+- Web automation (form filling, clicking, screenshots)
+- Single and bulk file downloads
+- HTML comparison and change detection
+- Cookie management (save, load, clear expired)
+- Caching web pages for reuse
+- Monitoring web page changes
+
+**Use Cases**: Web scraping, data mining, automated browser interaction, website analysis, media/asset acquisition, user session management, and website change monitoring.
+
+---
+
+### 3. Cryptographic Hashing & Integrity Verification
+
+A robust cryptographic engine providing multi-algorithm support and advanced protection mechanisms.
+
+**Core Capabilities**: Support for the SHA family (SHA-1 through SHAKE-256), intelligent hash detection, Salt management to prevent rainbow table attacks, "Hash-in-Hash" (HH) double-hashing for increased computational difficulty, and integrity verification.
+
+**Usage Examples**:
+- String and file hashing
+- Salt generation
+- Salted hashing and password verification
+- Automatic hash algorithm detection
+
+**Use Cases**: Digital forensics (DFIR), data integrity verification, secure authentication, password protection, and digital evidence validation.
+
+---
+
+### 4. Filesystem Management & Metadata Mapping (Security Kit - File)
+
+An advanced exploration engine for deep filesystem analysis and auditing.
+
+**Core Capabilities**: Recursive directory crawling, hierarchical metadata mapping (size, ownership, timestamps), structured filesystem inventory generation, metadata extraction, and filesystem auditing.
+
+**New Security Features**:
+- **Create Snapshot** (`create_snapshot`): Capture a complete image of file system state for later use.
+- **Verify Snapshot** (`verify_snapshot`): Compare current state with previous snapshot to detect changes, new files, or deletions.
+- **Security Mapping** (`dict_files_in_directory`, `map_directory_metadata`)
+
+**Usage Examples**:
+- Taking a snapshot of a project folder to detect future changes
+- Getting detailed file statistics and information
+- Mapping complete directory metadata (recursively)
+- Generating file dictionaries with hashes
+- Saving dictionaries to JSON files
+- Retrieving file permission strings
+- Bulk file deletion
+
+**Use Cases**: Digital forensics (DFIR), system auditing, integrity-based backup solutions, file analysis, and filesystem inspection.
+
+---
+
+### 5. Language & Geography Data (Data Kit)
+
+A comprehensive dataset for language detection, country information, and Iranian geographic data.
+
+**Core Capabilities**:
+- **Language**: Language detection, filtering by language, digit normalization, RTL character detection, character classification, and ASCII approximation (transliteration).
+- **Countries**: Complete country information (calling codes, ISO codes, capitals, currencies, continents), country search, and phone number formatting.
+- **Iran**: Province and city information (coordinates, population, phone codes, car plate codes), SIM card operator detection, city search, and region-based province lookup.
+
+**Usage Examples**:
+- Detecting the language of a text (Persian, English, Arabic, ...)
+- Filtering Persian characters from a text
+- Normalizing digits (converting Persian digits to ASCII)
+- Getting complete information for a country (calling code, capital, currency)
+- Searching for countries by name
+- Getting the province and full information for an Iranian city
+- Detecting the SIM card operator based on the prefix
+- Getting the phone code and car plate code for a city
+
+**Use Cases**: Internationalization (i18n), localization (l10n), phone number validation, text analysis, Geographic Information Systems (GIS), and location-based applications.
+
+---
+
+### 6. Core Automation Toolkit (Automobile Kit)
+
+A unified automation layer for developers and system administrators that simplifies interaction with the operating system, terminal, Git, Python, package management, PowerShell, filesystem utilities, and process management.
+
+**Core Capabilities**:
+- **CMD**: Execute Command Prompt commands with timeout and multiple command support.
+- **PowerShell**: Execute PowerShell commands with structured execution and output capture.
+- **Hybrid**: Execute commands simultaneously in CMD and PowerShell and compare outputs.
+- **Git**: Full Git automation (clone, init, add, commit, push, pull, branch, status, log).
+- **Python**: Execute scripts, modules, and inline code, create virtual environments, and manage packages with Pip.
+- **Filesystem**: Common file and folder operations (create, copy, move, delete, list).
+- **Process Management**: Check, count, get info, suspend, resume, and kill processes, with special support for browsers.
+- **System Class**: A unified interface to access all automation capabilities.
+
+**Usage Examples**:
+- Developer automation (code management, testing)
+- DevOps workflows (deployment, monitoring)
+- Windows automation (system management)
+- New project initialization (init, venv)
+- Command-line utilities
+- Git automation (commit, push, branch)
+- Python environment management (venv, pip)
+- Process management (monitoring, closing browsers)
+- System auditing and cleanup
+
+**Use Cases**: Developer automation, DevOps workflows, Windows automation, project initialization, command-line utilities, Git automation, Python environment management, process management, and system administration.
+
+---
+
+### 7. General Tools Kit (Tools Kit) ** NEW **
+
+A foundational layer providing common, reusable utilities for other modules and developers.
+
+**Core Capabilities**:
+
+* **File Tools (`file_tools.py`)**:
+    * Basic file and folder operations (create, read, write, delete)
+    * JSON file handling (`dump_file`, `load_file`)
+    * File permission management (`get_permission`, `change_permission`)
+    * Complete file metadata extraction (`information_files_dict`)
+
+* **String Tools (`string_tools.py`)**:
+    * Secure random string generation with `secrets`
+    * Helper functions for random character generation
+    * **Random character generation source for `password_kit` module**
+
+* **Use Cases**: Developer automation, DevOps workflows, Windows automation, project initialization, command-line utilities, Git automation, Python environment management, process management, and system administration.
+
+---
+
+## Technical Requirements
+
+### Environment
+* Python 3.9+
+
+### Dependencies
+```bash
+pip install requests beautifulsoup4 selenium tenacity deepdiff pyautogui pyperclip
+```
+
+### Standard Libraries
+`hashlib`, `os`, `pathlib`, `datetime`, `json`, `shutil`, `string`, `random`, `re`, `typing`, `subprocess`, `time`, `pickle`
+
+---
+
+## Package Structure
+
+```
+src/allykit/
+├── __init__.py
+├── Security_kit/
+│   ├── __init__.py
+│   ├── file_kit.py
+│   ├── password_kit.py
+│   └── hash_kit.py
+├── web_kit/
+│   ├── __init__.py
+│   ├── CChrome.py
+│   ├── Communications.py
+│   ├── WebAutomation.py
+│   ├── Working_with_code.py
+│   ├── Elastic_bands.py
+│   ├── Get_Code.py
+│   └── Cookie.py
+├── data_kit/
+│   ├── __init__.py
+│   ├── IRAN.py
+│   ├── Language.py
+│   └── country.py
+└── Automobile_kit/
+    ├── __init__.py
+    ├── ProcessManager.py
+    ├── Automobile/
+    │   ├── __init__.py
+    │   ├── Cmd.py
+    │   ├── powershell.py
+    │   └── hybrid.py
+    └── New_automobile/
+        ├── __init__.py
+        ├── file.py
+        ├── python.py
+        └── git.py
+```
+## Version Summary
+
+This version represents a significant step forward with the addition of Tools_kit and the modular rewrite of password_kit. The Security_kit modules now benefit from a foundational layer (Tools_kit), greatly improving code reusability and maintainability.
+
+**Key Changes**:
+- Added Tools_kit with file_tools and string_tools
+- Complete modular rewrite of password_kit with Time_Password and Review_Password classes
+- Added snapshot and integrity verification capabilities to file_kit

allykit-1.2.2/README.md

@@ -0,0 +1,239 @@
+# allykit Library Documentation (Full & Updated Version)
+
+The `allykit` library is a comprehensive toolkit designed for security engineers, backend developers, DevOps engineers, system administrators, and digital forensics specialists. It integrates advanced cryptographic operations, automated web interaction, intelligent filesystem auditing, command-line automation, robust password management, language and geographic data, and cookie management into a unified framework.
+
+**Important Note**: Versions prior to 1.1.0 do not meet our standards, so please use the newer versions and enjoy.
+
+---
+
+## Modules Overview
+
+### 1. Password Generation & Security Kit (Security Kit)
+
+A high-level suite for managing credentials. It supports the generation of complex, randomized strings and time-sensitive passwords with expiration logic.
+
+**Core Capabilities**:
+- Customizable password generation (length, character constraints, prefixes/suffixes)
+- Time-based validity (GTP/WPWT)
+- Granular security auditing (Complexity Scoring and validation engines)
+- **`Time_Password` class** for complete time-based password management
+- **`Review_Password` class** for password validation and scoring
+- Secure hashing, integrity verification, and authentication utilities
+
+**Usage Examples**:
+- Basic and strong password generation
+- Password generation with prefix/suffix
+- Time-limited password generation (with `generating_password` function)
+- Password complexity validation (character checks, length, repetition)
+- Entropy scoring (strength evaluation)
+- Hashing with various algorithms (SHA256, SHA512, SHA3, BLAKE2)
+- Salted hashing (for secure storage)
+- Double hashing (Hash-in-Hash) for increased difficulty
+- Hash algorithm detection
+- Hash comparison
+- **Professional time-based password management with `Time_Password` class** (expiry check, remaining time, full status report)
+
+**Use Cases**: Automated credential management, secure token generation, password auditing, integrity verification, security strength evaluation, and one-time password authentication systems.
+
+---
+
+### 2. Web Kit & Scrapers (Web Kit)
+
+A specialized module for seamless web interaction, data extraction, cookie management, and web monitoring.
+
+**Core Capabilities**:
+- **Web Interaction**: Advanced HTML fetching (mimicking real browsers to bypass detection), DOM traversal via BeautifulSoup integration, Selenium automation, intelligent HTTP requests, and memory-efficient streaming for large remote file downloads.
+- **Cookie Management**: Saving, loading, managing expired cookies, switching between cookie files, and integration with WebAutomation.
+- **Caching**: Disk-based caching with TTL support for HTML and JavaScript content.
+- **Web Monitoring**: Change detection, data caching, and monitoring of web pages.
+
+**Usage Examples**:
+- URL normalization and validation
+- HTTP requests with retry logic
+- Extracting links, images, and text from HTML
+- JavaScript rendering with headless browsers
+- Web automation (form filling, clicking, screenshots)
+- Single and bulk file downloads
+- HTML comparison and change detection
+- Cookie management (save, load, clear expired)
+- Caching web pages for reuse
+- Monitoring web page changes
+
+**Use Cases**: Web scraping, data mining, automated browser interaction, website analysis, media/asset acquisition, user session management, and website change monitoring.
+
+---
+
+### 3. Cryptographic Hashing & Integrity Verification
+
+A robust cryptographic engine providing multi-algorithm support and advanced protection mechanisms.
+
+**Core Capabilities**: Support for the SHA family (SHA-1 through SHAKE-256), intelligent hash detection, Salt management to prevent rainbow table attacks, "Hash-in-Hash" (HH) double-hashing for increased computational difficulty, and integrity verification.
+
+**Usage Examples**:
+- String and file hashing
+- Salt generation
+- Salted hashing and password verification
+- Automatic hash algorithm detection
+
+**Use Cases**: Digital forensics (DFIR), data integrity verification, secure authentication, password protection, and digital evidence validation.
+
+---
+
+### 4. Filesystem Management & Metadata Mapping (Security Kit - File)
+
+An advanced exploration engine for deep filesystem analysis and auditing.
+
+**Core Capabilities**: Recursive directory crawling, hierarchical metadata mapping (size, ownership, timestamps), structured filesystem inventory generation, metadata extraction, and filesystem auditing.
+
+**New Security Features**:
+- **Create Snapshot** (`create_snapshot`): Capture a complete image of file system state for later use.
+- **Verify Snapshot** (`verify_snapshot`): Compare current state with previous snapshot to detect changes, new files, or deletions.
+- **Security Mapping** (`dict_files_in_directory`, `map_directory_metadata`)
+
+**Usage Examples**:
+- Taking a snapshot of a project folder to detect future changes
+- Getting detailed file statistics and information
+- Mapping complete directory metadata (recursively)
+- Generating file dictionaries with hashes
+- Saving dictionaries to JSON files
+- Retrieving file permission strings
+- Bulk file deletion
+
+**Use Cases**: Digital forensics (DFIR), system auditing, integrity-based backup solutions, file analysis, and filesystem inspection.
+
+---
+
+### 5. Language & Geography Data (Data Kit)
+
+A comprehensive dataset for language detection, country information, and Iranian geographic data.
+
+**Core Capabilities**:
+- **Language**: Language detection, filtering by language, digit normalization, RTL character detection, character classification, and ASCII approximation (transliteration).
+- **Countries**: Complete country information (calling codes, ISO codes, capitals, currencies, continents), country search, and phone number formatting.
+- **Iran**: Province and city information (coordinates, population, phone codes, car plate codes), SIM card operator detection, city search, and region-based province lookup.
+
+**Usage Examples**:
+- Detecting the language of a text (Persian, English, Arabic, ...)
+- Filtering Persian characters from a text
+- Normalizing digits (converting Persian digits to ASCII)
+- Getting complete information for a country (calling code, capital, currency)
+- Searching for countries by name
+- Getting the province and full information for an Iranian city
+- Detecting the SIM card operator based on the prefix
+- Getting the phone code and car plate code for a city
+
+**Use Cases**: Internationalization (i18n), localization (l10n), phone number validation, text analysis, Geographic Information Systems (GIS), and location-based applications.
+
+---
+
+### 6. Core Automation Toolkit (Automobile Kit)
+
+A unified automation layer for developers and system administrators that simplifies interaction with the operating system, terminal, Git, Python, package management, PowerShell, filesystem utilities, and process management.
+
+**Core Capabilities**:
+- **CMD**: Execute Command Prompt commands with timeout and multiple command support.
+- **PowerShell**: Execute PowerShell commands with structured execution and output capture.
+- **Hybrid**: Execute commands simultaneously in CMD and PowerShell and compare outputs.
+- **Git**: Full Git automation (clone, init, add, commit, push, pull, branch, status, log).
+- **Python**: Execute scripts, modules, and inline code, create virtual environments, and manage packages with Pip.
+- **Filesystem**: Common file and folder operations (create, copy, move, delete, list).
+- **Process Management**: Check, count, get info, suspend, resume, and kill processes, with special support for browsers.
+- **System Class**: A unified interface to access all automation capabilities.
+
+**Usage Examples**:
+- Developer automation (code management, testing)
+- DevOps workflows (deployment, monitoring)
+- Windows automation (system management)
+- New project initialization (init, venv)
+- Command-line utilities
+- Git automation (commit, push, branch)
+- Python environment management (venv, pip)
+- Process management (monitoring, closing browsers)
+- System auditing and cleanup
+
+**Use Cases**: Developer automation, DevOps workflows, Windows automation, project initialization, command-line utilities, Git automation, Python environment management, process management, and system administration.
+
+---
+
+### 7. General Tools Kit (Tools Kit) ** NEW **
+
+A foundational layer providing common, reusable utilities for other modules and developers.
+
+**Core Capabilities**:
+
+* **File Tools (`file_tools.py`)**:
+    * Basic file and folder operations (create, read, write, delete)
+    * JSON file handling (`dump_file`, `load_file`)
+    * File permission management (`get_permission`, `change_permission`)
+    * Complete file metadata extraction (`information_files_dict`)
+
+* **String Tools (`string_tools.py`)**:
+    * Secure random string generation with `secrets`
+    * Helper functions for random character generation
+    * **Random character generation source for `password_kit` module**
+
+* **Use Cases**: Developer automation, DevOps workflows, Windows automation, project initialization, command-line utilities, Git automation, Python environment management, process management, and system administration.
+
+---
+
+## Technical Requirements
+
+### Environment
+* Python 3.9+
+
+### Dependencies
+```bash
+pip install requests beautifulsoup4 selenium tenacity deepdiff pyautogui pyperclip
+```
+
+### Standard Libraries
+`hashlib`, `os`, `pathlib`, `datetime`, `json`, `shutil`, `string`, `random`, `re`, `typing`, `subprocess`, `time`, `pickle`
+
+---
+
+## Package Structure
+
+```
+src/allykit/
+├── __init__.py
+├── Security_kit/
+│   ├── __init__.py
+│   ├── file_kit.py
+│   ├── password_kit.py
+│   └── hash_kit.py
+├── web_kit/
+│   ├── __init__.py
+│   ├── CChrome.py
+│   ├── Communications.py
+│   ├── WebAutomation.py
+│   ├── Working_with_code.py
+│   ├── Elastic_bands.py
+│   ├── Get_Code.py
+│   └── Cookie.py
+├── data_kit/
+│   ├── __init__.py
+│   ├── IRAN.py
+│   ├── Language.py
+│   └── country.py
+└── Automobile_kit/
+    ├── __init__.py
+    ├── ProcessManager.py
+    ├── Automobile/
+    │   ├── __init__.py
+    │   ├── Cmd.py
+    │   ├── powershell.py
+    │   └── hybrid.py
+    └── New_automobile/
+        ├── __init__.py
+        ├── file.py
+        ├── python.py
+        └── git.py
+```
+## Version Summary
+
+This version represents a significant step forward with the addition of Tools_kit and the modular rewrite of password_kit. The Security_kit modules now benefit from a foundational layer (Tools_kit), greatly improving code reusability and maintainability.
+
+**Key Changes**:
+- Added Tools_kit with file_tools and string_tools
+- Complete modular rewrite of password_kit with Time_Password and Review_Password classes
+- Added snapshot and integrity verification capabilities to file_kit

{allykit-1.1.2 → allykit-1.2.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "allykit"
-version = "1.1.2"
+version = "1.2.2"
 description = "A comprehensive Python toolkit for security engineering, cryptography, web scraping, filesystem auditing, DFIR, command-line automation, Git, PowerShell, and reusable developer utilities."
 readme = "README.md"
 license = "MIT"