django-api-usage 0.1.5__tar.gz → 0.1.6__tar.gz

{django_api_usage-0.1.5/src/django_api_usage.egg-info → django_api_usage-0.1.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: django-api-usage
-Version: 0.1.5
+Version: 0.1.6
 Summary: Lightweight, privacy-first usage metering for Django APIs, with an optional deprecation lifecycle layer.
 Author-email: CodeSyntax <teknika@codesyntax.com>
 License-Expression: MIT
@@ -127,8 +127,12 @@ Django — **no dependency beyond Django itself** (no `django-object-actions` or
 similar):
 
 * **Endpoint stats** changelist: a search box (by endpoint path, route name, app,
-  method or replacement), filters by date, profile and role, and the **sum of
-  the `count` column** for the rows matching the current filters.
+  method or replacement), filters by date, client type, status class, and
+  **Application** / **Method**, plus the **sum of the `count` column** for the
+  rows matching the current filters. The Method filter lists the riskiest verbs
+  first (`DELETE`, `POST`, ...), so write and destructive calls stand out.
+* **Endpoint** changelist: the same Application / Method filters, plus
+  deprecation state, the site and the CSV export.
 * **Flush now**: moves counters buffered in the cache into the database, so they
   appear immediately when you run with `BUFFER_BACKEND = "cache"`.
 * **Clear statistics**: empties the aggregated counters behind a confirmation

{django_api_usage-0.1.5 → django_api_usage-0.1.6}/README.md

@@ -88,8 +88,12 @@ Django — **no dependency beyond Django itself** (no `django-object-actions` or
 similar):
 
 * **Endpoint stats** changelist: a search box (by endpoint path, route name, app,
-  method or replacement), filters by date, profile and role, and the **sum of
-  the `count` column** for the rows matching the current filters.
+  method or replacement), filters by date, client type, status class, and
+  **Application** / **Method**, plus the **sum of the `count` column** for the
+  rows matching the current filters. The Method filter lists the riskiest verbs
+  first (`DELETE`, `POST`, ...), so write and destructive calls stand out.
+* **Endpoint** changelist: the same Application / Method filters, plus
+  deprecation state, the site and the CSV export.
 * **Flush now**: moves counters buffered in the cache into the database, so they
   appear immediately when you run with `BUFFER_BACKEND = "cache"`.
 * **Clear statistics**: empties the aggregated counters behind a confirmation

{django_api_usage-0.1.5 → django_api_usage-0.1.6}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "django-api-usage"
-version = "0.1.5"
+version = "0.1.6"
 description = "Lightweight, privacy-first usage metering for Django APIs, with an optional deprecation lifecycle layer."
 readme = "README.md"
 license = "MIT"
@@ -42,7 +42,11 @@ Issues = "https://github.com/codesyntax/django-api-usage/issues"
 where = ["src"]
 
 [tool.setuptools.package-data]
-django_api_usage = ["templates/admin/django_api_usage/endpointstat/*.html"]
+django_api_usage = [
+    "templates/admin/django_api_usage/endpointstat/*.html",
+    "locale/*/LC_MESSAGES/*.po",
+    "locale/*/LC_MESSAGES/*.mo",
+]
 
 [tool.black]
 line-length = 88

{django_api_usage-0.1.5 → django_api_usage-0.1.6}/src/django_api_usage/__init__.py

@@ -1,3 +1,3 @@
 """django-api-usage: usage metering for Django APIs, with deprecation support."""
 
-__version__ = "0.1.5"
+__version__ = "0.1.6"

{django_api_usage-0.1.5 → django_api_usage-0.1.6}/src/django_api_usage/admin.py

@@ -60,6 +60,68 @@ class CsvExportMixin:
         return response
 
 
