Add pytest test suite and GitHub Actions CI

[ricardojrdez]

Summary

Adds an automated test suite and continuous integration, so regressions in the recent refactor and bug fixes are caught automatically.

Tests (tests/, 54 cases)

• test_arch.py — architecture singleton, mode-aware normalize_reg (x86 vs x64), REG_BY_WIDTH, abstract-register validation.
• test_utils.py — pretty_addr/pack_addr widths and the unsupported-mode guard (pretty_addr/pack_addr raise NameError on an unknown capstone mode #15).
• test_gadget.py — text representation, equality/hash, side-effect calculation (32- vs 64-bit names), subsumption, heuristic cost, and ANSI gating on non-TTY output (ANSI color codes are emitted even when output is not a TTY #14).
• test_gadfinder.py — canary byte avoidance on dedup (Avoid terminator canary bytes in ROP gadget's addresses (by default) when duplicated gadgets are removed #5), --keep-canary-address behaviour, address scoring, and deterministic sorting.
• test_parser.py — ROPLang op loading, composite ops, per-arch REG_BP alias resolution.
• test_operation.py — operation matching/filtering and immediate parsing.
• test_elf.py — ELF arch detection, executable-section extraction, and --base relocation (--base is silently ignored for ELF and Mach-O binaries #13).

Binary-loader tests build minimal ELFs in memory (see conftest.py), so no binary blobs are committed. An autouse fixture resets the global architecture singleton between tests.

CI (.github/workflows/ci.yml)

Runs pytest on Python 3.11, 3.12 and 3.13 for every push to master and every pull request.

Notes

• Locally: 54/54 pass on Python 3.11 and 3.13.
• PE and Mach-O loaders are not yet covered (would require committed fixtures); the ELF path exercises the shared loader logic and the --base fix.

🤖 Generated with Claude Code