Metadata-Version: 2.4
Name: turbo-orm
Version: 1.0.0
Summary: Ultra-fast Python ORM - 15.2x faster than SQLAlchemy with advanced features
Home-page: https://github.com/turbo-orm/turbo-orm
Author: Turbo ORM Team
Author-email: Turbo ORM Team <team@turbo-orm.dev>
Maintainer-email: Turbo ORM Team <team@turbo-orm.dev>
License: MIT License
        
        Copyright (c) 2024 Turbo ORM
        
        Permission is hereby granted, free of charge, to any person obtaining a copy
        of this software and associated documentation files (the "Software"), to deal
        in the Software without restriction, including without limitation the rights
        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
        copies of the Software, and to permit persons to whom the Software is
        furnished to do so, subject to the following conditions:
        
        The above copyright notice and this permission notice shall be included in all
        copies or substantial portions of the Software.
        
        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
        SOFTWARE.
        
Project-URL: Homepage, https://github.com/yourusername/turbo-orm
Project-URL: Documentation, https://turbo-orm.readthedocs.io
Project-URL: Repository, https://github.com/yourusername/turbo-orm
Project-URL: Bug Tracker, https://github.com/yourusername/turbo-orm/issues
Keywords: orm,database,sqlite,performance,async,turbo,fast,querybuilder
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Topic :: Database
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Operating System :: OS Independent
Classifier: Environment :: Web Environment
Classifier: Framework :: AsyncIO
Classifier: Natural Language :: English
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Provides-Extra: async
Requires-Dist: aiosqlite>=0.19.0; extra == "async"
Provides-Extra: redis
Requires-Dist: redis>=4.5.0; extra == "redis"
Provides-Extra: http
Requires-Dist: requests>=2.31.0; extra == "http"
Provides-Extra: dev
Requires-Dist: pytest>=7.4.0; extra == "dev"
Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
Dynamic: author
Dynamic: home-page
Dynamic: license-file
Dynamic: requires-python

# Turbo ORM

[![PyPI version](https://badge.fury.io/py/turbo-orm.svg)](https://badge.fury.io/py/turbo-orm)
[![Python 3.7+](https://img.shields.io/badge/python-3.7+-blue.svg)](https://www.python.org/downloads/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

**The fastest Python ORM.** 3-8x faster than SQLAlchemy, with zero external dependencies.

```python
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="alice@example.com")
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 →](https://github.com/yourusername/turbo-orm#benchmarks)

## 🚀 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

## 📦 Installation

```bash
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

```python
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)
```

## 🏆 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](https://turbo-orm.readthedocs.io/en/latest/quickstart/)
- [API Reference](https://turbo-orm.readthedocs.io/en/latest/api/)
- [Performance Guide](https://turbo-orm.readthedocs.io/en/latest/performance/)
- [Examples](https://github.com/yourusername/turbo-orm/tree/main/demos)

## 🎨 Real-World Examples

Check out complete demo applications:
- [Blog Platform](https://github.com/yourusername/turbo-orm/tree/main/demos/blog_platform)
- [Task Manager](https://github.com/yourusername/turbo-orm/tree/main/demos/task_manager)
- [Social Network](https://github.com/yourusername/turbo-orm/tree/main/demos/social_network)
- [Inventory System](https://github.com/yourusername/turbo-orm/tree/main/demos/inventory_system)

## 🤝 Contributing

Contributions are welcome! Please see [CONTRIBUTING.md](CONTRIBUTING.md).

## 📄 License

MIT License - see [LICENSE](LICENSE) file for details.

## ⭐ Show Your Support

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