Metadata-Version: 2.4
Name: fwz_pt
Version: 1.2.0
Summary: A multi-threaded proxy testing tool for HTTP/SOCKS5 proxies
Home-page: https://github.com/fawaz7/Proxy-tester
Author: Fawaz Al-Ghzawi
Author-email: Fawaz Al-Ghzawi <Ghazawe1@gmail.com>
License-Expression: MIT
Project-URL: Homepage, https://github.com/fawaz7/Proxy-tester
Project-URL: Bug Reports, https://github.com/fawaz7/Proxy-tester/issues
Project-URL: Source, https://github.com/fawaz7/Proxy-tester
Project-URL: Documentation, https://github.com/fawaz7/Proxy-tester/wiki
Keywords: proxy,testing,http,socks,socks5,network,tool,multi-threaded,cloudflare,speed-test,validation,rich-ui
Platform: Windows
Platform: Linux
Platform: macOS
Platform: Unix
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: System Administrators
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Internet :: Proxy Servers
Classifier: Topic :: System :: Networking
Classifier: Topic :: Software Development :: Testing
Classifier: Topic :: Utilities
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: rich>=13.0.0
Requires-Dist: requests>=2.28.0
Requires-Dist: pysocks>=1.7.1
Requires-Dist: pyfiglet>=0.8.0
Requires-Dist: colorama>=0.4.6
Provides-Extra: dev
Requires-Dist: pytest>=7.0.0; extra == "dev"
Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
Requires-Dist: black>=22.0.0; extra == "dev"
Requires-Dist: flake8>=5.0.0; extra == "dev"
Requires-Dist: mypy>=1.0.0; extra == "dev"
Provides-Extra: build
Requires-Dist: build>=0.8.0; extra == "build"
Requires-Dist: twine>=4.0.0; extra == "build"
Requires-Dist: wheel>=0.37.0; extra == "build"
Dynamic: author
Dynamic: home-page
Dynamic: license-file
Dynamic: platform
Dynamic: requires-python

# Fwz_PT - Proxy Tester

Fast, multi-threaded proxy testing from the command line.

## Features

- Multi-threaded HTTP and SOCKS5 proxy testing
- IP-whitelisted proxy support (no credentials required)
- Geo-location lookup
- Sequential speed testing (Cloudflare CDN + Fast.com fallback)
- Export results to TXT or CSV

## Installation

Recommended:

```bash
pipx install fwz-pt
```

Alternative (virtual environment):

```bash
python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate
pip install fwz-pt
```

From source:

```bash
git clone https://github.com/fawaz7/Proxy-tester.git
cd Proxy-tester
pip install -r requirements.txt
python src/main.py --help
```

## Usage

Basic syntax:

```bash
fwz_pt --http proxies.txt
fwz_pt --socks --geo --speed-test proxies.txt -o results.csv
```

IP-whitelisted proxies (no username/password):

```bash
fwz_pt --http --ip-whitelist proxies.txt
fwz_pt --socks --ip-whitelist 1.2.3.4:8080
```

Options:

| Flag | Description |
|------|-------------|
| `--http` | Use HTTP proxies |
| `--socks` | Use SOCKS5 proxies |
| `--ip-whitelist` | Accept `host:port` format (no credentials) |
| `--geo` | Enable geo-location lookup |
| `--speed-test` | Run download speed test |
| `-o <file>` | Save results (`.txt` or `.csv`) |
| `-v` / `--verbose` | Show debug output |

## Proxy formats

Standard (with credentials):

```
host:port:username:password
username:password@host:port
```

IP-whitelisted (with `--ip-whitelist`):

```
host:port
```

## Contributing

Feel free to open issues or pull requests on [GitHub](https://github.com/fawaz7/Proxy-tester).
