# Cherrypy-foundation

<p align="center">
<a href="LICENSE"><img alt="License" src="https://img.shields.io/badge/license-GPL--3.0-orange"></a>
<a href="https://gitlab.com/ikus-soft/cherrypy-foundation/pipelines"><img alt="Build" src="https://gitlab.com/ikus-soft/cherrypy-foundation/badges/master/pipeline.svg"></a>
<a href="https://sonar.ikus-soft.com/dashboard?id=cherrypy-foundation"><img alt="Quality Gate" src="https://sonar.ikus-soft.com/api/project_badges/measure?project=cherrypy-foundation&metric=alert_status"></a>
<a href="https://sonar.ikus-soft.com/dashboard?id=cherrypy-foundation"><img alt="Coverage" src="https://sonar.ikus-soft.com/api/project_badges/measure?project=cherrypy-foundation&metric=coverage"></a>
</p>

Cherrypy-foundation is a comprehensive toolkit that accelerates web application development with CherryPy. It provides a curated collection of utilities and integrations that handle common web development tasks, allowing you to focus on building your application's unique features.

## What's Included

- **Database Integration**: Seamless SQLAlchemy integration for database operations
- **Template Engine**: Jinja2 and JinjaX support for flexible, component-based templating
- **Form Handling**: Enhanced WTForms integration with automatic validation and Bootstrap rendering
- **URL Management**: Flexible URL generation with `url_for` utility
- **Error Handling**: Smart error pages that adapt to response content type (HTML, JSON, plain text)
- **UI Components**: Bootstrap-ready components for rapid interface development

## Who Is This For?

Cherrypy-foundation is designed for developers who:

- Want to build modern web applications with CherryPy without reinventing the wheel
- Need a lightweight alternative to full-stack frameworks while maintaining flexibility
- Prefer convention over configuration but value customization options
- Want battle-tested components that integrate seamlessly with CherryPy's architecture

This documentation will guide you through all available features, from basic utilities to advanced integrations, with practical examples to help you get started quickly.
