instant-python 0.22.0__tar.gz → 0.23.0__tar.gz

instant_python-0.23.0/.github/dependabot.yml

@@ -0,0 +1,40 @@
+version: 2
+
+updates:
+  - package-ecosystem: "uv"
+    directory: "/"
+    versioning-strategy: "increase"
+    open-pull-requests-limit: 5
+    commit-message:
+      prefix: "build"
+    schedule:
+      interval: "weekly"
+      day: "monday"
+      time: "06:00"
+      timezone: "Europe/Madrid"
+    cooldown:
+      semver-major-days: 90
+      semver-minor-days: 7
+      semver-patch-days: 3
+    groups:
+      development-minor-patch:
+        dependency-type: "development"
+        update-types:
+          - "minor"
+          - "patch"
+      production-minor-patch:
+        dependency-type: "production"
+        update-types:
+           - "minor"
+           - "patch"
+
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    open-pull-requests-limit: 5
+    commit-message:
+      prefix: "ci"
+    schedule:
+      interval: "weekly"
+      day: "monday"
+      time: "06:00"
+      timezone: "Europe/Madrid"

{instant_python-0.22.0 → instant_python-0.23.0}/.github/workflows/ci.yml

@@ -15,12 +15,12 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: 🛡️ Harden runner
-        uses: step-security/harden-runner@6c439dc8bdf85cadbbce9ed30d1c7b959517bc49 # v2.12.2
+        uses: step-security/harden-runner@9af89fc71515a100421586dfdb3dc9c984fbf411 # v2.19.4
         with:
           egress-policy: audit
 
       - name: 📥 Checkout the repository
-        uses: actions/checkout@v4
+        uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10  # v6.0.3
         with:
           ref: ${{ github.head_ref }}
           fetch-depth: 0
@@ -38,12 +38,12 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: 🛡️ Harden runner
-        uses: step-security/harden-runner@6c439dc8bdf85cadbbce9ed30d1c7b959517bc49 # v2.12.2
+        uses: step-security/harden-runner@9af89fc71515a100421586dfdb3dc9c984fbf411 # v2.19.4
         with:
           egress-policy: audit
 
       - name: 📥 Checkout the repository
-        uses: actions/checkout@v4
+        uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10  # v6.0.3
         with:
           ref: ${{ github.head_ref }}
           fetch-depth: 0
@@ -65,19 +65,19 @@ jobs:
 
     steps:
       - name: 🛡️ Harden runner
-        uses: step-security/harden-runner@6c439dc8bdf85cadbbce9ed30d1c7b959517bc49 # v2.12.2
+        uses: step-security/harden-runner@9af89fc71515a100421586dfdb3dc9c984fbf411 # v2.19.4
         with:
           egress-policy: audit
 
       - name: 📥 Checkout the repository
-        uses: actions/checkout@v4
+        uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10  # v6.0.3
         with:
           ref: ${{ github.head_ref }}
           fetch-depth: 0
           persist-credentials: false
 
       - name: ▶️ CodeQL Initialization
-        uses: github/codeql-action/init@181d5eefc20863364f96762470ba6f862bdef56b # v3.29.2
+        uses: github/codeql-action/init@8aad20d150bbac5944a9f9d289da16a4b0d87c1e # v4.36.2
         with:
           languages: python
           build-mode: none
@@ -85,7 +85,7 @@ jobs:
           config-file: ./codeql-config.yml
 
       - name: 🧐 CodeQL Analysis
-        uses: github/codeql-action/analyze@181d5eefc20863364f96762470ba6f862bdef56b # v3.29.2
+        uses: github/codeql-action/analyze@8aad20d150bbac5944a9f9d289da16a4b0d87c1e # v4.36.2
         with:
           category: '/language:python'
 
@@ -99,12 +99,12 @@ jobs:
 
     steps:
       - name: 🛡️ Harden runner
-        uses: step-security/harden-runner@6c439dc8bdf85cadbbce9ed30d1c7b959517bc49 # v2.12.2
+        uses: step-security/harden-runner@9af89fc71515a100421586dfdb3dc9c984fbf411 # v2.19.4
         with:
           egress-policy: audit
 
       - name: 📥 Checkout the repository
-        uses: actions/checkout@v4
+        uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10  # v6.0.3
         with:
           fetch-depth: 0
           persist-credentials: false
@@ -123,12 +123,12 @@ jobs:
 
     steps:
       - name: 🛡️ Harden runner