+#: HTTP methods, riskiest first: the point of the filter is spotting the
+#: write/destructive calls (POST, DELETE, ...) instead of the read ones.
+METHOD_ORDER = ("DELETE", "POST", "PUT", "PATCH", "GET", "HEAD", "OPTIONS")
+
+
+class AppLabelListFilter(admin.SimpleListFilter):
+    """Distinct application labels, under a readable title."""
+
+    title = _("Application")
+    parameter_name = "app_label"
+    #: Lookup against the admin's model; overridden for related filters.
+    field_path = "app_label"
+
+    def lookups(self, request, model_admin):
+        values = (
+            model_admin.model.objects.order_by()
+            .values_list(self.field_path, flat=True)
+            .distinct()
+        )
+        return [(value, value) for value in sorted(v for v in values if v)]
+
+    def queryset(self, request, queryset):
+        if not self.value():
+            return queryset
+        return queryset.filter(**{self.field_path: self.value()})
+
+
+class MethodListFilter(admin.SimpleListFilter):
+    """HTTP methods, riskiest (DELETE, POST, ...) first."""
+
+    title = _("Method")
+    parameter_name = "method"
+    field_path = "method"
+
+    def lookups(self, request, model_admin):
+        values = set(
+            model_admin.model.objects.order_by()
+            .values_list(self.field_path, flat=True)
+            .distinct()
+        )
+        ordered = [method for method in METHOD_ORDER if method in values]
+        rest = sorted(m for m in values if m and m not in METHOD_ORDER)
+        return [(method, method) for method in ordered + rest]
+
+    def queryset(self, request, queryset):
+        if not self.value():
+            return queryset
+        return queryset.filter(**{self.field_path: self.value()})
+
+
+class StatAppLabelListFilter(AppLabelListFilter):
+    """Application filter for the stats changelist (through the endpoint)."""
+
+    field_path = "endpoint__app_label"
+
+
+class StatMethodListFilter(MethodListFilter):
+    """Method filter for the stats changelist (through the endpoint)."""
+
+    field_path = "endpoint__method"
+
+
 @admin.register(Endpoint)
 class EndpointAdmin(CsvExportMixin, admin.ModelAdmin):
     actions = ("export_as_csv",)
@@ -86,7 +148,12 @@ class EndpointAdmin(CsvExportMixin, admin.ModelAdmin):
         "replacement",
         "owner",
     )
-    list_filter = ("deprecated", "app_label", "method", "site_id")
+    list_filter = (
+        "deprecated",
+        AppLabelListFilter,
+        MethodListFilter,
+        "site_id",
+    )
     search_fields = ("route_path", "route_name", "replacement", "owner", "notes")
     list_editable = ("deprecated", "sunset_date", "replacement", "owner")
 
@@ -108,7 +175,13 @@ class EndpointStatAdmin(CsvExportMixin, admin.ModelAdmin):
         ("count", "count"),
     )
     list_display = ("date", "endpoint", "client_type", "status_class", "count")
-    list_filter = ("date", "client_type", "status_class")
+    list_filter = (
+        "date",
+        "client_type",
+        "status_class",
+        StatAppLabelListFilter,
+        StatMethodListFilter,
+    )
     list_select_related = ("endpoint",)
     date_hierarchy = "date"
     # Search across the related endpoint (case-insensitive "contains").

django_api_usage-0.1.6/src/django_api_usage/locale/eu/LC_MESSAGES/django.po

