yashserver 0.1.0__py3-none-any.whl

yashserver/__init__.py

@@ -0,0 +1,4 @@
+"""Compatibility import path for the yashserver distribution."""
+
+from yserver import *  # noqa: F401,F403
+

yashserver-0.1.0.dist-info/METADATA

@@ -0,0 +1,227 @@
+Metadata-Version: 2.4
+Name: yashserver
+Version: 0.1.0
+Summary: Async-first server toolkit with plugins, native WebSocket support, auth/rate limiting, and TLS.
+Author: yashserver contributors
+Keywords: asyncio,server,plugin,websocket,tls,auth,rate-limit,database
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Framework :: AsyncIO
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE.md
+Provides-Extra: db
+Requires-Dist: sqlalchemy>=2.0; extra == "db"
+Requires-Dist: pymongo>=4.0; extra == "db"
+Requires-Dist: redis>=5.0; extra == "db"
+Requires-Dist: cassandra-driver>=3.29; extra == "db"
+Requires-Dist: boto3>=1.34; extra == "db"
+Requires-Dist: firebase-admin>=6.0; extra == "db"
+Requires-Dist: couchbase>=4.2; extra == "db"
+Requires-Dist: elasticsearch>=8.0; extra == "db"
+Requires-Dist: neo4j>=5.0; extra == "db"
+Requires-Dist: influxdb-client>=1.40; extra == "db"
+Requires-Dist: duckdb>=1.0; extra == "db"
+Dynamic: license-file
+
+# yashserver
+
+`yashserver` is an independent Python server library focused on simple APIs:
+- `YServer` for line-based TCP command servers
+- `YWebSocketServer` for WebSocket routes
+- `YHttpServer` for lightweight HTML/API serving
+- `YSyncServer`, `YSyncWebSocketServer`, `YSyncHttpServer` for non-async usage
+- Built-in TLS (`ssl_context`) support
+- Optional token auth and sliding-window rate limiting
+- Plugin hooks for lifecycle, traffic, and error handling
+
+Core networking is standard library based. Database connectors are optional and loaded only when used.
+
+## Install
+
+```bash
+pip install -e .
+```
+
+From PyPI:
+
+```bash
+pip install yashserver
+```
+
+For database drivers (optional):
+
+```bash
+pip install -e ".[db]"
+```
+
+## Task 1 Demo (Browser + HTML)
+
+Run:
+
+```bash
+python examples/task1_browser_server.py
+```
+
+Then open:
+
+`http://127.0.0.1:8080`
+
+You will see a small HTML page served by `YHttpServer`.
+Live chat is enabled by `YWebSocketServer` with no external dependencies.
+The page code is in `test.html`, served on `/` and `/test.html`.
+
+Demo highlights:
+- Chunked **binary** file upload (no base64 transfer path), including videos
+- ACK/retry chunk handling in the browser client
+- Server-side file storage + `/download/<id>` links
+- Optional auth token via env var `YSERVER_TOKEN`
+- Optional MongoDB text-message persistence
+
+Mongo text persistence env vars for `examples/task1_browser_server.py`:
+- `YSERVER_MONGO_TEXT_ENABLED` (`1` or `0`)
+- `YSERVER_MONGO_URI` (example: `mongodb://localhost:27018`)
+- `YSERVER_MONGO_DB` (default: `yserver_chat`)
+- `YSERVER_MONGO_COLLECTION` (default: `messages`)
+- `YSERVER_MONGO_GRIDFS_BUCKET` (default: `fs`, creates `<bucket>.files` + `<bucket>.chunks`)
+- `YSERVER_MONGO_GRIDFS_CHUNK_SIZE` (default: `524288` bytes)
+- `YSERVER_MONGO_WRITE_CONCERN` (default: `1` for fast local visibility in Compass)
+- `YSERVER_MONGO_JOURNAL` (`1` or `0`, default: `0`)
+- or set `YSERVER_MONGO_HOST` + `YSERVER_MONGO_PORT` instead of a full URI
+
+## Minimal Sync Example
+
+```python
+import yserver
+
+app = yserver.YSyncServer(port=9000)
+
+@app.route("ping")
+def ping(client, payload, server):
+    return {"reply": "pong"}
+
+app.run()
+```
+
+You can use a single import and access all public helpers from `yserver.*`, for example:
+`yserver.ConnectionStatsPlugin`, `yserver.LoggingPlugin`, `yserver.ServerTools`,
+`yserver.YSyncHttpServer`, `yserver.YSyncWebSocketServer`, and `yserver.run_many`.
+
+## Database Support
+
+Single import API:
+
+```python
+import yserver
+
+db = yserver.connect_database("sqlite", database=":memory:")
+db.execute("CREATE TABLE users (id INTEGER, name TEXT)")
+db.execute("INSERT INTO users (id, name) VALUES (?, ?)", (1, "Ada"))
+print(db.fetch_all("SELECT * FROM users"))
+db.close()
+```
+
+Also available through tools:
+
+```python
+db = yserver.ServerTools.connect_database("sqlite", database="app.db")
+print(yserver.ServerTools.supported_databases())
+```
+
+Supported backends:
+- MySQL
+- PostgreSQL
+- Microsoft SQL Server
+- Oracle Database
+- SQLite
+- MariaDB
+- MongoDB
+- Redis
+- Cassandra
+- DynamoDB
+- Firebase Realtime Database
+- Couchbase
+- Snowflake
+- Google BigQuery
+- Amazon Redshift
+- ClickHouse
+- Elasticsearch
+- Neo4j
+- InfluxDB
+- DuckDB
+
+Quick DB demo script:
+
+```bash
+python examples/task2_database_support.py
+```
+
+MongoDB Compass quick test (default local port `27018`):
+
+```bash
+python examples/task3_mongodb_compass_test.py
+```
+
+Compass connection string:
+
+`mongodb://localhost:27018`
+
+Notes:
+- SQL backends use SQLAlchemy (`url=` or DSN-style config).
+- SQLite is supported via stdlib `sqlite3`.
+- Non-SQL backends use their ecosystem drivers (optional install).
+
+## TLS / HTTPS
+
+```python
+import yserver
+
+ssl_ctx = yserver.ServerTools.create_server_ssl_context(
+    certfile="cert.pem",
+    keyfile="key.pem",
+)
+
+http = yserver.YSyncHttpServer(port=8443, ssl_context=ssl_ctx)
+ws = yserver.YSyncWebSocketServer(port=9443, ssl_context=ssl_ctx)
+```
+
+For the demo script (`examples/task1_browser_server.py`), you can enable TLS by env vars:
+
+```bash
+set YSERVER_TLS_CERT=cert.pem
+set YSERVER_TLS_KEY=key.pem
+python examples/task1_browser_server.py
+```
+
+If `tls/cert.pem` and `tls/key.pem` exist in the project root, the demo auto-enables HTTPS/WSS.
+
+## Auth + Rate Limit
+
+```python
+import yserver
+
+ws = yserver.YSyncWebSocketServer(
+    auth_token="my-secret-token",
+    rate_limit_per_window=300,
+    rate_limit_window_seconds=60.0,
+)
+
+http = yserver.YSyncHttpServer(
+    auth_token="my-secret-token",
+    rate_limit_per_window=800,
+    rate_limit_window_seconds=60.0,
+)
+```
+
+Token can be provided as:
+- Query param: `?token=...`
+- Header: `x-yserver-token: ...`
+- Header: `Authorization: Bearer ...`
+
+## Test Suite
+
+```bash
+python -m unittest discover -s tests -p "test_*.py" -v
+```

