picata 0.0.1__py3-none-any.whl → 0.0.2__py3-none-any.whl

README.md

@@ -1,59 +1,9 @@
-# Ada's website
+# Picata
 
-Wherein I set up a little website, and learn a bunch of stuff as I go.
+**This project is very much pre-alpha**
 
-## What it's made of
-
-### Inside the box
-
-- [Wagtail](https://wagtail.org) (on [Django](https://www.djangoproject.com)) is the web framework
-<!-- - [Tailwind CSS](https://tailwindcss.com) for styling -->
-
-### Holding things together
-
-- [UV](https://github.com/astral-sh/uv) for all Python project management
-- [Just](https://just.systems) as a command runner
-- [OpenTofu](https://opentofu.org) for DevOps
-- [Postgres](https://www.postgresql.org) for the database
-- [Docker](https://www.docker.com) for local development
-
-## Quickstart
-
-### Requirements
-
-- On a Mac:
-
-```shell
-brew install colima docker
-```
-
-### Run a development server
-
-```shell
-just tofu workspace select dev
-just tofu apply
-```
-
-This will spin up a box on DigitalOcean using the settings defined in
-[infra/variables.tf](infra/variables.tf), and create a DNS A record at
-(workspace).for.(tld), (i.e. dev.for.hpk.io) pointing to the box. The variables
-`do_token` and `ssh_fingerprint` should be defined in
-[infra/secrets.tfvars](infra/secrets.tfvars). Workspace-specific variables are
-defined in infra/envs/(workspace).tfvars; e.g.
-[infra/envs/dev.tfvars](infra/envs/dev.tfvars) defines the 'tags' list for the
-box as `[development]` and sets `cloud_init_config` to point to the
-[cloud-init](https://cloud-init.io) script
-[config/cloud-init-dev.yml](config/cloud-init-dev.yml).
-
-The development cloud-init script will:
-
-- Install the system packages [`just`](https://just.systems), [`zsh`](https://www.zsh.org),
-  [`gunicorn`](https://gunicorn.org), and `tree`
-- Create a 'wagtail' user, with UID 1500
-- Create the 'ada' user, and:
-  - install their SSH public keys,
-  - install their dotfiles,
-  - add them to the 'sudo' and 'wagtail' groups
-- Install [Node](http://nodejs.org) on the system, from the `TF_VAR_NODE_VERSION`
-  defined in [.env](.env)
-- Checkout this repository into `/app`, setting the owner and group to 'wagtail'.
+Picata is the CMS & blog application I've forked off from my personal website.
+It's effectively a ton of pre-made Wagtail "stuff" (models, views, templatetags,
+middleware, hooks, etc.), made generic enough that you can include this app
+in your `INSTALLED_APPS` and have a CMS/blog up-and-running without having to
+spend weeks or months tailoring Wagtail to your needs.

manage.py

@@ -5,7 +5,7 @@ from os import environ
 from sys import argv
 
 if __name__ == "__main__":
-    environ.setdefault("DJANGO_SETTINGS_MODULE", "hpk.settings.dev")
+    environ.setdefault("DJANGO_SETTINGS_MODULE", "picata.settings.dev")
 
     if len(argv) >= 2:  # noqa: PLR2004
         environ.setdefault("DJANGO_MANAGEMENT_COMMAND", argv[1])

picata/__init__.py

@@ -1 +1 @@
-"""Main "umbrella" package for custom code running hpk.io."""
+"""Top-level package for the Picata project."""

picata/apps.py

@@ -1,13 +1,13 @@
-"""Application configuration for the hpk Django app."""
+"""Application configuration for the Picata Django app."""
 
 from django.apps import AppConfig
 
 
 class Config(AppConfig):
-    """Configuration class for the hpk Django application."""
+    """Configuration class for the Picata Django application."""
 
     default_auto_field = "django.db.models.BigAutoField"
-    name = "hpk"
+    name = "picata"
 
     def ready(self) -> None:
         """Configure Wagtail admin with custom models, and register document transformers."""
@@ -15,13 +15,13 @@ class Config(AppConfig):
         # Register the 'custom article type' model with the Wagtail admin
         from wagtail_modeladmin.options import modeladmin_register
 
-        from hpk.models import ArticleTypeAdmin
+        from picata.models import ArticleTypeAdmin
 
         modeladmin_register(ArticleTypeAdmin)
 
         # Add document transformers to the HTMLProcessingMiddleware
-        from hpk.middleware import HTMLProcessingMiddleware
-        from hpk.transformers import AnchorInserter, add_heading_ids
+        from picata.middleware import HTMLProcessingMiddleware
+        from picata.transformers import AnchorInserter, add_heading_ids
 
         ## Add ids to all headings missing them within html > body > main
         HTMLProcessingMiddleware.add_transformer(add_heading_ids)

picata/blocks.py

@@ -3,8 +3,6 @@
 import pygments
 from django.forms import CharField
 from django.utils.html import format_html
-from hpk.typing.wagtail import BlockRenderContext, BlockRenderValue
-from hpk.validators import HREFValidator
 from pygments import formatters, lexers
 from pygments.util import ClassNotFound
 from wagtail.blocks import (
@@ -20,6 +18,9 @@ from wagtail.blocks import (
 )
 from wagtail.images.blocks import ImageChooserBlock
 
+from picata.typing.wagtail import BlockRenderContext, BlockRenderValue
+from picata.validators import HREFValidator
+
 
 class HREFField(CharField):
     """Custom field for href attributes (i.e. URLs but also schemes like 'mailto:')."""

picata/helpers/wagtail.py

@@ -8,7 +8,7 @@ from django.http import HttpRequest
 from wagtail.models import Page
 from wagtail.query import PageQuerySet
 
-from hpk.models import TaggedPage
+from picata.models import TaggedPage
 
 from . import get_models_of_type
 

picata/middleware.py

@@ -8,7 +8,7 @@ from typing import ClassVar
 from django.http import HttpRequest, HttpResponse
 from lxml import etree
 
-from hpk.helpers import make_response
+from picata.helpers import make_response
 
 logger = logging.getLogger(__name__)
 

picata/migrations/0001_initial.py

@@ -1,264 +1,130 @@
-# Generated by Django 5.1.4 on 2024-12-19 01:11
+# Generated by Django 5.1.5 on 2025-01-24 00:18
 
 import django.db.models.deletion
 import modelcluster.contrib.taggit
 import modelcluster.fields
+import wagtail.contrib.routable_page.models
 import wagtail.fields
 from django.db import migrations, models
 
 
 class Migration(migrations.Migration):
+
     initial = True
 
     dependencies = [
-        ("taggit", "0006_rename_taggeditem_content_type_object_id_taggit_tagg_content_8fc721_idx"),
-        ("wagtailcore", "0094_alter_page_locale"),
+        ('wagtailcore', '0094_alter_page_locale'),
+        ('wagtailimages', '0027_image_description'),
     ]
 
     operations = [
         migrations.CreateModel(
-            name="Article",
+            name='ArticleType',
+            fields=[
+                ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
+                ('name', models.CharField(help_text='Name of the article type.', max_length=100, unique=True)),
+                ('_Pluralised_name', models.CharField(blank=True, help_text="Plural form of the article type name (optional). Defaults to appending 's'.", max_length=100)),
+                ('slug', models.SlugField(max_length=100, unique=True)),
+                ('description', models.TextField(blank=True, help_text='Optional description of this type.')),
+            ],
+        ),
+        migrations.CreateModel(
+            name='BasicPage',
             fields=[
-                (
-                    "page_ptr",
-                    models.OneToOneField(
-                        auto_created=True,
-                        on_delete=django.db.models.deletion.CASCADE,
-                        parent_link=True,
-                        primary_key=True,
-                        serialize=False,
-                        to="wagtailcore.page",
-                    ),
-                ),
-                (
-                    "summary",
-                    wagtail.fields.RichTextField(
-                        blank=True, help_text="A short summary, or tagline for the article."
-                    ),
-                ),
-                (
-                    "content",
-                    wagtail.fields.StreamField(
-                        [("section", 5), ("image", 3)],
-                        blank=True,
-                        block_lookup={
-                            0: (
-                                "wagtail.blocks.CharBlock",
-                                (),
-                                {"help_text": "Heading for this section.", "required": True},
-                            ),
-                            1: (
-                                "wagtail.blocks.IntegerBlock",
-                                (),
-                                {
-                                    "help_text": "Heading level",
-                                    "max_value": 6,
-                                    "min_value": 1,
-                                    "required": True,
-                                },
-                            ),
-                            2: (
-                                "wagtail.blocks.RichTextBlock",
-                                (),
-                                {
-                                    "features": [
-                                        "bold",
-                                        "italic",
-                                        "link",
-                                        "ul",
-                                        "ol",
-                                        "document-link",
-                                    ]
-                                },
-                            ),
-                            3: ("wagtail.images.blocks.ImageChooserBlock", (), {}),
-                            4: (
-                                "wagtail.blocks.StreamBlock",
-                                [[("rich_text", 2), ("image", 3)]],
-                                {
-                                    "help_text": "Content blocks for this section.",
-                                    "required": False,
-                                },
-                            ),
-                            5: (
-                                "wagtail.blocks.StructBlock",
-                                [[("heading", 0), ("level", 1), ("content", 4)]],
-                                {},
-                            ),
-                        },
-                        help_text="Main content for the article.",
-                    ),
-                ),
+                ('page_ptr', models.OneToOneField(auto_created=True, on_delete=django.db.models.deletion.CASCADE, parent_link=True, primary_key=True, serialize=False, to='wagtailcore.page')),
+                ('content', wagtail.fields.StreamField([('rich_text', 0), ('code', 3), ('image', 4)], blank=True, block_lookup={0: ('wagtail.blocks.RichTextBlock', (), {}), 1: ('wagtail.blocks.TextBlock', (), {'help_text': None, 'required': True}), 2: ('wagtail.blocks.ChoiceBlock', [], {'choices': [('python', 'Python'), ('javascript', 'JavaScript'), ('html', 'HTML'), ('css', 'CSS'), ('bash', 'Bash'), ('plaintext', 'Plain Text')], 'required': False}), 3: ('wagtail.blocks.StructBlock', [[('code', 1), ('language', 2)]], {}), 4: ('wagtail.images.blocks.ImageChooserBlock', (), {})}, help_text='Main content for the page.')),
             ],
             options={
-                "verbose_name": "Article",
-                "verbose_name_plural": "Articles",
+                'abstract': False,
             },
-            bases=("wagtailcore.page",),
+            bases=('wagtailcore.page',),
         ),
         migrations.CreateModel(
-            name="ArticleTag",
+            name='HomePage',
             fields=[
-                (
-                    "id",
-                    models.BigAutoField(
-                        auto_created=True, primary_key=True, serialize=False, verbose_name="ID"
-                    ),
-                ),
-                ("name", models.CharField(max_length=100, unique=True, verbose_name="name")),
-                (
-                    "slug",
-                    models.SlugField(
-                        allow_unicode=True, max_length=100, unique=True, verbose_name="slug"
-                    ),
-                ),
+                ('page_ptr', models.OneToOneField(auto_created=True, on_delete=django.db.models.deletion.CASCADE, parent_link=True, primary_key=True, serialize=False, to='wagtailcore.page')),
+                ('top_content', wagtail.fields.StreamField([('rich_text', 0), ('image', 1), ('icon_link_lists', 11)], blank=True, block_lookup={0: ('wagtail.blocks.RichTextBlock', (), {}), 1: ('picata.blocks.WrappedImageChooserBlock', (), {}), 2: ('wagtail.blocks.CharBlock', (), {'help_text': 'Optional heading for this list (e.g., Social Links).', 'required': False}), 3: ('wagtail.blocks.IntegerBlock', (), {'default': 2, 'help_text': 'Heading level for the list (1-6).', 'max_value': 6, 'min_value': 1, 'required': False}), 4: ('picata.blocks.HREFBlock', (), {'help_text': 'An optional link field', 'max_length': 255, 'required': False}), 5: ('wagtail.blocks.CharBlock', (), {'help_text': 'The title for the list item.', 'max_length': 50, 'required': True}), 6: ('wagtail.blocks.CharBlock', (), {'help_text': 'Id of the icon in the static/icons.svg file.', 'max_length': 255, 'required': False}), 7: ('wagtail.blocks.StructBlock', [[('href', 4), ('label', 5), ('icon', 6)]], {}), 8: ('wagtail.blocks.ListBlock', (7,), {'help_text': 'The list of items.'}), 9: ('wagtail.blocks.StructBlock', [[('heading', 2), ('heading_level', 3), ('items', 8)]], {}), 10: ('wagtail.blocks.StreamBlock', [[('link_list', 9)]], {'help_text': 'Add one or more heading-and-link-list blocks.', 'required': False}), 11: ('wagtail.blocks.StructBlock', [[('lists', 10)]], {})}, help_text="Content stream above 'Recent posts'")),
+                ('bottom_content', wagtail.fields.StreamField([('rich_text', 0), ('image', 1), ('icon_link_lists', 11)], blank=True, block_lookup={0: ('wagtail.blocks.RichTextBlock', (), {}), 1: ('picata.blocks.WrappedImageChooserBlock', (), {}), 2: ('wagtail.blocks.CharBlock', (), {'help_text': 'Optional heading for this list (e.g., Social Links).', 'required': False}), 3: ('wagtail.blocks.IntegerBlock', (), {'default': 2, 'help_text': 'Heading level for the list (1-6).', 'max_value': 6, 'min_value': 1, 'required': False}), 4: ('picata.blocks.HREFBlock', (), {'help_text': 'An optional link field', 'max_length': 255, 'required': False}), 5: ('wagtail.blocks.CharBlock', (), {'help_text': 'The title for the list item.', 'max_length': 50, 'required': True}), 6: ('wagtail.blocks.CharBlock', (), {'help_text': 'Id of the icon in the static/icons.svg file.', 'max_length': 255, 'required': False}), 7: ('wagtail.blocks.StructBlock', [[('href', 4), ('label', 5), ('icon', 6)]], {}), 8: ('wagtail.blocks.ListBlock', (7,), {'help_text': 'The list of items.'}), 9: ('wagtail.blocks.StructBlock', [[('heading', 2), ('heading_level', 3), ('items', 8)]], {}), 10: ('wagtail.blocks.StreamBlock', [[('link_list', 9)]], {'help_text': 'Add one or more heading-and-link-list blocks.', 'required': False}), 11: ('wagtail.blocks.StructBlock', [[('lists', 10)]], {})}, help_text="Content stream rendered under 'Recent posts'")),
             ],
             options={
-                "verbose_name": "Article Tag",
-                "verbose_name_plural": "Article Tags",
+                'verbose_name': 'home page',
             },
+            bases=('wagtailcore.page',),
         ),
         migrations.CreateModel(
-            name="ArticleType",
+            name='PageTag',
             fields=[
-                (
-                    "id",
-                    models.BigAutoField(
-                        auto_created=True, primary_key=True, serialize=False, verbose_name="ID"
-                    ),
-                ),
-                (
-                    "name",
-                    models.CharField(
-                        help_text="Name of the article type.", max_length=100, unique=True
-                    ),
-                ),
-                (
-                    "name_plural",
-                    models.CharField(
-                        blank=True,
-                        help_text="Plural form of the article type name (optional). Defaults to appending 's'.",  # noqa: E501
-                        max_length=100,
-                    ),
-                ),
-                ("slug", models.SlugField(max_length=100, unique=True)),
-                (
-                    "description",
-                    models.TextField(blank=True, help_text="Optional description of this type."),
-                ),
+                ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
+                ('name', models.CharField(max_length=100, unique=True, verbose_name='name')),
+                ('slug', models.SlugField(allow_unicode=True, max_length=100, unique=True, verbose_name='slug')),
             ],
+            options={
+                'abstract': False,
+            },
         ),
         migrations.CreateModel(
-            name="BasicPage",
+            name='PostGroupPage',
             fields=[
-                (
-                    "page_ptr",
-                    models.OneToOneField(
-                        auto_created=True,
-                        on_delete=django.db.models.deletion.CASCADE,
-                        parent_link=True,
-                        primary_key=True,
-                        serialize=False,
-                        to="wagtailcore.page",
-                    ),
-                ),
-                (
-                    "content",
-                    wagtail.fields.StreamField(
-                        [("rich_text", 0), ("image", 1)],
-                        blank=True,
-                        block_lookup={
-                            0: ("wagtail.blocks.RichTextBlock", (), {}),
-                            1: ("wagtail.images.blocks.ImageChooserBlock", (), {}),
-                        },
-                        help_text="Main content for the page.",
-                    ),
-                ),
+                ('page_ptr', models.OneToOneField(auto_created=True, on_delete=django.db.models.deletion.CASCADE, parent_link=True, primary_key=True, serialize=False, to='wagtailcore.page')),
+                ('intro', wagtail.fields.RichTextField(blank=True, help_text='An optional introduction to this group.')),
             ],
             options={
-                "verbose_name": "Basic Page",
-                "verbose_name_plural": "Basic Pages",
+                'verbose_name': 'post listing',
+                'verbose_name_plural': 'post listings',
             },
-            bases=("wagtailcore.page",),
+            bases=(wagtail.contrib.routable_page.models.RoutablePageMixin, 'wagtailcore.page'),
         ),
         migrations.CreateModel(
-            name="PostGroupPage",
+            name='SplitViewPage',
             fields=[
-                (
-                    "page_ptr",
-                    models.OneToOneField(
-                        auto_created=True,
-                        on_delete=django.db.models.deletion.CASCADE,
-                        parent_link=True,
-                        primary_key=True,
-                        serialize=False,
-                        to="wagtailcore.page",
-                    ),
-                ),
-                (
-                    "intro",
-                    wagtail.fields.RichTextField(
-                        blank=True, help_text="An optional introduction to this group."
-                    ),
-                ),
+                ('page_ptr', models.OneToOneField(auto_created=True, on_delete=django.db.models.deletion.CASCADE, parent_link=True, primary_key=True, serialize=False, to='wagtailcore.page')),
+                ('content', wagtail.fields.StreamField([('rich_text', 0), ('code', 3), ('image', 4), ('icon_link_lists', 14)], blank=True, block_lookup={0: ('wagtail.blocks.RichTextBlock', (), {}), 1: ('wagtail.blocks.TextBlock', (), {'help_text': None, 'required': True}), 2: ('wagtail.blocks.ChoiceBlock', [], {'choices': [('python', 'Python'), ('javascript', 'JavaScript'), ('html', 'HTML'), ('css', 'CSS'), ('bash', 'Bash'), ('plaintext', 'Plain Text')], 'required': False}), 3: ('wagtail.blocks.StructBlock', [[('code', 1), ('language', 2)]], {}), 4: ('picata.blocks.WrappedImageChooserBlock', (), {}), 5: ('wagtail.blocks.CharBlock', (), {'help_text': 'Optional heading for this list (e.g., Social Links).', 'required': False}), 6: ('wagtail.blocks.IntegerBlock', (), {'default': 2, 'help_text': 'Heading level for the list (1-6).', 'max_value': 6, 'min_value': 1, 'required': False}), 7: ('picata.blocks.HREFBlock', (), {'help_text': 'An optional link field', 'max_length': 255, 'required': False}), 8: ('wagtail.blocks.CharBlock', (), {'help_text': 'The title for the list item.', 'max_length': 50, 'required': True}), 9: ('wagtail.blocks.CharBlock', (), {'help_text': 'Id of the icon in the static/icons.svg file.', 'max_length': 255, 'required': False}), 10: ('wagtail.blocks.StructBlock', [[('href', 7), ('label', 8), ('icon', 9)]], {}), 11: ('wagtail.blocks.ListBlock', (10,), {'help_text': 'The list of items.'}), 12: ('wagtail.blocks.StructBlock', [[('heading', 5), ('heading_level', 6), ('items', 11)]], {}), 13: ('wagtail.blocks.StreamBlock', [[('link_list', 12)]], {'help_text': 'Add one or more heading-and-link-list blocks.', 'required': False}), 14: ('wagtail.blocks.StructBlock', [[('lists', 13)]], {})}, help_text='Main content for the split-view page.')),
             ],
             options={
-                "verbose_name": "Post Group",
-                "verbose_name_plural": "Post Groups",
+                'verbose_name': 'split-view page',
+                'verbose_name_plural': 'split-view pages',
             },
-            bases=("wagtailcore.page",),
+            bases=('wagtailcore.page',),
         ),
         migrations.CreateModel(
-            name="ArticleTagItem",
+            name='Article',
             fields=[
-                (
-                    "id",
-                    models.BigAutoField(
-                        auto_created=True, primary_key=True, serialize=False, verbose_name="ID"
-                    ),
-                ),
-                (
-                    "content_object",
-                    modelcluster.fields.ParentalKey(
-                        on_delete=django.db.models.deletion.CASCADE,
-                        related_name="tagged_items",
-                        to="hpk.article",
-                    ),
-                ),
-                (
-                    "tag",
-                    models.ForeignKey(
-                        on_delete=django.db.models.deletion.CASCADE,
-                        related_name="%(app_label)s_%(class)s_items",
-                        to="taggit.tag",
-                    ),
-                ),
+                ('page_ptr', models.OneToOneField(auto_created=True, on_delete=django.db.models.deletion.CASCADE, parent_link=True, primary_key=True, serialize=False, to='wagtailcore.page')),
+                ('tagline', models.CharField(blank=True, help_text='A short tagline for the article.')),
+                ('summary', wagtail.fields.RichTextField(blank=True, help_text='A summary to be displayed in previews.')),
+                ('content', wagtail.fields.StreamField([('rich_text', 0), ('code', 3), ('image', 4)], blank=True, block_lookup={0: ('wagtail.blocks.RichTextBlock', (), {}), 1: ('wagtail.blocks.TextBlock', (), {'help_text': None, 'required': True}), 2: ('wagtail.blocks.ChoiceBlock', [], {'choices': [('python', 'Python'), ('javascript', 'JavaScript'), ('html', 'HTML'), ('css', 'CSS'), ('bash', 'Bash'), ('plaintext', 'Plain Text')], 'required': False}), 3: ('wagtail.blocks.StructBlock', [[('code', 1), ('language', 2)]], {}), 4: ('wagtail.images.blocks.ImageChooserBlock', (), {})}, help_text='Main content for the article.')),
+                ('page_type', models.ForeignKey(blank=True, help_text='Select the type of article.', null=True, on_delete=django.db.models.deletion.SET_NULL, related_name='articles', to='picata.articletype')),
             ],
             options={
-                "abstract": False,
+                'abstract': False,
             },
+            bases=('wagtailcore.page',),
         ),
-        migrations.AddField(
-            model_name="article",
-            name="tags",
-            field=modelcluster.contrib.taggit.ClusterTaggableManager(
-                blank=True,
-                help_text="Tags for the article.",
-                through="hpk.ArticleTagItem",
-                to="taggit.Tag",
-                verbose_name="Tags",
-            ),
+        migrations.CreateModel(
+            name='PageTagRelation',
+            fields=[
+                ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
+                ('content_object', modelcluster.fields.ParentalKey(on_delete=django.db.models.deletion.CASCADE, related_name='tagged_items', to='picata.article')),
+                ('tag', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='tagged_items', to='picata.pagetag')),
+            ],
+            options={
+                'abstract': False,
+            },
         ),
         migrations.AddField(
-            model_name="article",
-            name="article_type",
-            field=models.ForeignKey(
-                blank=True,
-                help_text="Select the type of article.",
-                null=True,
-                on_delete=django.db.models.deletion.SET_NULL,
-                related_name="articles",
-                to="hpk.articletype",
-            ),
+            model_name='article',
+            name='tags',
+            field=modelcluster.contrib.taggit.ClusterTaggableManager(blank=True, help_text='Tags for the article.', through='picata.PageTagRelation', to='picata.PageTag', verbose_name='Tags'),
+        ),
+        migrations.CreateModel(
+            name='SocialSettings',
+            fields=[
+                ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
+                ('default_social_image', models.ForeignKey(blank=True, help_text='Default image for social media previews.', null=True, on_delete=django.db.models.deletion.SET_NULL, related_name='+', to='wagtailimages.image')),
+                ('site', models.OneToOneField(editable=False, on_delete=django.db.models.deletion.CASCADE, to='wagtailcore.site')),
+            ],
+            options={
+                'abstract': False,
+            },
         ),
     ]

picata/models.py

@@ -20,8 +20,6 @@ from django.db.models import (
 from django.db.models.functions import Coalesce, ExtractYear
 from django.http import HttpRequest
 from django.urls import reverse
-from hpk.typing import Args, Kwargs
-from hpk.typing.wagtail import PageContext
 from modelcluster.contrib.taggit import ClusterTaggableManager
 from modelcluster.fields import ParentalKey
 from taggit.models import TagBase, TaggedItemBase
@@ -37,6 +35,9 @@ from wagtail.query import PageQuerySet
 from wagtail.search import index
 from wagtail_modeladmin.options import ModelAdmin
 
+from picata.typing import Args, Kwargs
+from picata.typing.wagtail import PageContext
+
 from .blocks import (
     CodeBlock,
     StaticIconLinkListsBlock,
@@ -103,7 +104,7 @@ class BasePage(Page):
 
     def get_context(self, request: HttpRequest, *args: Args, **kwargs: Kwargs) -> BasePageContext:
         """Gather any publication and preview data available for the page into the context."""
-        from hpk.helpers.wagtail import page_preview_data
+        from picata.helpers.wagtail import page_preview_data
 
         context = super().get_context(request, *args, **kwargs)
         context.update(page_preview_data(request, self))
@@ -356,7 +357,7 @@ class PostGroupPage(RoutablePageMixin, Page):
     """A top-level page for grouping various types of posts or articles."""
 
     template = "picata/post_listing.html"
-    subpage_types: ClassVar[list[str]] = ["hpk.Article"]
+    subpage_types: ClassVar[list[str]] = ["picata.Article"]
 
     intro = RichTextField(blank=True, help_text="An optional introduction to this group.")
 
@@ -465,7 +466,7 @@ class HomePage(BasePage):
 
     def get_context(self, request: HttpRequest, *args: Args, **kwargs: Kwargs) -> HomePageContext:
         """Add content streams and a recent posts list to the context."""
-        from hpk.helpers.wagtail import page_preview_data
+        from picata.helpers.wagtail import page_preview_data
 
         recent_posts = Article.objects.live_for_user(request.user).by_date()
         recent_posts = [page_preview_data(request, post) for post in recent_posts]

picata/settings/base.py

@@ -13,8 +13,8 @@ import contextlib
 from os import getenv
 from pathlib import Path
 
-from hpk.helpers import get_public_ip
-from hpk.log_utils import FormatterWithEverything
+from picata.helpers import get_public_ip
+from picata.log_utils import FormatterWithEverything
 
 SRC_DIR = Path(__file__).resolve().parent.parent.parent
 BASE_DIR = Path(SRC_DIR).parent
@@ -35,7 +35,7 @@ SECRET_KEY = getenv("SECRET_KEY")
 
 INSTALLED_APPS = [
     # Local apps
-    "hpk.apps.Config",
+    "picata.apps.Config",
     # Wagtail
     "wagtail.contrib.forms",
     "wagtail.contrib.redirects",
@@ -72,10 +72,10 @@ MIDDLEWARE = [
     "django.middleware.clickjacking.XFrameOptionsMiddleware",
     "django.middleware.security.SecurityMiddleware",
     "wagtail.contrib.redirects.middleware.RedirectMiddleware",
-    "hpk.middleware.HTMLProcessingMiddleware",
+    "picata.middleware.HTMLProcessingMiddleware",
 ]
 
-ROOT_URLCONF = "hpk.urls"
+ROOT_URLCONF = "picata.urls"
 
 TEMPLATES = [
     {
@@ -94,7 +94,7 @@ TEMPLATES = [
     },
 ]
 
-WSGI_APPLICATION = "hpk.wsgi.application"
+WSGI_APPLICATION = "picata.wsgi.application"
 
 
 # Database
@@ -103,7 +103,7 @@ WSGI_APPLICATION = "hpk.wsgi.application"
 DATABASES = {
     "default": {
         "ENGINE": "django.db.backends.postgresql",
-        "NAME": getenv("DB_NAME"),
+        "NAME": getenv("PICATA_DB"),
         "USER": getenv("DB_USER"),
         "PASSWORD": getenv("DB_PASSWORD"),
         "HOST": getenv("DB_HOST", "localhost"),
@@ -158,14 +158,14 @@ LOGGING = {
         },
         "django_log": {
             "level": "INFO",
-            "class": "hpk.log_utils.RotatingDailyFileHandler",
+            "class": "picata.log_utils.RotatingDailyFileHandler",
             "filename": LOG_DIR / "django.log",
             "formatter": "verbose",
         },
-        "hpk_log": {
+        "picata_log": {
             "level": "INFO",
-            "class": "hpk.log_utils.RotatingDailyFileHandler",
-            "filename": LOG_DIR / "hpk.log",
+            "class": "picata.log_utils.RotatingDailyFileHandler",
+            "filename": LOG_DIR / "picata.log",
             "formatter": "verbose",
         },
         "warnings_log": {
@@ -178,8 +178,8 @@ LOGGING = {
         },
     },
     "loggers": {
-        "hpk": {
-            "handlers": ["hpk_log"],
+        "picata": {
+            "handlers": ["picata_log"],
             "level": "INFO",
             "propagate": True,
         },
@@ -279,7 +279,7 @@ DEFAULT_FROM_EMAIL = getenv("ADMIN_EMAIL")
 # Wagtail
 # See https://docs.wagtail.org/en/stable/
 
-WAGTAIL_SITE_NAME = "Hpk.io"
+WAGTAIL_SITE_NAME = "[Example Site Name]"
 
 # Image serving
 WAGTAILIMAGES_IMAGE_MODEL = "wagtailimages.Image"
@@ -294,7 +294,7 @@ WAGTAILSEARCH_BACKENDS = {
 
 # Base URL to use when referring to full URLs within the Wagtail admin backend -
 # e.g. in notification emails. Don't include '/admin' or a trailing slash
-WAGTAILADMIN_BASE_URL = "https://" + getenv("FQDN", "hpk.io")
+WAGTAILADMIN_BASE_URL = "https://" + getenv("FQDN", "example.com")
 
 # https://docs.wagtail.org/en/stable/reference/settings.html#general-editing
 WAGTAILADMIN_RICH_TEXT_EDITORS = {