turbo-orm 1.1.0

Ultra-fast Python ORM with enhanced error handling, monitoring, and type-safe configuration

Turbo ORM

The fastest Python ORM. 3-8x faster than SQLAlchemy, with enhanced error handling, monitoring, and type-safe configuration.

from turbo import Database, Model, TextField

class User(Model):
    name = TextField()
    email = TextField()

db = Database("app.db")
db.connect()
User.create_table(db)

user = User(name="Alice", email="[e-mail]")
user.save(db)

⚡ Performance

• 84,164 ops/sec INSERT (3.5x faster than SQLAlchemy)
• 993,911 ops/sec SELECT (192x faster than SQLAlchemy)
• 614,488 ops/sec bulk operations with turbo mode

See full benchmark comparison →

🚀 Features

Core

• Zero Dependencies - Pure Python, uses built-in sqlite3
• Async Support - Full async/await with aiosqlite
• Migrations - Auto-diffing schema management
• CLI Tools - Project scaffolding and model generation
• Type Safe - Full IDE autocomplete support

Advanced

• Vector Search - Semantic similarity search
• CDC - Change Data Capture for real-time streaming
• Business Rules - Declarative validation engine
• RBAC - Role-based access control
• Redis Cache - Distributed query caching
• TUI Dashboard - Terminal monitoring interface

NEW in v1.1.0 ✨

• Enhanced Error Handling - Detailed errors with context and suggestions
• Query Performance Logging - Automatic slow query detection
• Type-Safe Configuration - Environment-aware config with validation
• Health Monitoring - Comprehensive system diagnostics
• 100% Backward Compatible - All existing code works unchanged

📦 Installation

pip install turbo_orm

# With async support
pip install turbo_orm[async]

# With Redis caching
pip install turbo_orm[redis]

# All extras
pip install turbo_orm[async,redis,http]

🎯 Quick Start

from turbo import Database, Model, TextField, IntegerField

# Define models
class Post(Model):
    title = TextField(required=True)
    content = TextField()
    views = IntegerField(default=0)

# Setup database
db = Database("blog.db")
db.connect()
Post.create_table(db)

# Create
post = Post(title="Hello World", content="My first post")
post.save(db)

# Read
post = Post.get(db, 1)
all_posts = Post.all(db)
popular = Post.filter(db, views__gt=100)

# Update
post.views += 1
post.save(db)

# Delete
post.delete(db)

✨ New in v1.1.0 - Enhanced Developer Experience

1. Enhanced Error Handling

from turbo import Database, Model, TextField

class User(Model):
    name = TextField()

db = Database(":memory:")
User.create_table(db)

try:
    user = User()  # Missing required field
    user.save(db)
except Exception as e:
    # Shows detailed error with context and suggestions
    print(e)

2. Query Performance Monitoring

db = Database("app.db", slow_query_threshold=0.5)
# ... your queries ...
stats = db.get_stats()
print(f"Slow queries: {stats['slow_queries']}")

3. Type-Safe Configuration

from turbo.config import ORMConfig

config = ORMConfig.from_env()  # Load from TURBO_ORM_* env vars
db = Database(config.database_path, pool_size=config.pool_size)

4. Health Monitoring

from turbo.health import DatabaseHealth

health = DatabaseHealth(db)
report = health.full_report()
if report['status'] == 'degraded':
    send_alert(report)

🏆 Why Turbo?

Feature	Turbo	SQLAlchemy	Peewee
INSERT Speed	84k ops/sec	24k ops/sec	10k ops/sec
SELECT Speed	994k ops/sec	5k ops/sec	6k ops/sec
Dependencies	0	2+	0
Async Support	✅	✅	❌
Vector Search	✅	❌	❌
CDC	✅	❌	❌

📚 Documentation

• Getting Started
• API Reference
• Performance Guide
• Examples

🎨 Real-World Examples

Check out complete demo applications:

• Blog Platform
• Task Manager
• Social Network
• Inventory System

🤝 Contributing

Contributions are welcome! Please see CONTRIBUTING.md.

📄 License

MIT License - see LICENSE file for details.

⭐ Show Your Support

If you find Turbo useful, please consider giving it a star on GitHub!