How git-yousfi-neji/netarmageddon works
Project type and purpose
• NetArmageddon is a command-line network stress-testing framework (not a client-server web app). It’s written in Python (3.10+) with a small C backend (libpcap-based traffic capture).
• Purpose: simulate device connections and attacks (DHCP exhaustion, ARP keep-alive, deauth, traffic logging) against routers or Wi-Fi APs.
File structure
Top-level directories and files:
• netarmageddon/ – main Python package
– __main__.py & cli.py: CLI entrypoint & argument parsing
– core/: individual attack modules (arp_keepalive.py, dhcp_exhaustion.py, deauth.py, traffic.py)
– core/traffic_c/: high-performance C code (traffic.c/h) built via Makefile
– utils/: shared helpers (config_loader, network_tools, metrics, output_manager)
• config/ – formatting and linting configs
• docs/ – markdown guides (development, testing, usage, architecture.md stub)
• tests/ – pytest test suite covering Python core and utils
• setup.py, requirements.txt, dev-requirements.txt, Makefile – build/install scripts
README for additional insights
• CLI interface with subcommands: dhcp, arp, traffic, deauth
• Extensible architecture: easy to add new modules under core/
• C-backend for packet capture, BPF filter support, thread-safe generation
• Full type safety (mypy), 90%+ test coverage, pre-commit code quality
Elements
• From User Terminal → CLI Dispatcher
• CLI → Config Loader → Attack Module
• Attack Module → Utils → libpcap (C backend) → Network Interface → Target
• Blue rectangles for Python components