Skip to content

Conversation

@bkeryan
Copy link
Collaborator

@bkeryan bkeryan commented May 1, 2025

What does this Pull Request accomplish?

Upgrade to the latest Sphinx, which requires Python 3.11 or later.

Change copyright year to "2022-2025" to reflect the first year when this package and its documentation were published.

Use %Y placeholder to specify the year.

Note

The package name was ni-measurement-service in 2022, then it was renamed to ni-measurementlink-service in 2023, and renamed again to ni-measurement-plugin-sdk-service in 2024.

Reformat pyproject.toml because I have my editor configured to reformat now.

Why should this Pull Request be merged?

While setting up Sphinx for another project, I noticed that the Python 3.9 version constraint requires using a Sphinx version from 2023 and the %Y placeholder was not supported with that older version.

What testing has been done?

Ran poetry run sphinx-build _docs_source docs -b html -W --keep-going and inspected the output locally.
It printed some warnings about ReadTheDocs's SSL certificates, so I'll check whether the PR build has the same warnings.

WARNING: failed to reach any of the inventories with the following issues:
intersphinx inventory 'https://nidcpower.readthedocs.io/en/stable/objects.inv' not fetchable due to <class 'requests.exceptions.SSLError'>: HTTPSConnectionPool(host='nidcpower.readthedocs.io', port=443): Max retries exceeded with url: /en/stable/objects.inv (Caused by SSLError(SSLCertVerificationError(1, '[SSL: CERTIFICATE_VERIFY_FAILED] certificate verify failed: unable to get local issuer certificate (_ssl.c:1006)')))

@github-actions
Copy link
Contributor

github-actions bot commented May 2, 2025

Test Results

    52 files  ±0      52 suites  ±0   1h 18m 16s ⏱️ - 2m 14s
   709 tests ±0     709 ✅ ±0      0 💤 ±0  0 ❌ ±0 
21 420 runs  ±0  20 344 ✅ ±0  1 076 💤 ±0  0 ❌ ±0 

Results for commit 5518f74. ± Comparison against base commit 45f53e6.

♻️ This comment has been updated with latest results.

@dixonjoel
Copy link
Collaborator

What happened to the checks on this PR? I'm waiting until we get a passing PR to review.

@bkeryan
Copy link
Collaborator Author

bkeryan commented May 5, 2025

What happened to the checks on this PR? I'm waiting until we get a passing PR to review.

I think GitHub was having some problems on Friday. I saw checks hanging in other repos too.

@bkeryan
Copy link
Collaborator Author

bkeryan commented May 5, 2025

Closing and reopening to try to fix GitHub checks

@bkeryan bkeryan closed this May 5, 2025
@bkeryan bkeryan reopened this May 5, 2025
@bkeryan bkeryan force-pushed the users/bkeryan/upgrade-sphinx branch from 61a8575 to 5518f74 Compare May 6, 2025 19:57
@bkeryan
Copy link
Collaborator Author

bkeryan commented May 7, 2025

What happened to the checks on this PR? I'm waiting until we get a passing PR to review.

The checks are passing now (despite Poetry+virtualenv --wheel=bundle problems).

@bkeryan bkeryan merged commit 64174c6 into main May 8, 2025
17 checks passed
@bkeryan bkeryan deleted the users/bkeryan/upgrade-sphinx branch May 8, 2025 17:32
bkeryan added a commit that referenced this pull request Jun 23, 2025
* service: Reformat pyproject.toml

* service: Upgrade to latest Sphinx

* service: Update poetry.lock

* service: Update copyright to reflect year first published

* service: Add a comment about Sphinx version

* docs: Add gRPC and protobuf hyperlinks

* service: Update poetry.lock

(cherry picked from commit 64174c6)
bkeryan added a commit that referenced this pull request Jun 24, 2025
* service: Reformat pyproject.toml

* service: Upgrade to latest Sphinx

* service: Update poetry.lock

* service: Update copyright to reflect year first published

* service: Add a comment about Sphinx version

* docs: Add gRPC and protobuf hyperlinks

* service: Update poetry.lock

(cherry picked from commit 64174c6)
bkeryan added a commit that referenced this pull request Jun 25, 2025
* docs: Upgrade Sphinx and change copyright year to "2022-%Y" (#1118)

* service: Reformat pyproject.toml

* service: Upgrade to latest Sphinx

* service: Update poetry.lock

* service: Update copyright to reflect year first published

* service: Add a comment about Sphinx version

* docs: Add gRPC and protobuf hyperlinks

* service: Update poetry.lock

(cherry picked from commit 64174c6)

* docs: Remove Sphinx --keep-going option (#1126)

(cherry picked from commit 262ab18)

* docs: Remove tomlkit dependency (#1166)

* docs: Remove tomlkit dependency

* service: Update poetry.lock

(cherry picked from commit 15b1bb8)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants