Metadata-Version: 2.4
Name: allykit
Version: 1.1.0
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/issues
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, and robust password management into a unified framework.

## Modules Overview

### 1. Password Generation & 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.

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

---

### 2. Web Kit & Scrapers

A specialized module for seamless web interaction and data extraction.

* **Core Capabilities:** 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.

* **Use Cases:** Web scraping, data mining, automated browser interaction, website analysis, and media/asset acquisition.

---

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

* **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.

* **Use Cases:** Digital forensics (DFIR), system auditing, integrity-based backup solutions, file analysis, and filesystem inspection.

---

### 5. Global Constants & Data Definitions

A centralized repository for standardized datasets used across all modules.

* **Core Capabilities:** Internationalization (country codes), Localization (Persian alphabet and Iranian geography), Character Set classifications (ctype-style), System Security constants (octal permission masks), and reusable datasets.

* **Use Cases:** Providing a single source of truth for validation, translation, localization, security permission checks, and reusable constants.

---

### 6. Core Automation Toolkit

A unified automation layer for developers and system administrators that simplifies interaction with the operating system, terminal, Git, Python, package management, PowerShell, and filesystem utilities.

#### CMD

Execute and automate Command Prompt operations.

* Execute terminal commands
* Execute multiple commands
* Open Command Prompt
* Clipboard output support
* Command timeout management
* Command automation

#### Git

Simple Git automation utilities.

* Clone repositories
* Initialize repositories
* Add files
* Commit changes
* Amend commits
* Push and Pull
* Branch management
* Repository inspection
* Restore files
* Reset commits

#### Python & Pip

Python development and package management utilities.

* Execute Python scripts
* Execute Python modules
* Run inline Python code
* Create virtual environments
* Install packages
* Upgrade packages
* Uninstall packages
* Generate `requirements.txt`
* Package inspection
* Cache management

#### Filesystem Utilities

Common filesystem operations.

* Create folders
* Delete files
* Copy files
* Move files
* Rename files
* List directory contents
* File size inspection

#### PowerShell

Native PowerShell integration.

* Execute PowerShell commands
* Structured execution
* Capture command output
* Timeout support
* Directory size calculation

#### Hybrid

Combined CMD and PowerShell execution.

* Execute commands in CMD and PowerShell simultaneously
* Compare outputs
* Cryptographic output verification
* Dictionary and list output formats

#### Use Cases

* Developer automation
* DevOps workflows
* Windows automation
* Project initialization
* Command-line utilities
* Git automation
* Python environment management
* 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`

---
## Package Structure
@ = Variable
* = Function


```
src/allykit/
├──  __init__.py
│   
├── core/
│   ├── Cmd.py :
│       └── class cmd
│   ├── python.py:
│       └──  class Pip 
│       └──  class Python(pip)
│   ├── powershell.py:
│       └──  class Powershell
│   ├── hybrid.py
│       └── class Hybrid(powershell)
│   ├── __init__.py
│       └── class System
│ 
├── Security_kit/
│   ├── __init__.py
│   ├── file_kit.py :  @ + *
│   ├── password_kit.py : *
│   ├── hash_kit.py : *
│
│    web_kit/
│   ├── CChrome.py : *
│    ├── Communications.py : *
│    ├── WebAutomation.py
│    │   └── class WebAutomation
│    ├── Working_with_code.py
│       └── class SoupToDict 
│          *
│    ├── Elastic_bands.py
│    │   ├── class Monitoring
│    │   └── class DiskCache
│    └── Get_Code.py : *
│    ├── __init__ 
│
├── data/
│   ├── IRAN.py : @ + *
│   ├── Language.py :  @ + *
│   ├── country.py:  @ + *
``` 
