veltix 1.0.0__tar.gz

veltix-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 NytroxDev
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

veltix-1.0.0/PKG-INFO

@@ -0,0 +1,215 @@
+Metadata-Version: 2.4
+Name: veltix
+Version: 1.0.0
+Summary: The networking library you always wanted
+Author-email: Nytrox <nytrox.dev@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/NytroxDev/Veltix
+Project-URL: Repository, https://github.com/NytroxDev/Veltix
+Project-URL: Issues, https://github.com/NytroxDev/Veltix/issues
+Keywords: networking,tcp,protocol,binary,socket,server,client
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: System :: Networking
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0; extra == "dev"
+Dynamic: license-file
+
+# Veltix
+
+> The networking library you always wanted
+
+[![PyPI](https://img.shields.io/pypi/v/veltix)](https://pypi.org/project/veltix/)
+[![Python](https://img.shields.io/pypi/pyversions/veltix)](https://pypi.org/project/veltix/)
+[![License](https://img.shields.io/github/license/NytroxDev/Veltix)](https://github.com/NytroxDev/Veltix/blob/main/LICENSE)
+
+## ✨ Features
+
+- 🚀 **Dead simple API** - Get started in minutes, not hours
+- 🔒 **Message integrity** - Built-in SHA256 hash verification
+- 📦 **Custom binary protocol** - Lightweight and efficient
+- 🪶 **Zero dependencies** - Pure Python stdlib only
+- 🔌 **Extensible** - Custom message types with plugin support
+- ⚡ **Multi-threaded** - Handle multiple clients automatically
+
+## 📖 Why Veltix?
+
+Existing Python networking libraries are either too low-level (raw sockets) or too complex (Twisted, asyncio). Veltix
+fills the gap with a simple, modern API that handles the boring parts for you.
+
+Built by a passionate developer who wanted networking to be easy, Veltix focuses on developer experience without
+sacrificing power or performance.
+
+## 🚀 Installation
+
+```bash
+pip install veltix
+```
+
+**Requirements:** Python 3.10+
+
+**That's it!** Zero dependencies, ready to use.
+
+## ⚡ Quick Start
+
+### Simple Chat Server
+
+**Server (server.py):**
+
+```python
+from veltix import Server, ServerConfig, MessageType, Request, Binding
+
+# Define message type
+CHAT = MessageType(code=200, name="chat")
+
+# Configure server
+config = ServerConfig(host="0.0.0.0", port=8080)
+server = Server(config)
+sender = server.get_sender()
+
+
+def on_message(client, response):
+    print(f"[{client.addr[0]}] {response.content.decode()}")
+    # Broadcast to all
+    reply = Request(CHAT, f"Echo: {response.content.decode()}".encode())
+    sender.broadcast(reply, server.get_all_clients_sockets())
+
+
+server.bind(Binding.ON_RECV, on_message)
+server.start()
+
+input("Press Enter to stop...")
+server.close_all()
+```
+
+**Client (client.py):**
+
+```python
+from veltix import Client, ClientConfig, MessageType, Request, Binding
+
+CHAT = MessageType(code=200, name="chat")
+
+config = ClientConfig(server_addr="127.0.0.1", port=8080)
+client = Client(config)
+sender = client.get_sender()
+
+
+def on_message(response):
+    print(f"Server: {response.content.decode()}")
+
+
+client.bind(Binding.ON_RECV, on_message)
+client.connect()
+
+# Send message
+msg = Request(CHAT, b"Hello Server!")
+sender.send(msg)
+
+input("Press Enter to disconnect...")
+client.disconnect()
+```
+
+**Run:**
+
+```bash
+python server.py
+python client.py  # In another terminal
+```
+
+## 📦 Examples
+
+More examples in [`examples/`](examples/):
+
+- **Echo Server** - Simple echo implementation
+- **File Transfer** - Send files over network
+- **Custom Types** - Define your message types
+- **Advanced Sender** - Complex messaging patterns
+
+## 📊 Comparison
+
+| Feature           | Veltix | socket | asyncio | Twisted |
+|-------------------|--------|--------|---------|---------|
+| Easy API          | ✅      | ❌      | ⚠️      | ❌       |
+| Zero deps         | ✅      | ✅      | ✅       | ❌       |
+| Custom protocol   | ✅      | ❌      | ❌       | ⚠️      |
+| Message integrity | ✅      | ❌      | ❌       | ❌       |
+| Multi-threading   | ✅      | ❌      | ❌       | ✅       |
+
+## 🗺️ Roadmap
+
+### v1.0.0 - Foundation (March 2026)
+
+- Core TCP server/client
+- Binary protocol with SHA256 integrity
+- Custom message types
+- Zero dependencies
+- **Status: IN PROGRESS**
+
+### v2.0.0 - Security (Summer 2026)
+
+- End-to-end encryption (ChaCha20 + X25519 + Ed25519)
+- Automatic key exchange
+- Perfect forward secrecy
+- **Status: PLANNED**
+
+### v3.0.0 - Performance (Fall 2026)
+
+- Rust core via PyO3
+- 10-100x speed improvements
+- Advanced optimizations
+- **Status: RESEARCH**
+
+### v4.0.0+ (2027+)
+
+- UDP support
+- Plugin ecosystem
+- Compression
+- WebSocket bridge
+
+## 🤝 Contributing
+
+We welcome contributions! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
+
+### Quick ways to help:
+
+- ⭐ Star the project
+- 🐛 Report bugs
+- 📚 Improve documentation
+- 💻 Submit pull requests
+- 💬 Join discussions
+
+## 🙏 Contributors
+
+### Core Team
+
+- **Nytrox** - Creator & Lead Developer
+
+### Community Heroes
+
+Thank you to everyone who has contributed through code, documentation, bug reports, and support!
+
+Want to be listed here? Check out our [Contributing guide](CONTRIBUTING.md)!
+
+## 📄 License
+
+MIT License - see [LICENSE](LICENSE) file for details.
+
+## 🔗 Links
+
+- **Documentation:** Coming soon
+- **GitHub:** [NytroxDev/Veltix](https://github.com/NytroxDev/Veltix)
+- **PyPI:** [pypi.org/project/veltix](https://pypi.org/project/veltix)
+- **Issues:** [Report a bug](https://github.com/NytroxDev/Veltix/issues)
+
+---
+
+**Built with ❤️ by Nytrox**

veltix-1.0.0/README.md

@@ -0,0 +1,189 @@
+# Veltix
+
+> The networking library you always wanted
+
+[![PyPI](https://img.shields.io/pypi/v/veltix)](https://pypi.org/project/veltix/)
+[![Python](https://img.shields.io/pypi/pyversions/veltix)](https://pypi.org/project/veltix/)
+[![License](https://img.shields.io/github/license/NytroxDev/Veltix)](https://github.com/NytroxDev/Veltix/blob/main/LICENSE)
+
+## ✨ Features
+
+- 🚀 **Dead simple API** - Get started in minutes, not hours
+- 🔒 **Message integrity** - Built-in SHA256 hash verification
+- 📦 **Custom binary protocol** - Lightweight and efficient
+- 🪶 **Zero dependencies** - Pure Python stdlib only
+- 🔌 **Extensible** - Custom message types with plugin support
+- ⚡ **Multi-threaded** - Handle multiple clients automatically
+
+## 📖 Why Veltix?
+
+Existing Python networking libraries are either too low-level (raw sockets) or too complex (Twisted, asyncio). Veltix
+fills the gap with a simple, modern API that handles the boring parts for you.
+
+Built by a passionate developer who wanted networking to be easy, Veltix focuses on developer experience without
+sacrificing power or performance.
+
+## 🚀 Installation
+
+```bash
+pip install veltix
+```
+
+**Requirements:** Python 3.10+
+
+**That's it!** Zero dependencies, ready to use.
+
+## ⚡ Quick Start
+
+### Simple Chat Server
+
+**Server (server.py):**
+
+```python
+from veltix import Server, ServerConfig, MessageType, Request, Binding
+
+# Define message type
+CHAT = MessageType(code=200, name="chat")
+
+# Configure server
+config = ServerConfig(host="0.0.0.0", port=8080)
+server = Server(config)
+sender = server.get_sender()
+
+
+def on_message(client, response):
+    print(f"[{client.addr[0]}] {response.content.decode()}")
+    # Broadcast to all
+    reply = Request(CHAT, f"Echo: {response.content.decode()}".encode())
+    sender.broadcast(reply, server.get_all_clients_sockets())
+
+
+server.bind(Binding.ON_RECV, on_message)
+server.start()
+
+input("Press Enter to stop...")
+server.close_all()
+```
+
+**Client (client.py):**
+
+```python
+from veltix import Client, ClientConfig, MessageType, Request, Binding
+
+CHAT = MessageType(code=200, name="chat")
+
+config = ClientConfig(server_addr="127.0.0.1", port=8080)
+client = Client(config)
+sender = client.get_sender()
+
+
+def on_message(response):
+    print(f"Server: {response.content.decode()}")
+
+
+client.bind(Binding.ON_RECV, on_message)
+client.connect()
+
+# Send message
+msg = Request(CHAT, b"Hello Server!")
+sender.send(msg)
+
+input("Press Enter to disconnect...")
+client.disconnect()
+```
+
+**Run:**
+
+```bash
+python server.py
+python client.py  # In another terminal
+```
+
+## 📦 Examples
+
+More examples in [`examples/`](examples/):
+
+- **Echo Server** - Simple echo implementation
+- **File Transfer** - Send files over network
+- **Custom Types** - Define your message types
+- **Advanced Sender** - Complex messaging patterns
+
+## 📊 Comparison
+
+| Feature           | Veltix | socket | asyncio | Twisted |
+|-------------------|--------|--------|---------|---------|
+| Easy API          | ✅      | ❌      | ⚠️      | ❌       |
+| Zero deps         | ✅      | ✅      | ✅       | ❌       |
+| Custom protocol   | ✅      | ❌      | ❌       | ⚠️      |
+| Message integrity | ✅      | ❌      | ❌       | ❌       |
+| Multi-threading   | ✅      | ❌      | ❌       | ✅       |
+
+## 🗺️ Roadmap
+
+### v1.0.0 - Foundation (March 2026)
+
+- Core TCP server/client
+- Binary protocol with SHA256 integrity
+- Custom message types
+- Zero dependencies
+- **Status: IN PROGRESS**
+
+### v2.0.0 - Security (Summer 2026)
+
+- End-to-end encryption (ChaCha20 + X25519 + Ed25519)
+- Automatic key exchange
+- Perfect forward secrecy
+- **Status: PLANNED**
+
+### v3.0.0 - Performance (Fall 2026)
+
+- Rust core via PyO3
+- 10-100x speed improvements
+- Advanced optimizations
+- **Status: RESEARCH**
+
+### v4.0.0+ (2027+)
+
+- UDP support
+- Plugin ecosystem
+- Compression
+- WebSocket bridge
+
+## 🤝 Contributing
+
+We welcome contributions! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
+
+### Quick ways to help:
+
+- ⭐ Star the project
+- 🐛 Report bugs
+- 📚 Improve documentation
+- 💻 Submit pull requests
+- 💬 Join discussions
+
+## 🙏 Contributors
+
+### Core Team
+
+- **Nytrox** - Creator & Lead Developer
+
+### Community Heroes
+
+Thank you to everyone who has contributed through code, documentation, bug reports, and support!
+
+Want to be listed here? Check out our [Contributing guide](CONTRIBUTING.md)!
+
+## 📄 License
+
+MIT License - see [LICENSE](LICENSE) file for details.
+
+## 🔗 Links
+
+- **Documentation:** Coming soon
+- **GitHub:** [NytroxDev/Veltix](https://github.com/NytroxDev/Veltix)
+- **PyPI:** [pypi.org/project/veltix](https://pypi.org/project/veltix)
+- **Issues:** [Report a bug](https://github.com/NytroxDev/Veltix/issues)
+
+---
+
+**Built with ❤️ by Nytrox**

veltix-1.0.0/Veltix/__init__.py

@@ -0,0 +1,10 @@
+from .server.server import Server, ServerConfig, ClientInfo
+from .client.client import Client, ClientConfig
+
+from .utils.binding import Binding
+
+from .network.types import MessageType
+from .network.request import Request, Response
+from .network.sender import Sender, Mode
+
+from .exceptions import *

veltix-1.0.0/Veltix/exceptions.py

@@ -0,0 +1,28 @@
+class VeltixError(Exception):
+    """
+    Base exception class for all Veltix framework errors.
+    """
+    def __init__(self, *args: object) -> None:
+        super().__init__(*args)
+
+
+class MessageTypeError(VeltixError):
+    """
+    Exception raised for invalid message type operations.
+    """
+    def __init__(self, *args: object) -> None:
+        super().__init__(*args)
+
+class SenderError(VeltixError):
+    """
+    Exception raised for sender-related errors.
+    """
+    def __init__(self, *args: object) -> None:
+        super().__init__(*args)
+
+class RequestError(VeltixError):
+    """
+    Exception raised for request parsing or compilation errors.
+    """
+    def __init__(self, *args: object) -> None:
+        super().__init__(*args)

veltix-1.0.0/pyproject.toml

@@ -0,0 +1,55 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "veltix"
+version = "1.0.0"
+description = "The networking library you always wanted"
+authors = [
+    { name = "Nytrox", email = "nytrox.dev@gmail.com" }
+]
+readme = "README.md"
+license = { text = "MIT" }
+requires-python = ">=3.10"
+
+keywords = [
+    "networking",
+    "tcp",
+    "protocol",
+    "binary",
+    "socket",
+    "server",
+    "client",
+]
+
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Topic :: System :: Networking",
+]
+
+dependencies = []
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.0",
+    "pytest-cov>=4.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/NytroxDev/Veltix"
+Repository = "https://github.com/NytroxDev/Veltix"
+Issues = "https://github.com/NytroxDev/Veltix/issues"
+
+[tool.setuptools]
+packages = ["Veltix"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+python_files = ["test_*.py"]

veltix-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

veltix-1.0.0/tests/test_basic.py

@@ -0,0 +1,185 @@
+"""
+Basic tests for Veltix core functionality.
+
+Run with: python -m pytest tests/test_basic.py
+Or simply: python tests/test_basic.py
+"""
+
+import threading
+import time
+
+from Veltix import (
+    Binding,
+    Client,
+    ClientConfig,
+    MessageType,
+    Request,
+    RequestError,
+    Response,
+    Server,
+    ServerConfig,
+)
+
+# Test message types
+TEST_MSG = MessageType(code=200, name="test")
+
+
+def test_message_type_creation():
+    """Test creating a MessageType."""
+    msg_type = MessageType(code=100, name="test", description="Test message")
+
+    assert msg_type.code == 100
+    assert msg_type.name == "test"
+    assert msg_type.description == "Test message"
+    print("✓ MessageType creation works")
+
+
+def test_request_compile_and_parse():
+    """Test Request compilation and Response parsing."""
+    # Create request
+    original_content = b"Hello Veltix!"
+    request = Request(TEST_MSG, original_content)
+
+    # Compile to bytes
+    compiled = request.compile()
+    assert isinstance(compiled, bytes)
+    assert len(compiled) > 46  # Header is 46 bytes
+    print("✓ Request compilation works")
+
+    # Parse back to Response
+    response = Request.parse(compiled)
+    assert isinstance(response, Response)
+    assert response.content == original_content
+    assert response.type.code == TEST_MSG.code
+    print("✓ Request parsing works")
+
+    # Verify hash integrity
+    import hashlib
+
+    expected_hash = hashlib.sha256(original_content).digest()
+    assert response.hash == expected_hash
+    print("✓ Hash integrity verification works")
+
+
+def test_server_client_communication():
+    """Test basic server-client communication."""
+    print("\nTesting server-client communication...")
+
+    # Shared state
+    received_messages = []
+    server_ready = threading.Event()
+
+    # Setup server
+    server_config = ServerConfig(host="127.0.0.1", port=8765)
+    server = Server(server_config)
+    sender_server = server.get_sender()
+
+    def on_server_recv(client, response):
+        content = response.content.decode("utf-8")
+        received_messages.append(f"server:{content}")
+
+        # Echo back
+        reply = Request(TEST_MSG, b"Echo: " + response.content)
+        sender_server.send(reply, client=client.conn)
+
+    server.bind(Binding.ON_RECV, on_server_recv)
+
+    # Start server in thread
+    def run_server():
+        server.start(_on_th=True)
+        server_ready.set()
+
+    server_thread = threading.Thread(target=run_server, daemon=True)
+    server_thread.start()
+    server_ready.wait(timeout=2)
+    time.sleep(0.5)  # Give server time to start
+
+    print("  Server started")
+
+    # Setup client
+    client_config = ClientConfig(server_addr="127.0.0.1", port=8765)
+    client = Client(client_config)
+    sender_client = client.get_sender()
+
+    def on_client_recv(response):
+        content = response.content.decode("utf-8")
+        received_messages.append(f"client:{content}")
+
+    client.bind(Binding.ON_RECV, on_client_recv)
+
+    # Connect and send
+    assert client.connect(), "Client failed to connect"
+    print("  Client connected")
+    time.sleep(0.2)
+
+    # Send test message
+    test_message = b"Test message"
+    request = Request(TEST_MSG, test_message)
+    assert sender_client.send(request), "Failed to send message"
+    print("  Message sent")
+
+    # Wait for response
+    time.sleep(0.5)
+
+    # Verify
+    assert len(received_messages) >= 1, (
+        f"No messages received. Got: {received_messages}"
+    )
+    assert "server:Test message" in received_messages, "Server didn't receive message"
+    assert any("client:Echo" in msg for msg in received_messages), (
+        "Client didn't receive echo"
+    )
+
+    print("  Messages exchanged successfully")
+
+    # Cleanup
+    client.disconnect()
+    server.close_all()
+    time.sleep(0.2)
+
+    print("✓ Server-client communication works")
+
+
+def test_message_integrity_check():
+    """Test that corrupted messages are rejected."""
+    # Create valid request
+    request = Request(TEST_MSG, b"Valid content")
+    compiled = request.compile()
+
+    # Corrupt the data (change a byte in the content)
+    corrupted = bytearray(compiled)
+    corrupted[-1] ^= 0xFF  # Flip last byte
+
+    # Should raise ValueError due to hash mismatch
+    try:
+        Request.parse(bytes(corrupted))
+        assert False, "Should have raised ValueError for corrupted data"
+    except RequestError as e:
+        assert "Invalid hash" in str(e) or "Corrupted" in str(e)
+        print("✓ Message integrity check works (corrupted data rejected)")
+
+
+# Run tests
+if __name__ == "__main__":
+    print("Running Veltix Basic Tests")
+    print("=" * 50)
+
+    try:
+        test_message_type_creation()
+        test_request_compile_and_parse()
+        test_message_integrity_check()
+        test_server_client_communication()
+
+        print("\n" + "=" * 50)
+        print("ALL TESTS PASSED! ✓")
+        print("Veltix is ready to deploy! 🚀")
+
+    except AssertionError as e:
+        print(f"\n✗ TEST FAILED: {e}")
+        exit(1)
+    except Exception as e:
+        print(f"\n✗ UNEXPECTED ERROR: {e}")
+        import traceback
+
+        traceback.print_exc()
+        exit(1)

veltix-1.0.0/veltix.egg-info/PKG-INFO

@@ -0,0 +1,215 @@
+Metadata-Version: 2.4
+Name: veltix
+Version: 1.0.0
+Summary: The networking library you always wanted
+Author-email: Nytrox <nytrox.dev@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/NytroxDev/Veltix
+Project-URL: Repository, https://github.com/NytroxDev/Veltix
+Project-URL: Issues, https://github.com/NytroxDev/Veltix/issues
+Keywords: networking,tcp,protocol,binary,socket,server,client
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: System :: Networking
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0; extra == "dev"
+Dynamic: license-file
+
+# Veltix
+
+> The networking library you always wanted
+
+[![PyPI](https://img.shields.io/pypi/v/veltix)](https://pypi.org/project/veltix/)
+[![Python](https://img.shields.io/pypi/pyversions/veltix)](https://pypi.org/project/veltix/)
+[![License](https://img.shields.io/github/license/NytroxDev/Veltix)](https://github.com/NytroxDev/Veltix/blob/main/LICENSE)
+
+## ✨ Features
+
+- 🚀 **Dead simple API** - Get started in minutes, not hours
+- 🔒 **Message integrity** - Built-in SHA256 hash verification
+- 📦 **Custom binary protocol** - Lightweight and efficient
+- 🪶 **Zero dependencies** - Pure Python stdlib only
+- 🔌 **Extensible** - Custom message types with plugin support
+- ⚡ **Multi-threaded** - Handle multiple clients automatically
+
+## 📖 Why Veltix?
+
+Existing Python networking libraries are either too low-level (raw sockets) or too complex (Twisted, asyncio). Veltix
+fills the gap with a simple, modern API that handles the boring parts for you.
+
+Built by a passionate developer who wanted networking to be easy, Veltix focuses on developer experience without
+sacrificing power or performance.
+
+## 🚀 Installation
+
+```bash
+pip install veltix
+```
+
+**Requirements:** Python 3.10+
+
+**That's it!** Zero dependencies, ready to use.
+
+## ⚡ Quick Start
+
+### Simple Chat Server
+
+**Server (server.py):**
+
+```python
+from veltix import Server, ServerConfig, MessageType, Request, Binding
+
+# Define message type
+CHAT = MessageType(code=200, name="chat")
+
+# Configure server
+config = ServerConfig(host="0.0.0.0", port=8080)
+server = Server(config)
+sender = server.get_sender()
+
+
+def on_message(client, response):
+    print(f"[{client.addr[0]}] {response.content.decode()}")
+    # Broadcast to all
+    reply = Request(CHAT, f"Echo: {response.content.decode()}".encode())
+    sender.broadcast(reply, server.get_all_clients_sockets())
+
+
+server.bind(Binding.ON_RECV, on_message)
+server.start()
+
+input("Press Enter to stop...")
+server.close_all()
+```
+
+**Client (client.py):**
+
+```python
+from veltix import Client, ClientConfig, MessageType, Request, Binding
+
+CHAT = MessageType(code=200, name="chat")
+
+config = ClientConfig(server_addr="127.0.0.1", port=8080)
+client = Client(config)
+sender = client.get_sender()
+
+
+def on_message(response):
+    print(f"Server: {response.content.decode()}")
+
+
+client.bind(Binding.ON_RECV, on_message)
+client.connect()
+
+# Send message
+msg = Request(CHAT, b"Hello Server!")
+sender.send(msg)
+
+input("Press Enter to disconnect...")
+client.disconnect()
+```
+
+**Run:**
+
+```bash
+python server.py
+python client.py  # In another terminal
+```
+
+## 📦 Examples
+
+More examples in [`examples/`](examples/):
+
+- **Echo Server** - Simple echo implementation
+- **File Transfer** - Send files over network
+- **Custom Types** - Define your message types
+- **Advanced Sender** - Complex messaging patterns
+
+## 📊 Comparison
+
+| Feature           | Veltix | socket | asyncio | Twisted |
+|-------------------|--------|--------|---------|---------|
+| Easy API          | ✅      | ❌      | ⚠️      | ❌       |
+| Zero deps         | ✅      | ✅      | ✅       | ❌       |
+| Custom protocol   | ✅      | ❌      | ❌       | ⚠️      |
+| Message integrity | ✅      | ❌      | ❌       | ❌       |
+| Multi-threading   | ✅      | ❌      | ❌       | ✅       |
+
+## 🗺️ Roadmap
+
+### v1.0.0 - Foundation (March 2026)
+
+- Core TCP server/client
+- Binary protocol with SHA256 integrity
+- Custom message types
+- Zero dependencies
+- **Status: IN PROGRESS**
+
+### v2.0.0 - Security (Summer 2026)
+
+- End-to-end encryption (ChaCha20 + X25519 + Ed25519)
+- Automatic key exchange
+- Perfect forward secrecy
+- **Status: PLANNED**
+
+### v3.0.0 - Performance (Fall 2026)
+
+- Rust core via PyO3
+- 10-100x speed improvements
+- Advanced optimizations
+- **Status: RESEARCH**
+
+### v4.0.0+ (2027+)
+
+- UDP support
+- Plugin ecosystem
+- Compression
+- WebSocket bridge
+
+## 🤝 Contributing
+
+We welcome contributions! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
+
+### Quick ways to help:
+
+- ⭐ Star the project
+- 🐛 Report bugs
+- 📚 Improve documentation
+- 💻 Submit pull requests
+- 💬 Join discussions
+
+## 🙏 Contributors
+
+### Core Team
+
+- **Nytrox** - Creator & Lead Developer
+
+### Community Heroes
+
+Thank you to everyone who has contributed through code, documentation, bug reports, and support!
+
+Want to be listed here? Check out our [Contributing guide](CONTRIBUTING.md)!
+
+## 📄 License
+
+MIT License - see [LICENSE](LICENSE) file for details.
+
+## 🔗 Links
+
+- **Documentation:** Coming soon
+- **GitHub:** [NytroxDev/Veltix](https://github.com/NytroxDev/Veltix)
+- **PyPI:** [pypi.org/project/veltix](https://pypi.org/project/veltix)
+- **Issues:** [Report a bug](https://github.com/NytroxDev/Veltix/issues)
+
+---
+
+**Built with ❤️ by Nytrox**

veltix-1.0.0/veltix.egg-info/SOURCES.txt

@@ -0,0 +1,11 @@
+LICENSE
+README.md
+pyproject.toml
+Veltix/__init__.py
+Veltix/exceptions.py
+tests/test_basic.py
+veltix.egg-info/PKG-INFO
+veltix.egg-info/SOURCES.txt
+veltix.egg-info/dependency_links.txt
+veltix.egg-info/requires.txt
+veltix.egg-info/top_level.txt

veltix-1.0.0/veltix.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

veltix-1.0.0/veltix.egg-info/requires.txt

@@ -0,0 +1,4 @@
+
+[dev]
+pytest>=7.0
+pytest-cov>=4.0

veltix-1.0.0/veltix.egg-info/top_level.txt

@@ -0,0 +1 @@
+Veltix