bwsgi 0.1.0__tar.gz

bwsgi-0.1.0/LICENSE

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

bwsgi-0.1.0/MANIFEST.in

@@ -0,0 +1,4 @@
+include README.md
+include LICENSE
+include pyproject.toml
+recursive-include vinod *.py py.typed

bwsgi-0.1.0/PKG-INFO

@@ -0,0 +1,162 @@
+Metadata-Version: 2.4
+Name: bwsgi
+Version: 0.1.0
+Summary: Ultra-lightweight, zero-dependency Python WSGI framework
+Author-email: Baraa Ahmed <baraa.runtime@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/BaraaByte/bwsgi
+Project-URL: Repository, https://github.com/BaraaByte/bwsgi
+Project-URL: Issues, https://github.com/BaraaByte/bwsgi/issues
+Keywords: wsgi,framework,zero-dependency,serv00,freebsd,flask-like
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: POSIX :: BSD :: FreeBSD
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Internet :: WWW/HTTP :: WSGI :: Application
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# Vinod
+
+Ultra-lightweight, **zero-dependency** Python WSGI framework.
+Flask-style routing. Django-style auth. Built on the Python Standard Library.
+
+## Why Vinod?
+
+- **Zero dependencies** — pure Python stdlib
+- **~5-8 MB idle RAM** — runs happily on 512MB hosts like Serv00
+- **Flask-style routing** — decorator-based, familiar syntax
+- **Secure auth built in** — PBKDF2 password hashing + DB-backed sessions
+- **WSGI native** — works with Passenger, Gunicorn, uWSGI
+
+## Install
+
+```bash
+pip install vinod
+```
+
+## Quick Start
+
+```python
+from vinod import Vinod, Response, login_required
+
+app = Vinod(db_path="app.db")
+
+@app.route("/")
+def home(req):
+    return Response.html("<h1>Hello from Vinod</h1>")
+
+@app.route("/dashboard")
+@login_required
+def dashboard(req):
+    return Response.html(f"<h1>Hi {req.user['username']}</h1>")
+
+if __name__ == "__main__":
+    app.run()
+```
+
+## Routing and responses
+
+Routes accept named path parameters and one or more HTTP methods:
+
+```python
+@app.route("/users/<username>", methods=("GET",))
+def user(req, username):
+    return Response.json({"username": username})
+
+profile_url = app.url_for("user", username="Jane Doe")
+```
+
+Path values generated by `url_for` are URL-encoded. Requests to a known path
+with an unsupported method receive `405 Method Not Allowed` and an `Allow`
+header. Static files are served from `static/` at `/static/`; files are
+streamed in chunks and paths are checked against the configured static root.
+
+`Request` provides `query`, `headers`, `cookies`, `body`, `form()`, and `json()`.
+Malformed JSON request bodies receive `400 Bad Request`.
+`Response` provides `text()`, `html()`, `json()`, `redirect()`, and `file()`.
+
+## JSON request validation
+
+Use `Request.validate_json()` to require a JSON object with specific required
+fields and Python types. Malformed JSON and invalid values return a JSON
+`400 Bad Request` response:
+
+```python
+@app.route("/api/items", methods=("POST",))
+def create_item(req):
+    item = req.validate_json({"name": str, "quantity": int})
+    return Response.json(item, "201 Created")
+```
+
+## Sessions and CSRF
+
+`req.session` is a server-side dictionary persisted in SQLite and identified by
+a signed, HTTP-only cookie. Set a stable secret key when creating the app so
+session cookies survive process restarts:
+
+```python
+app = Vinod(db_path="app.db", secret_key="load-this-from-your-environment")
+```
+
+Protect state-changing routes with `@csrf_protect`. Render `req.csrf_token()`
+into a hidden form field named `_csrf_token`, or send it in the
+`X-Csrf-Token` header for JSON requests:
+
+```python
+@app.route("/submit", methods=("POST",))
+@csrf_protect
+def submit(req):
+    req.session["submitted"] = True
+    return Response.json({"ok": True})
+```
+
+Safe methods (`GET`, `HEAD`, `OPTIONS`, and `TRACE`) do not require a token.
+Keep state-changing actions on non-safe methods and use CSRF protection for
+browser-session routes.
+
+## Templates, middleware, and errors
+
+Templates are UTF-8 files under `templates/` by default. `{{ name }}` values
+are HTML-escaped automatically; this intentionally supports variable
+substitution only, not template logic:
+
+```html
+<h1>Hello, {{ username }}</h1>
+```
+
+```python
+return app.render_template("hello.html", username="Ada")
+```
+
+Register standard WSGI middleware with a factory that accepts and returns a
+WSGI callable:
+
+```python
+def request_id_middleware(next_app):
+    def middleware(environ, start_response):
+        environ["HTTP_X_REQUEST_ID"] = "example"
+        return next_app(environ, start_response)
+    return middleware
+
+app.add_middleware(request_id_middleware)
+```
+
+Error handlers may be registered for HTTP status codes or exception classes:
+
+```python
+@app.errorhandler(ValueError)
+def invalid_value(req):
+    return Response.json({"error": "invalid value"}, "400 Bad Request")
+```
+
+## License
+
+MIT

