Metadata-Version: 2.4
Name: pnutmap
Version: 0.5.0
Summary: A simple python wrapper for nmap
Author-email: Peanut <pnutvacation@gmail.com>
Project-URL: Homepage, https://github.com/realpnut/pnutmap
Project-URL: Bug Tracker, https://github.com/realpnut/pnutmap/issues
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# pnutmap

![Python](https://img.shields.io/badge/python-3.x-3776AB?style=flat-square)
![Nmap](https://img.shields.io/badge/powered%20by-nmap-4CAF50?style=flat-square)
![Status](https://img.shields.io/badge/status-active-success?style=flat-square)
![License](https://img.shields.io/badge/license-MIT-lightgrey?style=flat-square)

## about

pnutmap is a simple interactive Python wrapper for `nmap` designed for fast network scanning from the terminal.

it provides an easier way to run common reconnaissance commands without manually typing full nmap flags every time.

built for Linux environments, learning, lab use, and authorized security testing.

---

## features

- quick scan (-F)
- full scan (-p-)
- service detection (-sV)
- os detection (-O)
- aggressive scan (-A)
- stealth scan (-sS)
- ping discovery (-sn)
- vulnerability scan (--script vuln)

---

## requirements

- Linux (Debian, Ubuntu, Arch, Kali, etc.)
- Python 3.x
- nmap installed

---

## installation (linux)

### Debian / Ubuntu / Kali
```bash
sudo apt update
sudo apt install nmap -y
git clone https://github.com/realpnut/pnutmap.git
cd pnutmap
python3 main.py
```

## disclaimer

this tool is intended for educational purposes and authorized security testing only.

do not use it against systems you do not own or have explicit permission to test.

---

## license

MIT License
