A curated collection of Python security tools developed for learning, experimentation, automation, and portfolio building.
This repository contains practical Python-based security utilities ranging from networking and system analysis to log processing and automation. Each project is organized in its own directory and includes documentation, usage examples, and educational resources.
- Build practical security-related Python tools
- Learn networking and system programming concepts
- Maintain clean and well-documented code
- Create reusable utilities for real-world tasks
- Provide bilingual educational documentation (English and Persian)
python-security-tools/
├── 01-port_scanner/
│ ├── source code
│ ├── README.md
│ ├── requirements.txt
│ ├── docs/
│ │ ├── en/
│ │ └── fa/
│ └── CHANGELOG.md
│
├── 02-dns_lookup/
│ ├── src/
│ ├── tests/
│ ├── README.md
│ ├── CHANGELOG.md
│ └── docs/
│ ├── en/
│ └── fa/
│
└── ...
| Tool | Description | Status |
|---|---|---|
| Port Scanner | Multithreaded TCP port scanner with service detection, banner grabbing, logging, JSON/CSV export, and automated tests | ✅ Stable |
| DNS Lookup Tool | DNS record lookup for A, AAAA, MX, NS, TXT, and CNAME records, with validation, structured results, logging, JSON/CSV export, and automated tests | ✅ Stable |
Each tool contains:
- Project-specific README
- Installation instructions
- Usage examples
- English documentation
- Persian documentation
- Changelog and future improvements
Furthermore, all the tools include a learning path—available in both Persian and English—that covers topics such as Python, networking, cybersecurity principles, and step-by-step source code analysis.
Projects in this repository may use:
- Python 3
- Socket programming
- Threading and concurrency
- File processing
- Network analysis
- APIs
- Automation techniques
- Security-oriented utilities
- Automated testing with pytest
The documentation included with each project explains:
- Design decisions
- Implementation details
- Code walkthroughs
- Future improvement ideas
- Common pitfalls and best practices
- ✅ Port Scanner
- ✅ DNS Lookup Tool
- Subdomain Finder
- Log Analyzer
- Packet Analyzer
- Network Monitor
- Service Detector
- URL Health Checker
- System Information Collector
- Additional security-focused utilities
This project is licensed under the MIT License.
Developed as an educational and portfolio-building project focused on Python, networking, automation, and security.