bwsgi-0.1.0/README.md

@@ -0,0 +1,137 @@
+# Vinod
+
+Ultra-lightweight, **zero-dependency** Python WSGI framework.
+Flask-style routing. Django-style auth. Built on the Python Standard Library.
+
+## Why Vinod?
+
+- **Zero dependencies** — pure Python stdlib
+- **~5-8 MB idle RAM** — runs happily on 512MB hosts like Serv00
+- **Flask-style routing** — decorator-based, familiar syntax
+- **Secure auth built in** — PBKDF2 password hashing + DB-backed sessions
+- **WSGI native** — works with Passenger, Gunicorn, uWSGI
+
+## Install
+
+```bash
+pip install vinod
+```
+
+## Quick Start
+
+```python
+from vinod import Vinod, Response, login_required
+
+app = Vinod(db_path="app.db")
+
+@app.route("/")
+def home(req):
+    return Response.html("<h1>Hello from Vinod</h1>")
+
+@app.route("/dashboard")
+@login_required
+def dashboard(req):
+    return Response.html(f"<h1>Hi {req.user['username']}</h1>")
+
+if __name__ == "__main__":
+    app.run()
+```
+
+## Routing and responses
+
+Routes accept named path parameters and one or more HTTP methods:
+
+```python
+@app.route("/users/<username>", methods=("GET",))
+def user(req, username):
+    return Response.json({"username": username})
+
+profile_url = app.url_for("user", username="Jane Doe")
+```
+
+Path values generated by `url_for` are URL-encoded. Requests to a known path
+with an unsupported method receive `405 Method Not Allowed` and an `Allow`
+header. Static files are served from `static/` at `/static/`; files are
+streamed in chunks and paths are checked against the configured static root.
+
+`Request` provides `query`, `headers`, `cookies`, `body`, `form()`, and `json()`.
+Malformed JSON request bodies receive `400 Bad Request`.
+`Response` provides `text()`, `html()`, `json()`, `redirect()`, and `file()`.
+
+## JSON request validation
+
+Use `Request.validate_json()` to require a JSON object with specific required
+fields and Python types. Malformed JSON and invalid values return a JSON
+`400 Bad Request` response:
+
+```python
+@app.route("/api/items", methods=("POST",))
+def create_item(req):
+    item = req.validate_json({"name": str, "quantity": int})
+    return Response.json(item, "201 Created")
+```
+
+## Sessions and CSRF
+
+`req.session` is a server-side dictionary persisted in SQLite and identified by
+a signed, HTTP-only cookie. Set a stable secret key when creating the app so
+session cookies survive process restarts:
+
+```python
+app = Vinod(db_path="app.db", secret_key="load-this-from-your-environment")
+```
+
+Protect state-changing routes with `@csrf_protect`. Render `req.csrf_token()`
+into a hidden form field named `_csrf_token`, or send it in the
+`X-Csrf-Token` header for JSON requests:
+
+```python
+@app.route("/submit", methods=("POST",))
+@csrf_protect
+def submit(req):
+    req.session["submitted"] = True
+    return Response.json({"ok": True})
+```
+
+Safe methods (`GET`, `HEAD`, `OPTIONS`, and `TRACE`) do not require a token.
+Keep state-changing actions on non-safe methods and use CSRF protection for
+browser-session routes.
+
+## Templates, middleware, and errors
+
+Templates are UTF-8 files under `templates/` by default. `{{ name }}` values
+are HTML-escaped automatically; this intentionally supports variable
+substitution only, not template logic:
+
+```html
+<h1>Hello, {{ username }}</h1>
+```
+
+```python
+return app.render_template("hello.html", username="Ada")
+```
+
+Register standard WSGI middleware with a factory that accepts and returns a
+WSGI callable:
+
+```python
+def request_id_middleware(next_app):
+    def middleware(environ, start_response):
+        environ["HTTP_X_REQUEST_ID"] = "example"
+        return next_app(environ, start_response)
+    return middleware
+
+app.add_middleware(request_id_middleware)
+```
+
+Error handlers may be registered for HTTP status codes or exception classes:
+
+```python
+@app.errorhandler(ValueError)
+def invalid_value(req):
+    return Response.json({"error": "invalid value"}, "400 Bad Request")
+```
+
+## License
+
+MIT

