django-spire 0.25.1__py3-none-any.whl → 0.26.0__py3-none-any.whl

django_spire/contrib/queryset/mixins.py

@@ -5,7 +5,7 @@ import json
 from abc import abstractmethod
 from typing import TYPE_CHECKING
 
-from django.db.models import QuerySet
+from django.db.models import QuerySet, Q
 from django_spire.contrib.form.utils import show_form_errors
 from django_spire.contrib.queryset.enums import SessionFilterActionEnum
 from django_spire.contrib.session.controller import SessionController
@@ -67,6 +67,27 @@ class SessionFilterQuerySetMixin(QuerySet):
 
 
 class SearchQuerySetMixin(QuerySet):
-    @abstractmethod
     def search(self, value: str | None) -> QuerySet:
-        pass
+        words = value.split(' ')
+
+        filtered_query = self
+
+        char_fields = [
+            field.name for field in self.model._meta.fields
+            if field.get_internal_type() == 'CharField'
+        ]
+
+        for word in words:
+            or_conditions = Q()
+            for field in char_fields:
+                or_conditions |= Q(**{f"{field}__icontains": word})
+            filtered_query = filtered_query.filter(or_conditions)
+
+        return filtered_query
+
+
+class ChoicesQueryMixin(QuerySet):
+    def to_choices(self):
+        return [
+            (obj.pk, str(obj)) for obj in self
+        ]

django_spire/contrib/service/django_model_service.py

@@ -1,20 +1,19 @@
 from __future__ import annotations
 
 import logging
-
 from abc import ABC
 from itertools import chain
 from typing import Generic, TypeVar
 
-from django.contrib.contenttypes.fields import GenericForeignKey
+from django.contrib.auth.models import User
 from django.db import transaction
-from django.db.models import Model, Field, AutoField, ForeignObjectRel, FileField
+from django.db.models import Model, AutoField, FileField
 
-from django_spire.contrib.constructor.django_model_constructor import BaseDjangoModelConstructor
+from django_spire.contrib.constructor.django_model_constructor import \
+    BaseDjangoModelConstructor
 from django_spire.contrib.service.exceptions import ServiceError
 
 
-
 log = logging.getLogger(__name__)
 
 TypeDjangoModel_co = TypeVar('TypeDjangoModel_co', bound=Model, covariant=True)
