django-admin-tables 0.1.0__tar.gz

django_admin_tables-0.1.0/.github/workflows/compat-matrix.yml

@@ -0,0 +1,27 @@
+name: Compatibility Matrix
+
+on:
+  push:
+    branches: [master, main]
+  pull_request:
+    branches: [master, main]
+
+jobs:
+  tox:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+
+      - name: Install Python versions
+        run: uv python install 3.10 3.12 3.13 3.14
+
+      - name: Install dependencies
+        run: uv sync
+
+      - name: Run compatibility matrix (tox)
+        run: uv run tox run

django_admin_tables-0.1.0/.github/workflows/js-tests.yml

@@ -0,0 +1,24 @@
+name: JavaScript Tests
+
+on:
+  push:
+    branches: [main, master]
+  pull_request:
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+          cache: "npm"
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Run Tests & Coverage
+        run: npm run coverage

django_admin_tables-0.1.0/.github/workflows/pre-commit.yml

@@ -0,0 +1,28 @@
+name: Pre-commit
+
+on:
+  push:
+    branches: [main, master]
+  pull_request:
+
+jobs:
+  pre-commit:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+
+      # The hooks run on python3.14 (default_language_version), found
+      # through the venv's bin on PATH under `uv run`.
+      - name: Set up Python
+        run: uv python install 3.14
+
+      - name: Install dependencies
+        run: uv sync --python 3.14
+
+      - name: Run pre-commit
+        run: uv run pre-commit run --all-files

django_admin_tables-0.1.0/.github/workflows/pytest.yml

@@ -0,0 +1,31 @@
+name: Python and Playwright Tests
+
+on:
+  push:
+    branches: [master, main]
+  pull_request:
+    branches: [master, main]
+
+jobs:
+  test-python:
+    name: Python Tests
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+
+      - name: Set up Python
+        run: uv python install
+
+      - name: Install dependencies
+        run: uv sync
+
+      - name: Install Playwright browsers
+        run: uv run playwright install --with-deps chromium
+
+      - name: Run Pytest
+        run: uv run pytest

django_admin_tables-0.1.0/.github/workflows/release.yml

@@ -0,0 +1,55 @@
+name: Release
+
+on:
+  release:
+    types:
+      - published
+
+jobs:
+  release-build:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+
+      - name: Show project version
+        run: |
+          grep "version" pyproject.toml
+
+      - name: Build release distributions
+        run: uv build
+
+      - name: Upload distributions
+        uses: actions/upload-artifact@v4
+        with:
+          name: release-dists
+          path: dist/
+
+  pypi-publish:
+    runs-on: ubuntu-latest
+    needs:
+      - release-build
+    permissions:
+      id-token: write
+      contents: read
+
+    environment:
+      name: pypi
+      url: https://pypi.org/project/django-admin-tables/
+
+    steps:
+      - name: Retrieve release distributions
+        uses: actions/download-artifact@v4
+        with:
+          name: release-dists
+          path: dist/
+
+      - name: Publish release distributions to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          packages-dir: dist/

django_admin_tables-0.1.0/.gitignore

@@ -0,0 +1,42 @@
+# Python
+__pycache__/
+*.py[cod]
+*.egg-info/
+.eggs/
+build/
+dist/
+.installed.cfg
+*.egg
+
+# Virtual environments
+.venv/
+venv/
+env/
+
+# Testing / coverage
+.pytest_cache/
+.coverage
+.coverage.*
+coverage/
+htmlcov/
+.mypy_cache/
+.ruff_cache/
+.tox/
+
+# Django
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+media/
+
+# Node / JS
+node_modules/
+
+# Editors / OS
+.vscode/
+.idea/
+.DS_Store
+
+# Docs
+docs/_build/

django_admin_tables-0.1.0/.pre-commit-config.yaml

