django-spire 0.23.4__py3-none-any.whl

django_spire/ai/sms/views.py

@@ -0,0 +1,61 @@
+from __future__ import annotations
+
+from django.http import HttpResponse, HttpResponseForbidden
+from django.views.decorators.csrf import csrf_exempt
+from django.views.decorators.http import require_POST
+from twilio.twiml.messaging_response import MessagingResponse
+
+from django_spire.ai.sms.decorators import twilio_auth_required
+from django_spire.ai.sms.intelligence.workflows.sms_conversation_workflow import sms_conversation_workflow
+from django_spire.ai.sms.models import SmsConversation
+
+
+@csrf_exempt
+@require_POST
+@twilio_auth_required
+def webhook_view(request):
+    from_number = request.POST.get('From', '')
+
+    if len(from_number) < 11:
+        return HttpResponseForbidden()
+
+    body = request.POST.get('Body', '')
+    message_sid = request.POST.get('MessageSid', '')
+
+    conversation, _ = SmsConversation.objects.get_or_create(
+        phone_number=from_number
+    )
+
+    message = conversation.add_message(
+        body=body,
+        is_inbound=True,
+        twilio_sid=message_sid,
+    )
+
+    try:
+        sms_intel = sms_conversation_workflow(
+            request=request,
+            user_input=body,
+            message_history=conversation.generate_message_history(),
+            actor=from_number,
+        )
+
+        twiml_response = MessagingResponse()
+        twiml_response.message(sms_intel.body)
+
+        conversation.add_message(
+            body=sms_intel.body,
+            is_inbound=False,
+            twilio_sid=message_sid,
+            is_processed=True
+        )
+
+        message.is_processed = True
+        message.save()
+
+        return HttpResponse(twiml_response)
+    except:
+        raise
+
+
+

django_spire/ai/tests/test_ai.py

@@ -0,0 +1,28 @@
+from __future__ import annotations
+
+from dandy import BaseIntel, Bot, recorder_to_html_file
+
+from django_spire.ai.decorators import log_ai_interaction_from_recorder
+from django_spire.core.tests.test_cases import BaseTestCase
+
+
+class AiTestCase(BaseTestCase):
+    def test_ai_interaction_decorator(self):
+        class HorseIntel(BaseIntel):
+            first_name: str
+            breed: str
+            color: str
+            has_cone_taped_to_head: bool
+
+        @log_ai_interaction_from_recorder(self.super_user, 'horse')
+        @recorder_to_html_file('horse')
+        def generate_horse_intel(user_input: str) -> HorseIntel:
+            bot = Bot()
+            return bot.llm.prompt_to_intel(
+                prompt=user_input,
+                intel_class=HorseIntel,
+            )
+
+        horse_intel = generate_horse_intel('Make me a magical horse that grants wishes!')
+
+        assert horse_intel.first_name != ''

django_spire/ai/urls.py

@@ -0,0 +1,11 @@
+from __future__ import annotations
+
+from django.urls import include, path
+
+
+app_name = 'ai'
+
+urlpatterns = [
+    path('chat/', include('django_spire.ai.chat.urls', namespace='chat')),
+    path('sms/', include('django_spire.ai.sms.urls', namespace='sms')),
+]

django_spire/auth/apps.py

@@ -0,0 +1,17 @@
+from django.apps import AppConfig
+
+from django_spire.utils import check_required_apps
+
+
+class AuthConfig(AppConfig):
+    default_auto_field = 'django.db.models.BigAutoField'
+    label = 'django_spire_auth'
+    name = 'django_spire.auth'
+
+    REQUIRED_APPS = ('django_spire_core',)
+    
+    URLPATTERNS_INCLUDE = 'django_spire.auth.urls'
+    URLPATTERNS_NAMESPACE = 'auth'
+
+    def ready(self) -> None:
+        check_required_apps(self.label)

django_spire/auth/controller/controller.py

