Metadata-Version: 2.4
Name: ps-torproxy
Version: 0.1.0
Summary: A simple Python wrapper to install, manage, and route traffic through Tor
Author-email: Praful Sapkota <sapkotapraful@gmail.com>
License: MIT
License-File: LICENSE
Keywords: anonymity,privacy,proxy,socks,tor
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Internet :: Proxy Servers
Requires-Python: >=3.10
Requires-Dist: loguru>=0.7.0
Requires-Dist: requests[socks]>=2.32.5
Description-Content-Type: text/markdown

# ps-torproxy

A simple Python library to install, manage, and route HTTP traffic through the Tor network.

## Installation

```bash
pip install ps_torproxy
```

## Prerequisites

- Linux (Debian-based) with `sudo` access
- `apt` package manager

## Usage

```python
from ps_torproxy import TorProxy

proxy = TorProxy()

# Check if traffic is going through Tor
print(proxy.check_proxy())  # True

# Get current exit IP
print(proxy.get_current_ip())

# Get a new identity (new IP)
proxy.renew_identity()

# Make a safe GET request with retries
response = proxy.safe_get("https://example.com")

# Cleanup when done
proxy.cleanup()
```
