Metadata-Version: 2.4
Name: allykit
Version: 1.1.1.post1
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

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), secure hashing, integrity verification, and authentication utilities.

* **Usage Examples**:
    * Basic and strong password generation
    * Password generation with prefix/suffix
    * Time-limited password generation
    * 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

* **Use Cases**: Automated credential management, secure token generation, password auditing, integrity verification, and security strength evaluation.

---

### 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

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.

* **Usage Examples**:
    * 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.

---

## 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
```