@@ -0,0 +1,84 @@
+import functools
+
+from django.core.exceptions import PermissionDenied
+from django.core.handlers.wsgi import WSGIRequest
+
+from django_spire.auth.permissions.decorators import permission_required_decorator_function
+from django_spire.core.utils import get_object_from_module_string
+
+
+class BaseAuthController:
+    def __init__(
+            self,
+            request: WSGIRequest | None = None
+    ):
+        self._request = request
+
+    @property
+    def request(self):
+        if self._request is None:
+            raise Exception('AuthController.request is None')
+
+        return self._request
+
+    @request.setter
+    def request(self, value: WSGIRequest):
+        self._request = value
+
+    def permission_required(
+            self,
+            *permissions: str,
+            all_required: bool = True
+    ):
+
+        def decorator(method):
+            @functools.wraps(method)
+            def wrapper(request: WSGIRequest, *args, **kwargs):
+                self.request = request
+
+                uncallable_permissions = []
+
+                for perm in permissions:
+                    callable_permission = (
+                        getattr(self, perm) if hasattr(self, perm) else perm
+                    )
+                    if callable(callable_permission):
+                        if not all_required and callable_permission():
+                            return method(request, *args, **kwargs)
+                        elif not callable_permission():
+                            raise PermissionDenied
+
+                    else:
+                        uncallable_permissions.append(perm)
+
+                return permission_required_decorator_function(
+                    uncallable_permissions,
+                    method,
+                    self.request,
+                    *args,
+                    all_required=all_required,
+                    **kwargs
+                )
+
+            return wrapper
+
+        return decorator
+
+
+class AppAuthController:
+    def __new__(
+            cls,
+            app_name: str,
+            request: WSGIRequest | None = None,
+            **kwargs
+    ):
+        from django_spire.conf import settings
+
+        if app_name not in settings.DJANGO_SPIRE_AUTH_CONTROLLERS:
+            raise Exception(f'Controller {app_name} not found in settings.AUTH_CONTROLLERS')
+
+        try:
+            return get_object_from_module_string(settings.DJANGO_SPIRE_AUTH_CONTROLLERS[app_name])(request)
+
+        except ModuleNotFoundError:
+            raise Exception(f'Auth Controller for {app_name} not found')

django_spire/auth/group/admin.py

@@ -0,0 +1,53 @@
+from __future__ import annotations
+
+from django.contrib import admin
+from django.urls import reverse
+from django.utils.html import format_html
+
+import django_spire.auth.user.models
+from django_spire.auth.group import models
+from django_spire.auth.user.tools import add_user_to_all_user_group
+
+
+@admin.register(models.AuthGroup)
+class PortalGroupAdmin(admin.ModelAdmin):
+    list_display = ('id', 'name', 'view_group_detail_link', 'user_count')
+    search_fields = ('id', 'name')
+    ordering = ('name',)
+
+    def view_group_detail_link(self, group: models.AuthGroup) -> str:
+        url = reverse('django_spire:auth:group:page:detail', kwargs={'pk': group.pk})
+        return format_html(f'<a href="{url}">View Details</a>')
+
+    view_group_detail_link.short_description = 'Details Link'
+
+    def user_count(self, group: models.AuthGroup) -> int:
+        return group.user_set.count()
+
+    user_count.short_description = 'User Count'
+
+
+@admin.register(django_spire.auth.user.models.AuthUser)
+class PortalUserAdmin(admin.ModelAdmin):
+    actions = ['add_to_all_user_group']
+    list_display = ('id', 'username', 'email', 'full_name', 'is_active', 'view_user_profile_link')
+    list_filter = ('is_active', 'is_staff')
+    search_fields = ('id', 'username', 'email', 'first_name', 'last_name')
+    ordering = ('username',)
+
+    def full_name(self, user: django_spire.auth.user.models.AuthUser) -> str:
+        return user.get_full_name()
+
+    full_name.short_description = 'Full Name'
+
+    def view_user_profile_link(self, user: django_spire.auth.user.models.AuthUser) -> str:
+        url = reverse('django_spire:auth:user:page:detail', kwargs={'pk': user.pk})
+        return format_html(f'<a href="{url}">Profile</a>')
+
+    view_user_profile_link.short_description = 'Profile Link'
+
+    @admin.action(description='Add to All Users Group')
+    def add_to_all_user_group(self, request, queryset):
+        for user in queryset:
+            add_user_to_all_user_group(user)
+        self.message_user(request, f'Updated {len(queryset)} users.')

