Robert Helewka r

0 Followers · 0 Following

• Toronto, Ontario
• https://helu.ca
• Joined on 2026-02-14

Repositories

7

Projects Packages Code Public Activity Starred Repositories

django-heluca-themis (1.1.2)

Published 2026-07-12 21:32:16 +00:00 by r

Installation

To install the package using pip, run the following command:

pip install --index-url  --extra-index-url https://pypi.org/simple django-heluca-themis

For more information on the PyPI registry, see the documentation.

About this package

Django app providing user preferences, theme management, API key management, Casdoor SSO adapters, and standard navigation templates

Themis

Reusable Django app providing user preferences, DaisyUI theme management, API key management, and standard navigation templates for all Heluca applications.

Themis — titan of order, custom, and law.

Features

• User Preferences — timezone (home + traveling), date/time/number formatting, week start day
• DaisyUI Themes — 32 built-in themes, separate light/dark selection, auto (system) mode
• Notifications — in-app notification bell, JS polling, browser desktop notifications, user preferences
• API Key Management — encrypted storage with per-key instructions and documentation links
• Standard Navigation — consistent navbar, user menu, notification bell, theme toggle, and bottom nav across all apps
• Middleware — automatic timezone activation and theme context
• Formatting Utilities — date, time, number formatting respecting user preferences
• Health Checks — Kubernetes-ready /ready/ and /live/ endpoints
• REST API — complete API for profiles, keys, and notifications

Installation

pip install git+ssh://git@git.helu.ca:22022/r/themis.git

Quick Start

1. Add to INSTALLED_APPS:

INSTALLED_APPS = [
    ...
    "rest_framework",
    "themis",
    ...
]

2. Configure middleware:

MIDDLEWARE = [
    ...
    "themis.middleware.TimezoneMiddleware",
    "themis.middleware.ThemeMiddleware",
    ...
]

3. Configure context processors:

TEMPLATES = [{
    "OPTIONS": {
        "context_processors": [
            ...
            "themis.context_processors.themis_settings",
            "themis.context_processors.user_preferences",
            "themis.context_processors.notifications",
            "themis.context_processors.navigation",
        ],
    },
}]

4. Include URLs:

urlpatterns = [
    ...
    path("", include("themis.urls")),
    path("api/v1/", include("themis.api.urls")),
    ...
]

5. Configure app settings:

THEMIS_APP_NAME = "My Application"

# Register navigation entries (block-based extension can't cross {% include %},
# so the chrome iterates these instead). Each entry: label, named URL, optional
# SVG icon `d` path. Bad url_names are skipped with a warning, not a 500.
THEMIS_NAV_ITEMS = [
    {"label": "Home", "url_name": "core:home"},
    {"label": "Mail", "url_name": "mail:account_list"},
]
THEMIS_USER_MENU_ITEMS = [
    {"label": "Mail Accounts", "url_name": "mail:account_list"},
]

6. Run migrations:

python manage.py migrate

7. Extend the base template:

{% extends "themis/base.html" %}

{% block nav_items %}
<li><a href="{% url 'dashboard' %}">Dashboard</a></li>
{% endblock %}

{% block content %}
<h1 class="text-2xl font-bold">My App</h1>
{% endblock %}

Casdoor SSO (optional)

Themis ships generic django-allauth adapters for Casdoor OIDC. They map the Casdoor groups claim to Django groups, set is_staff from configurable staff groups, and block superusers from SSO (they must use local auth).

SOCIALACCOUNT_ADAPTER = "themis.adapters.CasdoorAccountAdapter"
ACCOUNT_ADAPTER = "themis.adapters.LocalAccountAdapter"

Optional settings:

• THEMIS_STAFF_GROUPS — Casdoor groups granting is_staff (default ["staff", "sme", "admin"]).
• THEMIS_GROUP_MAPPING — Casdoor group name → Django group name.
• THEMIS_ORG_ADAPTER — dotted path to fn(user, org_identifier) invoked with the Casdoor organization claim, for apps with an Organization model. Omit it (the default) to skip organization mapping.

For sandbox environments with self-signed Casdoor certs, import the SSL bypass at the top of settings.py before any requests are made (activates only when CASDOOR_SSL_VERIFY=false):

import themis.ssl_patch  # noqa: F401

Documentation

• Themis App — Full documentation
• Notification Trigger Pattern — How to trigger notifications from your app
• Organization Pattern — Standard Organization model pattern
• Red Panda Standards — Django development standards
• Documentation Style Guide — Documentation standards

🐾 Red Panda Approval™

This project follows Red Panda Approval standards — our gold standard for Django application quality.

The 5 Sacred Django Criteria

1. Fresh Migration Test — Clean migrations from empty database
2. Elegant Simplicity — No unnecessary complexity
3. Observable & Debuggable — Proper logging and error handling
4. Consistent Patterns — Follow Django conventions
5. Actually Works — Passes all checks and serves real user needs

License

MIT License — see LICENSE file for details.

Author

Robert Helewka r@helu.ca

Package Information

• Package Name: django-heluca-themis
• Version: 1.0.0
• Django: >=5.2, <6.0
• Python: >=3.10

Requirements

Requires Python: >=3.10

Details

PyPI

2026-07-12 21:32:16 +00:00

23

Project Site

MIT

115 KiB

Assets (2)

django_heluca_themis-1.1.2-py3-none-any.whl 65 KiB

django_heluca_themis-1.1.2.tar.gz 49 KiB

Versions (3) View all

1.4.0 2026-08-07

1.2.0 2026-07-22

1.1.2 2026-07-12