Metadata-Version: 2.4
Name: proxidize_pt
Version: 1.0.0
Summary: Proxidize Proxy Tester - A multi-threaded proxy testing tool for HTTP/SOCKS proxies
Home-page: https://github.com/proxidize/proxy-tester
Author: Proxidize
Author-email: Proxidize <support@proxidize.com>
License: MIT
Project-URL: Homepage, https://github.com/proxidize/proxy-tester
Project-URL: Bug Reports, https://github.com/proxidize/proxy-tester/issues
Project-URL: Source, https://github.com/proxidize/proxy-tester
Project-URL: Documentation, https://github.com/proxidize/proxy-tester/wiki
Keywords: proxy,testing,http,socks,socks5,network,tool,multi-threaded
Platform: Windows
Platform: Linux
Platform: macOS
Platform: Unix
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: MIT License
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: httpx[socks]>=0.25.0
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
Requires-Dist: speedtest-cli>=2.1.3
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

# Proxidize: Proxy Tester

A professional, multi-threaded proxy testing tool for HTTP and SOCKS proxies with built-in speed testing and geo-location lookup.

## Features

- 🚀 **Multi-threaded Testing**: Efficient parallel proxy testing with intelligent thread management
- 🌍 **HTTP & SOCKS5 Support**: Test both HTTP and SOCKS5 proxies seamlessly
- 📍 **Geo-location Lookup**: Get detailed location information for working proxies
- ⚡ **Speed Testing**: Built-in download speed testing using speedtest-cli
- 🎨 **Beautiful UI**: Rich terminal interface with colored output and formatted tables
- 📊 **Export Results**: Save results to CSV format for analysis
- 🛡️ **Robust Error Handling**: Graceful handling of failures and interruptions
- 🔧 **Flexible Configuration**: Command-line options and interactive prompts

## Installation

### Quick Install (Recommended)

```bash
pip install proxidize_pt
```

### From Source

```bash
git clone https://github.com/proxidize/proxy-tester.git
cd proxy-tester
pip install -e .
```

### Development Installation

```bash
git clone https://github.com/proxidize/proxy-tester.git
cd proxy-tester
pip install -e ".[dev]"
```

## Usage

### Command Line Interface

Once installed, you can use any of these commands:

```bash
# Main command
proxidize [options] <proxy_file_or_single_proxy>

# Alternative commands
proxy-tester [options] <proxy_file_or_single_proxy>
pxt [options] <proxy_file_or_single_proxy>  # Short alias
```

### Basic Examples

```bash
# Test a single proxy
proxidize "proxy.example.com:8080:username:password" --http

# Test proxies from a file
proxidize data/proxies.txt --http --geo --speed-test

# Test SOCKS5 proxies with verbose output
proxidize data/socks_proxies.txt --sock --geo -v

# Export results to CSV
proxidize data/proxies.txt --http --geo -o results.csv
```

### Command Line Options

```
positional arguments:
  proxy                 Single proxy or path to proxy list file

options:
  -h, --help            show this help message and exit
  --sock                Use SOCKS5 proxy
  --http                Use HTTP proxy
  --geo                 Enable IP geolocation lookup
  --speed-test          Include download speed test
  -o OUTPUT, --output OUTPUT
                        Output file path
  -v, --verbose         Enable verbose debug output
```

### Proxy Format

Proxies should be in the format: `host:port:username:password`

Examples:

```
proxy.example.com:8080:user123:pass123
192.168.1.100:3128:admin:secret
socks.example.com:1080:sockuser:sockpass
```

### Sample Proxy Files

You can find sample proxy files in the `data/` directory:

- `working_http_proxies.txt` - Working HTTP proxies for testing
- `working_socks_proxies.txt` - Working SOCKS5 proxies for testing
- `semi_working_http_proxies.txt` - Mixed HTTP proxies for testing error handling

## Platform Support

Proxidize works on all major platforms:

- ✅ **Windows** (Windows 10, 11)
- ✅ **Linux** (Ubuntu, Debian, CentOS, etc.)
- ✅ **macOS** (10.14+)

## Requirements

- Python 3.7 or higher
- Internet connection for proxy testing
- All dependencies are automatically installed via pip

## Configuration

The tool uses intelligent defaults but can be customized via:

- Command-line arguments
- Interactive prompts
- Configuration files (coming soon)

## Output

Results are displayed in a beautiful table format and can be exported to CSV:

```
                          Proxy Test Results
┏━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━┳━━━━━━━━━━━┳━━━━━━━━━┓
┃ # ┃ Proxy Type ┃ IP Address     ┃ Location                          ┃ Latency ┃ Speed     ┃ Status  ┃
┡━━━╇━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━╇━━━━━━━━━━━╇━━━━━━━━━┩
│ 1 │ HTTP       │ 172.56.168.96  │ Brooklyn, New York, United States │ 966ms   │ 5.03 Mbps │ Working │
│ 2 │ SOCKS5     │ 172.58.255.34  │ College Park, Maryland, US        │ 1240ms  │ 3.2 Mbps  │ Working │
└───┴────────────┴────────────────┴───────────────────────────────────┴─────────┴───────────┴─────────┘
```

## License

This project is licensed under the MIT License - see the LICENSE file for details.

## Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

## Support

If you encounter any issues or have questions:

1. Check the [documentation](https://github.com/proxidize/proxy-tester/wiki)
2. Search [existing issues](https://github.com/proxidize/proxy-tester/issues)
3. Create a [new issue](https://github.com/proxidize/proxy-tester/issues/new)

## Changelog

### v1.0.0

- Initial release
- Multi-threaded proxy testing
- HTTP and SOCKS5 support
- Geo-location lookup
- Speed testing
- Beautiful terminal UI
- CSV export functionality
