Metadata-Version: 2.4
Name: setupit
Version: 1.0.0
Summary: The ultimate Military-Grade autonomous DevOps CI/CD pipeline with Pydantic shield and AES-256 secrets obfuscation.
Author: Ilja Ivanov
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: Microsoft :: Windows
Classifier: Topic :: Software Development :: Build Tools
Classifier: Topic :: Security :: Cryptography
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: pydantic>=2.0.0
Requires-Dist: cryptography>=41.0.0
Requires-Dist: build>=1.0.0
Requires-Dist: twine>=4.0.0
Requires-Dist: wheel>=0.40.0
Requires-Dist: setuptools>=61.0.0
Dynamic: license-file

# SetupIt 🚀

The ultimate **Military-Grade autonomous DevOps CI/CD pipeline** with a **Pydantic shield**, **AES-256 secrets obfuscation**, **Workspace Auto-Purge**, and **Flexible Quad-Engine CLI Automation** . Designed by **Ilja Ivanov (To_ri239)** .

---

## 🧬 How It Works

`SetupIt` completely automates your Python project deployment, package management, and file system initialization with high-level security and explicit environment isolation flags :
1. **Quad Entry Points**: Supports human-centric stealth deployment, headless server JSON automation, a protected pip wrapper with manual flag support, and an OS-level workspace initializer .
2. **On-Demand User-Space Isolation (`-u` Flag)**: Gives you complete manual control over package scopes. Explicitly passing the `-u` flag instructs the engine to dynamically inject `--user` parameters, safely routing installations straight to your home directory, avoiding system permission conflicts without breaking virtualenv constraints .
3. **Workspace Auto-Purge**: Automatically detects and deletes stale `dist/` and `*.egg-info` artifacts from previous builds using cross-platform triggers to guarantee clean and sterile builds .
4. **Zero-Trace Stealth Input**: Intercepts raw bytes straight from `sys.stdin` on the CPU level, preventing OS command-line sniffing and screen echo .
5. **Pydantic Validation**: Instantly verifies the master cryptographic key length (32, 64, or 128 characters) at the runtime entrance .
6. **AES-256 Obfuscation**: Enshrouds your PyPI API token into an encrypted block using the symmetric Fernet cipher, protecting your RAM from dumps .
7. **Memory Purge**: Instantly overwrites environment variables with garbage `NONE` bytes immediately after deployment, leaving RAM perfectly sterile .

---

## 🛠️ Project Structure

Ensure your separate project workspace is mapped out exactly like this :

```text
setupit/
├── pyproject.toml     # Enterprise metadata configuration (v1.0.0 Quad script mapping)
├── README.md          # This documentation file
├── LICENSE            # MIT License tied to Ilja Ivanov (To_ri239)
└── setupit/           # Main source package
    ├── __init__.py    # Sterile initialization module with global API export
    └── __main__.py    # The core Pydantic + AES-256 + Auto-Purge + Explicit Quad-Gateway engine
```

---

## 🚀 Execution Guide

### 1. Global Installation
Install the official stable production release of `setupit` directly from PyPI into your environment :
```powershell
pip install setupit
```

### 2. Mode 1: Interactive Stealth Deploy (Human-Centric)
Trigger your autonomous crypto-rocket with **zero arguments** :
```powershell
setupit
```
The terminal will securely prompt you for your secrets using an **invisible, secure input stream** .

### 3. Mode 2: Headless Automated Deploy (Server/JSON-Centric)
Create a secure profile file named `setup-it-settings.json` inside your system **User Home Directory** (`~`) :

```json
{
    "token": "pypi-<TOKEN>",
    "master_key": "<MASTER-KEY>"
}
```
Then simply execute the automated trigger command from any directory :
```powershell
setupit-json
```

### 4. Mode 3: Advanced Protected Pip Package Manager Wrapper
Run clean, human-readable wrapped shortcut commands over native pip routines with on-demand user-space protection. It smartly filters runtime parameters without syntax corruption :
```powershell
setupit-pip list
setupit-pip install <package_name> [-u]
setupit-pip upgrade <package_name> [-u]
setupit-pip delete <package_name>
setupit-pip info <package_name>
setupit-pip req-install <requirements.txt> [-u]
setupit-pip search <query>
setupit-pip gen-list <output_file.txt>
setupit-pip install-spec <package> <operator> <version> [-u]
```

### 5. Mode 4: Low-Level Workspace File System Initializer
Generate directories or populate files with text payloads directly from the command line without extra templates :
```powershell
setupit-init <directory_name> true
setupit-init <file_name> false <your string payload text content here>
```

---

## 📊 Pipeline Chronograph Logs (v1.0.0, example on Windows)

### Execution log for standard `setupit` trigger (with active Auto-Purge):
```text
🔒 [SetupIt]: Entering Secure Invisible Stdin Context (Twine-Style)...
🔑 Enter PyPI API Token: 
⚙️ Enter Master Key: 
⚙️ [SetupIt]: Pydantic validation PASSED (Key length: 32)
🔑 [SetupIt]: Unique Token ID: <first 15 symbols>...
✅ [SetupIt]: Done

🧹 [SetupIt]: Old builds detected. Purging 'dist' and '.egg-info' directories...
✅ [SetupIt]: Workspace is clean and sterile.

🕐 [SetupIt]: Building project...
✅ [SetupIt]: Done

🕒 [SetupIt]: Decrypting AES-256 secrets via Pydantic verified config...
✅ [SetupIt]: Done

🕙 [SetupIt]: Uploading dist via secure channel...
✅ [SetupIt]: Done

=== [SetupIt MEMORY PURGED] ===
No process can sniff active tokens anymore. RAM state: STEALTH.
🕛🚀 [SetupIt]: Sending the project to PyPI successful! Security level: MILITARY (v1.0.0)
```

### Execution log for low-level `setupit-init` engine:
```text
PS C:\Users\User\Проекты> setupit-init my_new_module true
📁 [SetupIt-Gen]: Directory 'my_new_module' created successfully.

PS C:\Users\User\Проекты> setupit-init info.txt false Hello World! This is a secure payload.
📄 [SetupIt-Gen]: File 'info.txt' generated with secure payload.
```

### Execution log for explicit `setupit-pip` wrapper with user-space flag requested:
```text
PS C:\Users\User\PycharmProjects\SetupItProject> setupit-pip install pydantic -u
Requirement already satisfied: pydantic in c:\users\user\appdata\roaming\python\python312\site-packages (2.13.4)
```

## 📄 License
This project is fully distributed under the **MIT License** .
