hackversity 0.0.2

A tiered, defensive recon & scanning toolkit for cybersecurity students.

hackversity

A tiered, defensive & read-only recon / scanning toolkit for cybersecurity students, distributed as a single PyPI package named hackversity.

Only test systems you own or have explicit written permission to test.

Every tool is read-only. There is no exploit, payload, packet-spoofing, or injection code anywhere in this package — in any tier. Every scan/probe command requires an explicit target (there are no default targets and no bundled lists of real-world hosts) and prints the authorisation notice above before running.

Install

pip install hackversity

This installs two equivalent console commands: hackversity and the short alias hv.

Command tree

Commands are grouped by verb and tagged by difficulty tier.

Command	Description	Tier
hv scan port <target>	Threaded TCP connect scan	beginner
hv scan banner <target>	Grab service banners	beginner
hv scan async <target>	asyncio connect scan (faster)	intermediate
hv find subdomain <domain>	DNS brute force + crt.sh	beginner
hv find emails <domain>	Public-email OSINT (site + WHOIS + crt.sh)	intermediate
hv find urls <domain>	Historical URLs from the Wayback Machine	intermediate
hv find dirs <url>	Endpoint discovery (your wordlist)	intermediate
hv find paths <url>	robots.txt + sitemap.xml advertised paths	intermediate
hv lookup whois <domain>	WHOIS lookup	beginner
hv lookup dns <domain>	DNS records + SPF/DMARC/DKIM/CAA	beginner
hv lookup ip <ip>	Reverse DNS + RDAP + ASN (keyless)	beginner
hv lookup shodan <ip>	Read an IP's Shodan record (API key)	intermediate
hv analyze headers <url>	HTTP security-header scoring	intermediate
hv analyze tech <url>	Web technology fingerprinting	intermediate
hv analyze waf <url>	Passive WAF / CDN detection	intermediate
hv analyze cors <url>	CORS misconfiguration checks	intermediate
hv analyze cookies <url>	Cookie security (Secure/HttpOnly/SameSite)	intermediate
hv analyze tls <host>	TLS cert / cipher inspection (--grade for scoring)	intermediate
hv analyze cve <svc> <ver>	NVD CVE lookup (informational)	intermediate
hv analyze pcap <file>	Summarise a .pcap file	advanced
hv map topology <target>	Traceroute + port aggregation	advanced
hv report generate <dir>	Merge JSON results into a report	advanced

Run hv --help or hv <verb> --help for full help with examples on every command.

Use as a Python library

Every tool is importable as a plain function:

from hackversity.tools.beginner import scan_ports, find_subdomains, whois_lookup

results = scan_ports("127.0.0.1", ports=[22, 80, 443])
open_ports = [r.port for r in results if r.is_open]

Development

pip install -e ".[test]"
pytest

License

MIT