cherrypy-foundation 1.0.0a15__tar.gz → 1.0.0a17__tar.gz

{cherrypy_foundation-1.0.0a15 → cherrypy_foundation-1.0.0a17}/.gitignore

@@ -8,3 +8,7 @@ coverage.xml
 pytestdebug.log
 xunit
 xunit.xml
+/.pybuild
+/build
+/debian/tmp
+/debian/debhelper-build-stamp

{cherrypy_foundation-1.0.0a15 → cherrypy_foundation-1.0.0a17}/.gitlab-ci.yml

@@ -26,6 +26,9 @@ isort:
 djlint:
   <<: *tox
 
+doc:
+  <<: *tox
+
 py3:
   <<: *tox
   artifacts:
@@ -64,7 +67,9 @@ package:deb:
   image: buildpack-deps:$DIST
   parallel:
     matrix:
-      - DIST: [trixie]
+      - DIST: trixie
+      - DIST: trixie
+        DEB_BUILD_PROFILES: nocheck
   script: |
     set -x
     set -e

cherrypy_foundation-1.0.0a17/PKG-INFO

@@ -0,0 +1,71 @@
+Metadata-Version: 2.4
+Name: cherrypy-foundation
+Version: 1.0.0a17
+Summary: Cherrypy-foundation
+Author-email: Patrik Dufresne <patrik@ikus-soft.com>
+License: GPLv3
+Project-URL: Homepage, https://gitlab.com/ikus-soft/cherrypy-foundation
+Classifier: Development Status :: 4 - Beta
+Classifier: Framework :: CherryPy
+Classifier: Intended Audience :: System Administrators
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: <4,>=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE.md
+Requires-Dist: babel
+Requires-Dist: CherryPy
+Requires-Dist: Jinja2
+Requires-Dist: jinjax
+Requires-Dist: pytz
+Requires-Dist: WTForms>=3.2.1
+Provides-Extra: test
+Requires-Dist: apscheduler; extra == "test"
+Requires-Dist: argon2-cffi; extra == "test"
+Requires-Dist: ldap3; extra == "test"
+Requires-Dist: parameterized; extra == "test"
+Requires-Dist: pytest; extra == "test"
+Requires-Dist: requests_oauthlib; extra == "test"
+Requires-Dist: selenium; extra == "test"
+Requires-Dist: sqlalchemy; extra == "test"
+Provides-Extra: ldap
+Requires-Dist: ldap3; extra == "ldap"
+Provides-Extra: oauth
+Requires-Dist: requests_oauthlib; extra == "oauth"
+Provides-Extra: passwd
+Requires-Dist: argon2-cffi; extra == "passwd"
+Provides-Extra: scheduler
+Requires-Dist: apscheduler; extra == "scheduler"
+Dynamic: license-file
+
+# 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.

cherrypy_foundation-1.0.0a17/README.md

@@ -0,0 +1,30 @@
+# 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.

cherrypy_foundation-1.0.0a17/debian/TODO

@@ -0,0 +1,3 @@
+- Symlink for all vendor files - bootstrap, jquery, etc.
+- How to run the unit test with the symlink files
+- symlink for sphinxdoc warning: ignoring unknown JavaScript code: debian/python3-cherrypy-foundation/usr/share/doc/python3-cherrypy-foundation/_static/scripts/fontawesome.js

{cherrypy_foundation-1.0.0a15 → cherrypy_foundation-1.0.0a17}/debian/control

@@ -3,33 +3,41 @@ Section: web
 Priority: optional
 Maintainer: Patrik Dufresne <patrik@ikus-soft.com>
 Build-Depends:
- chromium-driver,
  debhelper-compat (= 13),
  dh-python,
  dh-sequence-python3,
  pybuild-plugin-pyproject,
  python3,
  python3-all-dev,
- python3-apscheduler,
- python3-argon2,
- python3-babel,
- python3-cherrypy3,
- python3-jinja2,
- python3-jinjax,
- python3-ldap3,
- python3-oauthlib,
- python3-parameterized,
+ python3-myst-parser,
  python3-pip,