bwsgi-0.1.0/bwsgi.egg-info/PKG-INFO

@@ -0,0 +1,162 @@
+Metadata-Version: 2.4
+Name: bwsgi
+Version: 0.1.0
+Summary: Ultra-lightweight, zero-dependency Python WSGI framework
+Author-email: Baraa Ahmed <baraa.runtime@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/BaraaByte/bwsgi
+Project-URL: Repository, https://github.com/BaraaByte/bwsgi
+Project-URL: Issues, https://github.com/BaraaByte/bwsgi/issues
+Keywords: wsgi,framework,zero-dependency,serv00,freebsd,flask-like
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: POSIX :: BSD :: FreeBSD
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Internet :: WWW/HTTP :: WSGI :: Application
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# Vinod
+
+Ultra-lightweight, **zero-dependency** Python WSGI framework.
+Flask-style routing. Django-style auth. Built on the Python Standard Library.
+
+## Why Vinod?
+
+- **Zero dependencies** — pure Python stdlib
+- **~5-8 MB idle RAM** — runs happily on 512MB hosts like Serv00
+- **Flask-style routing** — decorator-based, familiar syntax
+- **Secure auth built in** — PBKDF2 password hashing + DB-backed sessions
+- **WSGI native** — works with Passenger, Gunicorn, uWSGI
+
+## Install
+
+```bash
+pip install vinod
+```
+
+## Quick Start
+
+```python
+from vinod import Vinod, Response, login_required
+
+app = Vinod(db_path="app.db")
+
+@app.route("/")
+def home(req):
+    return Response.html("<h1>Hello from Vinod</h1>")
+
+@app.route("/dashboard")
+@login_required
+def dashboard(req):
+    return Response.html(f"<h1>Hi {req.user['username']}</h1>")
+
+if __name__ == "__main__":
+    app.run()
+```
+
+## Routing and responses
+
+Routes accept named path parameters and one or more HTTP methods:
+
+```python
+@app.route("/users/<username>", methods=("GET",))
+def user(req, username):
+    return Response.json({"username": username})
+
+profile_url = app.url_for("user", username="Jane Doe")
+```
+
+Path values generated by `url_for` are URL-encoded. Requests to a known path
+with an unsupported method receive `405 Method Not Allowed` and an `Allow`
+header. Static files are served from `static/` at `/static/`; files are
+streamed in chunks and paths are checked against the configured static root.
+
+`Request` provides `query`, `headers`, `cookies`, `body`, `form()`, and `json()`.
+Malformed JSON request bodies receive `400 Bad Request`.
+`Response` provides `text()`, `html()`, `json()`, `redirect()`, and `file()`.
+
+## JSON request validation
+
+Use `Request.validate_json()` to require a JSON object with specific required
+fields and Python types. Malformed JSON and invalid values return a JSON
+`400 Bad Request` response:
+
+```python
+@app.route("/api/items", methods=("POST",))
+def create_item(req):
+    item = req.validate_json({"name": str, "quantity": int})
+    return Response.json(item, "201 Created")
+```
+
+## Sessions and CSRF
+
+`req.session` is a server-side dictionary persisted in SQLite and identified by
+a signed, HTTP-only cookie. Set a stable secret key when creating the app so
+session cookies survive process restarts:
+
+```python
+app = Vinod(db_path="app.db", secret_key="load-this-from-your-environment")
+```
+
+Protect state-changing routes with `@csrf_protect`. Render `req.csrf_token()`
+into a hidden form field named `_csrf_token`, or send it in the
+`X-Csrf-Token` header for JSON requests:
+
+```python
+@app.route("/submit", methods=("POST",))
+@csrf_protect
+def submit(req):
+    req.session["submitted"] = True
+    return Response.json({"ok": True})
+```
+
+Safe methods (`GET`, `HEAD`, `OPTIONS`, and `TRACE`) do not require a token.
+Keep state-changing actions on non-safe methods and use CSRF protection for
+browser-session routes.
+
+## Templates, middleware, and errors
+
+Templates are UTF-8 files under `templates/` by default. `{{ name }}` values
+are HTML-escaped automatically; this intentionally supports variable
+substitution only, not template logic:
+
+```html
+<h1>Hello, {{ username }}</h1>
+```
+
+```python
+return app.render_template("hello.html", username="Ada")
+```
+
+Register standard WSGI middleware with a factory that accepts and returns a
+WSGI callable:
+
+```python
+def request_id_middleware(next_app):
+    def middleware(environ, start_response):
+        environ["HTTP_X_REQUEST_ID"] = "example"
+        return next_app(environ, start_response)
+    return middleware
+
+app.add_middleware(request_id_middleware)
+```
+
+Error handlers may be registered for HTTP status codes or exception classes:
+
+```python
+@app.errorhandler(ValueError)
+def invalid_value(req):
+    return Response.json({"error": "invalid value"}, "400 Bad Request")
+```
+
+## License
+
+MIT

