open-api-framework 0.8.1__tar.gz → 0.9.1__tar.gz

{open_api_framework-0.8.1 → open_api_framework-0.9.1}/CHANGELOG.rst

@@ -1,6 +1,30 @@
 Changelog
 =========
 
+0.9.1 (2024-12-16)
+------------------
+
+**Bugfixes/QOL**
+
+* Change ``LOG_STDOUT`` default value to True
+* Re-add separate ``CELERY_LOGLEVEL`` configuration setting
+
+
+0.9.0 (2024-11-11)
+------------------
+**New Features**
+
+* Add ``SESSION_COOKIE_AGE`` configurable setting
+* Add user session management admin
+
+.. note::
+
+ SessionProfile admin should be added to admin index and its fixture.
+
+**Bugfixes/QOL**
+
+* fix runtime configuration for django-log-outgoing-requests
+
 0.8.1 (2024-09-26)
 ------------------
 

{open_api_framework-0.8.1/open_api_framework.egg-info → open_api_framework-0.9.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: open_api_framework
-Version: 0.8.1
+Version: 0.9.1
 Summary: A metapackage for registration components, that bundles the dependencies shared between these components and provides generic settings
 Author-email: Maykin Media <support@maykinmedia.nl>
 License: Copyright © Maykin 2024
@@ -59,6 +59,7 @@ Requires-Dist: celery>=5.4.0
 Requires-Dist: flower>=2.0.1
 Requires-Dist: maykin-2fa>=1.0.1
 Requires-Dist: django-setup-configuration>=0.1.0
+Requires-Dist: django-sessionprofile>=3.0.0
 Provides-Extra: tests
 Requires-Dist: pytest; extra == "tests"
 Requires-Dist: pytest-django; extra == "tests"
@@ -66,6 +67,7 @@ Requires-Dist: tox; extra == "tests"
 Requires-Dist: isort; extra == "tests"
 Requires-Dist: black; extra == "tests"
 Requires-Dist: flake8; extra == "tests"
+Requires-Dist: factory-boy; extra == "tests"
 Provides-Extra: coverage
 Requires-Dist: pytest-cov; extra == "coverage"
 Provides-Extra: docs
@@ -78,7 +80,7 @@ Requires-Dist: twine; extra == "release"
 Open API Framework
 ==================
 
-:Version: 0.8.1
+:Version: 0.9.1
 :Source: https://github.com/maykinmedia/open-api-framework
 :Keywords: metapackage, dependencies
 

{open_api_framework-0.8.1 → open_api_framework-0.9.1}/README.rst

@@ -1,7 +1,7 @@
 Open API Framework
 ==================
 
-:Version: 0.8.1
+:Version: 0.9.1
 :Source: https://github.com/maykinmedia/open-api-framework
 :Keywords: metapackage, dependencies
 

open_api_framework-0.9.1/open_api_framework/admin.py

@@ -0,0 +1,40 @@
+from django.contrib import admin
+
+from sessionprofile.models import SessionProfile
+
+from open_api_framework.utils import get_session_store
+
+
+@admin.register(SessionProfile)
+class SessionProfileAdmin(admin.ModelAdmin):
+    list_display = ["session_key", "user", "exists"]
+
+    @property
+    def SessionStore(self):
+
+        return get_session_store()
+
+    def get_queryset(self, request):
+        qs = super().get_queryset(request)
+        return qs.filter(user=request.user)
+
+    def has_add_permission(self, request, obj=None):
+        return False
+
+    def has_change_permission(self, request, obj=None):
+        return False
+
+    @admin.display(boolean=True)
+    def exists(self, obj):
+        return self.SessionStore().exists(obj.session_key)
+
+    def delete_model(self, request, obj):
+        self.SessionStore(obj.session_key).flush()
+        super().delete_model(request, obj)
+
+    def delete_queryset(self, request, queryset):
+
+        for session_profile in queryset.iterator():
+            self.SessionStore(session_profile.session_key).flush()
+
+        super().delete_queryset(request, queryset)

{open_api_framework-0.8.1 → open_api_framework-0.9.1}/open_api_framework/conf/base.py

@@ -229,19 +229,20 @@ INSTALLED_APPS = [
     "mozilla_django_oidc_db",
     "log_outgoing_requests",
     "django_setup_configuration",
+    "sessionprofile",
     "open_api_framework",
     PROJECT_DIRNAME,
 ]
 
 MIDDLEWARE = [
     "django.middleware.security.SecurityMiddleware",
+    "sessionprofile.middleware.SessionProfileMiddleware",
     "django.contrib.sessions.middleware.SessionMiddleware",
     "corsheaders.middleware.CorsMiddleware",
     "django.middleware.common.CommonMiddleware",
     "django.middleware.csrf.CsrfViewMiddleware",
     "django.contrib.auth.middleware.AuthenticationMiddleware",
     "maykin_2fa.middleware.OTPMiddleware",
-    "mozilla_django_oidc_db.middleware.SessionRefresh",
     "django.contrib.messages.middleware.MessageMiddleware",
     "django.middleware.clickjacking.XFrameOptionsMiddleware",
     "axes.middleware.AxesMiddleware",
@@ -349,7 +350,7 @@ DEFAULT_FROM_EMAIL = config(
 # LOGGING
 #
 LOG_STDOUT = config(
-    "LOG_STDOUT", default=False, help_text="whether to log to stdout or not"
+    "LOG_STDOUT", default=True, help_text="whether to log to stdout or not"
 )
 LOG_LEVEL = config(
     "LOG_LEVEL",
@@ -376,6 +377,13 @@ if LOG_QUERIES and not DEBUG:
         RuntimeWarning,
     )
 
+CELERY_LOGLEVEL = config(
+    "CELERY_LOGLEVEL",
+    default="INFO",
+    help_text="control the verbosity of logging output for celery, independent of ``LOG_LEVEL``."
+    " Available values are ``CRITICAL``, ``ERROR``, ``WARNING``, ``INFO`` and ``DEBUG``",
+)
+
 LOGGING_DIR = Path(BASE_DIR) / "log"
 
 logging_root_handlers = ["console"] if LOG_STDOUT else ["project"]
@@ -414,6 +422,19 @@ LOGGING = {
             "class": "logging.StreamHandler",
             "formatter": "db",
         },
+        "celery_console": {
+            "level": CELERY_LOGLEVEL,
+            "class": "logging.StreamHandler",
+            "formatter": "timestamped",
+        },
+        "celery_file": {
+            "level": CELERY_LOGLEVEL,
+            "class": "logging.handlers.RotatingFileHandler",
+            "filename": Path(LOGGING_DIR) / "celery.log",
+            "formatter": "verbose",
+            "maxBytes": 1024 * 1024 * 10,  # 10 MB
+            "backupCount": 10,
+        },
         "django": {
             "level": LOG_LEVEL,
             "class": "logging.handlers.RotatingFileHandler",
@@ -501,11 +522,16 @@ LOGGING = {
             "handlers": (
                 ["log_outgoing_requests", "save_outgoing_requests"]
                 if LOG_REQUESTS
-                else []
+                else ["save_outgoing_requests"]
             ),
             "level": "DEBUG",
             "propagate": True,
         },
+        "celery": {
+            "handlers": ["celery_console"] if LOG_STDOUT else ["celery_file"],
+            "level": CELERY_LOGLEVEL,
+            "propagate": True,
+        },
     },
 }
 
@@ -535,6 +561,12 @@ AUTHENTICATION_BACKENDS = [
 
 SESSION_COOKIE_NAME = f"{PROJECT_DIRNAME}_sessionid"
 SESSION_ENGINE = "django.contrib.sessions.backends.cache"
+SESSION_COOKIE_AGE = config(
+    "SESSION_COOKIE_AGE",
+    default=1209600,
+    help_text="For how long, in seconds, the session cookie will be valid.",
+)
+
 
 LOGIN_URL = reverse_lazy("admin:login")
 LOGIN_REDIRECT_URL = reverse_lazy("admin:index")
@@ -1041,3 +1073,9 @@ CSP_FRAME_SRC = ["'self'"]
 # CSP_SANDBOX # too much
 
 CSP_UPGRADE_INSECURE_REQUESTS = False  # TODO enable on production?
+
+
+#
+# Django Solo
+#
+SOLO_CACHE = "default"

open_api_framework-0.9.1/open_api_framework/utils.py

@@ -0,0 +1,8 @@
+from importlib import import_module
+
+from django.conf import settings
+from django.contrib.sessions.backends.base import SessionBase
+
+
+def get_session_store() -> SessionBase:
+    return import_module(settings.SESSION_ENGINE).SessionStore

{open_api_framework-0.8.1 → open_api_framework-0.9.1/open_api_framework.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: open_api_framework
-Version: 0.8.1
+Version: 0.9.1
 Summary: A metapackage for registration components, that bundles the dependencies shared between these components and provides generic settings
 Author-email: Maykin Media <support@maykinmedia.nl>
 License: Copyright © Maykin 2024
@@ -59,6 +59,7 @@ Requires-Dist: celery>=5.4.0
 Requires-Dist: flower>=2.0.1
 Requires-Dist: maykin-2fa>=1.0.1
 Requires-Dist: django-setup-configuration>=0.1.0
+Requires-Dist: django-sessionprofile>=3.0.0
 Provides-Extra: tests
 Requires-Dist: pytest; extra == "tests"
 Requires-Dist: pytest-django; extra == "tests"
@@ -66,6 +67,7 @@ Requires-Dist: tox; extra == "tests"
 Requires-Dist: isort; extra == "tests"
 Requires-Dist: black; extra == "tests"
 Requires-Dist: flake8; extra == "tests"
+Requires-Dist: factory-boy; extra == "tests"
 Provides-Extra: coverage
 Requires-Dist: pytest-cov; extra == "coverage"
 Provides-Extra: docs
@@ -78,7 +80,7 @@ Requires-Dist: twine; extra == "release"
 Open API Framework
 ==================
 
-:Version: 0.8.1
+:Version: 0.9.1
 :Source: https://github.com/maykinmedia/open-api-framework
 :Keywords: metapackage, dependencies
 

{open_api_framework-0.8.1 → open_api_framework-0.9.1}/open_api_framework.egg-info/SOURCES.txt

@@ -5,9 +5,11 @@ README.rst
 pyproject.toml
 setup.cfg
 open_api_framework/__init__.py
+open_api_framework/admin.py
 open_api_framework/apps.py
 open_api_framework/context_processors.py
 open_api_framework/py.typed
+open_api_framework/utils.py
 open_api_framework.egg-info/PKG-INFO
 open_api_framework.egg-info/SOURCES.txt
 open_api_framework.egg-info/dependency_links.txt
@@ -27,5 +29,6 @@ open_api_framework/templates/open_api_framework/components/version.html
 open_api_framework/templatetags/__init__.py
 open_api_framework/templatetags/doc_tags.py
 open_api_framework/templatetags/open_api_framework.py
+tests/test_admin.py
 tests/test_config_helpers.py
 tests/test_generate_envvar_docs.py

{open_api_framework-0.8.1 → open_api_framework-0.9.1}/open_api_framework.egg-info/requires.txt

@@ -27,6 +27,7 @@ celery>=5.4.0
 flower>=2.0.1
 maykin-2fa>=1.0.1
 django-setup-configuration>=0.1.0
+django-sessionprofile>=3.0.0
 
 [coverage]
 pytest-cov
@@ -46,3 +47,4 @@ tox
 isort
 black
 flake8
+factory-boy

{open_api_framework-0.8.1 → open_api_framework-0.9.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "open_api_framework"
-version = "0.8.1"
+version = "0.9.1"
 description = "A metapackage for registration components, that bundles the dependencies shared between these components and provides generic settings"
 authors = [
     {name = "Maykin Media", email = "support@maykinmedia.nl"}
@@ -56,6 +56,7 @@ dependencies = [
     "flower>=2.0.1",
     "maykin-2fa>=1.0.1",
     "django-setup-configuration>=0.1.0",
+    "django-sessionprofile>=3.0.0",
 ]
 
 [project.urls]
@@ -72,6 +73,7 @@ tests = [
     "isort",
     "black",
     "flake8",
+    "factory-boy",
 ]
 coverage = [
     "pytest-cov",
@@ -101,7 +103,7 @@ testpaths = ["tests"]
 DJANGO_SETTINGS_MODULE = "testapp.settings"
 
 [tool.bumpversion]
-current_version = "0.8.1"
+current_version = "0.9.1"
 files = [
     {filename = "pyproject.toml"},
     {filename = "README.rst"},

open_api_framework-0.9.1/tests/test_admin.py

@@ -0,0 +1,197 @@
+from django.contrib.sessions.backends.cache import SessionStore as CachedSessionStore
+from django.contrib.sessions.backends.db import SessionStore as DBSessionStore
+from django.contrib.sessions.models import Session
+from django.test import override_settings
+from django.urls import reverse
+
+import pytest
+from sessionprofile.models import SessionProfile
+
+from open_api_framework.utils import get_session_store
+
+from .factories import SessionProfileFactory
+
+
+@pytest.fixture
+def session_changelist_url():
+    return reverse("admin:sessionprofile_sessionprofile_changelist")
+
+
+def test_session_profile_sanity(client, admin_user, session_changelist_url):
+
+    client.force_login(admin_user)
+    response = client.get(session_changelist_url)
+    assert response.status_code == 200
+
+    assert SessionProfile.objects.count() == 1
+
+    session = SessionProfile.objects.get()
+    assert client.session.session_key == session.session_key
+
+
+def test_only_session_profile_of_user_shown(
+    client, admin_user, django_user_model, session_changelist_url
+):
+
+    other_admin = django_user_model.objects.create_superuser("garry")
+
+    client.force_login(other_admin)
+    response = client.get(session_changelist_url)
+    assert response.status_code == 200
+
+    client.force_login(admin_user)
+    response = client.get(session_changelist_url)
+    assert response.status_code == 200
+
+    # two sessions, one for each user
+    assert SessionProfile.objects.count() == 2
+
+    # Session created after response, needs to be called again
+    response = client.get(session_changelist_url)
+
+    admin_user_session = SessionProfile.objects.get(user=admin_user)
+    assert admin_user_session.session_key in response.content.decode()
+
+    other_user_session = SessionProfile.objects.get(user=other_admin)
+    assert other_user_session.session_key not in response.content.decode()
+
+    # should only be able to access own page
+    change_url = reverse(
+        "admin:sessionprofile_sessionprofile_change",
+        args=[admin_user_session.session_key],
+    )
+    response = client.get(change_url)
+    assert response.status_code == 200
+
+    change_url = reverse(
+        "admin:sessionprofile_sessionprofile_change",
+        args=[other_user_session.session_key],
+    )
+    response = client.get(change_url)
+    assert response.status_code == 302
+    assert response.url == reverse("admin:index")
+
+
+def test_cant_delete_other_users_session(client, admin_user, django_user_model):
+    client.force_login(admin_user)
+
+    other_admin = django_user_model.objects.create_superuser("garry")
+
+    other_user_session = SessionProfileFactory(user=other_admin)
+
+    delete_url = reverse(
+        "admin:sessionprofile_sessionprofile_delete",
+        args=[other_user_session.session_key],
+    )
+
+    response = client.post(delete_url, {"post": "yes"})
+    assert response.status_code == 302
+
+    SessionStore = get_session_store()
+
+    assert SessionStore().exists(other_user_session.session_key)
+
+
+def test_delete_with_session_db_backend(client, admin_user, session_changelist_url):
+    client.force_login(admin_user)
+
+    session = SessionProfileFactory(user=admin_user)
+
+    assert SessionProfile.objects.count() == 1
+    # sesison created by login
+    assert Session.objects.count() == 2
+    assert DBSessionStore().exists(session.session_key)
+
+    url = reverse("admin:sessionprofile_sessionprofile_delete", args=[session.pk])
+
+    response = client.post(url, {"post": "yes"})
+    assert response.status_code == 302
+
+    # new session saved upon request
+    assert SessionProfile.objects.count() == 1
+    assert SessionProfile.objects.count() != session
+    assert Session.objects.count() == 1
+    assert not DBSessionStore().exists(session.session_key)
+
+
+@override_settings(SESSION_ENGINE="django.contrib.sessions.backends.cache")
+def test_delete_with_session_cache_backend(client, admin_user, session_changelist_url):
+    client.force_login(admin_user)
+
+    session = SessionProfileFactory(user=admin_user)
+
+    assert SessionProfile.objects.count() == 1
+    assert Session.objects.count() == 0
+    assert CachedSessionStore().exists(session.session_key)
+
+    url = reverse("admin:sessionprofile_sessionprofile_delete", args=[session.pk])
+
+    response = client.post(url, {"post": "yes"})
+    assert response.status_code == 302
+
+    # new session saved upon request
+    assert SessionProfile.objects.count() == 1
+    assert SessionProfile.objects.count() != session
+    assert Session.objects.count() == 0
+    assert not CachedSessionStore().exists(session.session_key)
+
+
+def test_delete_action_with_session_db_backend(
+    client, admin_user, session_changelist_url
+):
+    client.force_login(admin_user)
+    sessions = SessionProfileFactory.create_batch(5, user=admin_user)
+
+    # one created from user login
+    assert Session.objects.count() == 6
+    assert SessionProfile.objects.count() == 5
+
+    session_keys = [session.session_key for session in sessions]
+    for session_key in session_keys:
+        assert DBSessionStore().exists(session_key)
+
+    response = client.post(
+        session_changelist_url,
+        {"action": "delete_selected", "_selected_action": session_keys, "post": "yes"},
+    )
+    assert response.status_code == 302
+
+    # one is created as the post request is sent
+    assert SessionProfile.objects.count() == 1
+    assert Session.objects.count() == 1
+
+    for session_key in session_keys:
+        assert not DBSessionStore().exists(session_key)
+
+
+@override_settings(SESSION_ENGINE="django.contrib.sessions.backends.cache")
+def test_delete_action_with_session_cache_backend(
+    client, admin_user, session_changelist_url
+):
+
+    client.force_login(admin_user)
+    sessions = SessionProfileFactory.create_batch(5, user=admin_user)
+
+    # no db sessions are created
+    assert Session.objects.count() == 0
+    assert SessionProfile.objects.count() == 5
+
+    session_keys = [session.session_key for session in sessions]
+
+    # sessions are created
+    for session_key in session_keys:
+        assert CachedSessionStore().exists(session_key)
+
+    response = client.post(
+        session_changelist_url,
+        {"action": "delete_selected", "_selected_action": session_keys, "post": "yes"},
+    )
+    assert response.status_code == 302
+
+    # one is created as the post request is sent
+    assert SessionProfile.objects.count() == 1
+    assert Session.objects.count() == 0
+
+    # sessions should be deleted
+    for session_key in session_keys:
+        assert not CachedSessionStore().exists(session_key)