Metadata-Version: 2.4
Name: vzrecon
Version: 3.0.0
Summary: Protocol-level validator for HTTP/SOCKS4/SOCKS5 proxies
Author: VZLOI GROUP
License-Expression: MIT
Project-URL: Homepage, https://github.com/vzloi/vzrecon
Project-URL: Source, https://github.com/vzloi/vzrecon
Project-URL: Issues, https://github.com/vzloi/vzrecon/issues
Project-URL: Changelog, https://github.com/vzloi/vzrecon/blob/main/CHANGELOG.md
Keywords: proxy,socks,socks5,socks4,validator,recon,async
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: System Administrators
Classifier: Operating System :: POSIX
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Internet
Classifier: Topic :: System :: Networking
Classifier: Topic :: Utilities
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Provides-Extra: dev
Requires-Dist: pytest>=8.0; extra == "dev"
Requires-Dist: pytest-asyncio>=0.23; extra == "dev"
Dynamic: license-file

# vzrecon

Protocol-level validator for HTTP, SOCKS4 and SOCKS5 proxies.
Zero dependencies. Termux-native.

Signed: VZLOI GROUP // ops

## Install

    pip install -e .
    vzrecon --self-test

## Use

    vzrecon                          # scan cwd for *_proxies.txt
    vzrecon -d ./lists -o ./out      # explicit paths
    vzrecon --preset stealth         # 200 workers
    vzrecon --preset turbo           # 2400 workers
    vzrecon --only http,socks5
    vzrecon --plain

## Protocols

- HTTP    RFC 7231 CONNECT + forward GET fallback
- SOCKS5  RFC 1928, no-auth greeting
- SOCKS4  original spec, IPv4 targets only

## Output

- `<proto>_alive.txt` — endpoints, one per line
- `<proto>_alive.json` — signed_by, protocol, count, proxies[]
- `<proto>_alive.csv` — endpoint, latency_ms

## Exit codes

- 0 scan completed
- 1 self-test failed
- 2 config error
- 3 no source files found

## License

MIT. Copyright (c) 2026 VZLOI GROUP.