-        uses: step-security/harden-runner@6c439dc8bdf85cadbbce9ed30d1c7b959517bc49 # v2.12.2
+        uses: step-security/harden-runner@9af89fc71515a100421586dfdb3dc9c984fbf411 # v2.19.4
         with:
           egress-policy: audit
 
       - name: 📥 Checkout the repository
-        uses: actions/checkout@v4
+        uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10  # v6.0.3
         with:
           fetch-depth: 0
           persist-credentials: false
@@ -144,12 +144,12 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: 🛡️ Harden runner
-        uses: step-security/harden-runner@6c439dc8bdf85cadbbce9ed30d1c7b959517bc49 # v2.12.2
+        uses: step-security/harden-runner@9af89fc71515a100421586dfdb3dc9c984fbf411 # v2.19.4
         with:
           egress-policy: audit
 
       - name: 📥 Checkout the repository
-        uses: actions/checkout@v4
+        uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10  # v6.0.3
         with:
           fetch-depth: 0
           persist-credentials: false
@@ -164,7 +164,7 @@ jobs:
         run: uv run pytest --cov --cov-report=xml --cov-branch test -ra -s
 
       - name: 📥 Upload coverage report to Codecov
-        uses: codecov/codecov-action@v5
+        uses: codecov/codecov-action@e79a6962e0d4c0c17b229090214935d2e33f8354  # v6.0.1
         with:
           files: coverage.xml
           flags: unittests
@@ -180,12 +180,12 @@ jobs:
         python-version: [ '3.10', '3.11', '3.12', '3.13' ]
     steps:
       - name: 🛡️ Harden runner
-        uses: step-security/harden-runner@6c439dc8bdf85cadbbce9ed30d1c7b959517bc49 # v2.12.2
+        uses: step-security/harden-runner@9af89fc71515a100421586dfdb3dc9c984fbf411 # v2.19.4
         with:
           egress-policy: audit
 
       - name: 📥 Checkout the repository
-        uses: actions/checkout@v4
+        uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10  # v6.0.3
         with:
           fetch-depth: 0
           persist-credentials: false

{instant_python-0.22.0 → instant_python-0.23.0}/.github/workflows/pages.yml

@@ -18,12 +18,12 @@ jobs:
 
     steps:
       - name: 🛡️ Harden runner
-        uses: step-security/harden-runner@6c439dc8bdf85cadbbce9ed30d1c7b959517bc49 # v2.12.2
+        uses: step-security/harden-runner@9af89fc71515a100421586dfdb3dc9c984fbf411 # v2.19.4
         with:
           egress-policy: audit
 
       - name: 📥 Checkout the repository
-        uses: actions/checkout@v4
+        uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10  # v6.0.3
         with:
           fetch-depth: 0
           persist-credentials: false
@@ -52,7 +52,7 @@ jobs:
           REDIRECT_EOF
 
       - name: 📤 Upload documentation artifact
-        uses: actions/upload-pages-artifact@v3
+        uses: actions/upload-pages-artifact@fc324d3547104276b827a68afc52ff2a11cc49c9 # v5
         with:
           path: site
 
@@ -71,10 +71,10 @@ jobs:
 
     steps:
       - name: 🛡️ Harden runner
-        uses: step-security/harden-runner@6c439dc8bdf85cadbbce9ed30d1c7b959517bc49 # v2.12.2
+        uses: step-security/harden-runner@9af89fc71515a100421586dfdb3dc9c984fbf411 # v2.19.4
         with:
           egress-policy: audit
 
       - name: 🚀 Deploy to GitHub Pages
         id: deployment
-        uses: actions/deploy-pages@v4
+        uses: actions/deploy-pages@cd2ce8fcbc39b97be8ca5fce6e763baed58fa128 # v5

{instant_python-0.22.0 → instant_python-0.23.0}/.github/workflows/release.yml

@@ -17,19 +17,19 @@ jobs:
 
     steps:
       - name: 🛡️ Harden runner
-        uses: step-security/harden-runner@6c439dc8bdf85cadbbce9ed30d1c7b959517bc49 # v2.12.2
+        uses: step-security/harden-runner@9af89fc71515a100421586dfdb3dc9c984fbf411 # v2.19.4
         with:
           egress-policy: audit
 
       - name: 📥 Checkout the repository
