Overview — Aquilia Documentation
Comprehensive guide and documentation for Overview in the Aquilia framework. View API reference, examples, and implementation patterns.
Docs / Models Models (ORM) Pure Python, async-first ORM. Subclass Model and declare fields. A metaclass collects descriptors, assigns PKs, parses Meta , registers globally, and attaches Manager . Architecture Metaclass-driven. All database access methods return an awaitable. A global ModelRegistry maps tables and dependencies. Quick Start from aquilia.models import Model from aquilia.models.fields_module import CharField, EmailField, BooleanField, DateTimeField class User(Model): table = "users" name = CharField(max_length=150) email = EmailField(unique=True) active = BooleanField(default=True) created_at = DateTimeField(auto_now_add=True) class Meta: ordering = ["-created_at"] CRUD Operations Mutations use instance methods. Queries are issued through the QuerySet attached to the objects manager. # CREATE user = User(name="Alice", email="alice@co.com") await user.save(db) # INSERT — calls save() # Eager objects manager creation user = await User.objects.create(db, name="Bob", email="bob@co.com") # READ users = await User.objects.filter(active=True).all() user = await User.objects.get(id=1) # strict one or raise # UPDATE user.name = "Alice Smith" await user.save(db, update_fields=["name"]) # UPDATE with update_fields # DELETE await user.delete_instance(db) # calls delete_instance() Instance Methods Method Description ))} Meta Options Configure table properties in Meta : Option Type Description ))} Model Registry Metaclass auto-registers models in ModelRegistry for dependency mapping. from aquilia.models.registry import ModelRegistry # Get model class UserModel = ModelRegistry.get("User") # Create all tables (respects FK topology order) await ModelRegistry.create_tables(db) Fields )
Go to Homepage