artanis 0.1.4

A simple, yet fast, Python framework with named routes

Artanis

A lightweight, minimalist ASGI web framework for Python built with simplicity and performance in mind.

📚 Complete Documentation | 🚀 Quick Start Guide | 💡 Examples | 🔍 API Reference

Artanis provides a clean, intuitive API for building modern web applications with Express.js-style middleware and comprehensive built-in features.

✨ Key Features

• 🚀 Express.js-Style API: Clean app.get(), app.post(), app.use() middleware patterns
• 🏗️ Advanced Routing: Modular routers, path parameters, nested subrouting, parameterized mounts
• 🔐 Built-in Security: CORS, CSP, HSTS, rate limiting, security headers, comprehensive middleware suite
• 📡 Event System: Startup/shutdown events, custom business events, priority execution, event middleware
• ⚠️ Exception Handling: Custom exception hierarchy, structured error responses, automatic logging
• 📊 Professional Logging: Structured logging, JSON/text formats, request tracking, component-specific loggers
• 🔷 Type Safety: Complete type hints, mypy compatibility, excellent IDE support
• 🎯 ASGI Compliant: Works with Uvicorn, Hypercorn, Daphne - zero runtime dependencies

📖 View Complete Feature List & Documentation →

📦 Installation

pip install artanis

Requirements: Python 3.8+ • Zero runtime dependencies

📚 Development Setup Guide | 🔧 Contributing Guidelines

🚀 Quick Start

from artanis import App

app = App()

# Simple route
async def hello():
    return {"message": "Hello, World!"}

app.get("/", hello)

# Route with path parameter
async def get_user(user_id):
    return {"user_id": user_id, "name": f"User {user_id}"}

app.get("/users/{user_id}", get_user)

# POST route with JSON body
async def create_user(request):
    data = await request.json()
    return {"created": data}

app.post("/users", create_user)

# Run with: uvicorn main:app --reload

🚀 Complete Quick Start Tutorial | 💡 View More Examples

📚 Documentation & Resources

Complete Documentation: nordxai.github.io/Artanis

Quick Links

• 🚀 Quick Start Guide - Get started in minutes
• 💡 Examples - Real-world applications and patterns
• 🔍 API Reference - Complete API documentation
• 🏗️ Tutorial - Build your first application
• 🛠️ Contributing - Development setup and guidelines

🚀 CLI Tool

Create new projects instantly:

# Create a new Artanis project
artanis new my-project
cd my-project

# Run your application
uvicorn main:app --reload

🛠️ Development & Testing

# Clone repository
git clone https://github.com/nordxai/Artanis
cd Artanis

# Install in development mode
pip install -e ".[dev]"

# Run tests (191 comprehensive tests)
pytest

# Code quality checks
ruff check . && mypy src/artanis

🤝 Community & Support

• 📚 Documentation - Complete guides and API reference
• 🐛 Issues - Bug reports and feature requests
• 💬 Discussions - Community support and questions
• 📦 PyPI - Package releases and changelog
• ⭐ GitHub - Source code and contributions

Requirements: Python 3.8+ • Zero runtime dependencies • ASGI compliant

---

Built with ❤️ for the Python community
Express.js simplicity meets Python performance