Metadata-Version: 2.4
Name: nerixusarmor
Version: 1.0.0
Summary: Enterprise-grade AST-based polymorphic obfuscation and mutation engine for Python
Author-email: NerixusArmor Team <thesaintofbeauty@gmail.com>
License: MIT
Project-URL: Homepage, https://github.com/NerixusOBF/NerixusArmor
Keywords: obfuscation,security,protection,polymorphism,ast,encryption,anti-debug
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Information Technology
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
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: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Security
Classifier: Topic :: Software Development :: Build Tools
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# NerixusArmor

NerixusArmor is an advanced, pure-Python obfuscation and polymorphic mutation engine designed to secure source code against static analysis, decompilation, and automated reconstruction. By operating directly at the Abstract Syntax Tree (AST) level, NerixusArmor structurally mutates the logic of Python programs while guaranteeing complete cross-platform compatibility and zero native dependencies.

> Disclaimer: Obfuscation acts as a strong deterrent by significantly increasing the cost, complexity, and time required for reverse-engineering. It does not provide absolute protection against dedicated runtime memory analysis, dynamic debugging, or execution interception.

---

# Core Protection Mechanics

- Supports multiple variable and function renaming schemes, including Hexadecimal (`_0x4f2a`), Barcode (`l1I1lI0`), Zalgo (`o_OoXxWw`), and Custom user-defined dictionaries (`nerixus_Xy9p`).
- Removes standard arithmetic operators (`+`, `-`, `^`) and replaces them with an injected, pure-bitwise Software Arithmetic Logic Unit (ALU).
- Restructures standard dot-notation attribute access (e.g., `os.path.join`) into nested dynamic `getattr()` lookups, hiding imports and API dependencies from static scanners.
- Splices string literals into arbitrary micro-chunks, encrypts them dynamically, and joins them via flat AST lists to avoid compiler-level recursion limits on large files.
- Compresses (`zlib`), encrypts (`base64`), and packages the entire code payload into an AST-obfuscated bootstrapped loader that executes strictly in-memory (`exec`).
- Transforms linear execution paths into finite state machines inside dispatch loops, scrambling the Control Flow Graph (CFG).
- Wraps basic statements into try-except blocks with mathematically unreachable dead-code targets to break automated decompiler analysis.
- Automatically generates syntactчески valid but execution-unreachable helper classes, variables, and mathematical loops to bloat and confuse static decoders.

---

# Installation

Install the library directly via `pip`:

```bash
pip install NerixusArmor