django_spire/auth/group/apps.py

@@ -0,0 +1,22 @@
+from django.apps import AppConfig
+
+from django_spire.utils import check_required_apps
+
+
+class AuthGroupConfig(AppConfig):
+    default_auto_field = 'django.db.models.BigAutoField'
+    label = 'django_spire_auth_group'
+    name = 'django_spire.auth.group'
+
+    REQUIRED_APPS = ('django_spire_core', 'django_spire_auth')
+
+    MODEL_PERMISSIONS = (
+        {
+            'name': 'group',
+            'model_class_path': 'django_spire.auth.group.models.AuthGroup',
+            'is_proxy_model': True
+        },
+    )
+
+    def ready(self) -> None:
+        check_required_apps(self.label)

django_spire/auth/group/factories.py

@@ -0,0 +1,15 @@
+from __future__ import annotations
+
+from django_spire.auth.group.models import AuthGroup
+
+
+def bulk_create_groups_from_names(names: list[str]):
+    existing_groups = AuthGroup.objects.all().values_list('name', flat=True)
+
+    new_groups = [
+        AuthGroup(name=name)
+        for name in names
+        if name not in existing_groups
+    ]
+
+    return AuthGroup.objects.bulk_create(new_groups)

django_spire/auth/group/forms.py

@@ -0,0 +1,45 @@
+from __future__ import annotations
+
+import json
+
+from django import forms
+from django.contrib.auth.models import Group, User
+
+from django_spire.auth.group.factories import bulk_create_groups_from_names
+
+
+class GroupNamesField(forms.CharField):
+    """Receives a list of group names as a json string"""
+
+    def clean(self, value) -> list[str]:
+        return json.loads(value)
+
+
+class GroupNamesForm(forms.Form):
+    groups = GroupNamesField(required=False)
+
+    def save(self):
+        return bulk_create_groups_from_names(self.cleaned_data['groups'])
+
+
+class GroupForm(forms.ModelForm):
+    def clean_name(self):
+        name = self.cleaned_data['name']
+
+        if name.lower() == 'all users':
+            message = '"All Users" is a reserved name. Please choose another name.'
+            raise forms.ValidationError(message)
+
+        return name
+    class Meta:
+        model = Group
+        exclude = ['permissions']
+        widgets = {}
+
+
+class GroupUserForm(forms.Form):
+    users = forms.ModelMultipleChoiceField(required=False, queryset=User.objects.filter(is_active=True))
+
+    @staticmethod
+    def user_label(obj):
+        return obj.get_full_name()

django_spire/auth/group/migrations/0001_initial.py

@@ -0,0 +1,32 @@
+# Generated by Django 5.2 on 2025-04-23 17:23
+
+import django.contrib.auth.models
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    initial = True
+
+    dependencies = [
+        ('auth', '0012_alter_user_first_name_max_length'),
+    ]
+
+    operations = [
+        migrations.CreateModel(
+            name='AuthGroup',
+            fields=[
+            ],
+            options={
+                'verbose_name': 'Auth Group',
+                'verbose_name_plural': 'Auth Groups',
+                'proxy': True,
+                'indexes': [],
+                'constraints': [],
+            },
+            bases=('auth.group', models.Model),
+            managers=[
+                ('objects', django.contrib.auth.models.GroupManager()),
+            ],
+        ),
+    ]

django_spire/auth/group/models.py

@@ -0,0 +1,35 @@
+from __future__ import annotations
+
+from django.contrib.auth.models import Group
+from django.urls import reverse
+
+from django_spire.contrib.breadcrumb.breadcrumbs import Breadcrumbs
+from django_spire.history.activity.mixins import ActivityMixin
+
+
+class AuthGroup(Group, ActivityMixin):
+    @classmethod
+    def base_breadcrumb(cls) -> Breadcrumbs:
+        crumbs = Breadcrumbs()
+        crumbs.add_breadcrumb('Groups', reverse('django_spire:auth:group:page:list'))
+        return crumbs
+
+    def breadcrumbs(self) -> Breadcrumbs:
+        crumbs = Breadcrumbs()
+        crumbs.add_base_breadcrumb(self._meta.model)
+
+        if self.pk:
+            crumbs.add_breadcrumb(
+                name=self.name,
+                href=reverse(
+                    'django_spire:auth:group:page:detail',
+                    kwargs={'pk': self.pk}
+                )
+            )
+
+        return crumbs
+
+    class Meta:
+        proxy = True
+        verbose_name = 'Auth Group'
+        verbose_name_plural = 'Auth Groups'

