Skip to main content

SocketSwap

SocketSwap is a tool that allows to proxy any third-party libraries traffic through a TCP SOCKS5 Proxy.

Some Python libaries support proxing out of the box like requests. For all other libaries especially ones not natively written in python, you can use SocketSwap to redirect traffic via a proxy.

Usage:

There are two ways to use SwapSock.

- Via a Context Manager that starts the proxy in a daemon process
- Directly as a blocking script

Context Manager

import socket
from SocketSwap import ProxySwapContext


def socket_factory():
    target_host = "localhost"
    target_port = 5432
    remote_socket = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
    remote_socket.connect((target_host, target_port))
    return remote_socket

def main():
    
    with ProxySwapContext(socket_factory, "127.0.0.1", 2222):
        # do something you want to proxy
        # connect to 127.0.0.1:2222

The ProxySwapContext takes essentially 3 mandatory arguments.

Logging and Debugging

from SocketSwap import ProxySwapContext

# debug level logging
import logging
socket_swap_logger = logging.getLogger("SocketSwap")
socket_swap_logger.addHandler(logging.StreamHandler())
socket_swap_logger.setLevel(logging.DEBUG)

By default logging is not enabled. You can do so by assigning a handler to the "SocketSwap" logger and choosing a level.

Credits:

The TCP Proxy part is a slim modified version of https://github.com/ickerwx/tcpproxy.

Metadata

Release files for SocketSwap 0.1.11

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Built distribution (wheel)

Table of built distributions (wheels) for SocketSwap 0.1.11
File Interpreter ABI Platform Actions
SocketSwap-0.1.11-py2.py3-none-any.whl Python 3, Python 2 none any Details for SocketSwap-0.1.11-py2.py3-none-any.whl

Release files / SocketSwap-0.1.11-py2.py3-none-any.whl

Download URL SocketSwap-0.1.11-py2.py3-none-any.whl
Size 9.3 kB
Tags Python 2 Python 3
SHA-256 checksum
How to use checksums
e59e9bed75f8fe6b46528746b79bcd19ed9d0f12afa6558152d357a045e37e68
BLAKE2b-256 checksum
How to use checksums
60573f760b9340b89db7a9af67a4cd63a066d22077dc4ed8ce759471b412d7ea
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.2 CPython/3.10.6

Security for SocketSwap 0.1.11

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page