NexaWeb - Next-Generation Full-Stack Python Framework with C++ Performance Core
Project description
๐ NexaWeb
Next-Generation Full-Stack Python Web Framework
A high-performance, lightweight, full-stack web framework designed to compete with Laravel and React while being significantly lighter, faster, and more efficient.
โจ Features
- ๐๏ธ Full Application Framework - Not just an API framework, but a complete solution
- ๐ PYXM Template Engine - Custom HTML + Python expression templates
- โก Native Async Support - ASGI-compatible for high concurrency
- ๐ Security-First Design - Built-in CSRF, XSS protection, rate limiting
- ๐๏ธ Lightweight ORM - Active Record pattern with query builder
- ๐ Authentication - JWT tokens, sessions, role-based guards
- โ Validation System - 30+ built-in rules with form support
- ๐ Plugin Architecture - Extensible hooks and extension points
- ๐ ๏ธ CLI Tools - Project scaffolding and management
- ๐ Optional C++ Core - Native extensions for performance-critical code
๐ฆ Installation
pip install nexaweb
Or install from source:
git clone https://github.com/nexaweb/nexaweb.git
cd nexaweb
pip install -e .
๐ Quick Start
Create a New Project
nexaweb create myapp
cd myapp
nexaweb serve
Minimal Example
from nexaweb import Application, Request, Response
app = Application()
@app.get("/")
async def index(request: Request) -> Response:
return Response.html("<h1>Hello, NexaWeb!</h1>")
@app.get("/api/users")
async def users(request: Request) -> Response:
return Response.json({"users": ["Alice", "Bob"]})
if __name__ == "__main__":
import uvicorn
uvicorn.run("app:app", reload=True)
๐ Framework Components
Core (nexaweb.core)
- Application - ASGI application with middleware support
- Router - High-performance route matching with parameters
- Request/Response - Full HTTP request/response handling
- Middleware - Composable middleware pipeline
- WebSocket - Real-time bidirectional communication
- Config - Flexible configuration management
PYXM Template Engine (nexaweb.pyxm)
Custom template format combining HTML with Python expressions:
<!-- templates/index.pyxm -->
<html>
<head><title>{{ title }}</title></head>
<body>
<h1>{{ greeting }}</h1>
{% for user in users %}
<p>{{ user.name }} - {{ user.email }}</p>
{% endfor %}
</body>
</html>
Security (nexaweb.security)
- CSRF Protection - Double-submit cookie pattern
- XSS Prevention - Content sanitization
- Rate Limiting - Token bucket algorithm
- Sandboxed Execution - Safe template evaluation
Authentication (nexaweb.auth)
from nexaweb.auth import Authenticator, JWTHandler
# JWT Authentication
jwt = JWTHandler(secret="your-secret")
tokens = jwt.create_tokens({"user_id": 123})
# Session-based Auth
auth = Authenticator(user_provider)
user = await auth.attempt(email, password)
ORM (nexaweb.orm)
from nexaweb.orm import Model, StringField, IntegerField
class User(Model):
__tablename__ = "users"
id = IntegerField(primary_key=True)
name = StringField(max_length=100)
email = StringField(max_length=255, unique=True)
# Query Builder
users = await User.query() \
.where("active", True) \
.order_by("name") \
.limit(10) \
.all()
Validation (nexaweb.validation)
from nexaweb.validation import Validator
data = {"email": "user@example.com", "age": 25}
rules = {
"email": "required|email",
"age": "required|integer|min:18",
}
result = await Validator.validate(data, rules)
CLI Tools (nexaweb.cli)
nexaweb create myapp # Create new project
nexaweb serve # Run development server
nexaweb build # Build for production
nexaweb migrate # Run database migrations
nexaweb make controller # Generate components
nexaweb routes # List all routes
nexaweb shell # Interactive shell
Plugin System (nexaweb.plugins)
from nexaweb.plugins import Plugin
class MyPlugin(Plugin):
class Meta:
name = "my-plugin"
version = "1.0.0"
async def boot(self, app):
@app.get("/plugin-route")
async def plugin_route(request):
return Response.json({"plugin": "active"})
๐๏ธ Project Structure
myapp/
โโโ app.py # Application entry point
โโโ config.py # Configuration
โโโ routes.py # Route definitions
โโโ app/
โ โโโ controllers/ # Request handlers
โ โโโ models/ # Database models
โ โโโ middleware/ # Custom middleware
โ โโโ services/ # Business logic
โโโ templates/ # PYXM templates
โโโ static/ # Static assets
โโโ tests/ # Test files
โโโ migrations/ # Database migrations
๐ Documentation
๐ค Publishing to PyPI
Tutorial lengkap untuk upload NexaWeb ke PyPI:
1. Persiapan Akun PyPI
# 1. Buat akun di https://pypi.org/account/register/
# 2. Buat API Token di https://pypi.org/manage/account/token/
# - Pilih scope "Entire account" (untuk upload pertama)
# - Simpan token dengan baik (hanya ditampilkan sekali!)
2. Install Build Tools
pip install --upgrade pip build twine
3. Build Package
# Build source distribution dan wheel
python -m build
# Akan menghasilkan:
# dist/
# โโโ nexaweb-1.0.0a1-py3-none-any.whl
# โโโ nexaweb-1.0.0a1.tar.gz
4. Test di TestPyPI (Opsional tapi Disarankan)
# Upload ke TestPyPI dulu untuk testing
twine upload --repository testpypi dist/*
# Username: __token__
# Password: [paste TestPyPI API token]
# Test install dari TestPyPI
pip install --index-url https://test.pypi.org/simple/ nexaweb
5. Upload ke PyPI (Production)
# Upload ke PyPI production
twine upload dist/*
# Username: __token__
# Password: [paste PyPI API token]
6. Setup .pypirc (Opsional)
Buat file ~/.pypirc agar tidak perlu input token setiap upload:
[distutils]
index-servers =
pypi
testpypi
[pypi]
username = __token__
password = pypi-xxxxxxxxxxxxxxxxxxxx
[testpypi]
username = __token__
password = pypi-xxxxxxxxxxxxxxxxxxxx
Lalu upload cukup dengan:
twine upload dist/*
7. Verifikasi Upload
# Cek di browser
# https://pypi.org/project/nexaweb/
# Test install
pip install nexaweb
# Verifikasi
python -c "import nexaweb; print(nexaweb.__version__)"
8. Update Version (untuk rilis berikutnya)
Edit pyproject.toml:
[project]
version = "1.0.0-alpha.2" # Ubah versi
Lalu ulangi langkah 3-5.
๐ Checklist Sebelum Upload
- Update version di
pyproject.toml - Update
README.mdjika ada perubahan - Pastikan semua tests pass
- Review dependencies di
pyproject.toml - Hapus folder
dist/lama:rm -rf dist/ - Build ulang:
python -m build - Test di TestPyPI dulu (opsional)
๐ง Troubleshooting
Error: Package already exists
# Hapus versi lama di dist/ dan build ulang dengan versi baru
rm -rf dist/ && python -m build
Error: Invalid API token
# Pastikan format token benar
# Username: __token__
# Password: pypi-xxx... (termasuk prefix "pypi-")
Error: Missing metadata
# Pastikan README.md dan pyproject.toml lengkap
# Verifikasi dengan: twine check dist/*
๐ค Contributing
Contributions are welcome! Please read our Contributing Guide.
# Development setup
git clone https://github.com/daffa-aditya-p/NexaWeb.git
cd nexaweb
pip install -e ".[dev]"
pytest
๐ License
MIT License - see LICENSE for details.
๐ Acknowledgments
Built with inspiration from Laravel, FastAPI, Django, and React.
Made with โค๏ธ by the NexaWeb Team
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
nexaweb-1.0.0a1.tar.gz
(155.6 kB
view details)
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
nexaweb-1.0.0a1-py3-none-any.whl
(182.0 kB
view details)
File details
Details for the file nexaweb-1.0.0a1.tar.gz.
File metadata
- Download URL: nexaweb-1.0.0a1.tar.gz
- Upload date:
- Size: 155.6 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.12.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
28dde5ff623f81cb91523327651c0f038df842ba984b9bd0b5ae3d5706b0f54a
|
|
| MD5 |
d54ece1e31fad08149c530217b46e4ae
|
|
| BLAKE2b-256 |
9615c975403655a443f88912dcbb48d2a38083c25a487a80344f472f0d65969f
|
File details
Details for the file nexaweb-1.0.0a1-py3-none-any.whl.
File metadata
- Download URL: nexaweb-1.0.0a1-py3-none-any.whl
- Upload date:
- Size: 182.0 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.12.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
d485408f89bdc1db6c615c1a7ca22139a0a929fcf1811130a6a033fe7195ec43
|
|
| MD5 |
3a270b5f4d347b499a16cc9d49688f7a
|
|
| BLAKE2b-256 |
bac5d08ff65698e8886f18bbd5accb5e48ab51281395f93b7f73b772af2ddf3b
|