@@ -0,0 +1,112 @@
+# Basque translation of django-api-usage.
+# Copyright (C) 2026 CodeSyntax
+# This file is distributed under the same license as the django-api-usage package.
+# Urtzi Odriozola <uodriozola@codesyntax.com>, 2026.
+#
+msgid ""
+msgstr ""
+"Project-Id-Version: django-api-usage\n"
+"Report-Msgid-Bugs-To: \n"
+"POT-Creation-Date: 2026-10-08 06:10-0500\n"
+"PO-Revision-Date: 2026-10-08 06:20-0500\n"
+"Last-Translator: Urtzi Odriozola <uodriozola@codesyntax.com>\n"
+"Language-Team: Basque\n"
+"Language: eu\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Plural-Forms: nplurals=2; plural=(n != 1);\n"
+
+#: src/django_api_usage/admin.py:46
+msgid "Export selected rows to CSV"
+msgstr "Esportatu hautatutako errenkadak CSVra"
+
+#: src/django_api_usage/admin.py:71
+msgid "Application"
+msgstr "Aplikazioa"
+
+#: src/django_api_usage/admin.py:93
+msgid "Method"
+msgstr "Metodoa"
+
+#: src/django_api_usage/admin.py:196
+msgid ""
+"Search by endpoint path, route name, app, method or replacement (for example "
+"'herriak' or 'artikuluak')."
+msgstr ""
+"Bilatu endpointaren bidearen, route-izenaren, aplikazioaren, metodoaren edo "
+"ordezkoaren arabera (adibidez 'herriak' edo 'artikuluak')."
+
+#: src/django_api_usage/admin.py:251
+#, python-brace-format
+msgid "Flushed {count} buffered counter(s)."
+msgstr "{count} kontagailu eraman dira bufferretik datu-basera."
+
+#: src/django_api_usage/admin.py:258
+msgid ""
+"Nothing was buffered: with BUFFER_BACKEND='db' counters are already in the "
+"database."
+msgstr ""
+"Ez zegoen ezer bufferrean: BUFFER_BACKEND='db' denean kontagailuak jada datu-"
+"basean daude."
+
+#: src/django_api_usage/admin.py:270
+#: src/django_api_usage/templates/admin/django_api_usage/endpointstat/change_list.html:12
+#: src/django_api_usage/templates/admin/django_api_usage/endpointstat/confirm_clear.html:8
+msgid "Clear statistics"
+msgstr "Estatistikak hustu"
+
+#: src/django_api_usage/admin.py:282
+#, python-brace-format
+msgid "Deleted {count} statistic row(s)."
+msgstr "{count} estatistika-errenkada ezabatu dira."
+
+#: src/django_api_usage/templates/admin/django_api_usage/endpointstat/change_list.html:8
+msgid "Flush now"
+msgstr "Flush orain"
+
+#: src/django_api_usage/templates/admin/django_api_usage/endpointstat/change_list.html:21
+#, python-format
+msgid "TOTAL COUNT: %(total)s"
+msgstr ""
+
+#: src/django_api_usage/templates/admin/django_api_usage/endpointstat/confirm_clear.html:6
+msgid "Home"
+msgstr ""
+
+#: src/django_api_usage/templates/admin/django_api_usage/endpointstat/confirm_clear.html:7
+msgid "Endpoint stats"
+msgstr "Endpoint estatistikak"
+
+#: src/django_api_usage/templates/admin/django_api_usage/endpointstat/confirm_clear.html:14
+#, python-format
+msgid ""
+"\n"
+"      This will delete the only aggregated statistic row. Endpoints and "
+"their\n"
+"      deprecation metadata are kept.\n"
+"    "
+msgid_plural ""
+"\n"
+"      This will delete all %(counter)s aggregated statistic rows. Endpoints\n"
+"      and their deprecation metadata are kept.\n"
+"    "
+msgstr[0] ""
+"\n"
+"      Estatistika-errenkada agregatu bakarra ezabatuko da. Endpointak eta "
+"haien\n"
+"      deprecation-metadatuak mantendu egingo dira.\n"
+"    "
+msgstr[1] ""
+"\n"
+"      %(counter)s estatistika-errenkada agregatu ezabatuko dira. Endpointak\n"
+"      eta haien deprecation-metadatuak mantendu egingo dira.\n"
+"    "
+
+#: src/django_api_usage/templates/admin/django_api_usage/endpointstat/confirm_clear.html:24
+msgid "Yes, clear statistics"
+msgstr "Bai, estatistikak hustu"
+
+#: src/django_api_usage/templates/admin/django_api_usage/endpointstat/confirm_clear.html:25
+msgid "Cancel"
+msgstr ""

{django_api_usage-0.1.5 → django_api_usage-0.1.6/src/django_api_usage.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: django-api-usage
-Version: 0.1.5
+Version: 0.1.6
 Summary: Lightweight, privacy-first usage metering for Django APIs, with an optional deprecation lifecycle layer.
 Author-email: CodeSyntax <teknika@codesyntax.com>
 License-Expression: MIT
@@ -127,8 +127,12 @@ Django — **no dependency beyond Django itself** (no `django-object-actions` or
 similar):
 
 * **Endpoint stats** changelist: a search box (by endpoint path, route name, app,
-  method or replacement), filters by date, profile and role, and the **sum of
-  the `count` column** for the rows matching the current filters.
+  method or replacement), filters by date, client type, status class, and
+  **Application** / **Method**, plus the **sum of the `count` column** for the
+  rows matching the current filters. The Method filter lists the riskiest verbs
+  first (`DELETE`, `POST`, ...), so write and destructive calls stand out.
+* **Endpoint** changelist: the same Application / Method filters, plus
+  deprecation state, the site and the CSV export.
 * **Flush now**: moves counters buffered in the cache into the database, so they
   appear immediately when you run with `BUFFER_BACKEND = "cache"`.
 * **Clear statistics**: empties the aggregated counters behind a confirmation

{django_api_usage-0.1.5 → django_api_usage-0.1.6}/src/django_api_usage.egg-info/SOURCES.txt

@@ -19,6 +19,8 @@ src/django_api_usage.egg-info/SOURCES.txt
 src/django_api_usage.egg-info/dependency_links.txt
 src/django_api_usage.egg-info/requires.txt
 src/django_api_usage.egg-info/top_level.txt
+src/django_api_usage/locale/eu/LC_MESSAGES/django.mo
+src/django_api_usage/locale/eu/LC_MESSAGES/django.po
 src/django_api_usage/management/__init__.py
 src/django_api_usage/management/commands/__init__.py
 src/django_api_usage/management/commands/api_usage_flush.py
@@ -33,5 +35,6 @@ tests/test_checks.py
 tests/test_commands.py
 tests/test_csv_export.py
 tests/test_drf.py
+tests/test_filters.py
 tests/test_middleware.py
 tests/test_models.py