-        uses: actions/checkout@v4
+        uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10  # v6.0.3
         with:
           fetch-depth: 0
           persist-credentials: false
 
       - name: 🔖 Create release
         id: released
-        uses: python-semantic-release/python-semantic-release@2896129e02bb7809d2cf0c1b8e9e795ee27acbcf # v10.0.2
+        uses: python-semantic-release/python-semantic-release@350c48fcb3ffcdfd2e0a235206bc2ecea6b69df0 # v10.0.2
         with:
           build: true
           push: true
@@ -56,12 +56,12 @@ jobs:
 
     steps:
       - name: 🛡️ Harden runner
-        uses: step-security/harden-runner@6c439dc8bdf85cadbbce9ed30d1c7b959517bc49 # v2.12.2
+        uses: step-security/harden-runner@9af89fc71515a100421586dfdb3dc9c984fbf411 # v2.19.4
         with:
           egress-policy: audit
 
       - name: 📥 Checkout the repository
-        uses: actions/checkout@v4
+        uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10  # v6.0.3
         with:
           fetch-depth: 0
           persist-credentials: false

{instant_python-0.22.0 → instant_python-0.23.0}/CHANGELOG.md

@@ -2,6 +2,53 @@
 
 <!-- version list -->
 
+## v0.23.0 (2026-06-05)
+
+### ✨ Features
+
+- **config**: Add new custom documentation to built in features selection
+  ([`73f9976`](https://github.com/dimanu-py/instant-python/commit/73f99763c39082d1d9b9b1bf3d63eaf55976bdf1))
+
+- **templates**: Introduce custom documentation structure in main default applications when is
+  selected
+  ([`a6a101d`](https://github.com/dimanu-py/instant-python/commit/a6a101d5b8171af2113bad93951486ba2bac56b1))
+
+- **templates**: Specify documentation folder structure to be created when custom documentation
+  feature is selected
+  ([`482aa99`](https://github.com/dimanu-py/instant-python/commit/482aa99e84bf5edb2ea9e7b4059727ec51708d71))
+
+- **templates**: Add github action to publish documentation to github pages when built in feature
+  for custom docs is selected
+  ([`bae3778`](https://github.com/dimanu-py/instant-python/commit/bae37789a0845a281ee6a6f1c791ded35ef8648e))
+
+- **templates**: Add mkdocs dependencies to pyproject.toml template when custom documentation built
+  in feature is selected
+  ([`4c52158`](https://github.com/dimanu-py/instant-python/commit/4c52158fdb6e429dfb0be5815e312360c7b3ea67))
+
+- **templates**: Add new command to makefile template to allow serving documentation locally when
+  built in feature is selected
+  ([`390b4f7`](https://github.com/dimanu-py/instant-python/commit/390b4f798dd8d1d3342dfaba3e89ca84286c9aa9))
+
+- **templates**: Add mkdocs basic template with single Home section and common features
+  ([`11901d8`](https://github.com/dimanu-py/instant-python/commit/11901d84b4c7b38fc419d61efd18f91ba36c33e1))
+
+- **templates**: Add dependabot automatically when github actions built in feature is selected
+  ([`08db5de`](https://github.com/dimanu-py/instant-python/commit/08db5de21af8bfa7decfed1572a5df94da785344))
+
+- **templates**: Avoid installing dependencies newer than 3 days when uv is selected
+  ([`feae9d7`](https://github.com/dimanu-py/instant-python/commit/feae9d790802b02bb723d2eecf6dd8d611ae9cc8))
+
+### 🪲 Bug Fixes
+
+- **templates**: Correct invalid time format when dependabot.yml is updated
+  ([`aa4c67a`](https://github.com/dimanu-py/instant-python/commit/aa4c67a40bc858b6e0949dcfd3bf3980493e511c))
+
+### ♻️ Refactoring
+
+- **templates**: Update github actions versions in templates to newer versions and using commit sha
+  ([`a6a96de`](https://github.com/dimanu-py/instant-python/commit/a6a96de5c49a8f94959f6222dd4a65beda47e210))
+
+
 ## v0.22.0 (2026-06-03)
 
 ### ✨ Features

{instant_python-0.22.0 → instant_python-0.23.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: instant-python
-Version: 0.22.0
+Version: 0.23.0
 Summary: Instant boilerplate generation for Python projects
 Project-URL: documentation, https://dimanu-py.github.io/instant-python/
 Project-URL: repository, https://github.com/dimanu-py/instant-python/

instant_python-0.23.0/instant_python/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.23.0"

{instant_python-0.22.0 → instant_python-0.23.0}/instant_python/shared/supported_built_in_features.py

@@ -15,6 +15,7 @@ class SupportedBuiltInFeatures(str, Enum):
     CITATION = "citation_file"
     SECURITY = "security_file"
     AI_AGENTS = "ai_agents"
+    DOCS = "custom_documentation"
 
     @classmethod
     def get_supported_built_in_features(cls) -> list[str]:

{instant_python-0.22.0 → instant_python-0.23.0}/instant_python/templates/boilerplate/github/ci.yml

@@ -20,7 +20,7 @@ jobs:
           egress-policy: audit
 
       - name: 📥 Checkout the repository
-        uses: actions/checkout@v4
+        uses: actions/checkout@93cb6efe18208431cddfb8368fd83d5badbf9bfd  # v5.0.1
         with:
           ref: {% raw %}${{ github.head_ref }}{% endraw %}
 
@@ -43,7 +43,7 @@ jobs:
           egress-policy: audit
 
       - name: 📥 Checkout the repository
-        uses: actions/checkout@v4
+        uses: actions/checkout@93cb6efe18208431cddfb8368fd83d5badbf9bfd  # v5.0.1
         with:
           ref: {% raw %}${{ github.head_ref }}{% endraw %}
 
@@ -65,7 +65,7 @@ jobs:
           egress-policy: audit
 
       - name: 📥 Checkout the repository
-        uses: actions/checkout@v4
+        uses: actions/checkout@93cb6efe18208431cddfb8368fd83d5badbf9bfd  # v5.0.1
         with:
           ref: {% raw %}${{ github.head_ref }}{% endraw %}
 
@@ -92,7 +92,7 @@ jobs:
           egress-policy: audit
 
       - name: 📥 Checkout the repository
-        uses: actions/checkout@v4
+        uses: actions/checkout@93cb6efe18208431cddfb8368fd83d5badbf9bfd  # v5.0.1
         with:
           ref: {% raw %}${{ github.head_ref }}{% endraw %}
 
@@ -128,7 +128,7 @@ jobs:
           egress-policy: audit
 
       - name: 📥 Checkout the repository
-        uses: actions/checkout@v4
+        uses: actions/checkout@93cb6efe18208431cddfb8368fd83d5badbf9bfd  # v5.0.1
         with:
           fetch-depth: 0
           persist-credentials: false
@@ -153,7 +153,7 @@ jobs:
           egress-policy: audit
 
       - name: 📥 Checkout the repository
-        uses: actions/checkout@v4
+        uses: actions/checkout@93cb6efe18208431cddfb8368fd83d5badbf9bfd  # v5.0.1
         with:
           fetch-depth: 0
           persist-credentials: false
@@ -174,7 +174,7 @@ jobs:
           egress-policy: audit
 
       - name: 📥 Checkout the repository
-        uses: actions/checkout@v4
+        uses: actions/checkout@93cb6efe18208431cddfb8368fd83d5badbf9bfd  # v5.0.1
         with:
           fetch-depth: 0
           persist-credentials: false
@@ -189,7 +189,7 @@ jobs:
         run: {{ general.dependency_manager }} run pytest --cov --cov-report=xml --cov-branch test -ra -s
 
       - name: 📥 Upload coverage report to Codecov
-        uses: codecov/codecov-action@v5
+        uses: codecov/codecov-action@75cd11691c0faa626561e295848008c8a7dddffe  # v5
         with:
           files: coverage.xml
           flags: unittests

instant_python-0.23.0/instant_python/templates/boilerplate/github/dependabot.yml

@@ -0,0 +1,62 @@
+version: 2
+
+updates:
+  - package-ecosystem: "{{ general.dependency_manager }}"
+    directory: "/"
+    versioning-strategy: "increase"
+    open-pull-requests-limit: 5
+    commit-message:
+      prefix: "build"
+    schedule:
+      interval: "weekly"
+      day: "monday"
+      time: "06:00"
+      timezone: "Europe/Madrid"
+    cooldown:
+      semver-major-days: 90
+      semver-minor-days: 7
+      semver-patch-days: 3
+    groups:
+      development-minor-patch:
+        dependency-type: "development"
+        update-types:
+          - "minor"
+          - "patch"
+      production-minor-patch:
+        dependency-type: "production"
+        update-types:
+           - "minor"
+           - "patch"
+
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    open-pull-requests-limit: 5
+    commit-message:
+      prefix: "ci"
+    schedule:
+      interval: "weekly"
+      day: "monday"
+      time: "06:00"
+      timezone: "Europe/Madrid"
+
+  - package-ecosystem: "docker"
+    directory: "/"
+    open-pull-requests-limit: 5
+    commit-message:
+      prefix: "build"
+    schedule:
+      interval: "weekly"
+      day: "monday"
+      time: "06:00"
+      timezone: "Europe/Madrid"
+
+  - package-ecosystem: "docker-compose"
+    directory: "/"
+    open-pull-requests-limit: 5
+    commit-message:
+      prefix: "build"
+    schedule:
+      interval: "weekly"
+      day: "monday"
+      time: "06:00"
+      timezone: "Europe/Madrid"

instant_python-0.23.0/instant_python/templates/boilerplate/github/pages.yml

@@ -0,0 +1,63 @@
+name: Build and Deploy Documentation to GitHub Pages
+
+on:
+  push:
+    branches:
+      - main
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  build:
+    name: Build documentation
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+
+    steps:
+      - name: 🛡️ Harden runner
+        uses: step-security/harden-runner@6c439dc8bdf85cadbbce9ed30d1c7b959517bc49 # v2.12.2
+        with:
+          egress-policy: audit
+
+      - name: 📥 Checkout the repository
+        uses: actions/checkout@93cb6efe18208431cddfb8368fd83d5badbf9bfd  # v5.0.1
+        with:
+          fetch-depth: 0
+          persist-credentials: false
+
+      - name: 🛠️ Setup environment
+        uses: ./.github/actions/python_setup
+
+      - name: 📖 Build documentation
+        run: uv run mkdocs build
+
+      - name: 📤 Upload documentation artifact
+        uses: actions/upload-pages-artifact@fc324d3547104276b827a68afc52ff2a11cc49c9 # v5
+        with:
+          path: site
+
+  deploy:
+    name: Deploy to GitHub Pages
+    needs: build
+    if: github.ref == 'refs/heads/main'
+    runs-on: ubuntu-latest
+    permissions:
+      pages: write
+      id-token: write
+
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+
+    steps:
+      - name: 🛡️ Harden runner
+        uses: step-security/harden-runner@6c439dc8bdf85cadbbce9ed30d1c7b959517bc49 # v2.12.2
+        with:
+          egress-policy: audit
+
+      - name: 🚀 Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@cd2ce8fcbc39b97be8ca5fce6e763baed58fa128 # v5

{instant_python-0.22.0 → instant_python-0.23.0}/instant_python/templates/boilerplate/github/release.yml

@@ -32,7 +32,7 @@ jobs:
           egress-policy: audit
 
       - name: 📥 Checkout the repository
-        uses: actions/checkout@v4
+        uses: actions/checkout@93cb6efe18208431cddfb8368fd83d5badbf9bfd  # v5.0.1
         with:
           fetch-depth: 0
           persist-credentials: false
@@ -77,7 +77,7 @@ jobs:
           egress-policy: audit
 
       - name: 📥 Checkout the repository
-        uses: actions/checkout@v4
+        uses: actions/checkout@93cb6efe18208431cddfb8368fd83d5badbf9bfd  # v5.0.1
         with:
           fetch-depth: 0
           persist-credentials: false

instant_python-0.23.0/instant_python/templates/boilerplate/mkdocs.yml

@@ -0,0 +1,70 @@
+site_name: {{ general.slug }}
+site_url: https://{{ git.username }}.github.io/{{ general.slug }}/
+site_description: >
+  {{ general.description }}
+repo_name: {{ general.slug }}
+repo_url: https://github.com/{{ git.username }}/{{ general.slug }}
+docs_dir: docs/documentation
+plugins:
+  - search
+  - tags
+  - section-index
+extra_javascript:
+  - https://cdn.jsdelivr.net/npm/chart.js
+markdown_extensions:
+  - admonition
+  - pymdownx.details
+  - pymdownx.superfences:
+  - attr_list:
+  - pymdownx.emoji:
+      emoji_index: !!python/name:material.extensions.emoji.twemoji
+      emoji_generator: !!python/name:material.extensions.emoji.to_svg
+  - pymdownx.highlight:
+      anchor_linenums: true
+      line_spans: __span
+      pygments_lang_class: true
+  - pymdownx.inlinehilite:
+  - pymdownx.snippets:
+  - pymdownx.superfences:
+theme:
+  name: material
+  font:
+    text: Roboto
+    code: Roboto Mono
+  favicon: assets/favicon.svg
+  logo: assets/logo.svg
+  icon:
+    logo: logo
+  features:
+    - navigation.path
+    - navigation.instant
+    - navigation.instant.prefetch
+    - navigation.instant.progress
+    - navigation.sections
+    - navigation.indexes
+    - navigation.tracking
+    - content.code.annotate
+    - toc.follow
+    - navigation.footer
+    - navigation.top
+    - content.code.copy
+    - content.tabs.link
+    - navigation.tabs
+    - navigation.tabs.sticky
+    - search.suggest
+    - search.highlight
+  palette:
+    - scheme: slate
+      toggle:
+        icon: material/weather-sunny
+        name: Dark Mode
+      primary: '#B4BEFE'
+      accent: '#FAB387'
+    - scheme: default
+      toggle:
+        icon: material/weather-night
+        name: Light Mode
+      primary: '#B4BEFE'
+      accent: '#FAB387'
+nav:
+  - Home: HOME.md

{instant_python-0.22.0 → instant_python-0.23.0}/instant_python/templates/boilerplate/pyproject.toml

@@ -31,6 +31,13 @@
     "pytest": ["github_actions", "makefile", "precommit_hook"],
     "pytest-asyncio": ["async_alembic", "async_sqlalchemy"],
     "object-mother-sindri": ["value_objects"]
+    },
+    "docs": {
+    "mkdocs": ["custom_documentation"],
+    "mkdocs-literate-nav": ["custom_documentation"],
+    "mkdocs-macros-plugin": ["custom_documentation"],
+    "mkdocs-material": ["custom_documentation"],
+    "mkdocs-section-index": ["custom_documentation"]
     }
 } %}
 {% macro get_dev_group_dependencies(group_name) -%}
@@ -48,6 +55,7 @@
 {% set release_deps = get_dev_group_dependencies("release") %}
 {% set lint_deps = get_dev_group_dependencies("lint") %}
 {% set test_deps = get_dev_group_dependencies("test") %}
+{% set docs_deps = get_dev_group_dependencies("docs") %}
 [project]
 name = "{{ general.slug }}"
 version = "{{ general.version }}"
@@ -75,6 +83,9 @@ dev = [
 {% if test_deps.strip() %}
     {include-group = "test"},
 {% endif %}
+{% if docs_deps.strip() %}
+    {include-group = "docs"},
+{% endif %}
 ]
 {% if release_deps.strip() %}
 release = [
@@ -88,6 +99,15 @@ lint = [
 test = [
 {{ test_deps }}]
 {% endif %}
+{% if docs_deps.strip() %}
+docs = [
+{{ docs_deps }}]
+{% endif %}
+{% endif %}
+
+{% if general.dependency_manager == "uv" %}
+[tool.uv]
+exclude-newer = "3 days"
 {% endif %}
 
 {% if dependencies | has_dependency("ruff") or has_github_actions_or_makefile %}

{instant_python-0.22.0 → instant_python-0.23.0}/instant_python/templates/boilerplate/scripts/makefile

@@ -3,6 +3,7 @@
 {% set has_pre_commit_hooks = "precommit_hook" in template.built_in_features %}
 {% set has_github_actions_or_makefile = ["github_actions", "makefile"] | is_in(template.built_in_features) %}
 {% set has_agents = "ai_agents" in template.built_in_features %}
+{% set has_custom_docs = "custom_docs" in template.built_in_features %}
 .DEFAULT_GOAL := help
 
 .PHONY: help
@@ -183,7 +184,6 @@ search:  ## Show package details.
 	{% elif has_uv %}
 	@uv pip show $$package
 	{% endif %}
-
 {% if has_agents %}
 .PHONY: claude
 claude:  ## Create symlinks for Claude Code compatibility (CLAUDE.md → AGENTS.md, .claude → .agents).
@@ -200,4 +200,9 @@ opencode:  ## Create symlinks for OpenCode compatibility.
 	@ln -s ../.agents/commands .opencode/commands
 	@ls -la .opencode
 
+{% endif %}
+{% if has_custom_docs %}
+.PHONY: docs-serve
+docs-serve:  ## Start server for documentation.
+	@uv run mkdocs serve
 {% endif %}