- python3-pytest, 
- python3-requests,
- python3-requests-oauthlib,
- python3-responses,
- python3-selenium,
+ python3-pydata-sphinx-theme,
  python3-setuptools,
  python3-setuptools-scm,
- python3-sqlalchemy,
- python3-tz,
- python3-wtforms,
+ python3-sphinx,
+ sphinx-common,
+# Optional dependencies to execute the test test.
+ chromium-driver <!nocheck>,
+ libjs-bootstrap5 <!nocheck>,
+ libjs-jquery <!nocheck>,
+ libjs-jquery-datatables <!nocheck>,
+ libjs-jquery-datatables-extensions <!nocheck>,
+ python3-apscheduler <!nocheck>,
+ python3-argon2 <!nocheck>,
+ python3-babel <!nocheck>,
+ python3-cherrypy3 <!nocheck>,
+ python3-jinja2 <!nocheck>,
+ python3-jinjax <!nocheck>,
+ python3-ldap3 <!nocheck>,
+ python3-oauthlib <!nocheck>,
+ python3-parameterized <!nocheck>,
+ python3-pytest <!nocheck>, 
+ python3-requests <!nocheck>,
+ python3-requests-oauthlib <!nocheck>,
+ python3-selenium <!nocheck>,
+ python3-sqlalchemy <!nocheck>,
+ python3-tz <!nocheck>,
+ python3-wtforms <!nocheck>,
 Rules-Requires-Root: no
 Standards-Version: 4.7.0
 Homepage: https://gitlab.com/ikus-soft/cherrypy-foundation
@@ -48,8 +56,6 @@ Depends:
 Suggests:
  python3-apscheduler,
  python3-argon2,
- python3-jinja2,
- python3-jinjax,
  python3-ldap3,
  python3-oauthlib,
  python3-requests-oauthlib,
@@ -59,3 +65,10 @@ Description: Common utilities and integrations for building CherryPy web applica
  with SQLAlchemy for database access, Jinja2 for templating, WTForms for
  form handling, and Bootstrap for UI components, helping streamline
  application development.
+
+Package: python3-cherrypy-foundation-doc
+Section: doc
+Architecture: all
+Depends: ${sphinxdoc:Depends}, ${misc:Depends}
+Description: Documentation for cherrypy-foundation
+ This package contains the HTML documentation for cherrypy-foundation.

{cherrypy_foundation-1.0.0a15 → cherrypy_foundation-1.0.0a17}/debian/copyright

@@ -6,7 +6,7 @@ Files-Excluded:
  src/cherrypy_foundation/components/vendor
 
 Files: *
-Copyright: 2019-2025 Patrik Dufresne <patrik@ikus-soft.com>
+Copyright: 2019-2026 IKUS Software <patrik@ikus-soft.com>
 License: GPL-3+
 
 License: GPL-3+

cherrypy_foundation-1.0.0a17/debian/python3-cherrpy-foundation-doc.install

@@ -0,0 +1 @@
+build/html/* usr/share/doc/python3-cherrypy-foundation-doc

cherrypy_foundation-1.0.0a17/debian/python3-cherrpy-foundation.install

@@ -0,0 +1 @@
+usr/lib/python3*/*

cherrypy_foundation-1.0.0a17/debian/rules

@@ -0,0 +1,35 @@
+#!/usr/bin/make -f
+
+include /usr/share/dpkg/pkg-info.mk
+
+export SETUPTOOLS_SCM_PRETEND_VERSION_FOR_CHERRYPY_FOUNDATION := $(DEB_VERSION_UPSTREAM)
+
+# Force use of pyproject.toml
+export PYBUILD_SYSTEM=pyproject
+
+%:
+	dh $@ --with python3,sphinxdoc --buildsystem=pybuild --test-tox
+
+# Generate documentation
+execute_after_dh_auto_build:
+ifeq (,$(findstring nodoc, $(DEB_BUILD_OPTIONS)))
+	PYTHONPATH=. python3 -m sphinx -N -b html doc build/html
+endif
+
+# For testing, we need a timezone
+override_dh_auto_test:
+	TZ=UTC dh_auto_test
+
+# Remove tests files
+execute_after_dh_auto_install:
+	find debian/tmp/usr/lib/python$(PYTHON3_DEFAULT)/dist-packages/cherrypy_foundation -type d -name "tests" -exec rm -rf {} +
+
+execute_before_dh_auto_clean:
+	rm -rf *.egg-info
+# Clean Sphinx build artifacts
+	rm -rf build/html docs/_build
+
+# Generate orig.tar.gz
+gentarball:
+	git archive --format=tar HEAD --prefix=$(DEB_SOURCE)-$(DEB_VERSION_UPSTREAM)/ | gzip -9 > ../$(DEB_SOURCE)_$(DEB_VERSION_UPSTREAM).orig.tar.gz
+	mk-origtargz --compression gzip ../$(DEB_SOURCE)_$(DEB_VERSION_UPSTREAM).orig.tar.gz

