SocketSwap 0.1.5

socketswap is a python package that allows to proxy any third-party libraries traffic through a local TCP Proxy

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 conn_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(conn_factory, "127.0.0.1", 2222):
        # do something you want to proxy

The ProxySwapContext takes essentially 3 mandatory arguments.

Credits:

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