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

django_spire/ai/chat/router.py

@@ -3,13 +3,11 @@ from __future__ import annotations
 from abc import ABC, abstractmethod
 from typing import TYPE_CHECKING
 
-from dandy import Bot, Prompt
 from dandy.recorder import recorder_to_html_file
 
 from django_spire.ai.chat.intelligence.decoders.intent_decoder import generate_intent_decoder
 from django_spire.ai.chat.message_intel import BaseMessageIntel, DefaultMessageIntel
 from django_spire.ai.decorators import log_ai_interaction_from_recorder
-from django_spire.conf import settings
 
 if TYPE_CHECKING:
     from dandy.llm.request.message import MessageHistory
@@ -62,27 +60,19 @@ class SpireChatRouter(BaseChatRouter):
         user_input: str,
         message_history: MessageHistory | None = None
     ) -> BaseMessageIntel:
-        persona_name = getattr(settings, 'DJANGO_SPIRE_AI_PERSONA_NAME', 'AI Assistant')
-
-        system_prompt = (
-            Prompt()
-            .text(f'You are {persona_name}, a helpful AI assistant.')
-            .line_break()
-            .text('Important rules:')
-            .list([
-                f'You should always identify yourself as {persona_name}.',
-                'Please never mention being Qwen, Claude, GPT, or any other model name.',
-                'Be helpful, friendly, and professional.',
-            ])
+        from django_spire.knowledge.intelligence.workflows.knowledge_workflow import (
+            knowledge_search_workflow,
         )
 
-        bot = Bot()
-        bot.llm_role = system_prompt
+        if request.user.has_perm('django_spire_knowledge.view_collection'):
+            return knowledge_search_workflow(
+                request=request,
+                user_input=user_input,
+                message_history=message_history
+            )
 
-        return bot.llm.prompt_to_intel(
-            prompt=user_input,
-            intel_class=DefaultMessageIntel,
-            message_history=message_history,
+        return DefaultMessageIntel(
+            text='Sorry, I could not find any information on that.'
         )
 
     def workflow(

django_spire/ai/chat/templates/django_spire/ai/chat/dropdown/ellipsis_dropdown.html

@@ -11,8 +11,10 @@
 {% endblock %}
 
 {% block dropdown_content %}
-    {% include 'django_spire/dropdown/element/dropdown_link_element.html' with x_click="enable_rename_chat(); toggle_dropdown()" link_text='Rename' link_css='text-start' %}
+    {% if recent_chat %}
+        {% include 'django_spire/dropdown/element/dropdown_link_element.html' with x_click="enable_rename_chat(); toggle_dropdown()" link_text='Rename' link_css='text-start' %}
 
-    {% url 'django_spire:ai:chat:template:confirm_delete' pk=recent_chat.id as delete_url %}
-    {% include 'django_spire/dropdown/element/ellipsis_dropdown_modal_link_element.html' with view_url=delete_url link_text='Delete' link_css='text-app-danger text-start' %}
+        {% url 'django_spire:ai:chat:template:confirm_delete' pk=recent_chat.id as delete_url %}
+        {% include 'django_spire/dropdown/element/ellipsis_dropdown_modal_link_element.html' with view_url=delete_url link_text='Delete' link_css='text-app-danger text-start' %}
+    {% endif %}
 {% endblock %}

django_spire/ai/chat/templates/django_spire/ai/chat/message/default_message.html

@@ -1,5 +1,9 @@
 {% extends 'django_spire/ai/chat/message/message.html' %}
 
+{% load spire_ai_chat_tags %}
+
 {% block message_content %}
-    {{ message_intel.text|linebreaksbr }}
-{% endblock %}
+    <div class="ai-message-content">
+        {{ message_intel.text|render_markdown }}
+    </div>
+{% endblock %}

django_spire/ai/chat/templatetags/spire_ai_chat_tags.py

@@ -0,0 +1,19 @@
+from __future__ import annotations
+
+import marko
+
+from django import template
+from django.utils.safestring import mark_safe
+
+
+register = template.Library()
+
+
+@register.filter
+def render_markdown(value: str) -> str:
+    if not value:
+        return ''
+
+    html = marko.convert(value)
+
+    return mark_safe(html)

django_spire/ai/chat/tests/test_router/test_spire_chat_router.py

@@ -23,13 +23,26 @@ class TestSpireChatRouter(BaseTestCase):
 
         assert isinstance(router, SpireChatRouter)
 
-    def test_default_chat_callable_returns_message_intel(self) -> None:
+    def test_default_chat_callable_returns_default_without_permission(self) -> None:
         router = SpireChatRouter()
 
-        with patch('django_spire.ai.chat.router.Bot') as MockBot:
-            mock_bot_instance = Mock()
-            MockBot.return_value = mock_bot_instance
-            mock_bot_instance.llm.prompt_to_intel.return_value = DefaultMessageIntel(text='Response')
+        self.request.user = Mock()
+        self.request.user.has_perm.return_value = False
+
+        result = router._default_chat_callable(
+            request=self.request,
+            user_input='Hello',
+            message_history=None
+        )
+
+        assert isinstance(result, DefaultMessageIntel)
+        assert result.text == 'Sorry, I could not find any information on that.'
+
+    def test_default_chat_callable_calls_knowledge_workflow_with_permission(self) -> None:
+        router = SpireChatRouter()
+
+        with patch('django_spire.knowledge.intelligence.workflows.knowledge_workflow.knowledge_search_workflow') as mock_workflow:
+            mock_workflow.return_value = DefaultMessageIntel(text='Knowledge response')
 
             result = router._default_chat_callable(
                 request=self.request,
@@ -37,25 +50,13 @@ class TestSpireChatRouter(BaseTestCase):
                 message_history=None
             )
 
-            assert isinstance(result, DefaultMessageIntel)
-            mock_bot_instance.llm.prompt_to_intel.assert_called_once()
-
-    @override_settings(DJANGO_SPIRE_AI_PERSONA_NAME='Test Bot')
-    def test_default_callable_uses_persona_name(self) -> None:
-        router = SpireChatRouter()
-
-        with patch('django_spire.ai.chat.router.Bot') as MockBot:
-            mock_bot_instance = Mock()
-            MockBot.return_value = mock_bot_instance
-            mock_bot_instance.llm.prompt_to_intel.return_value = DefaultMessageIntel(text='Response')
-
-            router._default_chat_callable(
+            mock_workflow.assert_called_once_with(
                 request=self.request,
                 user_input='Hello',
                 message_history=None
             )
 
-            assert MockBot.called
+            assert isinstance(result, DefaultMessageIntel)
 
     def test_workflow_uses_intent_decoder(self) -> None:
         router = SpireChatRouter()
@@ -131,72 +132,3 @@ class TestSpireChatRouter(BaseTestCase):
 
             assert isinstance(result, DefaultMessageIntel)
             assert result.text == 'Test Response'
-
-    @override_settings(DJANGO_SPIRE_AI_PERSONA_NAME='Custom Persona')
-    def test_default_callable_with_custom_persona(self) -> None:
-        router = SpireChatRouter()
-
-        with patch('django_spire.ai.chat.router.Bot') as MockBot:
-            mock_bot_instance = Mock()
-            MockBot.return_value = mock_bot_instance
-            mock_bot_instance.llm.prompt_to_intel.return_value = DefaultMessageIntel(text='Response')
-
-            router._default_chat_callable(
-                request=self.request,
-                user_input='Hello',
-                message_history=None
-            )
-
-            assert mock_bot_instance.llm_role is not None
-
-    def test_default_callable_passes_message_history(self) -> None:
-        router = SpireChatRouter()
-        message_history = MessageHistory()
-
-        with patch('django_spire.ai.chat.router.Bot') as MockBot:
-            mock_bot_instance = Mock()
-            MockBot.return_value = mock_bot_instance
-            mock_bot_instance.llm.prompt_to_intel.return_value = DefaultMessageIntel(text='Response')
-
-            router._default_chat_callable(
-                request=self.request,
-                user_input='Hello',
-                message_history=message_history
-            )
-
-            call_kwargs = mock_bot_instance.llm.prompt_to_intel.call_args[1]
-            assert call_kwargs['message_history'] == message_history
-
-    def test_default_callable_passes_user_input(self) -> None:
-        router = SpireChatRouter()
-
-        with patch('django_spire.ai.chat.router.Bot') as MockBot:
-            mock_bot_instance = Mock()
-            MockBot.return_value = mock_bot_instance
-            mock_bot_instance.llm.prompt_to_intel.return_value = DefaultMessageIntel(text='Response')
-
-            router._default_chat_callable(
-                request=self.request,
-                user_input='Test input',
-                message_history=None
-            )
-
-            call_kwargs = mock_bot_instance.llm.prompt_to_intel.call_args[1]
-            assert call_kwargs['prompt'] == 'Test input'
-
-    def test_default_callable_uses_default_message_intel(self) -> None:
-        router = SpireChatRouter()
-
-        with patch('django_spire.ai.chat.router.Bot') as MockBot:
-            mock_bot_instance = Mock()
-            MockBot.return_value = mock_bot_instance
-            mock_bot_instance.llm.prompt_to_intel.return_value = DefaultMessageIntel(text='Response')
-
-            router._default_chat_callable(
-                request=self.request,
-                user_input='Hello',
-                message_history=None
-            )
-
-            call_kwargs = mock_bot_instance.llm.prompt_to_intel.call_args[1]
-            assert call_kwargs['intel_class'] == DefaultMessageIntel

django_spire/auth/templates/django_spire/auth/element/android_and_chrome_app_install_element.html

@@ -0,0 +1,33 @@
+<div class="text-center">
+    <button id="android-install-button" class="btn btn-app-primary fs-4 mt-3" hidden>
+        Install App <i class="bi bi-file-arrow-down"></i>
+    </button>
+</div>
+
+<script type="application/javascript">
+    let android_install_prompt = null;
+    let android_install_button = document.querySelector("#android-install-button");
+
+    window.addEventListener("beforeinstallprompt", (event) => {
+        event.preventDefault();
+        android_install_prompt = event;
+        android_install_button.removeAttribute("hidden");
+    });
+
+    android_install_button.addEventListener("click", async () => {
+        if (!android_install_prompt) {
+            return;
+        }
+        const result = await android_install_prompt.prompt();
+        disableInAppInstallPrompt();
+    });
+
+    window.addEventListener("appinstalled", () => {
+        disableInAppInstallPrompt();
+    });
+
+    function disableInAppInstallPrompt() {
+        android_install_prompt = null;
+        android_install_button.setAttribute("hidden", "");
+    }
+</script>

django_spire/auth/templates/django_spire/auth/element/ios_app_install_element.html

@@ -0,0 +1,48 @@
+{% load static %}
+
+<div class="text-center">
+    <button id="ios-install-button" class="btn btn-app-primary fs-4 mt-3" data-bs-toggle="modal" data-bs-target="#ios-install-app-modal" hidden>
+        Install App <i class="bi bi-file-arrow-down"></i>
+    </button>
+</div>
+
+<div class="modal fade" id="ios-install-app-modal" tabindex="-1" aria-labelledby="exampleModalLabel" aria-hidden="true" data-bs-theme="{{ theme.mode }}">
+    <div class="modal-dialog">
+        <div class="modal-content bg-app-layer-one">
+            <div class="modal-header">
+                <img
+                    src="{% block app_icon %}{% endblock %}"
+                    alt="No Image"
+                    class="border rounded-3 me-3 shadow"
+                    style=" height: 3.0rem; "
+                >
+                <span class="fs-5 fw-semibold">{% block app_title %}{% endblock %}</span>
+                <button type="button" class="btn-close" data-bs-dismiss="modal" aria-label="Close"></button>
+            </div>
+            <div class="modal-body">
+                <p>Install the app on your Apple device to easily access it anytime by following the instructions below in the Safari Web Browser.</p>
+                <ol>
+                    <li class="p-2">Tap on the <span class="border border-2 p-1 rounded-3"><i class="bi bi-box-arrow-up"></i></span> in your browser bar</li>
+                    <li class="p-2">Select <span class="border border-2 p-1 rounded-3">Add to Home Screen</span></li>
+                    <li class="p-2">Click <span class="border border-2 p-1 rounded-3">Add</span> When Prompted</li>
+                </ol>
+                <p class="m-0">You will need to close this popup to complete the installation process</p>
+            </div>
+        </div>
+    </div>
+</div>
+
+<script type="application/javascript">
+    let ios_install_button = document.querySelector("#ios-install-button");
+
+    const isIos = () => {
+        const userAgent = window.navigator.userAgent.toLowerCase();
+        return /iphone|ipad|ipod/.test(userAgent);
+    }
+
+    const isInStandaloneMode = () => ('standalone' in window.navigator) && (window.navigator.standalone);
+
+    if (isIos() && !isInStandaloneMode()) {
+        ios_install_button.removeAttribute("hidden");
+    }
+</script>

django_spire/auth/templates/django_spire/auth/page/auth_page.html

@@ -10,7 +10,8 @@
                     <div class="text-center pb-5">
                         <a href="/">
                             {% block authentication_page_img %}
-                                <img height="120px" class="ms-1" src="{% static 'img/django_spire.png' %}" alt="">
+                                <img height="120px" class="ms-1" src="{% static 'django_spire/img/django_spire.svg' %}"
+                                     alt="">
                             {% endblock %}
                         </a>
                     </div>

django_spire/auth/templates/django_spire/auth/page/login_page.html

@@ -9,4 +9,6 @@
             Forgot my password
         </a>
     </div>
+    {% include 'django_spire/auth/element/android_and_chrome_app_install_element.html' %}
+    {% include 'django_spire/auth/element/ios_app_install_element.html' %}
 {% endblock %}

django_spire/comment/mixins.py

@@ -3,17 +3,17 @@ from __future__ import annotations
 from typing import TYPE_CHECKING
 
 from django.contrib.contenttypes.fields import GenericRelation
-from django.db import models
 
 from django_spire.comment.models import Comment
+from django_spire.history.activity.mixins import ActivityMixin
 
 if TYPE_CHECKING:
     from django.contrib.auth.models import User
 
 
-class CommentModelMixin(models.Model):
+class CommentModelMixin(ActivityMixin):
     comments = GenericRelation(
-        'comment.Comment',
+        Comment,
         related_query_name='comment',
         editable=False
     )

django_spire/comment/templates/django_spire/comment/card/comment_list_card.html

@@ -1,30 +1,33 @@
 {% extends 'django_spire/card/title_card.html' %}
 
 {% load permission_tags %}
+{% load model_tags %}
 
 {% block card_title %}
     Comments
 {% endblock %}
 
 {% block card_button %}
+    {% with app_label=obj|model_app_label model_name=obj|model_name %}
         {% check_permission user app_label model_name 'change' as has_access %}
         {% if has_access %}
             <span
-                @click="dispatch_modal_view('{% url "comment:form_content" obj_pk=obj.pk comment_pk=0 app_label=app_label model_name=model_name %}')"
+                    @click="dispatch_modal_view('{% url "django_spire:comment:form_content" obj_pk=obj.pk comment_pk=0 app_label=app_label model_name=model_name %}')"
             >
-                {% include 'button/primary_dark_button.html' with button_logo_only='bi bi-plus' %}
-            </span>
+                    {% include 'django_spire/button/primary_button.html' with button_text='Add' button_icon='bi bi-plus' %}
+                </span>
         {% endif %}
+    {% endwith %}
 {% endblock %}
 
 {% block card_title_content %}
     {% with obj.comments.active.prefetch_user as comments %}
         {% if comments %}
             {% for comment in comments %}
-                {% include 'comment/item/comment_item.html' %}
+                {% include 'django_spire/comment/item/comment_item.html' %}
             {% endfor %}
         {% else %}
-            {% include 'item/no_data_item.html' %}
+            {% include 'django_spire/item/no_data_item.html' %}
         {% endif %}
     {% endwith %}
 {% endblock %}

django_spire/comment/templates/django_spire/comment/form/comment_form.html

@@ -1,18 +1,18 @@
 {% extends 'django_spire/modal/content/modal_title_content.html' %}
 
 {% block modal_content_title %}
-    Comment
+    {{ model_name }} Comment
 {% endblock %}
 
 {% block modal_content_content %}
     <form
-        action="{% url 'comment:form' comment_pk=comment.pk|default:0 obj_pk=obj_pk app_label=app_label model_name=model_name %}"
+            action="{% url 'django_spire:comment:form' comment_pk=comment.pk|default:0 obj_pk=obj_pk app_label=app_label model_name=model_name %}"
         method="post"
     >
         {% csrf_token %}
         {% include 'django_spire/comment/form/content/comment_form_content.html' %}
         <div class="pt-3">
-            {% include 'django_spire/contrib/form/form_submit_button.html' %}
+            {% include 'django_spire/contrib/form/button/form_submit_button.html' %}
         </div>
     </form>
 {% endblock %}

django_spire/comment/templates/django_spire/comment/form/content/comment_form_content.html

@@ -4,6 +4,7 @@
             comment: new ModelObjectGlue('comment'),
             async init() {
                 await this.comment.get()
+                this.comment.glue_fields.information.label = 'Message'
             }
         }"
 >

django_spire/comment/templates/django_spire/comment/item/comment_item_ellipsis.html

@@ -1,5 +1,6 @@
 {% extends 'django_spire/dropdown/ellipsis_dropdown.html' %}
 {% load spire_core_tags %}
+{% load model_tags %}
 
 {% block dropdown_content %}
 {#    {% include 'django_spire/comment/element/comment_edit_link.html' %}#}
@@ -8,14 +9,17 @@
 {#    {% endif %}#}
 
     {#    {% url 'comment:delete_form' pk=comment.pk as delete_url %}#}
-    {% if comment.user_id == user.id %}
-        {% url 'comment:form_content' comment_pk=comment.pk obj_pk=obj.pk app_label=app_label model_name=model_name as edit_url %}
-        {% include 'django_spire/dropdown/element/ellipsis_dropdown_modal_link_element.html' with link_text='Edit' view_url=edit_url %}
-    {% endif %}
-    {% if comment.user_id == user.id %}
-        {% url 'comment:delete_form' comment_pk=comment.pk obj_pk=obj.pk app_label=app_label model_name=model_name as delete_url %}
-        {% include 'django_spire/dropdown/element/ellipsis_dropdown_modal_link_element.html' with link_text='Delete' link_css='text-danger' view_url=delete_url %}
-    {% endif %}
+
+    {% with app_label=obj|model_app_label model_name=obj|model_name %}
+        {% if comment.user_id == user.id %}
+            {% url 'django_spire:comment:form_content' comment_pk=comment.pk obj_pk=obj.pk app_label=app_label model_name=model_name as edit_url %}
+            {% include 'django_spire/dropdown/element/ellipsis_dropdown_modal_link_element.html' with link_text='Edit' view_url=edit_url %}
+        {% endif %}
+        {% if comment.user_id == user.id %}
+            {% url 'django_spire:comment:delete_form' comment_pk=comment.pk obj_pk=obj.pk app_label=app_label model_name=model_name as delete_url %}
+            {% include 'django_spire/dropdown/element/ellipsis_dropdown_modal_link_element.html' with link_text='Delete' link_css='text-danger' view_url=delete_url %}
+        {% endif %}
+    {% endwith %}
 {#    {% if comment.user_id == user.id %}#}
 {#        {% include 'django_spire/dropdown/element/dropdown_link_element.html' with link_text='Delete' link_css='text-danger' link_href=delete_url %}#}
 {#    {% endif %}#}

django_spire/comment/views.py

@@ -2,6 +2,7 @@ from __future__ import annotations
 
 from typing import TYPE_CHECKING
 
+import django_glue as dg
 from django.contrib import messages
 from django.contrib.auth.decorators import login_required
 from django.http import HttpResponseRedirect
@@ -9,15 +10,14 @@ from django.shortcuts import get_object_or_404
 from django.template.response import TemplateResponse
 from django.urls import reverse
 
+from django_spire.auth.group.utils import has_app_permission_or_404
 from django_spire.comment import models
 from django_spire.comment.forms import CommentForm
-from django_spire.core.redirect import safe_redirect_url
-from django_spire.core.shortcuts import get_object_or_null_obj, model_object_from_app_label
 from django_spire.contrib.form.utils import show_form_errors
-from django_spire.auth.group.utils import has_app_permission_or_404
 from django_spire.contrib.generic_views import dispatch_modal_delete_form_content
-
-import django_glue as dg
+from django_spire.core.redirect import safe_redirect_url
+from django_spire.core.shortcuts import get_object_or_null_obj, \
+    model_object_from_app_label
 
 if TYPE_CHECKING:
     from django.core.handlers.wsgi import WSGIRequest
@@ -112,7 +112,7 @@ def comment_modal_delete_form_view(
         messages.warning(request, 'You can only delete your comments.')
         return HttpResponseRedirect(return_url)
 
-    form_action = reverse('comment:delete_form', kwargs={
+    form_action = reverse('django_spire:comment:delete_form', kwargs={
         'comment_pk': comment_pk,
         'obj_pk': obj_pk,
         'app_label': app_label,
@@ -123,8 +123,7 @@ def comment_modal_delete_form_view(
         obj.add_activity(
             user=request.user,
             verb='deleted',
-            device=request.device,
-            information=f'{request.user.get_full_name()} deleted a comment on "{obj}".'
+            information=f'{request.user.get_full_name()} deleted a comment on "{obj}".',
         )
 
     return dispatch_modal_delete_form_content(
@@ -133,4 +132,5 @@ def comment_modal_delete_form_view(
         form_action=form_action,
         activity_func=add_activity,
         return_url=return_url,
+        show_success_message=True
     )

django_spire/consts.py

@@ -1,4 +1,4 @@
-__VERSION__ = '0.25.1'
+__VERSION__ = '0.26.0'
 
 MAINTENANCE_MODE_SETTINGS_NAME = 'MAINTENANCE_MODE'
 

django_spire/contrib/form/utils.py

@@ -6,10 +6,10 @@ from django.contrib import messages
 
 if TYPE_CHECKING:
     from django.core.handlers.wsgi import WSGIRequest
-    from django.forms import Form
+    from django.forms import BaseForm
 
 
-def form_errors_as_list(form: Form) -> list[str]:
+def form_errors_as_list(form: BaseForm) -> list[str]:
     form_errors = []
 
     for field_name, error_list in form.errors.items():
@@ -34,7 +34,7 @@ def form_errors_as_list(form: Form) -> list[str]:
     return form_errors
 
 
-def show_form_errors(request: WSGIRequest, *forms: Form) -> None:
+def show_form_errors(request: WSGIRequest, *forms: BaseForm) -> None:
     for form in forms:
         for error in form_errors_as_list(form):
             messages.error(request=request, message=error)

django_spire/contrib/progress/session.py

@@ -13,7 +13,7 @@ from django_spire.contrib.progress.enums import ProgressStatus
 from django_spire.contrib.progress.tasks import ParallelTask, SequentialTask
 
 if TYPE_CHECKING:
-    from typing_extensions import Any, Callable, Generator
+    from typing import Any, Callable, Generator
 
 
 SIMULATION_MESSAGES = [

django_spire/contrib/queryset/filter_tools.py

@@ -1,9 +1,10 @@
 from __future__ import annotations
 
-from typing import TYPE_CHECKING
+from collections.abc import Sequence
+from typing import Any
 
-if TYPE_CHECKING:
-    from django.db.models import QuerySet
+from django.contrib.contenttypes.fields import GenericForeignKey
+from django.db.models import QuerySet, Field, ForeignObjectRel, ForeignKey
 
 
 def filter_by_lookup_map(
@@ -16,19 +17,15 @@ def filter_by_lookup_map(
     Filters a given queryset based on a lookup map and provided data. Additional filters
     can also be applied if provided.
 
-    Parameters:
-        queryset (QuerySet): The queryset to be filtered.
-        lookup_map (dict): A dictionary mapping input data keys to filtering fields in
-            the queryset.
-        data (dict): A dictionary containing key-value pairs to filter the queryset.
-        extra_filters (list | None): Optional. A list of extra positional filter
-            arguments to be applied. Defaults to None.
-
-    Returns:
-        QuerySet: The filtered queryset.
+    :param queryset (QuerySet): The queryset to be filtered.
+    :param lookup_map (dict): A dictionary mapping input data keys to filtering fields in
+        the queryset.
+    :param data (dict): A dictionary containing key-value pairs to filter the queryset.
+    :param extra_filters (list | None): Optional. A list of extra positional filter
+        arguments to be applied. Defaults to None.
 
+    :returns: QuerySet: The filtered queryset.
     """
-
     if extra_filters is None:
         extra_filters = {}
 
@@ -39,3 +36,48 @@ def filter_by_lookup_map(
     } | extra_filters
 
     return queryset.filter(**lookup_kwargs)
+
+
+def _get_kwarg_name_for_filter_field(
+    field: Field[Any, Any] | ForeignObjectRel | GenericForeignKey,
+    val: Any
+) -> str:
+    """
+    Determines the appropriate keyword argument name for filtering based on the field type
+    and value type.
+
+    :param field (Field | ForeignObjectRel | GenericForeignKey): The model field to generate
+        the filter keyword argument for.
+    :param val (Any): The value to be used for filtering.
+
+    :returns: str: The keyword argument string suitable for filtering.
+    """
+    if isinstance(val, Sequence):
+        if isinstance(field, ForeignKey):
+            return f'{field.name}_id__in'
+        return f'{field.name}__in'
+    else:
+        return field.name
+
+
+def filter_by_model_fields(queryset: QuerySet, data: dict) -> QuerySet:
+    """
+    Filters a given queryset based on the queryset's model fields and provided data.
+
+    :param queryset (QuerySet): The queryset to be filtered.
+    :param data (dict): A dictionary containing key-value pairs to filter the queryset.
+
+    :returns: QuerySet: The filtered queryset.
+    """
+    model_fields = [f for f in queryset.model._meta.get_fields()]
+
+    lookup_kwargs = {
+        _get_kwarg_name_for_filter_field(
+            field=model_field,
+            val=data[model_field.name]
+        ): data[model_field.name]
+        for model_field in model_fields
+        if model_field.name in data and data[model_field.name] not in (None, "", [])
+    }
+
+    return queryset.filter(**lookup_kwargs)