@@ -0,0 +1,58 @@
+default_language_version:
+  python: &python-version python3.14
+
+repos:
+- repo: https://github.com/pre-commit/pre-commit-hooks
+  rev: 3e8a8703264a2f4a69428a0aa4dcb512790b2c8c  # frozen: v6.0.0
+  hooks:
+  - id: check-added-large-files
+  - id: check-case-conflict
+  - id: check-json
+  - id: check-merge-conflict
+  - id: check-symlinks
+  - id: check-toml
+  - id: debug-statements
+  - id: end-of-file-fixer
+  - id: trailing-whitespace
+
+- repo: https://github.com/biomejs/pre-commit
+  rev: d1ce4972fb5ad09afd33b432bca71e8c5dfbb2b5  # frozen: v2.5.6
+  hooks:
+  - id: biome-check
+    additional_dependencies:
+    - '@biomejs/biome@2.3.8'
+    language_version: default
+
+- repo: https://github.com/adamchainz/django-upgrade
+  rev: bdcc9646c249f00ec9781751791e7b75b48b3722  # frozen: 1.31.1
+  hooks:
+  - id: django-upgrade
+    args: [--target-version, "4.2"]
+
+- repo: https://github.com/astral-sh/ruff-pre-commit
+  rev: 39d9ac5938dadb73df0564a45f163e25ff9fa6e2  # frozen: v0.16.1
+  hooks:
+  - id: ruff-check
+    args: [--fix]
+  - id: ruff-format
+
+- repo: local
+  hooks:
+  - id: mypy
+    name: mypy
+    entry: mypy
+    language: python
+    additional_dependencies:
+    - mypy>=1.10
+    - django-stubs[compatible-mypy]>=5
+    - django>=4.2
+    - pytest-django>=4.8
+    types: [python]
+    files: ^(src|example)/
+    pass_filenames: false
+    args: [src/django_admin_tables, example]
+
+- repo: https://github.com/tox-dev/pyproject-fmt
+  rev: d600c142bb19f521ae6a6a345f94a2efd7937759  # frozen: v2.26.0
+  hooks:
+  - id: pyproject-fmt

django_admin_tables-0.1.0/CHANGELOG.md

@@ -0,0 +1,56 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.1.0] - 2026-10-17
+
+First release.
+
+### Added
+
+- `ExclusiveRadioFieldsMixin` (`django_admin_tables.radio_select`):
+  `BooleanField` columns shown as radio
+  buttons, exclusive across the rows of an inline or of the changelist's
+  `list_editable`, checked on the server too.
+- `ForeignKeyLinkMixin` (`django_admin_tables.fk_links`): foreign keys in
+  `list_display` as links to their change view, with
+  `get_foreign_key_link()`, `foreign_key_link_template` and
+  `foreign_key_link_class`.
+- `HideableColumnsMixin` (`django_admin_tables.columns`): a "Columns" menu
+  on the changelist to hide or show the columns in `list_display_hideable`
+  (`list_display_hidden` start hidden), remembered per user and model in
+  the browser. System checks `django_admin_tables.E001` and `E002`.
+- `responsive_columns` (same mixin): columns hidden below a viewport width
+  (`"sm"`…`"2xl"` or pixels), with CSS media queries, on the changelist
+  and in tabular inlines; disabled in the "Columns" menu while hidden.
+  System checks `django_admin_tables.E003` and `E004`.
+- `FooterRowsMixin`: rows of totals, averages… (`footer_rows`) below the
+  columns of the changelist and of inlines, as the table's own `<tfoot>`
+  (a summary line on stacked inlines). Aggregates run in one query, on
+  the filtered rows (`footer_scope = "filtered"`, every page) or the page
+  shown (`"page"`). On django-admin-inline-controls' inlines they follow
+  its filters, paging and refreshes, without depending on it. System
+  checks `django_admin_tables.E005` to
+  `E007`.
+- `RowActionsMixin`: buttons on each row (`row_actions`), on the
+  changelist (an "Actions" column) and in inlines, with `"view"` and
+  `"delete"` built in, `@row_action` for permissions, labels and
+  confirmations, and per-row hooks. Each one posts to the `ModelAdmin`
+  (`<pk>/row-action/<action>/`) and comes back to the page; on
+  django-admin-inline-controls' inlines only the inline is refreshed,
+  without depending on it. System checks `django_admin_tables.E008` and
+  `E009`.
+- `UnsavedChangesMixin`: a changelist with `list_editable` asks before
+  its unsaved edits are lost (pages, filters, sorting, search…), but not
+  when it's saved or an action runs (`list_editable_unsaved_warning`).
+- Hideable and responsive columns and row actions work under a strict
+  Content Security Policy: no inline `<style>` nor script.
+- `AdminTablesMixin`: every extra in one mixin, on a `ModelAdmin`, a
+  `TabularInline` or a `StackedInline`, each off until its option is set.
+- django-unfold support: Unfold's radio and checkbox classes, link colors,
+  and the "Columns" menu next to its "Filters" button.
+- Spanish translation.
+- Django 4.2 – 6.1, Python 3.10+.