{cherrypy_foundation-1.0.0a15 → cherrypy_foundation-1.0.0a17}/debian/upstream/metadata

@@ -1,4 +1,4 @@
-Name: rdiffweb
+Name: cherrypy-foundation
 Bug-Database: https://gitlab.com/ikus-soft/cherrypy-foundation/-/issues
 Contact: https://gitlab.com/ikus-soft/cherrypy-foundation/-/project_members
 Repository: git://git@gitlab.com:ikus-soft/cherrypy-foundation.git

cherrypy_foundation-1.0.0a17/doc/_templates/version.html

@@ -0,0 +1,2 @@
+<!-- This will display the version of the docs -->
+cherrypy-foundation {{ version }}

cherrypy_foundation-1.0.0a17/doc/conf.py

@@ -0,0 +1,69 @@
+# Configuration file for the Sphinx documentation builder.
+#
+# This file only contains a selection of the most common options. For a full
+# list see the documentation:
+# https://www.sphinx-doc.org/en/master/usage/configuration.html
+
+# -- Path setup --------------------------------------------------------------
+
+# If extensions (or modules to document with autodoc) are in another directory,
+# add these directories to sys.path here. If the directory is relative to the
+# documentation root, use os.path.abspath to make it absolute, like shown here.
+#
+# import os
+# import sys
+# sys.path.insert(0, os.path.abspath('.'))
+
+# -- Project information -----------------------------------------------------
+
+project = 'Cherrypy-foundation'
+copyright = 'Copyright (C) 2026 IKUS Software'
+author = 'Patrik Dufresne'
+
+# -- General configuration ---------------------------------------------------
+
+# Add any Sphinx extension module names here, as strings. They can be
+# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
+# ones.
+extensions = [
+    'myst_parser',
+    'sphinx.ext.autosectionlabel',
+]
+
+autosectionlabel_prefix_document = True
+
+# Enable anchors for cross references
+myst_heading_anchors = 2
+
+# Add any paths that contain templates here, relative to this directory.
+templates_path = ['_templates']
+
+# List of patterns, relative to source directory, that match files and
+# directories to ignore when looking for source files.
+# This pattern also affects html_static_path and html_extra_path.
+exclude_patterns = []
+
+# -- Options for HTML output -------------------------------------------------
+
+# The theme to use for HTML and HTML Help pages.  See the documentation for
+# a list of builtin themes.
+#
+html_theme = 'pydata_sphinx_theme'
+# Ref: https://alabaster.readthedocs.io/en/latest/customization.html#theme-options
+html_theme_options = {
+    "footer_start": ["copyright"],
+    "footer_end": ["version"],
+    'use_edit_page_button': True,
+}
+html_context = {
+    "gitlab_user": "ikus-soft",
+    "gitlab_repo": "cherrypy-foundation",
+    "gitlab_version": "main",
+    "doc_path": "doc",
+}
+html_show_sourcelink = False
+
+# Add any paths that contain custom static files (such as style sheets) here,
+# relative to this directory. They are copied after the builtin static files,
+# so a file named "default.css" will overwrite the builtin "default.css".
+#html_static_path = ['_static']

cherrypy_foundation-1.0.0a17/doc/error_page.md

