Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .github/workflows/tests.yml
Original file line number Diff line number Diff line change
Expand Up @@ -82,7 +82,7 @@ jobs:
strategy:
fail-fast: false
matrix:
python-version: ["3.10", "3.11", "3.12", "3.13"]
python-version: ["3.11", "3.12", "3.13", "3.14"]

steps:
- name: Checkout
Expand Down
7 changes: 5 additions & 2 deletions Makefile
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,9 @@ SPHINXAUTOBUILD = "$(realpath .venv/bin/sphinx-autobuild)"
SPHINXBUILD = "$(realpath .venv/bin/sphinx-build)"
SPHINXAPIDOC = "$(realpath .venv/bin/sphinx-apidoc)"
TOWNCRIERPATH = "$(realpath .venv/bin/towncrier)"
# TODO: determine why sphinx-apidoc ignores this environment variable
# sphinx-apidoc's own SPHINX_APIDOC_OPTIONS env var is never set as a real
# shell variable here, so it's passed explicitly via --automodule-options
# on the apidoc target below instead.
SPHINX_APIDOC_OPTIONS = ignore-module-all,members,show-inheritance,undoc-members
DOCS_DIR = ./docs/
BUILDDIR = ../_build
Expand All @@ -27,7 +29,7 @@ ALLSPHINXOPTS = -W -d $(BUILDDIR)/doctrees $(PAPEROPT_$(PAPER)) $(SPHINXOPTS)
VALEFILES := $(shell find $(DOCS_DIR) -type f -name "*.rst" -print) # Also add `src` for docstrings.
VALEOPTS ?=
ZIZMOROPTS ?=
PYTHONVERSION = >=3.10,<3.15
PYTHONVERSION = >=3.11,<3.15

