django-program 0.1.0__tar.gz

django_program-0.1.0/PKG-INFO

@@ -0,0 +1,56 @@
+Metadata-Version: 2.3
+Name: django-program
+Version: 0.1.0
+Summary: Modern conference management plugin for Django
+Keywords: django,conference,registration,program,schedule,tickets
+Author: Jacob Coffee
+Author-email: Jacob Coffee <jacob@python.org>
+License: MIT
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Web Environment
+Classifier: Framework :: Django
+Classifier: Framework :: Django :: 5.2
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Topic :: Internet :: WWW/HTTP
+Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Dist: django>=5.2
+Requires-Dist: django-fernet-encrypted-fields>=0.3.1
+Requires-Dist: pillow>=12.1.1
+Requires-Dist: pretalx-client>=0.1.0
+Requires-Dist: stripe>=12.0.0
+Requires-Python: >=3.14
+Project-URL: Changelog, https://github.com/JacobCoffee/django-program/releases/
+Project-URL: Documentation, https://jacobcoffee.github.io/django-program
+Project-URL: Issue Tracker, https://github.com/JacobCoffee/django-program/issues
+Project-URL: Repository, https://github.com/JacobCoffee/django-program
+Description-Content-Type: text/markdown
+
+An attempt to modernize the conference workflow.
+
+Inspirations
+- [Symposion](https://github.com/pinax/symposion)
+- [Registrasion](https://github.com/chrisjrn/registrasion)
+
+## Example Dev Server
+
+A runnable Django project lives in `examples/` for interacting with models via the admin, shell, and management commands.
+
+```bash
+make dev
+# Visit http://localhost:8000/admin/  (login: admin/admin)
+```
+
+Or step by step:
+
+```bash
+uv run python examples/manage.py migrate
+uv run python examples/manage.py bootstrap_conference --config conference.example.toml
+uv run python examples/manage.py createsuperuser
+uv run python examples/manage.py runserver
+```

django_program-0.1.0/README.md

@@ -0,0 +1,23 @@
+An attempt to modernize the conference workflow.
+
+Inspirations
+- [Symposion](https://github.com/pinax/symposion)
+- [Registrasion](https://github.com/chrisjrn/registrasion)
+
+## Example Dev Server
+
+A runnable Django project lives in `examples/` for interacting with models via the admin, shell, and management commands.
+
+```bash
+make dev
+# Visit http://localhost:8000/admin/  (login: admin/admin)
+```
+
+Or step by step:
+
+```bash
+uv run python examples/manage.py migrate
+uv run python examples/manage.py bootstrap_conference --config conference.example.toml
+uv run python examples/manage.py createsuperuser
+uv run python examples/manage.py runserver
+```

django_program-0.1.0/pyproject.toml

@@ -0,0 +1,344 @@
+[build-system]
+build-backend = "uv_build"
+requires = ["uv_build>=0.9.11,<0.11.0"]
+
+[dependency-groups]
+docs = [
+  "linkify-it-py>=2.0.0",
+  "myst-parser>=2.0.0",
+  "shibuya>=2024.8.0",
+  "sphinx>=7.0.0",
+  "sphinx-autobuild>=2024.0.0",
+  "sphinx-autodoc-typehints>=2.0.0",
+  "sphinx-copybutton>=0.5.0",
+  "sphinx-design>=0.5.0",
+]
+lint = ["codespell>=2.2.6", "prek>=0.2.18", "ruff>=0.8.0", "ty>=0.0.1a27"]
+test = [
+  "model-bakery>=1.20.0",
+  "pytest>=8.1.1",
+  "pytest-cov>=4.1.0",
+  "pytest-django>=4.9.0",
+  "pytest-sugar>=1.1.1",
+  "pytest-xdist>=3.8.0",
+]
+dev = [
+  { include-group = "docs" },
+  { include-group = "lint" },
+  { include-group = "test" },
+  "python-dotenv>=1.2.1",
+]
+
+[project]
+authors = [{ name = "Jacob Coffee", email = "jacob@python.org" }]
+classifiers = [
+  "Development Status :: 3 - Alpha",
+  "Environment :: Web Environment",
+  "Framework :: Django",
+  "Framework :: Django :: 5.2",
+  "Intended Audience :: Developers",
+  "License :: OSI Approved :: MIT License",
+  "Operating System :: OS Independent",
+  "Programming Language :: Python",
+  "Programming Language :: Python :: 3.14",
+  "Programming Language :: Python :: 3 :: Only",
+  "Topic :: Internet :: WWW/HTTP",
+  "Topic :: Internet :: WWW/HTTP :: Dynamic Content",
+  "Topic :: Software Development :: Libraries :: Python Modules",
+]
+dependencies = [
+    "django>=5.2",
+    "django-fernet-encrypted-fields>=0.3.1",
+    "pillow>=12.1.1",
+    "pretalx-client>=0.1.0",
+    "stripe>=12.0.0",
+]
+description = "Modern conference management plugin for Django"
+keywords = [
+  "django",
+  "conference",
+  "registration",
+  "program",
+  "schedule",
+  "tickets",
+]
+license = { text = "MIT" }
+name = "django-program"
+readme = "README.md"
+requires-python = ">=3.14"
+version = "0.1.0"
+
+[project.urls]
+Changelog = "https://github.com/JacobCoffee/django-program/releases/"
+Documentation = "https://jacobcoffee.github.io/django-program"
+"Issue Tracker" = "https://github.com/JacobCoffee/django-program/issues"
+Repository = "https://github.com/JacobCoffee/django-program"
+
+[tool.codespell]
+skip = "uv.lock"
+
+[tool.coverage.report]
+exclude_lines = [
+  "pragma: no cover",
+  "if TYPE_CHECKING:",
+  "raise NotImplementedError",
+  "\\.\\.\\.",
+  "@abstractmethod",
+  "class .*(Protocol):",
+]
+fail_under = 100
+
+[tool.coverage.run]
+concurrency = ["multiprocessing", "thread"]
+omit = ["*/tests/*"]
+parallel = true
+source = ["django_program"]
+
+[tool.git-cliff.changelog]
+header = """
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+"""
+body = """
+{% if version %}\
+    {% if previous.version %}\
+## [{{ version | trim_start_matches(pat="v") }}]($REPO/compare/{{ previous.version }}..{{ version }}) - {{ timestamp | date(format="%Y-%m-%d") }}
+    {% else %}\
+## [{{ version | trim_start_matches(pat="v") }}] - {{ timestamp | date(format="%Y-%m-%d") }}
+    {% endif %}\
+{% else %}\
+## [unreleased]
+{% endif %}\
+{% for group, commits in commits | group_by(attribute="group") %}
+
+### {{ group | striptags | trim | upper_first }}
+
+{% for commit in commits
+| filter(attribute="scope")
+| sort(attribute="scope") %}
+- **({{commit.scope}})**{% if commit.breaking %} [**breaking**]{% endif %} {{ commit.message }} - ([{{ commit.id | truncate(length=7, end="") }}]($REPO/commit/{{ commit.id }})) - {{ commit.author.name }}
+{%- endfor -%}
+{%- for commit in commits %}
+{%- if commit.scope -%}
+{% else %}
+- {% if commit.breaking %}[**breaking**] {% endif %}{{ commit.message }} - ([{{ commit.id | truncate(length=7, end="") }}]($REPO/commit/{{ commit.id }})) - {{ commit.author.name }}
+{% endif -%}
+{% endfor -%}
+{% endfor %}
+"""
+footer = """
+---
+*django-program Changelog*
+"""
+output = "docs/changelog.md"
+postprocessors = [
+  { pattern = '\$REPO', replace = "https://github.com/JacobCoffee/django-program" },
+]
+trim = true
+
+[tool.git-cliff.git]
+commit_parsers = [
+  { message = "^feat", group = "Features" },
+  { message = "^fix", group = "Bug Fixes" },
+  { message = "^doc", group = "Documentation" },
+  { message = "^perf", group = "Performance" },
+  { message = "^refactor", group = "Refactoring" },
+  { message = "^style", group = "Style" },
+  { message = "^revert", group = "Revert" },
+  { message = "^test", group = "Tests" },
+  { message = "^chore\\(version\\):", skip = true },
+  { message = "^chore", group = "Miscellaneous Chores" },
+  { body = ".*security", group = "Security" },
+]
+conventional_commits = true
+filter_unconventional = true
+sort_commits = "oldest"
+tag_pattern = "v[0-9].*"
+
+[tool.pytest.ini_options]
+addopts = [
+  "--strict-markers",
+  "--tb=short",
+  "-n", "auto",
+  "-p", "no:pastebin",
+  "-p", "no:doctest",
+  "-p", "no:legacypath",
+]
+DJANGO_SETTINGS_MODULE = "tests.settings"
+filterwarnings = [
+  "error",
+  "ignore:The default scheme will be changed:DeprecationWarning",
+]
+markers = [
+  "unit: mark test as unit test",
+  "integration: mark test as integration test",
+  "e2e: mark test as end-to-end test",
+]
+norecursedirs = ["docs", "*.egg-info", ".git", ".tox", "dist", "build", "refcode", "examples"]
+python_classes = ["Test*"]
+python_files = ["test_*.py"]
+python_functions = ["test_*"]
+pythonpath = ["."]
+testpaths = ["tests"]
+
+[tool.ruff]
+exclude = ["refcode/"]
+fix = true
+line-length = 120
+src = ["src/django_program", "tests", "packages/pretalx-client/src/pretalx_client"]
+target-version = "py314"
+
+[tool.ruff.format]
+docstring-code-format = true
+docstring-code-line-length = 88
+indent-style = "space"
+quote-style = "double"
+
+[tool.ruff.lint]
+fixable = ["ALL"]
+ignore = [
+  "COM812", # Missing trailing comma (conflicts with formatter)
+  "ISC001", # Single-line string concatenation (conflicts with formatter)
+  "ERA001", # Commented-out code
+  "TD",     # TODOs
+  "FIX002", # Line contains TODO
+  "EM101",  # Exception string literal
+  "EM102",  # Exception f-string literal
+  "TRY003", # Long exception message
+  "RUF012", # Mutable class attributes (Django uses these extensively)
+  "D105",   # Missing docstring in magic method (__str__ etc.)
+  "D106",   # Missing docstring in public nested class (Django Meta)
+  "DJ001",  # Avoid using null=True on string fields (not always applicable)
+]
+select = ["ALL"]
+
+[tool.ruff.lint.isort]
+known-first-party = ["django_program", "pretalx_client", "tests"]
+
+[tool.ruff.lint.per-file-ignores]
+"**/migrations/**/*.*" = [
+  "ANN",    # Type annotations
+  "D",      # Docstrings
+  "E501",   # Line too long (auto-generated)
+  "INP001", # Implicit namespace package
+]
+"**/management/**/*.*" = [
+  "ANN401",  # Any in management command signatures (Django convention)
+  "ARG002",  # Unused *args in handle() (Django convention)
+  "N806",    # User = get_user_model() (Django convention)
+  "PLR2004", # Magic values in verbosity checks
+]
+"docs/conf.py" = [
+  "A001",   # Variable shadowing builtin
+  "INP001", # Implicit namespace package
+  "PTH",    # Use pathlib
+  "DTZ",    # Datetime timezone
+]
+"examples/**/*.*" = [
+  "INP001", # Implicit namespace package (standalone Django project)
+  "PLC0415", # Import not at top level (Django manage.py pattern)
+  "S105",   # Hardcoded secret key (dev-only)
+]
+"scripts/**/*.*" = [
+  "D",        # Docstrings (utility scripts)
+  "INP001",   # Implicit namespace package
+  "S",        # Security (local dev scripts)
+  "T201",     # Print statements (CLI scripts)
+  "ANN",      # Type annotations (utility scripts)
+  "C901",     # Complexity (codegen functions are inherently complex)
+  "PLR0912",  # Too many branches (codegen)
+  "PLR0915",  # Too many statements (codegen)
+]
+"packages/**/tests/**/*.*" = [
+  "A",
+  "ANN",
+  "ARG",
+  "B",
+  "BLE",
+  "C901",
+  "D",
+  "DTZ",
+  "EM",
+  "ERA001",
+  "F841",
+  "FBT",
+  "G",
+  "N",
+  "PGH",
+  "PIE",
+  "PLR",
+  "PLW",
+  "PTH",
+  "RET504",
+  "RSE",
+  "S",
+  "S101",
+  "SIM",
+  "SLF001",
+  "TCH",
+  "TRY",
+  "UP006",
+]
+"tests/**/*.*" = [
+  "A",
+  "ANN",
+  "ARG",
+  "B",
+  "BLE",
+  "C901",
+  "D",
+  "DTZ",
+  "EM",
+  "ERA001",
+  "F841",
+  "FBT",
+  "G",
+  "N",
+  "PGH",
+  "PIE",
+  "PLR",
+  "PLW",
+  "PTH",
+  "RET504",
+  "RSE",
+  "S",
+  "S101",
+  "SIM",
+  "SLF001",
+  "TCH",
+  "TRY",
+  "UP006",
+]
+
+[tool.ruff.lint.pydocstyle]
+convention = "google"
+
+[tool.ty]
+
+[tool.ty.environment]
+python = ".venv"
+
+[tool.ty.rules]
+deprecated = "warn"
+# Django's ORM dynamically adds .objects, so ty can't resolve it
+unresolved-attribute = "warn"
+# Django field types (CharField etc.) don't resolve to Python builtins
+invalid-return-type = "warn"
+# Django field descriptors don't implement SupportsInt/SupportsIndex protocols
+unsupported-operator = "warn"
+invalid-argument-type = "warn"
+
+[tool.ty.src]
+exclude = ["docs/conf.py", "tests/", "refcode/", "packages/*/tests/", "scripts/"]
+
+[tool.uv]
+default-groups = ["dev"]
+constraint-dependencies = ["django>=5.2,<5.3"]
+
+[tool.uv.sources]
+pretalx-client = { workspace = true }
+
+[tool.uv.workspace]
+members = ["packages/*"]

django_program-0.1.0/src/django_program/__init__.py

@@ -0,0 +1,5 @@
+"""Modern conference management for Django."""
+
+from django_program.__metadata__ import __version__
+
+__all__ = ["__version__"]

django_program-0.1.0/src/django_program/__metadata__.py

@@ -0,0 +1,3 @@
+"""django-program metadata."""
+
+__version__ = "0.1.0"

django_program-0.1.0/src/django_program/conference/__init__.py

@@ -0,0 +1 @@
+"""Conference and section management for django-program."""

django_program-0.1.0/src/django_program/conference/admin.py

@@ -0,0 +1,150 @@
+"""Django admin configuration for the conference app."""
+
+from django import forms
+from django.contrib import admin
+
+from django_program.conference.models import Conference, Section
+
+SECRET_PLACEHOLDER = "\u2022" * 12
+
+
+class SecretInput(forms.PasswordInput):
+    """Password widget that shows a placeholder instead of the real value.
+
+    When a value already exists in the database the widget renders
+    ``SECRET_PLACEHOLDER`` as the visible value so admins know a key is
+    set, but the actual secret never appears in the HTML source. Submitting
+    the placeholder (or an empty string) signals "keep existing value".
+    """
+
+    def format_value(self, value: str | None) -> str:
+        """Return a dot placeholder when a value exists, empty string otherwise."""
+        if value:
+            return SECRET_PLACEHOLDER
+        return ""
+
+
+class SecretField(forms.CharField):
+    """Char field that preserves the stored value when left unchanged.
+
+    Works with ``SecretInput``: if the submitted value is empty or equals
+    the placeholder, the field returns the original database value so
+    secrets are never accidentally blanked.
+    """
+
+    widget = SecretInput
+
+    def __init__(self, **kwargs: object) -> None:
+        """Set sensible defaults for secret fields."""
+        kwargs.setdefault("required", False)
+        super().__init__(**kwargs)
+        self.widget.attrs.setdefault("autocomplete", "off")
+
+    def has_changed(self, initial: str | None, data: str | None) -> bool:
+        """Treat placeholder or blank submissions as unchanged."""
+        if not data or data == SECRET_PLACEHOLDER:
+            return False
+        return super().has_changed(initial, data)
+
+    def clean(self, value: str | None) -> str | None:
+        """Return the stored value when the field is left blank or unchanged."""
+        if not value or value == SECRET_PLACEHOLDER:
+            return self.initial
+        return super().clean(value)
+
+
+_STRIPE_FIELDS = ("stripe_secret_key", "stripe_publishable_key", "stripe_webhook_secret")
+
+
+class ConferenceForm(forms.ModelForm):
+    """Custom form that masks Stripe secret fields in the admin.
+
+    Uses ``SecretField`` / ``SecretInput`` so decrypted values are never
+    present in the rendered HTML. Admins see a dot placeholder when a
+    value is set; leaving the field unchanged preserves the stored secret.
+    """
+
+    stripe_secret_key = SecretField()
+    stripe_publishable_key = SecretField()
+    stripe_webhook_secret = SecretField()
+
+    class Meta:
+        model = Conference
+        exclude: list[str] = []
+
+
+class SectionInline(admin.TabularInline):
+    """Inline editor for conference sections.
+
+    Allows adding and editing sections directly from the conference
+    admin change form.
+    """
+
+    model = Section
+    extra = 1
+    prepopulated_fields = {"slug": ("name",)}
+    fields = ("name", "slug", "start_date", "end_date", "order")
+
+
+@admin.register(Conference)
+class ConferenceAdmin(admin.ModelAdmin):
+    """Admin interface for managing conferences.
+
+    Groups fields into logical fieldsets: basic information, dates,
+    third-party integrations (Pretalx and Stripe), and status metadata.
+    Sections are editable inline via ``SectionInline``.
+    """
+
+    form = ConferenceForm
+    list_display = ("name", "slug", "start_date", "end_date", "is_active")
+    list_filter = ("is_active",)
+    search_fields = ("name", "slug")
+    prepopulated_fields = {"slug": ("name",)}
+    inlines = (SectionInline,)
+
+    fieldsets = (
+        (
+            None,
+            {
+                "fields": ("name", "slug", "venue", "address", "website_url"),
+            },
+        ),
+        (
+            "Dates",
+            {
+                "fields": ("start_date", "end_date", "timezone"),
+            },
+        ),
+        (
+            "Integrations",
+            {
+                "fields": (
+                    "pretalx_event_slug",
+                    "stripe_secret_key",
+                    "stripe_publishable_key",
+                    "stripe_webhook_secret",
+                ),
+                "classes": ("collapse",),
+            },
+        ),
+        (
+            "Status",
+            {
+                "fields": ("is_active",),
+            },
+        ),
+    )
+
+
+@admin.register(Section)
+class SectionAdmin(admin.ModelAdmin):
+    """Admin interface for managing conference sections.
+
+    Provides filtering by conference and search by name or slug.
+    The slug field is auto-populated from the section name.
+    """
+
+    list_display = ("name", "conference", "start_date", "end_date", "order")
+    list_filter = ("conference",)
+    search_fields = ("name", "slug")
+    prepopulated_fields = {"slug": ("name",)}

django_program-0.1.0/src/django_program/conference/apps.py

@@ -0,0 +1,12 @@
+"""Django app configuration for the conference app."""
+
+from django.apps import AppConfig
+
+
+class DjangoProgramConferenceConfig(AppConfig):
+    """Configuration for the conference app."""
+
+    default_auto_field = "django.db.models.BigAutoField"
+    name = "django_program.conference"
+    label = "program_conference"
+    verbose_name = "Conference"

django_program-0.1.0/src/django_program/conference/management/__init__.py

@@ -0,0 +1 @@
+"""Management commands for the conference app."""

django_program-0.1.0/src/django_program/conference/management/commands/__init__.py

@@ -0,0 +1 @@
+"""Conference management commands."""