django-ec-calendar 0.1.0__tar.gz

django_ec_calendar-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_ec_calendar-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_ec_calendar-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_ec_calendar-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_ec_calendar-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-ec-calendar/
+
+    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_ec_calendar-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_ec_calendar-0.1.0/.pre-commit-config.yaml

@@ -0,0 +1,69 @@
+# The vendored EventCalendar build: as it is published.
+exclude: /vendor/
+
+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_ec_calendar, 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_ec_calendar-0.1.0/CHANGELOG.md

@@ -0,0 +1,25 @@
+# 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-29
+
+### Added
+
+- `CalendarAdminMixin`: a calendar of a changelist's objects (its queryset,
+  filters and search), a "Calendar" link away. A click opens an object,
+  selecting dates adds one with them, dragging one (or its end) saves its
+  dates — checked by the model, saved through `save_model()` and logged.
+  In Django's admin and in Unfold, following the page's theme.
+- `CalendarSource`: objects as EventCalendar's events by their fields
+  (`DateTimeField` or `DateField`, an end, all day, a title and a color),
+  in the site's time zone whatever the browser's.
+- `EventFeedView` and `{% ec_calendar %}`: a calendar on your own pages.
+- EventCalendar 5.17.1 (vkurko, MIT), its standalone build, included.
+- Events on the calendar's element, to do otherwise without changing its
+  script: `django-ec-calendar:event-click`, `:date-click`, `:select`
+  (cancellable) and `:event-change`.
+- Spanish translation.

django_ec_calendar-0.1.0/CONTRIBUTING.md

@@ -0,0 +1,106 @@
+# 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
+```
+
+With Unfold: `DJANGO_SETTINGS_MODULE=example.settings_unfold python manage.py runserver`.
+The admin's bookings and holidays have a "Calendar"; `/` is a calendar on a
+page.
+
+EventCalendar is vendored in
+`src/django_ec_calendar/static/django_ec_calendar/vendor/event-calendar/`,
+as `@event-calendar/build` publishes it (`npm pack @event-calendar/build@<version>`,
+its `dist/event-calendar.min.{js,css}` and the repository's `LICENSE`). Update
+its version in `config.py`'s docstring, the README and the CHANGELOG too.
+
+## 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`

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