ENH CivisFuture.job_run_url property

Squashed branch work:
- ENH CivisFuture.job_run_url property
- MAINT update API spec
- MAINT GitHub Actions workflow for PyPI releases
- MAINT comply with updated license spec for pyproject.toml
- MAINT dependabot updates for docs/requirements.txt (incl. suppression)
- DOCS refresh docs/requirements.txt
- FIX update client.pyi generator for new black formatting
- STY black
- MAINT update changelog

Author: jacksonlee-civis

.github/dependabot.yml

@@ -0,0 +1,13 @@
+version: 2
+updates:
+  - package-ecosystem: "pip"
+    directory: "/docs"
+    schedule:
+      interval: "monthly"
+    # Never open PRs, as docs/requirements.txt is only used in Read The Docs builds,
+    # has low security risks in general, and we manually update it with uv.
+    # open-pull-requests-limit: 0 blocks version-update PRs; the catch-all ignore
+    # rule additionally blocks security-update PRs (which bypass the limit).
+    open-pull-requests-limit: 0
+    ignore:
+      - dependency-name: "*"

.github/workflows/release.yml

@@ -0,0 +1,67 @@
+name: Release
+
+on:
+  release:
+    types: [published]
+
+permissions:
+  contents: read
+
+jobs:
+  build:
+    name: Build
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+
+      - name: Set up Python
+        run: uv python install 3.14
+
+      - name: Build sdist and wheel
+        run: uvx --from build pyproject-build --installer uv
+
+      - name: Upload distributions
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist
+
+  publish:
+    name: Publish to PyPI
+    runs-on: ubuntu-latest
+    needs: build
+    environment:
+      name: pypi
+      url: https://pypi.org/p/civis
+    permissions:
+      id-token: write
+    steps:
+      - name: Download distributions
+        uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+
+  github-release-upload:
+    name: Upload artifacts to GitHub release
+    runs-on: ubuntu-latest
+    needs: build
+    permissions:
+      contents: write
+    steps:
+      - name: Download distributions
+        uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist
+
+      - name: Upload to GitHub release
+        env:
+          GH_TOKEN: ${{ github.token }}
+        run: gh release upload "${{ github.event.release.tag_name }}" dist/* --repo "${{ github.repository }}"

CHANGELOG.md

@@ -13,6 +13,17 @@ and this project adheres to [Semantic Versioning](http://semver.org/).
 ### Fixed
 ### Security
 
+## 2.9.0 - 2026-04-22
+
+### Added
+- Added the `job_run_url` property to `civis.futures.CivisFuture`
+  for the URL of the specific run of the Civis Platform job being tracked. (#534)
+- Added GitHub Actions workflow for PyPI releases. (#534)
+
+### Changed
+- Updated the API spec. (#534)
+- Suppressed all pull requests by GitHub's dependabot for docs/requirements.txt. (534)
+
 ## 2.8.1 - 2026-03-02
 
 ### Changed

docs/requirements.txt

@@ -2,27 +2,27 @@
 #    uv pip compile pyproject.toml --extra=docs --python=.venv/bin/python -o docs/requirements.txt
 alabaster==1.0.0
     # via sphinx
-attrs==25.4.0
+attrs==26.1.0
     # via
     #   jsonschema
     #   referencing
-babel==2.17.0
+babel==2.18.0
     # via sphinx
-certifi==2026.1.4
+certifi==2026.2.25
     # via requests
-charset-normalizer==3.4.4
+charset-normalizer==3.4.7
     # via requests
-click==8.3.1
+click==8.3.2
     # via civis (pyproject.toml)
 cloudpickle==3.1.2
     # via civis (pyproject.toml)
-docutils==0.21.2
+docutils==0.22.4
     # via
     #   sphinx
     #   sphinx-rtd-theme
 idna==3.11
     # via requests
-imagesize==1.4.1
+imagesize==2.0.0
     # via sphinx
 jinja2==3.1.6
     # via sphinx
@@ -36,39 +36,37 @@ jsonschema-specifications==2025.9.1
     # via jsonschema
 markupsafe==3.0.3
     # via jinja2
-numpydoc==1.8.0
+numpydoc==1.10.0
     # via civis (pyproject.toml)
-packaging==25.0
+packaging==26.1
     # via sphinx
-pygments==2.19.2
+pygments==2.20.0
     # via sphinx
 pyyaml==6.0.3
     # via civis (pyproject.toml)
 referencing==0.37.0
     # via
     #   jsonschema
     #   jsonschema-specifications
-requests==2.32.5
+requests==2.33.1
     # via
     #   civis (pyproject.toml)
     #   sphinx
 roman-numerals==4.1.0
-    # via roman-numerals-py
-roman-numerals-py==4.1.0
     # via sphinx
 rpds-py==0.30.0
     # via
     #   jsonschema
     #   referencing
 snowballstemmer==3.0.1
     # via sphinx
-sphinx==8.2.3
+sphinx==9.1.0
     # via
     #   civis (pyproject.toml)
     #   numpydoc
     #   sphinx-rtd-theme
     #   sphinxcontrib-jquery
-sphinx-rtd-theme==3.0.2
+sphinx-rtd-theme==3.1.0
     # via civis (pyproject.toml)
 sphinxcontrib-applehelp==2.0.0
     # via sphinx
@@ -84,9 +82,7 @@ sphinxcontrib-qthelp==2.0.0
     # via sphinx
 sphinxcontrib-serializinghtml==2.0.0
     # via sphinx
-tabulate==0.9.0
-    # via numpydoc
-tenacity==9.1.2
+tenacity==9.1.4
     # via civis (pyproject.toml)
 urllib3==2.6.3
     # via requests

pyproject.toml

@@ -4,13 +4,17 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "civis"
-version = "2.8.1"
+version = "2.9.0"
 description = "Civis API Python Client"
 readme = "README.rst"
 requires-python = ">= 3.11"
 authors = [ { name = "Civis Analytics", email = "[email protected]" } ]
-license = { text = "BSD-3-Clause" }
+license = "BSD-3-Clause"
 dependencies = [
+    # This is a public package that can be used in environments we don't control.
+    # Therefore we don't set version upper bounds (i.e., don't use <= or <)
+    # to avoid dependency version conflicts. If a particular dependency version
+    # is known to be incompatible with civis-python, enumerate the version with !=.
     "click >= 6.0",
     "cloudpickle >= 0.2",
     "joblib >= 1.5.0",
@@ -24,7 +28,6 @@ dependencies = [
 ]
 classifiers = [
     "Development Status :: 5 - Production/Stable",
-    "License :: OSI Approved :: BSD License",
     "Programming Language :: Python",
     "Programming Language :: Python :: 3",
     "Programming Language :: Python :: 3 :: Only",
@@ -43,35 +46,37 @@ civis = "civis.cli.__main__:main"
 civis_joblib_worker = "civis.run_joblib_func:main"
 
 [project.optional-dependencies]
+# Not pinning versions for dev dependencies, so that we always install their
+# latest versions on CI builds for forward compatibility.
 dev-core = [
-    "bandit",  # Install the latest version.
-    "black == 25.12.0",
-    "build == 1.3.0",
-    "flake8 == 7.3.0",
-    "mypy == 1.19.1",
-    "pandas == 2.3.3",
-    "pip-audit",  # Install the latest version.
-    "polars == 1.36.1",
-    "pytest == 9.0.2",
-    "pytest-cov == 7.0.0",
-    "twine == 6.2.0",
-    # The stub packages are used by mypy, so just get their latest versions.
+    "bandit",
+    "black",
+    "build",
+    "flake8",
+    "mypy",
+    "pandas",
+    "pip-audit",
+    "polars",
+    "pytest",
+    "pytest-cov",
+    "twine",
+    # The stub packages are used by mypy.
     "pandas-stubs",
     "types-jsonschema",
     "types-PyYAML",
     "types-requests",
 ]
 dev-civisml = [
-    "feather-format == 0.4.1",
-    "numpy == 2.4.0",
-    "scikit-learn == 1.8.0",
-    "scipy == 1.16.3",
+    "feather-format",
+    "numpy",
+    "scikit-learn",
+    "scipy",
 ]
 docs = [
     # docs/requirements.txt pins all transitive dependencies for a reproducible doc build.
-    "numpydoc == 1.8.0",
-    "Sphinx == 8.2.3",
-    "sphinx-rtd-theme == 3.0.2",
+    "numpydoc",
+    "Sphinx",
+    "sphinx-rtd-theme",
 ]
 
 [tool.setuptools.packages.find]

src/civis/__init__.py

@@ -8,7 +8,6 @@
 from civis.response import find, find_one, ListResponse, Response, PaginatedResponse
 from civis.service_client import ServiceClient
 
-
 try:
     # __sphinx_build__ is injected into bulitins in docs/conf.py.
     if __sphinx_build__:  # type: ignore[name-defined]

src/civis/_camel_to_snake.py

@@ -4,7 +4,6 @@
 
 import re
 
-
 UNDERSCORER1 = re.compile(r"(.)([A-Z][a-z]+)")
 UNDERSCORER2 = re.compile("([a-z0-9])([A-Z])")
 

src/civis/_retries.py

@@ -3,7 +3,6 @@
 import tenacity
 from tenacity.wait import wait_base
 
-
 log = logging.getLogger(__name__)
 
 _RETRY_CODES = [429, 502, 503, 504]

src/civis/cli/__main__.py

@@ -43,7 +43,6 @@
 from civis.resources._resources import parse_method_name
 from civis._retries import retry_request
 
-
 _REPLACEABLE_COMMAND_CHARS = re.compile(r"[^A-Za-z0-9]+")
 _BASE_API_URL = "https://api.civisanalytics.com"
 CLI_USER_AGENT = "civis-cli"

src/civis/cli/_cli_commands.py

@@ -3,6 +3,7 @@
 """
 Additional commands to add to the CLI beyond the OpenAPI spec.
 """
+
 import functools
 import os
 import sys
@@ -16,7 +17,6 @@
 from civis.utils import job_logs
 from civis._retries import get_default_retrying
 
-
 # From http://patorjk.com/software/taag/#p=display&f=3D%20Diagonal&t=CIVIS
 _CIVIS_ASCII_ART = r"""
   ,----..     ,---,               ,---,  .--.--.