django_spire/auth/group/querysets.py

@@ -0,0 +1,8 @@
+from __future__ import annotations
+
+from django.db.models import QuerySet
+
+
+class GroupQuerySet(QuerySet):
+    def active(self):
+        return self.order_by('name')

django_spire/auth/group/templates/django_spire/auth/group/card/detail_card.html

@@ -0,0 +1,25 @@
+{% extends 'django_spire/card/title_card.html' %}
+
+{% load spire_core_tags %}
+
+{% block card_title %}
+    {{ group.name }}
+{% endblock %}
+
+{% block card_button %}
+    {% if perms.django_spire_auth_group.change_authgroup %}
+        {% url 'django_spire:auth:group:form:update' pk=group.pk as edit_group_url %}
+        {% include 'django_spire/button/primary_dark_button.html' with button_icon='bi bi-pencil' button_text='Edit' button_href=edit_group_url %}
+    {% endif %}
+{% endblock %}
+
+{% block card_title_content %}
+    <div class="row">
+        <div class="col">
+            {% include 'django_spire/element/attribute_element.html' with attribute_title='Name' attribute_value=group.name %}
+        </div>
+        <div class="col">
+            {% include 'django_spire/element/attribute_element.html' with attribute_title='Number of Users' attribute_value=group.user_set.count|default:'0' %}
+        </div>
+    </div>
+{% endblock %}

django_spire/auth/group/templates/django_spire/auth/group/card/form_card.html

@@ -0,0 +1,9 @@
+{% extends 'django_spire/card/title_card.html' %}
+
+{% block card_title %}
+    {{ form_title }}
+{% endblock %}
+
+{% block card_title_content %}
+    {% include 'django_spire/auth/group/form/form.html' %}
+{% endblock %}

django_spire/auth/group/templates/django_spire/auth/group/card/group_permission_list_card.html

@@ -0,0 +1,13 @@
+{% extends 'django_spire/card/title_card.html' %}
+
+{% block card_padding_class %}p-0{% endblock %}
+
+{% block card_title %}
+   {{ group.name }} Permissions - {{ group.user_set.count }} Users
+{% endblock %}
+
+{% block card_title_content %}
+    {% for perm_data in permission_data %}
+        {% include 'django_spire/auth/group/item/group_perm_item.html' %}
+    {% endfor %}
+{% endblock %}

django_spire/auth/group/templates/django_spire/auth/group/card/group_user_form_card.html

@@ -0,0 +1,9 @@
+{% extends 'django_spire/card/title_card.html' %}
+
+{% block card_title %}
+    Edit Assigned Group Users for {{ group.name }}
+{% endblock %}
+
+{% block card_title_content %}
+    {% include 'django_spire/auth/group/form/group_user_form.html' %}
+{% endblock %}

django_spire/auth/group/templates/django_spire/auth/group/card/list_card.html

@@ -0,0 +1,24 @@
+{% extends 'django_spire/card/title_card.html' %}
+
+{% block card_padding_class %}p-0{% endblock %}
+
+{% load spire_core_tags %}
+
+{% block card_title %}
+    Group List
+{% endblock %}
+
+{% block card_button %}
+    {% if perms.django_spire_auth_group.change_authgroup %}
+        {% url 'django_spire:auth:group:form:add' as add_group_url %}
+        {% include 'django_spire/button/primary_dark_button.html' with button_href=add_group_url button_text='Add' button_icon='bi bi-plus' %}
+    {% endif %}
+{% endblock %}
+
+{% block card_title_content %}
+    {% for group in group_list %}
+            {% include 'django_spire/auth/group/item/group_item.html' with perm_data=group_list_permission_data|index:forloop.counter0 location='group' %}
+    {% empty %}
+        {% include 'django_spire/item/no_data_item.html' %}
+    {% endfor %}
+{% endblock %}

