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

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