@@ -82,7 +81,7 @@ class BaseDjangoModelService(
         then it calls self.obj.save(), then updates the m2m fields on the object instance
         using logic similar to django's `BaseModelForm._save_m2m()` method. In all cases,
         it treats the incoming `field_data` exactly the same as `cleaned_data` is treated
-        in the django code that it is emulating, and therefore does not perform any validation 
+        in the django code that it is emulating, and therefore does not perform any validation
         on the data or the model instance as it is assumed that field_data has already been validated upstream.
 
         Args:

django_spire/core/management/commands/spire_startapp.py

@@ -11,8 +11,7 @@ from django_spire.core.management.commands.spire_startapp_pkg.config import (
 )
 from django_spire.core.management.commands.spire_startapp_pkg.filesystem import FileSystem
 from django_spire.core.management.commands.spire_startapp_pkg.generator import (
-    AppGenerator,
-    # TemplateGenerator,
+    AppGenerator, TemplateGenerator,
 )
 from django_spire.core.management.commands.spire_startapp_pkg.processor import (
     TemplateEngine,
@@ -70,11 +69,19 @@ class Command(BaseCommand):
         template_builder = TemplateBuilder(reporter)
 
         app_generator = AppGenerator(filesystem, template_processor, reporter, path_config)
-        # template_generator = TemplateGenerator(filesystem, template_processor, reporter, path_config)
+        template_generator = TemplateGenerator(filesystem, template_processor, reporter,
+                                               path_config)
 
         user_inputs = user_input_collector.collect_all_inputs()
         app_path = user_inputs['app_path']
 
+        skip_app_generation = user_inputs['skip_app_generation']
+        skip_template_generation = user_inputs['skip_template_generation']
+
+        if skip_app_generation and skip_template_generation:
+            reporter.write('Skipped file generation.', reporter.style_notice)
+            return
+
         validator.validate_app_format(app_path)
 
         config = config_factory.create_config(app_path, user_inputs)
@@ -85,34 +92,44 @@ class Command(BaseCommand):
             reporter.style_notice
         )
 
-        missing = registry.get_missing_components(config.components)
+        if not skip_app_generation:
+            missing = registry.get_missing_components(config.components)
+
+            if missing:
+                reporter.report_missing_components(missing)
+
+                template_builder.build_app_tree_structure(
+                    path_resolver.get_base_dir(),
+                    config.components,
+                    registry.get_installed_apps(),
+                    path_config.app_template
+                )
+
+                if reporter.prompt_confirmation('\nProceed with app creation? (y/n): '):
+                    for module in [missing[-1]]:
+                        module_config = config_factory.create_config(module,
+                                                                     user_inputs)
 
-        if missing:
-            reporter.report_missing_components(missing)
+                    app_generator.generate(module_config)
 
-            template_builder.build_app_tree_structure(
+                    reporter.report_installed_apps_suggestion(missing)
+                else:
+                    reporter.write('Skipping app creation.', reporter.style_notice)
+
+            else:
+                reporter.write('All component(s) exist.', reporter.style_success)
+
+        if not skip_template_generation:
+            template_builder.build_html_tree_structure(
                 path_resolver.get_base_dir(),
                 config.components,
                 registry.get_installed_apps(),
-                path_config.app_template
+                path_config.html_template
             )
 
-            # template_builder.build_html_tree_structure(
-            #     path_resolver.get_base_dir(),
-            #     config.components,
-            #     registry.get_installed_apps(),
-            #     path_config.html_template
-            # )
-
-            if not reporter.prompt_confirmation('\nProceed with app creation? (y/n): '):
-                reporter.write('App creation aborted.', reporter.style_error)
+            if not reporter.prompt_confirmation(
+                    '\nProceed with template creation? (y/n): '):
+                reporter.write('Skipping template creation.', reporter.style_notice)
                 return
 
-            for module in [missing[-1]]:
-                module_config = config_factory.create_config(module, user_inputs)
-                app_generator.generate(module_config)
-                # template_generator.generate(module_config)
-
-            reporter.report_installed_apps_suggestion(missing)
-        else:
-            reporter.write('All component(s) exist.', reporter.style_success)
+            template_generator.generate(config)

django_spire/core/management/commands/spire_startapp_pkg/exceptions.py

@@ -0,0 +1,5 @@
+from django.core.management import CommandError
+
+
+class AppExistsError(CommandError):
+    pass

django_spire/core/management/commands/spire_startapp_pkg/maps.py

@@ -591,14 +591,24 @@ class TemplatePaths:
     """
 
     detail_card_template_name: str
+    detail_container_template_name: str
     detail_page_template_name: str
     form_card_template_name: str
+    form_container_template_name: str
     form_page_template_name: str
     form_template_name: str
     item_template_name: str
+    list_items_card_template_name: str
+    list_table_card_template_name: str
     list_card_template_name: str
+    list_container_template_name: str
+    list_items_template_name: str
+    list_filter_form_template_name: str
     list_page_template_name: str
     template_directory_path: str
+    table_row_template_name: str
+    table_rows_template_name: str
+    table_template_name: str
 
     @classmethod
     def build(
@@ -620,15 +630,31 @@ class TemplatePaths:
             else app_name.lower()
         )
 
+        list_display_type = (
+            user_inputs.get('list_display_type', 'items')
+            if user_inputs
+            else 'items'
+        )
+
         return cls(
-            detail_card_template_name=app_name.lower() + '_detail_card',
-            detail_page_template_name=app_name.lower() + '_detail_page',
-            form_card_template_name=app_name.lower() + '_form_card',
-            form_page_template_name=app_name.lower() + '_form_page',
-            form_template_name=app_name.lower() + '_form',
-            item_template_name=app_name.lower() + '_item',
-            list_card_template_name=app_name.lower() + '_list_card',
-            list_page_template_name=app_name.lower() + '_list_page',
+            detail_card_template_name='detail_card',
+            detail_container_template_name='detail_container',
+            detail_page_template_name='detail_page',
+            form_card_template_name='form_card',
+            form_container_template_name='form_container',
+            form_page_template_name='form_page',
+            form_template_name='form',
+            item_template_name='item',
+            list_items_card_template_name=f'list_items_card',
+            list_table_card_template_name=f'list_table_card',
+            list_card_template_name=f'list_{list_display_type}_card',
+            list_container_template_name='list_container',
+            list_filter_form_template_name='list_filter_form',
+            list_items_template_name='list_items',
+            table_row_template_name='row',
+            table_rows_template_name='rows',
+            table_template_name='table',
+            list_page_template_name='list_page',
             template_directory_path=template_path,
         )
 
@@ -747,37 +773,43 @@ class ViewFunctions:
     View function names.
 
     Example:
-        list_page_view_name: 'list_page_view'
-        detail_page_view_name: 'detail_page_view'
-        create_form_view_name: 'create_form_view'
-        update_form_view_name: 'update_form_view'
-        delete_form_view_name: 'delete_form_view'
-        create_modal_form_view_name: 'create_modal_form_view'
-        update_modal_form_view_name: 'update_modal_form_view'
-        delete_modal_form_view_name: 'delete_modal_form_view'
+        list_view_name: 'list_page_view'
+        detail_view_name: 'detail_page_view'
+        create_view_name: 'create_form_view'
+        update_view_name: 'update_form_view'
+        delete_view_name: 'delete_form_view'
+        create_modal_view_name: 'create_modal_form_view'
+        update_modal_view_name: 'update_modal_form_view'
+        delete_modal_view_name: 'delete_modal_form_view'
+        list_items_view_name: 'items_view'
+        rows_view_name: 'rows_view'
 
     """
 
-    create_form_view_name: str
-    create_modal_form_view_name: str
-    delete_form_view_name: str
-    delete_modal_form_view_name: str
-    detail_page_view_name: str
-    list_page_view_name: str
-    update_form_view_name: str
-    update_modal_form_view_name: str
+    create_view_name: str
+    create_modal_view_name: str
+    delete_view_name: str
+    delete_modal_view_name: str
+    detail_view_name: str
+    list_view_name: str
+    update_view_name: str
+    update_modal_view_name: str
+    list_items_view_name: str
+    rows_view_name: str
 
     @classmethod
     def build(cls, components: list[str], **_kwargs) -> ViewFunctions:
         return cls(
-            create_form_view_name='create_form_view',
-            create_modal_form_view_name='create_modal_form_view',
-            delete_form_view_name='delete_form_view',
-            delete_modal_form_view_name='delete_modal_form_view',
-            detail_page_view_name='detail_page_view',
-            list_page_view_name='list_page_view',
-            update_form_view_name='update_form_view',
-            update_modal_form_view_name='update_modal_form_view',
+            create_view_name='create_view',
+            create_modal_view_name='create_modal_view',
+            delete_view_name='delete_form_view',
+            delete_modal_view_name='delete_modal_view',
+            detail_view_name='detail_view',
+            list_view_name='list_view',
+            update_view_name='update_view',
+            update_modal_view_name='update_modal_view',
+            rows_view_name='rows_view',
+            list_items_view_name='items_view',
         )
 
 

django_spire/core/management/commands/spire_startapp_pkg/template/app/constants.py.template

@@ -0,0 +1 @@
+LIST_FILTERING_SESSION_KEY = '${context_single_var}_list_filter'

django_spire/core/management/commands/spire_startapp_pkg/template/app/forms.py.template

@@ -16,3 +16,7 @@ class ${form_class_name}(forms.ModelForm):
     class Meta:
         model = models.${model_class_name}
         exclude: ClassVar = []
+
+
+class ${model_class_name}ListFilterForm(forms.Form):
+    search = forms.CharField(required=False)

django_spire/core/management/commands/spire_startapp_pkg/template/app/models.py.template

@@ -5,12 +5,13 @@ from django.urls import reverse
 
 from django_spire.contrib.breadcrumb import Breadcrumbs
 from django_spire.history.mixins import HistoryModelMixin
+from django_spire.history.activity.mixins import ActivityMixin
 
 from ${module_path} import querysets
 from ${module_path}.services.service import ${service_class_name}
 
 
-class ${model_class_name}(HistoryModelMixin):
+class ${model_class_name}(HistoryModelMixin, ActivityMixin):
     name = models.CharField(max_length=255)
     description = models.TextField(default='')
 

django_spire/core/management/commands/spire_startapp_pkg/template/app/querysets.py.template

@@ -5,6 +5,8 @@ from typing import TYPE_CHECKING
 from django.db.models import Q
 
 from django_spire.history.querysets import HistoryQuerySet
+from django_spire.contrib.queryset.mixins import SearchQuerySetMixin, \
+    SessionFilterQuerySetMixin
 
 if TYPE_CHECKING:
     from django.db.models import QuerySet
@@ -12,9 +14,16 @@ if TYPE_CHECKING:
     from ${module_path}.models import ${model_class_name}
 
 
-class ${queryset_class_name}(HistoryQuerySet):
-    def search(self, search_value: str) -> QuerySet[${model_class_name}]:
-        return self.filter(
-            Q(name__icontains=search_value) |
-            Q(description__icontains=search_value)
-        )
+class ${queryset_class_name}(
+    HistoryQuerySet,
+    SearchQuerySetMixin,
+    SessionFilterQuerySetMixin
+):
+    def bulk_filter(self, filter_data: dict) -> QuerySet[${model_class_name}]:
+        queryset = self
+
+        search = filter_data.get('search', '')
+        if search:
+            queryset = queryset.search(search)
+
+        return queryset

django_spire/core/management/commands/spire_startapp_pkg/template/app/urls/__init__.py.template

@@ -8,4 +8,5 @@ app_name = '${url_namespace}'
 urlpatterns = [
     path('page/', include('${module_path}.urls.page_urls', namespace='page')),
     path('form/', include('${module_path}.urls.form_urls', namespace='form')),
+    path('template/', include('${module_path}.urls.template_urls', namespace='template')),
 ]

django_spire/core/management/commands/spire_startapp_pkg/template/app/urls/form_urls.py.template

@@ -8,10 +8,10 @@ from ${module_path}.views import form_views
 app_name = 'form'
 
 urlpatterns = [
-    path('create/', form_views.${create_form_view_name}, name='create'),
-    path('<int:pk>/update/', form_views.${update_form_view_name}, name='update'),
-    path('<int:pk>/delete/', form_views.${delete_form_view_name}, name='delete'),
-    path('create/modal/', form_views.${create_modal_form_view_name}, name='create_modal'),
-    path('<int:pk>/update/modal/', form_views.${update_modal_form_view_name}, name='update_modal'),
-    path('<int:pk>/delete/modal/', form_views.${delete_modal_form_view_name}, name='delete_modal'),
+    path('create/', form_views.${create_view_name}, name='create'),
+    path('<int:pk>/update/', form_views.${update_view_name}, name='update'),
+    path('<int:pk>/delete/', form_views.${delete_view_name}, name='delete'),
+    path('create/modal/', form_views.${create_modal_view_name}, name='create_modal'),
+    path('<int:pk>/update/modal/', form_views.${update_modal_view_name}, name='update_modal'),
+    path('<int:pk>/delete/modal/', form_views.${delete_modal_view_name}, name='delete_modal'),
 ]

django_spire/core/management/commands/spire_startapp_pkg/template/app/urls/page_urls.py.template

@@ -8,6 +8,6 @@ from ${module_path}.views import page_views
 app_name = 'page'
 
 urlpatterns = [
-    path('list/', page_views.${list_page_view_name}, name='list'),
-    path('<int:pk>/detail/', page_views.${detail_page_view_name}, name='detail'),
+    path('list/', page_views.${list_view_name}, name='list'),
+    path('<int:pk>/detail/', page_views.${detail_view_name}, name='detail'),
 ]

django_spire/core/management/commands/spire_startapp_pkg/template/app/urls/template_urls.py.template

@@ -0,0 +1,12 @@
+from __future__ import annotations
+
+from django.urls import path
+
+from ${module_path}.views import template_views
+
+
+app_name = 'template'
+
+urlpatterns = [
+    path('items/', template_views.${list_items_view_name}, name='items'),
+]

django_spire/core/management/commands/spire_startapp_pkg/template/app/views/form_views.py.template

@@ -23,7 +23,7 @@ if TYPE_CHECKING:
 
 
 @permission_required('${permission_prefix}.delete_${model_instance_name}')
-def ${delete_modal_form_view_name}(request: WSGIRequest, pk: int) -> TemplateResponse:
+def ${delete_modal_view_name}(request: WSGIRequest, pk: int) -> TemplateResponse:
     ${context_single_var} = get_object_or_404(models.${model_class_name}, pk=pk)
 
     form_action = reverse(
@@ -35,7 +35,6 @@ def ${delete_modal_form_view_name}(request: WSGIRequest, pk: int) -> TemplateRes
         ${context_single_var}.add_activity(
             user=request.user,
             verb='deleted',
-            device=request.device,
             information=f'{request.user.get_full_name()} deleted a ${model_instance_name}.'
         )
 
@@ -52,7 +51,7 @@ def ${delete_modal_form_view_name}(request: WSGIRequest, pk: int) -> TemplateRes
 
 
 @permission_required('${permission_prefix}.delete_${model_instance_name}')
-def ${delete_form_view_name}(request: WSGIRequest, pk: int) -> TemplateResponse:
+def ${delete_view_name}(request: WSGIRequest, pk: int) -> TemplateResponse:
     ${context_single_var} = get_object_or_404(models.${model_class_name}, pk=pk)
 
     return_url = request.GET.get(
@@ -68,16 +67,16 @@ def ${delete_form_view_name}(request: WSGIRequest, pk: int) -> TemplateResponse:
 
 
 @permission_required('${permission_prefix}.add_${model_instance_name}')
-def ${create_modal_form_view_name}(request: WSGIRequest) -> TemplateResponse:
-    return _modal_form_view(request)
+def ${create_modal_view_name}(request: WSGIRequest) -> TemplateResponse:
+    return _modal_view(request)
 
 
 @permission_required('${permission_prefix}.change_${model_instance_name}')
-def ${update_modal_form_view_name}(request: WSGIRequest, pk: int) -> TemplateResponse:
-    return _modal_form_view(request, pk)
+def ${update_modal_view_name}(request: WSGIRequest, pk: int) -> TemplateResponse:
+    return _modal_view(request, pk)
 
 
-def _modal_form_view(request: WSGIRequest, pk: int = 0) -> TemplateResponse:
+def _modal_view(request: WSGIRequest, pk: int = 0) -> TemplateResponse:
     ${context_single_var} = get_object_or_404(models.${model_class_name}, pk=pk)
 
     dg.glue_model_object(request, '${glue_model_key}', ${context_single_var})
@@ -94,12 +93,12 @@ def _modal_form_view(request: WSGIRequest, pk: int = 0) -> TemplateResponse:
 
 
 @permission_required('${permission_prefix}.add_${model_instance_name}')
-def ${create_form_view_name}(request: WSGIRequest) -> TemplateResponse:
+def ${create_view_name}(request: WSGIRequest) -> TemplateResponse:
     return _form_view(request)
 
 
 @permission_required('${permission_prefix}.change_${model_instance_name}')
-def ${update_form_view_name}(request: WSGIRequest, pk: int) -> TemplateResponse:
+def ${update_view_name}(request: WSGIRequest, pk: int) -> TemplateResponse:
     return _form_view(request, pk)
 
 
@@ -112,7 +111,7 @@ def _form_view(request: WSGIRequest, pk: int = 0) -> TemplateResponse|HttpRespon
         form = forms.${form_class_name}(request.POST, instance=${context_single_var})
 
         if form.is_valid():
-            ${context_single_var} = form.save()
+            ${context_single_var}, _ = ${context_single_var}.services.save_model_obj(**form.cleaned_data)
             add_form_activity(${context_single_var}, pk, request.user)
 
             return redirect(

django_spire/core/management/commands/spire_startapp_pkg/template/app/views/page_views.py.template

@@ -4,10 +4,16 @@ from typing import TYPE_CHECKING
 
 from django.contrib.auth.decorators import permission_required
 from django.shortcuts import get_object_or_404
+from django.urls import reverse
 
 from django_spire.contrib.generic_views import portal_views
+from django_spire.core.table.enums import ResponsiveMode
+from django_spire.contrib.session.controller import SessionController
+
 
 from ${module_path} import models
+from ${module_path}.forms import ${model_class_name}ListFilterForm
+from ${module_path}.constants import LIST_FILTERING_SESSION_KEY
 
 if TYPE_CHECKING:
     from django.core.handlers.wsgi import WSGIRequest
@@ -15,7 +21,7 @@ if TYPE_CHECKING:
 
 
 @permission_required('${permission_prefix}.view_${model_instance_name}')
-def ${detail_page_view_name}(request: WSGIRequest, pk: int) -> TemplateResponse:
+def ${detail_view_name}(request: WSGIRequest, pk: int) -> TemplateResponse:
     ${context_single_var} = get_object_or_404(models.${model_class_name}, pk=pk)
 
     context_data = {
@@ -31,9 +37,17 @@ def ${detail_page_view_name}(request: WSGIRequest, pk: int) -> TemplateResponse:
 
 
 @permission_required('${permission_prefix}.view_${model_instance_name}')
-def ${list_page_view_name}(request: WSGIRequest) -> TemplateResponse:
+def ${list_view_name}(request: WSGIRequest) -> TemplateResponse:
+    models.${model_class_name}.objects.process_session_filter(
+        request=request,
+        session_key=LIST_FILTERING_SESSION_KEY,
+        form_class=${model_class_name}ListFilterForm,
+    )
+
     context_data = {
-        '${context_plural_var}': models.${model_class_name}.objects.all()
+        'responsive_mode': ResponsiveMode.SCROLL,
+        '${context_single_var}_items_endpoint': reverse('${url_reverse_path}:template:items'),
+        'filter_session': SessionController(request, LIST_FILTERING_SESSION_KEY),
     }
 
     return portal_views.list_view(

django_spire/core/management/commands/spire_startapp_pkg/template/app/views/template_views.py.template

@@ -0,0 +1,40 @@
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+from django.contrib.auth.decorators import permission_required
+
+from django_spire.contrib.generic_views import portal_views
+
+from ${module_path} import models
+from ${module_path}.constants import LIST_FILTERING_SESSION_KEY
+from ${module_path}.forms import ${model_class_name}ListFilterForm
+
+if TYPE_CHECKING:
+    from django.core.handlers.wsgi import WSGIRequest
+    from django.template.response import TemplateResponse
+
+
+@permission_required('${permission_prefix}.view_${model_instance_name}')
+def ${list_items_view_name}(request: WSGIRequest) -> TemplateResponse:
+    sort_field = request.GET.get('sort', 'name')
+    sort_direction = request.GET.get('direction', 'asc')
+
+    ${context_plural_var} = (
+        models.${model_class_name}.objects
+        .process_session_filter(
+            request=request,
+            session_key=LIST_FILTERING_SESSION_KEY,
+            form_class=${model_class_name}ListFilterForm,
+        ).order_by(
+            f"{'-' if sort_direction == 'desc' else ''}{sort_field}"
+        )
+    )
+
+    return portal_views.infinite_scrolling_view(
+        request,
+        context_data={'batch_size': 10,},
+        queryset=${context_plural_var},
+        queryset_name='${context_plural_var}',
+        template='${template_directory_path}/table/${table_rows_template_name}.html'
+    )

django_spire/core/management/commands/spire_startapp_pkg/template/templates/card/${form_card_template_name}.html.template

@@ -5,5 +5,5 @@
 {% endblock %}
 
 {% block card_title_content %}
-    {% include '${template_directory_path}/form/${form_template_name}' %}
+    {% include '${template_directory_path}/form/${form_template_name}.html' %}
 {% endblock %}

django_spire/core/management/commands/spire_startapp_pkg/template/templates/card/${list_base_card_template_name}.html.template

@@ -0,0 +1,16 @@
+{% extends 'django_spire/card/title_card.html' %}
+
+{% block card_title %}
+    ${model_verbose_name_plural}
+{% endblock %}
+
+{% block card_button %}
+    {% if perms.${permission_prefix}.add_${model_instance_name} %}
+        {% url '${url_reverse_path}:form:create' as new_${context_single_var}_url %}
+        {% include 'django_spire/button/primary_dark_button.html' with button_text='Add' button_icon='bi bi-plus' button_href=new_${context_single_var}_url %}
+    {% endif %}
+{% endblock %}
+
+{% block card_title_content %}
+    {% include '${template_directory_path}/table/${list_table_card_template_name}.html' with endpoint=${context_single_var}_rows_endpoint %}
+{% endblock %}

django_spire/core/management/commands/spire_startapp_pkg/template/templates/card/${list_items_card_template_name}.html.template

@@ -0,0 +1,16 @@
+{% extends 'django_spire/card/title_card.html' %}
+
+{% block card_title %}
+    ${model_verbose_name_plural}
+{% endblock %}
+
+{% block card_button %}
+    {% if perms.${permission_prefix}.add_${model_instance_name} %}
+        {% url '${url_reverse_path}:form:create' as new_${context_single_var}_url %}
+        {% include 'django_spire/button/primary_dark_button.html' with button_text='Add' button_icon='bi bi-plus' button_href=new_${context_single_var}_url %}
+    {% endif %}
+{% endblock %}
+
+{% block card_title_content %}
+    {% include '${template_directory_path}/container/${list_container_template_name}.html' with endpoint=${context_single_var}_items_endpoint %}
+{% endblock %}

django_spire/core/management/commands/spire_startapp_pkg/template/templates/card/${list_table_card_template_name}.html.template

@@ -0,0 +1,16 @@
+{% extends 'django_spire/card/title_card.html' %}
+
+{% block card_title %}
+    ${model_verbose_name_plural}
+{% endblock %}
+
+{% block card_button %}
+    {% if perms.${permission_prefix}.add_${model_instance_name} %}
+        {% url '${url_reverse_path}:form:create' as new_${context_single_var}_url %}
+        {% include 'django_spire/button/primary_dark_button.html' with button_text='Add' button_icon='bi bi-plus' button_href=new_${context_single_var}_url %}
+    {% endif %}
+{% endblock %}
+
+{% block card_title_content %}
+    {% include '${template_directory_path}/table/${table_template_name}.html' with endpoint=${context_single_var}_items_endpoint %}
+{% endblock %}

django_spire/core/management/commands/spire_startapp_pkg/template/templates/container/${list_container_template_name}.html.template

@@ -0,0 +1 @@
+{% extends 'django_spire/container/infinite_scroll_container.html' %}