# Add the following 'help' target to your Makefile
# And add help text after each target name starting with '\#\#'
Expand Down Expand Up @@ -75,6 +77,7 @@ apidoc: .venv ## Build .rst stub file pages for API reference documentation
--remove-old \
--separate \
--module-first \
--automodule-options=$(SPHINX_APIDOC_OPTIONS) \
Comment thread
stevepiercy marked this conversation as resolved.
Resolved
-o reference/api \
$(SOURCE) \
$(SOURCE)/tests*
Expand Down
4 changes: 1 addition & 3 deletions docs/conf.py
Original file line number Diff line number Diff line change
Expand Up @@ -196,9 +196,7 @@ def _drop_private_bases(app, name, obj, options, bases):
base was private, so the "Bases:" line never renders empty.
"""
kept = [
base
for base in bases
if not (isinstance(base, str) and _PRIVATE_BASE_RE.fullmatch(base))
base for base in bases if not (isinstance(base, str) and _PRIVATE_BASE_RE.fullmatch(base))
]
bases[:] = kept or [":py:class:`object`"]

Expand Down
1 change: 1 addition & 0 deletions docs/reference/api/calendaring_jmap.async_client.rst
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,7 @@ calendaring\_jmap.async\_client module
======================================

.. automodule:: calendaring_jmap.async_client
:ignore-module-all:
:members:
:show-inheritance:
:undoc-members:
1 change: 1 addition & 0 deletions docs/reference/api/calendaring_jmap.client.rst
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,7 @@ calendaring\_jmap.client module
===============================

.. automodule:: calendaring_jmap.client
:ignore-module-all:
:members:
:show-inheritance:
:undoc-members:
1 change: 1 addition & 0 deletions docs/reference/api/calendaring_jmap.constants.rst
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,7 @@ calendaring\_jmap.constants module
==================================

.. automodule:: calendaring_jmap.constants
:ignore-module-all:
:members:
:show-inheritance:
:undoc-members:
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,7 @@ calendaring\_jmap.convert.ical\_to\_jscal module
================================================

.. automodule:: calendaring_jmap.convert.ical_to_jscal
:ignore-module-all:
:members:
:show-inheritance:
:undoc-members:
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,7 @@ calendaring\_jmap.convert.jscal\_to\_ical module
================================================

.. automodule:: calendaring_jmap.convert.jscal_to_ical
:ignore-module-all:
:members:
:show-inheritance:
:undoc-members:
1 change: 1 addition & 0 deletions docs/reference/api/calendaring_jmap.error.rst
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,7 @@ calendaring\_jmap.error module
==============================

.. automodule:: calendaring_jmap.error
:ignore-module-all:
:members:
:show-inheritance:
:undoc-members:
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,7 @@ calendaring\_jmap.objects.attachment module
===========================================

.. automodule:: calendaring_jmap.objects.attachment
:ignore-module-all:
:members:
:show-inheritance:
:undoc-members:
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,7 @@ calendaring\_jmap.objects.busy\_interval module
===============================================

.. automodule:: calendaring_jmap.objects.busy_interval
:ignore-module-all:
:members:
:show-inheritance:
:undoc-members:
1 change: 1 addition & 0 deletions docs/reference/api/calendaring_jmap.objects.calendar.rst
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,7 @@ calendaring\_jmap.objects.calendar module
=========================================

.. automodule:: calendaring_jmap.objects.calendar
:ignore-module-all:
:members:
:show-inheritance:
:undoc-members:
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,7 @@ calendaring\_jmap.objects.calendar\_object module
=================================================

.. automodule:: calendaring_jmap.objects.calendar_object
:ignore-module-all:
:members:
:show-inheritance:
:undoc-members:
1 change: 1 addition & 0 deletions docs/reference/api/calendaring_jmap.objects.contact.rst
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,7 @@ calendaring\_jmap.objects.contact module
========================================

.. automodule:: calendaring_jmap.objects.contact
:ignore-module-all:
:members:
:show-inheritance:
:undoc-members:
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,7 @@ calendaring\_jmap.objects.event\_search\_result module
======================================================

.. automodule:: calendaring_jmap.objects.event_search_result
:ignore-module-all:
:members:
:show-inheritance:
:undoc-members:
1 change: 1 addition & 0 deletions docs/reference/api/calendaring_jmap.session.rst
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,7 @@ calendaring\_jmap.session module
================================

.. automodule:: calendaring_jmap.session
:ignore-module-all:
:members:
:show-inheritance:
:undoc-members:
1 change: 1 addition & 0 deletions news/+drop-python-310.breaking.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
Dropped Python 3.10 support. ``requires-python`` is now ``>=3.11``.
1 change: 1 addition & 0 deletions news/+python-314-support.feature.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
Added Python 3.14 support.
1 change: 1 addition & 0 deletions news/+sphinx-apidoc-options.documentation.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
The ``apidoc`` make target now actually passes ``SPHINX_APIDOC_OPTIONS`` to :program:`sphinx-apidoc`, via ``--automodule-options``; the :file:`Makefile` set the variable but never wired it into the command.
1 change: 1 addition & 0 deletions news/+sphinx-autodoc-typehints-warning.documentation.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
The one-off Sphinx warning about an unresolvable forward reference in ``niquests``' own type hints is suppressed locally instead of turning off warnings-as-errors project-wide; it's a bug in ``niquests``, not in calendaring-jmap.
Comment thread
stevepiercy marked this conversation as resolved.
Resolved
4 changes: 2 additions & 2 deletions pyproject.toml
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ build-backend = "hatchling.build"
name = "calendaring-jmap"
description = "JMAP (RFC 8620) calendar client library"
readme = "README.md"
requires-python = ">=3.10"
requires-python = ">=3.11"
license = "AGPL-3.0-or-later"
license-files = ["LICENSE"]
authors = [{ name = "Sashank Bhamidi" }]
Expand All @@ -21,10 +21,10 @@ classifiers = [
"License :: OSI Approved :: GNU Affero General Public License v3 or later (AGPLv3+)",
"Operating System :: OS Independent",
"Programming Language :: Python",
"Programming Language :: Python :: 3.10",
"Programming Language :: Python :: 3.11",
"Programming Language :: Python :: 3.12",
"Programming Language :: Python :: 3.13",
"Programming Language :: Python :: 3.14",
"Topic :: Office/Business :: Scheduling",
"Topic :: Software Development :: Libraries :: Python Modules",
]
Expand Down
Loading
Loading