We're excited to announce TamilPY v0.1.9, our biggest release yet! 🎉

This release transforms TamilPY into a more complete schema-driven FastAPI platform, introducing powerful runtime capabilities, a fluent Query Builder, background jobs, scheduling, caching, application lifecycle management, and a significantly improved developer experience.

Whether you're building APIs, internal tools, or enterprise applications, v0.1.9 helps you build faster while writing less boilerplate.

📚 Documentation

• TamilPY Docs
• Platform Guides
• GitHub Pages Study Guides

Our documentation has also received a major upgrade with a professional GitHub Pages site featuring clickable feature cards, responsive layouts, and detailed study guides.

✨ What's New in v0.1.9

🔍 Fluent Query Builder

Introducing tpy.query, a schema-driven query builder designed for clean, readable, and secure database queries.

Highlights

• Parameterized queries
• SQLite support
• PostgreSQL support
• MySQL support
• MongoDB helpers
• Built-in pagination
• Repository integration

Instead of writing raw SQL, developers can now build expressive queries directly from repositories.

🔗 ORM Relationships

TamilPY now supports ORM-style relationships directly inside schema.tpy.

Supported relationships:

• belongs_to
• has_one
• has_many
• belongs_to_many

It also includes eager loading through:

• with_()
• EagerLoader

This makes complex data retrieval significantly cleaner and faster.

⚡ Event System

A brand-new event-driven architecture is now available.

Features include:

• Event
• Listener
• EventDispatcher
• Wildcard listeners
• Stop propagation
• Process singleton support

Perfect for decoupling business logic from application workflows.

🧵 Queue System

Background job processing is now built into TamilPY.

Supported drivers:

• Sync
• Database
• Redis (optional)

New CLI commands:

tpy queue table
tpy queue work

⏰ Scheduler

Schedule recurring jobs with simple cadence helpers.

Features:

• app/schedule.py
• Overlap protection
• Register-based scheduling

Commands:

tpy schedule run
tpy schedule list

⚡ Cache System

Built-in cache abstraction supporting:

• Memory
• File
• Redis

Command:

tpy cache clear

🌐 Standard API Responses

The new ApiResponse class provides consistent JSON responses across every endpoint.

Available responses include:

• success
• created
• paginated
• error
• validation_error
• not_found

No more manually formatting response payloads.

✅ Validation

A completely redesigned validation system featuring:

• Pipe-rule validation
• Validator
• ValidationException

Simple, expressive, and reusable.

🏗️ Application Kernel

TamilPY now includes a fully featured application kernel.

Capabilities include:

• Application create()
• mount()
• Dependency Injection Container
• Service Providers
• Plugin support

This lays the foundation for scalable enterprise applications.

🛡 Middleware Groups

Middleware can now be organized using MiddlewareManager, making request pipelines cleaner and easier to maintain.

❤️ Health Checks & Lifecycle Hooks

Production-ready health endpoints:

• /health
• /health/ready

Lifecycle hooks:

• boot
• shutdown
• before request
• after request
• exception

📝 Logging

A new logging system supports:

• Console logging
• File logging
• Stack channels

Managed through:

• LogManager
• get_logger()

⚙️ Configuration Improvements

Configuration now supports:

• Nested keys
• Environment overlays
• Configuration caching
• Automatic loading
• Freshness checks

Production deployments become significantly faster using:

TPY_CONFIG_CACHE=1

🚀 Route Cache

Cache application routes for faster startup.

Commands:

tpy route cache
tpy route list
tpy route clear

👨‍💻 Better CLI Experience

Developer productivity has improved with several new commands.

tpy about
tpy commands
tpy -V

Rich-powered banners, tables, and improved terminal output make the CLI more enjoyable to use.

⚡ Optimize & Watch Mode

Development is now faster than ever.

tpy optimize

Builds optimized configuration and route caches.

tpy watch

Automatically rebuilds whenever schema.tpy changes.

📖 Documentation Improvements

Documentation has been completely redesigned.

Highlights include:

• Professional GitHub Pages site
• Feature cards
• Dedicated documentation pages
• Mobile responsive layout
• Improved navigation
• Schema relationship grammar guide

Learning TamilPY is now easier than ever.

🔄 Changes

• Repositories now expose query()
• Existing CRUD methods remain compatible
• Automatic configuration loading
• New project scaffolding
• Legacy response helpers remain supported for backward compatibility

🚀 New CLI Commands

tpy queue table
tpy queue work

tpy schedule run
tpy schedule list

tpy cache clear

tpy config show
tpy config cache
tpy config status
tpy config clear

tpy route cache
tpy route list
tpy route clear

tpy optimize

tpy watch

tpy about
tpy commands
tpy -V

⬆️ Upgrade

Upgrade everything:

pip install --upgrade "tamilPY[all]"

Redis only:

pip install --upgrade "tamilPY[redis]"

After upgrading, regenerate repositories using:

tpy build

tpy crud

For the best production performance:

tpy optimize

Enable configuration caching:

TPY_CONFIG_CACHE=1

🎯 Looking Ahead

TamilPY continues to evolve toward becoming a complete schema-driven FastAPI platform that minimizes boilerplate while maximizing developer productivity.

Version 0.1.9 represents a major milestone, bringing together data access, background processing, scheduling, caching, validation, lifecycle management, and an improved developer experience into one cohesive framework.

We'd love your feedback, feature requests, and contributions from the community.

⭐ If you find TamilPY useful, consider starring the project on GitHub and sharing it with fellow Python developers.

Happy Coding! 🚀