Metadata-Version: 2.4
Name: websocket-rs
Version: 0.5.0
Classifier: Programming Language :: Rust
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Programming Language :: Python :: Implementation :: PyPy
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: License :: OSI Approved :: MIT License
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Libraries
Classifier: Topic :: Communications
Requires-Dist: maturin>=1.0 ; extra == 'dev'
Requires-Dist: pytest>=7.0 ; extra == 'dev'
Requires-Dist: websockets>=12.0 ; extra == 'dev'
Requires-Dist: ruff>=0.1.0 ; extra == 'dev'
Requires-Dist: pytest>=7.0 ; extra == 'test'
Requires-Dist: websockets>=12.0 ; extra == 'test'
Requires-Dist: uvloop>=0.22.1 ; extra == 'benchmark'
Requires-Dist: websockets>=12.0 ; extra == 'benchmark'
Requires-Dist: websocket-client>=1.9.0 ; extra == 'benchmark'
Requires-Dist: picows>=0.3.0 ; extra == 'benchmark'
Provides-Extra: dev
Provides-Extra: test
Provides-Extra: benchmark
License-File: LICENSE
Summary: High-performance WebSocket client library for Python using Rust
Keywords: websocket,rust,async,high-performance,client
Home-Page: https://github.com/coseto6125/websocket-rs
Author-email: coseto6125 <enorenor@gmail.com>
License: MIT
Requires-Python: >=3.12
Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
Project-URL: Homepage, https://github.com/coseto6125/websocket-rs
Project-URL: Documentation, https://github.com/coseto6125/websocket-rs/blob/main/API.md
Project-URL: API Reference, https://github.com/coseto6125/websocket-rs/blob/main/API.md
Project-URL: Source Code, https://github.com/coseto6125/websocket-rs
Project-URL: Bug Tracker, https://github.com/coseto6125/websocket-rs/issues
Project-URL: Changelog, https://github.com/coseto6125/websocket-rs/releases

# WebSocket-RS 🚀

High-performance WebSocket client implementation in Rust with Python bindings. Provides both sync and async APIs with significant performance improvements over pure Python implementations.

## 🎯 Performance Highlights

- **Sync Client**: 1.85x faster than websocket-client, 6.2x faster than websockets
- **Async Client (Pipelined)**: 12x faster than picows, 21x faster than websockets
- Pure Rust implementation with zero-copy optimizations
- Thread-safe with concurrent operations support

## 📦 Installation

```bash
pip install websocket-rs
```

## 🚀 Quick Start

### Synchronous Client

```python
from websocket_rs.sync.client import connect

# Simple usage
with connect("ws://localhost:8765") as ws:
    ws.send("Hello, WebSocket!")
    response = ws.recv()
    print(response)
```

### Asynchronous Client

```python
import asyncio
from websocket_rs.async_client import connect

async def main():
    async with connect("ws://localhost:8765") as ws:
        await ws.send("Hello, Async!")
        response = await ws.recv()
        print(response)

asyncio.run(main())
```

## 📚 Full Documentation

Visit our GitHub repository for comprehensive documentation:

- **📖 Full README**: https://github.com/coseto6125/websocket-rs#readme
- **📊 Performance Benchmarks**: https://github.com/coseto6125/websocket-rs/blob/main/docs/BENCHMARKS.md
- **🔧 API Reference**: https://github.com/coseto6125/websocket-rs/blob/main/docs/API.md
- **🤝 Contributing Guide**: https://github.com/coseto6125/websocket-rs/blob/main/docs/CONTRIBUTING.md

## 🌟 Key Features

- **🚄 High Performance**: Rust-powered implementation
- **🔄 Dual APIs**: Both sync and async support
- **✅ Drop-in Replacement**: Compatible with Python websockets library
- **🔒 Thread-Safe**: Safe concurrent operations
- **⚡ Zero-Copy**: Optimized memory usage
- **🐍 Python 3.12+**: Modern Python support

## 📝 Requirements

- Python 3.12 or higher
- Supported platforms: Linux, Windows, macOS (x86_64, ARM64)

## 🔗 Links

- **Repository**: https://github.com/coseto6125/websocket-rs
- **Issues**: https://github.com/coseto6125/websocket-rs/issues
- **Changelog**: https://github.com/coseto6125/websocket-rs/releases

## 📄 License

MIT License - see [LICENSE](https://github.com/coseto6125/websocket-rs/blob/main/LICENSE) for details.

---

**Made with ❤️ using Rust and PyO3**