@@ -0,0 +1,163 @@
+# Error Pages
+
+The `error_page` utility replaces CherryPy's default error pages with a more flexible error handler.  
+It generates error responses based on the response `Content-Type`, returning either:
+
+- an HTML page (default),
+- a JSON error response for `application/json`
+- plain text for `text/plain`.
+
+If available, the HTML error page is rendered using Jinja2 with a template named `error_page.html`.
+
+⚠️ **Note:** For 404 errors, the error handler sanitizes the error message to avoid leaking path information. A generic message is returned instead of exposing the requested path.
+
+## Setup
+
+```python
+from cherrypy_foundation.error_page import error_page
+
+cherrypy.config.update({
+    'error_page.default': error_page,
+})
+```
+
+## Features
+
+### Content Negotiation
+
+The error handler automatically detects the expected response format:
+
+**HTML Response** (default for browsers):
+```http
+GET /invalid-page HTTP/1.1
+Accept: text/html
+
+HTTP/1.1 404 Not Found
+Content-Type: text/html
+
+<!DOCTYPE html>
+<html>
+  <head><title>404 Not Found</title></head>
+  <body>
+    <h2>404 Not Found</h2>
+    <p>Nothing matches the given URI</p>
+  </body>
+</html>
+```
+
+**JSON Response** (for API clients):
+```http
+GET /api/invalid HTTP/1.1
+Accept: application/json
+
+HTTP/1.1 404 Not Found
+Content-Type: application/json
+
+{"message": "Nothing matches the given URI", "status": "404 Not Found"}
+```
+
+**Plain Text Response**:
+```http
+GET /invalid HTTP/1.1
+Accept: text/plain
+
+HTTP/1.1 404 Not Found
+Content-Type: text/plain
+
+Nothing matches the given URI
+```
+
+### Server Error Logging
+
+All internal server error 500 are automatically logged with full traceback information:
+
+```python
+@cherrypy.expose
+def broken(self):
+    raise ValueError("Something went wrong!")
+    
+# Logs: error page status=500 Internal Server Error message=ValueError: Something went wrong!
+#       [full traceback]
+```
+
+### Custom Error Pages with Jinja2
+
+To use custom error page templates, create an `error_page.html` template in your Jinja2 environment:
+
+The following variables are available in the `error_page.html` template:
+
+- `status` (str): HTTP status code and message (e.g., "404 Not Found")
+- `message` (str): Detailed error message
+- `traceback` (str): Stack trace (only for server errors when debug mode is enabled)
+- `version` (str): CherryPy version
+
+
+```html
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8">
+    <title>{{ status }}</title>
+    <link rel="stylesheet" href="/static/css/bootstrap.min.css">
+  </head>
+  <body>
+    <div class="container mt-5">
+      <div class="alert alert-danger">
+        <h1>{{ status }}</h1>
+        <p>{{ message }}</p>
+        
+        {% if traceback %}
+        <details>
+          <summary>Technical Details</summary>
+          <pre>{{ traceback }}</pre>
+        </details>
+        {% endif %}
+      </div>
+    </div>
+  </body>
+</html>
+```
+
+## Complete Example
+
+```python
+import cherrypy
+from cherrypy_foundation.error_page import error_page
+
+# Setup Jinja2
+env = cherrypy.tools.jinja2.create_env(
+    package_name=__package__,
+)
+
+# Configure error handler
+cherrypy.config.update({
+    'error_page.default': error_page,
+})
+
+@cherrypy.tools.jinja2(env=env)
+class Root:
+    
+    @cherrypy.expose
+    @cherrypy.tools.jinja2(template='index.html')
+    def index(self):
+        return {}
+    
+    @cherrypy.expose
+    def not_found(self):
+        # Will trigger 404 error page
+        raise cherrypy.NotFound()
+    
+    @cherrypy.expose
+    def server_error(self):
+        # Will trigger 500 error page with logging
+        raise ValueError("Database connection failed")
+    
+    @cherrypy.expose
+    @cherrypy.tools.json_out()
+    def api_endpoint(self):
+        # API errors will return JSON
+        raise cherrypy.HTTPError(400, "Invalid request parameters")
+
+if __name__ == '__main__':
+    cherrypy.quickstart(Root())
+```