Metadata-Version: 2.4
Name: socatlib
Version: 2.0.4
Summary: Advanced asynchronous Python library for network communication using socat
Home-page: https://github.com/ash404/SocatLib
Author: ash404.dev
Author-email: "ash404.dev" <momoh70070@gmail.com>
License: MIT
Project-URL: Homepage, https://github.com/ash404/SocatLib
Project-URL: Repository, https://github.com/ash404/SocatLib
Project-URL: Issues, https://github.com/ash404/SocatLib/issues
Keywords: socat,async,networking,socket,network-communication
Classifier: Development Status :: 4 - Beta
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
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: License :: OSI Approved :: MIT License
Classifier: Operating System :: POSIX :: Linux
Classifier: Operating System :: MacOS
Classifier: Operating System :: Microsoft :: Windows
Classifier: Topic :: Internet
Classifier: Topic :: System :: Networking
Requires-Python: >=3.6
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: author
Dynamic: home-page
Dynamic: license-file
Dynamic: requires-python

# SocatLib v2.0.4

Advanced asynchronous Python library for network communication using socat.

## Installation
```bash
pip install socatlib
```

## Quick Start
```python
import asyncio
from socatlib import sending, listening

async def main():
    server = await listening(4444)
    await asyncio.sleep(1)
    
    result = await sending("Hello Server", "127.0.0.1", 4444)
    print(result)
    
    server.terminate()

asyncio.run(main())
```

## Features

- Async/await support
- Error handling with detailed messages
- 5 second timeout on all operations
- File transfer support
- Reverse shell capability
- OpenSSL encryption support
- Easy integration into existing projects

## API Reference

### sending(msg, ip, port, timeout=5)
Send a message to a server and get response.

**Parameters:**
- `msg` (str): Message to send
- `ip` (str): Target IP address
- `port` (int): Target port
- `timeout` (int): Operation timeout in seconds (default: 5)

**Returns:**
- `dict`: `{"success": bool, "data": str, "error": str}`

[... باقي الـ API Documentation ...]

## Requirements

- Python 3.6+
- socat installed and in PATH

## Author

ash404.dev

## License

MIT License