django_api_usage-0.1.6/tests/test_filters.py

@@ -0,0 +1,122 @@
+"""Tests for the Application / Method changelist filters."""
+
+from django.contrib import admin as django_admin
+from django.contrib.auth.models import User
+from django.urls import reverse
+from django.utils import translation
+
+from django_api_usage.admin import MethodListFilter
+from django_api_usage.models import Endpoint, EndpointStat
+
+from .base import UsageTestCase
+
+ENDPOINT_CHANGELIST = "admin:django_api_usage_endpoint_changelist"
+STAT_CHANGELIST = "admin:django_api_usage_endpointstat_changelist"
+
+
+class FilterTest(UsageTestCase):
+    def setUp(self):
+        super().setUp()
+        self.admin = User.objects.create_superuser("admin", "a@example.com", "pw")
+        self.client.force_login(self.admin)
+
+        self.get_endpoint = Endpoint.objects.create(
+            app_label="api",
+            route_path="api/3.0/artikuluak/",
+            route_name="artikuluak-list",
+            method="GET",
+        )
+        self.post_endpoint = Endpoint.objects.create(
+            app_label="api",
+            route_path="api/3.0/artikuluak/",
+            route_name="artikuluak-create",
+            method="POST",
+        )
+        self.delete_endpoint = Endpoint.objects.create(
+            app_label="gida",
+            route_path="api/3.0/gida/",
+            route_name="gida-list",
+            method="DELETE",
+        )
+        # Stats for the risky ones only; GET has no usage.
+        EndpointStat.objects.create(
+            endpoint=self.post_endpoint,
+            date="2026-10-08",
+            client_type="anon",
+            status_class="2xx",
+            count=3,
+        )
+        self.delete_stat = EndpointStat.objects.create(
+            endpoint=self.delete_endpoint,
+            date="2026-10-08",
+            client_type="anon",
+            status_class="2xx",
+            count=1,
+        )
+
+    def endpoints(self, **params):
+        response = self.client.get(reverse(ENDPOINT_CHANGELIST), params)
+        self.assertEqual(response.status_code, 200)
+        return set(response.context["cl"].queryset)
+
+    def stats(self, **params):
+        response = self.client.get(reverse(STAT_CHANGELIST), params)
+        self.assertEqual(response.status_code, 200)
+        return set(response.context["cl"].queryset)
+
+    # -- endpoints ----------------------------------------------------------
+
+    def test_endpoint_admin_filters_by_method(self):
+        self.assertEqual(self.endpoints(method="POST"), {self.post_endpoint})
+
+    def test_endpoint_admin_filters_by_application(self):
+        self.assertEqual(self.endpoints(app_label="gida"), {self.delete_endpoint})
+
+    def test_endpoint_admin_without_filter_lists_everything(self):
+        self.assertEqual(
+            self.endpoints(),
+            {self.get_endpoint, self.post_endpoint, self.delete_endpoint},
+        )
+
+    # -- stats (through the endpoint) ---------------------------------------
+
+    def test_stats_admin_filters_by_method(self):
+        rows = self.stats(method="DELETE")
+        self.assertEqual([row.endpoint for row in rows], [self.delete_endpoint])
+
+    def test_stats_admin_filters_by_application(self):
+        rows = self.stats(app_label="api")
+        self.assertEqual([row.endpoint for row in rows], [self.post_endpoint])
+
+    # -- filter presentation ------------------------------------------------
+
+    def test_titles_are_readable_instead_of_raw_field_names(self):
+        html = self.client.get(reverse(STAT_CHANGELIST)).content.decode()
+
+        self.assertIn("Application", html)
+        self.assertIn("Method", html)
+        self.assertNotIn("Irizpidea: app label", html)
+
+    def test_method_lookups_put_the_risky_ones_first(self):
+        model_admin = django_admin.site._registry[Endpoint]
+        list_filter = MethodListFilter(
+            request=None, params={}, model=Endpoint, model_admin=model_admin
+        )
+
+        lookups = [value for value, _ in list_filter.lookups(None, model_admin)]
+
+        self.assertEqual(lookups, ["DELETE", "POST", "GET"])
+
+    def test_basque_catalog_is_shipped(self):
+        with translation.override("eu"):
+            html = self.client.get(reverse(ENDPOINT_CHANGELIST)).content.decode()
+
+            self.assertIn("Aplikazioa", html)
+            self.assertIn("Metodoa", html)
+
+    def test_total_count_label_is_left_untranslated(self):
+        """The label was requested verbatim, so the eu catalog keeps it English."""
+        with translation.override("eu"):
+            html = self.client.get(reverse(STAT_CHANGELIST)).content.decode()
+
+            self.assertIn("TOTAL COUNT", html)