django_admin_tables-0.1.0/CONTRIBUTING.md

@@ -0,0 +1,113 @@
+# Contributing
+
+## Development setup
+
+With [uv](https://docs.astral.sh/uv/) (recommended):
+
+```bash
+uv sync
+uv run playwright install --with-deps chromium
+npm install
+uv run pre-commit install
+```
+
+Without uv:
+
+```bash
+pip install -e ".[dev]"
+playwright install --with-deps chromium
+npm install
+pre-commit install
+```
+
+## Running the example project
+
+```bash
+cd example
+python manage.py migrate
+python manage.py createsuperuser
+python manage.py runserver
+```
+
+## Tests
+
+Python (pytest + pytest-django, coverage always on via `addopts`):
+
+```bash
+uv run pytest
+```
+
+`tests/e2e/` (real-browser tests via pytest-playwright, driving a real
+Chromium against `live_server`) runs as part of that same `uv run pytest`
+— no separate command. They need `uv run playwright install chromium`
+once (see Setup above) and are slower than the rest of the suite;
+everything else under `tests/` is unit/integration-level and doesn't
+touch a browser.
+
+JavaScript (vitest + jsdom):
+
+```bash
+npm test
+npm run coverage
+```
+
+## Compatibility matrix (tox)
+
+`uv run pytest` above only runs against whatever Django version `uv.lock`
+resolved (the newest one satisfying `dependencies`). To check the full
+supported range — every Django series in `classifiers`, against the
+oldest and newest Python it supports (within this package's own
+`requires-python` floor) — run the tox matrix instead:
+
+```bash
+uv run tox run-parallel   # every env, in parallel
+uv run tox -e py314-dj52  # a single env, e.g. to debug one failure
+```
+
+`[tool.tox]` in `pyproject.toml` lists the exact envs. Each one gets its own ephemeral venv (via
+[tox-uv](https://github.com/tox-dev/tox-uv), using uv's own Python
+builds — `uv python install <version>` once for any you don't have yet)
+with only `pytest`/`pytest-django`/`pytest-cov` and that env's pinned
+Django, not the full `dev` group, and skips `tests/e2e/` (no Playwright
+in those envs). This only tests boundaries (oldest + newest Python per
+Django series), not every valid combination — that catches most real
+breakage while staying fast. Runs in CI as a separate
+`compat-matrix.yml` workflow, alongside the regular `pytest.yml`. Update
+the `env_list` here whenever `classifiers` gains or drops a Django
+series.
+
+## Lint / format / type-check
+
+```bash
+uv run ruff check .
+uv run ruff format --check .
+uv run mypy src example
+# or, everything at once:
+uv run pre-commit run --all-files
+```
+
+The mypy pre-commit hook runs against the project venv (it needs
+django-stubs to resolve model types), not an isolated pre-commit env.
+
+## Before opening a PR
+
+- [ ] `uv run pytest`
+- [ ] `npm test`
+- [ ] `uv run pre-commit run --all-files`
+
+## Translations
+
+Catalogs live in `src/django_admin_tables/locale/`. After changing
+translatable text, from that package directory:
+
+```bash
+cd src/django_admin_tables
+DJANGO_SETTINGS_MODULE=tests.settings PYTHONPATH=../..:../../example \
+  uv run django-admin makemessages -l es --no-obsolete --add-location file --no-wrap
+# translate the new/changed entries in locale/es/LC_MESSAGES/django.po, then:
+DJANGO_SETTINGS_MODULE=tests.settings PYTHONPATH=../..:../../example \
+  uv run django-admin compilemessages
+```
+
+Commit both the `.po` and the compiled `.mo`. `tests/test_i18n.py` fails if
+an entry is untranslated or fuzzy, or if the `.mo` doesn't match the `.po`.

django_admin_tables-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Rodolfo Becerra
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.