django-admin-inline-controls 0.1.0__tar.gz

django_admin_inline_controls-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_inline_controls-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_inline_controls-0.1.0/.github/workflows/pre-commit.yml

@@ -0,0 +1,26 @@
+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
+
+      - name: Set up Python
+        run: uv python install
+
+      - name: Install dependencies
+        run: uv sync
+
+      - name: Run pre-commit
+        run: uv run pre-commit run --all-files

django_admin_inline_controls-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_inline_controls-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-inline-controls/
+
+    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_inline_controls-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_inline_controls-0.1.0/.pre-commit-config.yaml

@@ -0,0 +1,68 @@
+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
+    - django-filter>=23.2
+    - django-nested-admin>=4.1
+    - pytest-django>=4.8
+    types: [python]
+    files: ^(src|example)/
+    pass_filenames: false
+    args: [src/django_admin_inline_controls, example]
+
+# Only needed if the library ships Django templates (src/<pkg>/templates/).
+# Remove this hook if it doesn't.
+- repo: https://github.com/adamchainz/djade-pre-commit
+  rev: 52a7ce253113456c2a1113186a4a19b15c8b68af  # frozen: 1.9.0
+  hooks:
+  - id: djade
+    files: '(/|^)templates/'
+
+- repo: https://github.com/tox-dev/pyproject-fmt
+  rev: d600c142bb19f521ae6a6a345f94a2efd7937759  # frozen: v2.26.0
+  hooks:
+  - id: pyproject-fmt

django_admin_inline_controls-0.1.0/CHANGELOG.md

@@ -0,0 +1,52 @@
+# 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-05
+
+First release.
+
+### Added
+
+- **`InlineControlsMixin`** for `TabularInline` and `StackedInline`:
+  - pagination, with page links or infinite scroll, and saving rows loaded
+    across several pages;
+  - filters, generated from lookups or from a form of yours
+    (`contrib.filters` for a django-filter `FilterSet`);
+  - multi-column sorting from the column headers;
+  - state namespaced per inline in the URL, and in-place refresh of a
+    single inline (re-initializing the admin's inline and widget JS) with
+    an unsaved-changes prompt.
+- **Saving one inline** (`inline_save_button`, with
+  `InlineControlsAdminMixin` on the parent): without submitting or
+  reloading the rest of the page, recorded in the parent's history.
+- **Bulk actions** (`inline_bulk_actions`): like the changelist's, on the
+  selected rows, with "select all" across pages, the `@inline_action`
+  decorator (permissions, confirmation prompts) and a built-in
+  `delete_selected`.
+- **Row actions** (`inline_actions`): buttons on each saved row, with
+  django-inline-actions' API — the `(request, obj, parent_obj)` signature,
+  `get_inline_actions()`, per-row `get_<action>_label/css/attr()` hooks and
+  the `ViewAction`, `DeleteAction` and `DefaultActionsMixin` mixins — run
+  without submitting the change form, with the permissions checked by the
+  server.
+- **Footer rows** (`inline_footer_rows`, `inline_footer_scope`): totals,
+  averages… aggregated in one query over the filtered rows or the page,
+  rendered by the server as the table's `<tfoot>` (also in the add view,
+  empty) or as a summary line; raw values in `data-*` attributes for the
+  page's JS; format (`format_inline_footer_value()`) and markup
+  (`tfoot.html`) customizable.
+- **Customizable markup:** template blocks throughout, per-inline
+  templates, and `inline_controls_selectors` (`DEFAULT_SELECTORS`) for
+  themes and custom inline templates, plus the `inline-controls:place` and
+  `inline-controls:updated` events.
+- **django-unfold** support (`contrib.unfold`, `unfold` extra): the
+  controls in Unfold's inlines with its colors, light and dark.
+- **django-nested-admin** support (`contrib.nested`, `nested` extra).
+- Only the scripts an inline uses are loaded (`core.js`, `save.js`,
+  `actions.js`).
+- Spanish translation, and system checks for every option.
+- Django 4.2 – 6.1, Python 3.10+.

django_admin_inline_controls-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_inline_controls/locale/`. After changing
+translatable text, from that package directory:
+
+```bash
+cd src/django_admin_inline_controls
+DJANGO_SETTINGS_MODULE=tests.settings PYTHONPATH=../..:../../example \
+  uv run django-admin makemessages -l es --no-obsolete --add-location file
+# 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 a `.mo` is older than its `.po`.

django_admin_inline_controls-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.