bwsgi-0.1.0/bwsgi.egg-info/SOURCES.txt

@@ -0,0 +1,15 @@
+LICENSE
+MANIFEST.in
+README.md
+pyproject.toml
+bwsgi.egg-info/PKG-INFO
+bwsgi.egg-info/SOURCES.txt
+bwsgi.egg-info/dependency_links.txt
+bwsgi.egg-info/top_level.txt
+tests/test_smoke.py
+vinod/__init__.py
+vinod/auth.py
+vinod/core.py
+vinod/db.py
+vinod/decorators.py
+vinod/py.typed

bwsgi-0.1.0/bwsgi.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

bwsgi-0.1.0/bwsgi.egg-info/top_level.txt

@@ -0,0 +1 @@
+vinod

bwsgi-0.1.0/pyproject.toml

@@ -0,0 +1,40 @@
+[build-system]
+requires = ["setuptools>=77.0.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "bwsgi"
+version = "0.1.0"
+description = "Ultra-lightweight, zero-dependency Python WSGI framework"
+readme = "README.md"
+requires-python = ">=3.9"
+
+# Modern PEP 639 standard configurations
+license = "MIT"
+license-files = ["LICENSE"] 
+
+authors = [{ name = "Baraa Ahmed", email = "baraa.runtime@gmail.com" }]
+keywords = ["wsgi", "framework", "zero-dependency", "serv00", "freebsd", "flask-like"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Operating System :: POSIX :: BSD :: FreeBSD",
+    "Operating System :: POSIX :: Linux",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    # Removed the invalid "Framework :: WSGI" line to fix the 400 Bad Request error
+    "Topic :: Internet :: WWW/HTTP :: WSGI :: Application",
+]
+dependencies = []
+
+[project.urls]
+Homepage = "https://github.com/BaraaByte/bwsgi"
+Repository = "https://github.com/BaraaByte/bwsgi"
+Issues = "https://github.com/BaraaByte/bwsgi/issues"
+
+[tool.setuptools]
+packages = ["vinod"]
+include-package-data = true

bwsgi-0.1.0/setup.cfg

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