Metadata-Version: 2.4
Name: allykit
Version: 1.0.4
Summary: A comprehensive Python toolkit for security engineering, cryptography, web scraping, filesystem auditing, DFIR, and reusable utility functions.
Author-email: allykit Developer <hossein.moradian.ir@outlook.com>
License-Expression: MIT
Project-URL: Homepage, https://github.com/hossein-moradian/
Project-URL: Repository, 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,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 :: 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
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, and digital forensics specialists. It integrates advanced cryptographic operations, automated web interaction, intelligent filesystem auditing, 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), and granular security auditing (Complexity Scoring and validation engines).
*   **Use Cases:** Automated credential management, secure token generation, 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, and memory-efficient streaming for large remote file downloads.
*   **Use Cases:** Web scraping, data mining, and automated 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, and "Hash-in-Hash" (HH) double-hashing for increased computational difficulty.
*   **Use Cases:** Digital forensics, data integrity verification, and secure authentication layers.

### 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), and structured filesystem inventory generation.
*   **Use Cases:** Digital forensics (DFIR), system auditing, and integrity-based backup solutions.

### 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), and System Security constants (octal permission masks).
*   **Use Cases:** Providing a single source of truth for validation, translation, and security permission checks.

## Technical Requirements
*   **Environment:** Python 3.x
*   **Dependencies:** pip install selenium beautifulsoup4 requests tenacity deepdiff 
*   **Standard Libraries:** `hashlib`, `os`, `pathlib`, `datetime`, `json`, `shutil`, `string`, `random`, `re`, `typing`
