Metadata-Version: 2.1
Name: forwarderd
Version: 1
Summary: SSH Forward Daemon
Author-email: Elchin Sarkarov <elchin751@gmail.com>
Classifier: Development Status :: 4 - Beta
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: POSIX
Classifier: Operating System :: Microsoft :: Windows
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Provides-Extra: daemon

SSH port forwarder daemon

### Daemon
Install `forwarderd[daemon]` and run `forwarderd.__main__` any suitable way

Example for Linux, will create systemd service "forwarderd":
```bash
mkdir forwarderd
cd forwarderd
python3 -m venv .
source bin/activate
python3 install forwarderd[daemon]
python3 -m forwarderd --systemd-install
systemctl start forwarderd
```

### Usage
Install `forwarderd`, then request spawn tunnel such way
```python
from forwarderd import spawn_tunnel, SpawnTunnelRequest

spawn_resp = await spawn_tunnel(
    SpawnTunnelRequest(
        ssh_addr='localhost:6969',
        ssh_user='user',
        ssh_identity_file='/root/.ssh/forward_key',  # must be accessible for daemon
        remote_addr='localhost:6969',
    )
)
```