yashserver-0.1.0.dist-info/RECORD

@@ -0,0 +1,13 @@
+yashserver/__init__.py,sha256=1Bj8cgmTAubrUFS-NGNSKnULgr7ngJmkff7hrS8qcyg,108
+yashserver-0.1.0.dist-info/licenses/LICENSE.md,sha256=fKra_bdTQIr0joKOW0g4MTdCuItypRKOQZEFO0KB-rs,1080
+yserver/__init__.py,sha256=s8gOQrJRiUeou0MxhFG1VHv9Pf7ISG2BU3lkUNVbVbw,1194
+yserver/database.py,sha256=nyMQUjtFYyBrx2TJczSNMes-NercnRVgCU6E_BbIf6o,32194
+yserver/plugin.py,sha256=v-Zv5xpuXw7z-BhhRgOrsLhUhCpDeRvPmTNhAJoomgA,4517
+yserver/plugins.py,sha256=I8GbFo4R3HFCirqK308w0MVGCwf1aFYcWMOMYZWW-UU,1449
+yserver/server.py,sha256=pY_aMn1uC4Ncc15DrLvqWCmnJsBfZRcBVre3kxF9H4E,45403
+yserver/sync.py,sha256=YJaJofieWqGh4Kx5jLk2tWBkqEc9bTlBw4gZkRrumjQ,9511
+yserver/tools.py,sha256=1G9vS-A0diAupj0uWXaiOoYZDcK2tz5y3hR4enKrYtc,3911
+yashserver-0.1.0.dist-info/METADATA,sha256=Iq0Q1BtyPgYyVMa1DeY9bvkjFQfdot-eAP15Bdvh-MU,6102
+yashserver-0.1.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+yashserver-0.1.0.dist-info/top_level.txt,sha256=SRM7mlm-usE-5y9jW_TZfwSyuW8u8hIWWR-IfDYCkPM,19
+yashserver-0.1.0.dist-info/RECORD,,

yashserver-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

yashserver-0.1.0.dist-info/licenses/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 yashserver contributors
+
+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.

yashserver-0.1.0.dist-info/top_level.txt

@@ -0,0 +1,2 @@
+yashserver
+yserver

yserver/__init__.py

@@ -0,0 +1,45 @@
+"""yserver: make asyncio server development simple."""
+
+from .database import (
+    DatabaseClient,
+    DatabaseConfigError,
+    DatabaseError,
+    MissingDependencyError,
+    UnsupportedDatabaseError,
+    build_sqlalchemy_url,
+    connect_database,
+    database_support_matrix,
+    list_supported_databases,
+)
+from .plugin import LoggingPlugin, ServerPlugin
+from .plugins import ConnectionStatsPlugin
+from .server import HttpRequest, TcpClient, WebSocketClient, WsMessage, YHttpServer, YServer, YWebSocketServer
+from .sync import YSyncHttpServer, YSyncServer, YSyncWebSocketServer, run_many
+from .tools import ServerTools
+
+__all__ = [
+    "build_sqlalchemy_url",
+    "connect_database",
+    "database_support_matrix",
+    "list_supported_databases",
+    "ConnectionStatsPlugin",
+    "DatabaseClient",
+    "DatabaseConfigError",
+    "DatabaseError",
+    "LoggingPlugin",
+    "MissingDependencyError",
+    "ServerPlugin",
+    "ServerTools",
+    "HttpRequest",
+    "UnsupportedDatabaseError",
+    "WsMessage",
+    "TcpClient",
+    "WebSocketClient",
+    "YHttpServer",
+    "YServer",
+    "YSyncHttpServer",
+    "YSyncServer",
+    "YSyncWebSocketServer",
+    "YWebSocketServer",
+    "run_many",
+]