django_spire/auth/group/templates/django_spire/auth/group/card/permission_user_groups_form_card.html

@@ -0,0 +1,77 @@
+{% extends 'django_spire/card/title_card.html' %}
+
+{% block card_title %}
+    Permissions
+{% endblock %}
+
+
+{% block card_title_content %}
+    {% include 'django_spire/element/divider_element.html' with divider_title='Groups' %}
+    <div class="fs--1 text-muted">Adding a user to a group will assign them permissions allocated to this group.</div>
+
+    <div
+        x-data="{
+            async init() {
+                await this.group.get()
+                this.groups = await this.group_queryset.all()
+
+             },
+            group_queryset: new QuerySetGlue('group_queryset'),
+            group: new ModelObjectGlue('group'),
+            groups: [],
+            selected_groups: [],
+            get return_user_groups() {
+                return JSON.stringify(this.selected_groups)
+            },
+            get return_groups() {
+                return JSON.stringify(this.groups)
+            },
+            add_group() {
+                console.log(this.group.name)
+                if(this.group_exists(this.group.name) || this.group.name.length === 0) {
+                    dispatch_error_notification('Group names must be unique.')
+                } else {
+                    console.log(this.group)
+                    this.groups.push({... this.group})
+                    this.group.name = ''
+                }
+            },
+            select_group(group){
+                if(this.is_linked_group(group.name)) {
+                   this.selected_groups.splice(this.selected_groups.findIndex(obj => obj.name === group.name), 1);
+                } else {
+                    this.selected_groups.push(group)
+                }
+            },
+            is_linked_group() {
+                return this.selected_groups.some(obj => obj.name === group.name)
+            },
+            group_exists() {
+                return this.groups.some(obj => obj.name === this.group.name)
+            }
+        }"
+    >
+        <input type="text" hidden x-model="return_groups" name="groups">
+        <input type="text" hidden x-model="return_user_groups" name="user_groups">
+
+        <template x-for="(group, index) in groups" :key="index">
+            {% include 'django_spire/auth/group/item/permission_user_group_form_item.html' %}
+        </template>
+
+        <template x-if="groups.length === 0">
+            <div class="mt-1">
+                Create a group to add permissions!
+            </div>
+        </template>
+
+       <div class="row g-3 pt-2">
+           <div class="col-12">
+               {% include 'django_spire/element/divider_element.html' with divider_title='Add Group' %}
+               {% include 'django_glue/form/field/char_field.html' with label='Group Name' x_model_value='group.name' %}
+           </div>
+           <div class="col-12">
+               <span @click="add_group()">{% include 'django_spire/button/secondary_outlined_button.html' with button_text='Add Group' %}</span>
+           </div>
+       </div>
+    </div>
+{% endblock %}

django_spire/auth/group/templates/django_spire/auth/group/card/user_list_card.html

@@ -0,0 +1,26 @@
+{% extends 'django_spire/card/title_card.html' %}
+
+{% load spire_core_tags %}
+
+{% block card_title %}
+    Users
+{% endblock %}
+
+{% block card_button %}
+    {% if perms.django_spire_auth_group.change_authgroup %}
+        {% url 'django_spire:auth:group:form:user' pk=group.pk as group_user_form %}
+        {% include 'django_spire/button/primary_dark_button.html' with button_href=group_user_form button_icon='bi bi-pencil' %}
+    {% endif %}
+{% endblock %}
+
+{% block card_title_content %}
+    {% for user in user_list %}
+        {% include 'django_spire/auth/group/item/group_user_item.html' with small_view=True %}
+    {% empty %}
+        {% include 'django_spire/item/no_data_item.html' %}
+    {% endfor %}
+{% endblock %}
+
+{% block card_footer %}
+    {% include 'django_spire/element/pagination_element.html' with paginated_list=user_list %}
+{% endblock %}