Noctyra

Noctyra è un framework basato su AST progettato per la trasformazione e la deoffuscazione del codice. Fornisce una pipeline modulare per analizzare e semplificare il codice sorgente Python risolvendo espressioni e logiche complesse.

Panoramica

Il progetto mira a fornire un ambiente flessibile per l'elaborazione dell'Abstract Syntax Tree di Python. Impiegando una sequenza di trasformatori pluggabili, Noctyra può:

• Semplificare logiche e condizioni annidate.
• Risolvere valori statici e pattern di codifica comuni.
• Srotolare blocchi di esecuzione dinamica in codice leggibile.
• Ottimizzare e pulire costrutti offuscati.

Per Iniziare

Prerequisiti

Assicurati di avere uv installato per la gestione delle dipendenze.

uv sync

Esecuzione della Pipeline

Per elaborare uno script di destinazione, usa il seguente comando:

python main.py <file_input> [opzioni]

Opzioni:

• file: Percorso del file Python di input (obbligatorio).
• --output: Nome del file per il codice trasformato (default: out.py).
• --iterations: Imposta un numero fisso di passaggi di trasformazione (default: 0 per rilevamento automatico).
• --max-iterations: Limita i passaggi in modalità automatica (default: 100).
• --debug: Abilita il logging verboso per il debug delle trasformazioni. (look sick)

Sviluppo

Questo progetto utilizza uv per la gestione delle dipendenze e un Makefile per le attività comuni.

Configurazione

uv sync --all-extras --dev

Controllo Qualità

Prima di inviare una PR o di eseguire il push delle modifiche, assicurati che tutti i controlli siano superati:

• Esegui i test: make test
• Lint e Formattazione: make format
• Controllo Tipi: make typecheck

(Utenti Windows: questi comandi funzionano automaticamente tramite make.bat.)

CI/CD

I controlli automatici vengono eseguiti ad ogni push tramite GitHub Actions, inclusi linting con Ruff, type checking con Mypy e test unitari con Pytest.

Avviso di Sicurezza

Noctyra include un motore di valutazione interno con limiti di risorse di base. Tuttavia, quando si ha a che fare con codice non fidato, è altamente consigliato eseguire la pipeline all'interno di un ambiente isolato (come un contenitore o una sandbox) per prevenire potenziali effetti collaterali o esaurimento delle risorse.

---