Voltz Mini Web Framework (Experimental)

Voltz is a small and experimental Python web framework built from scratch to understand how HTTP routing, request handling, controllers and the WSGI interface work under the hood.

This project is not intended for production use.
Its purpose is educational: to explore the internal mechanics behind popular frameworks such as Flask or Django and to deepen backend fundamentals.

---

Features

• Basic WSGI application
• URL routing system
• Support for function-based controllers
• Simple MVC-inspired structure
• JSON and text/HTML responses
• Clear, minimal and easy-to-read codebase

---

Project Structure

voltz-mini-web-framework/
├── voltz/
│   ├── framework.py
│   ├── router.py
│   ├── controllers/
│   └── utils.py
└── README.md

---

Example Usage

Below is a simple example demonstrating how to define routes and controllers using Voltz:

from voltz.framework import App

app = App()

@app.route("/")
def home():
    return "Welcome to Voltz Web Framework!"

@app.route("/api")
def api_example():
    return {"message": "This is an API response."}

Run the application with a WSGI server such as wsgiref:

from wsgiref.simple_server import make_server
from voltz.framework import app

server = make_server("", 8000, app)
server.serve_forever()

---

What I Practiced

• Understanding the WSGI protocol and how Python applications handle HTTP requests
• Building a routing system from scratch
• Implementing controllers and response handling
• Designing a minimal framework architecture
• Exploring MVC-like patterns
• Gaining deeper insight into how frameworks such as Flask operate internally

---

Why This Project Matters

This framework demonstrates curiosity and technical depth beyond typical beginner projects.
By building a framework instead of just using one, I practiced fundamentals that improve my backend skills, including:

• Request/response life cycle
• URL dispatching
• Abstraction design
• Clean module organization
• Python internals

This knowledge reinforces my work in backend development, automation and problem-solving.

---

Tech Stack

• Python
• WSGI
• Routing system
• MVC concepts

---

Contact

LinkedIn: https://linkedin.com/in/ethical-leonardo