sphobjinv 2.3.1.3__tar.gz → 2.4__tar.gz

{sphobjinv-2.3.1.3 → sphobjinv-2.4}/CHANGELOG.md

@@ -2,15 +2,149 @@
 
 All notable changes to this project will be documented in this file.
 
-The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/)
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/)
 and this project follows an extension of
-[Semantic Versioning](http://semver.org/spec/v2.0.0.html), where a bump in a
+[Semantic Versioning](https://semver.org/spec/v2.0.0.html), where a bump in a
 fourth number represents an administrative maintenance release with no code
 changes.
 
-### *Unreleased*
+### [2.4] - 2026-03-23
 
-...
+#### Added
+
+  * Add `sphobjinv-textconv` CLI entrypoint ([#331]).
+    * Takes a single required argument, the path to a local inventory file, and
+      emits the plaintext inventory to `stdout`.
+    * The target use-case is as a Git textconv, primarily intended for
+      compressed `objects.inv` files; but, it will work with any valid type of
+      input file.
+
+#### Tests
+
+  * Remove flake8_ext test file and machinery ([#336]).
+    * pytest environment now can easily de-sync from the flake8 environment
+      since flake8 is running in tox now.
+    * It was really always over-cautious, too.
+
+  * Exclude `setup.py` from coverage ([#336]).
+    * Necessary due to a change in coverage.py behavior, maybe?
+    * Definitely is not expected to run during execution of the test suite.
+
+  * Remove unused `ensure_doc_scratch` fixture from `conftest.py` ([#336]).
+    * Obsolete now that the README shell examples aren't doctested.
+
+  * Add 3.13t and 3.14t to `tox` test matrix ([#333]).
+    * Also add report of the current GIL status to the `tox` env output.
+
+  * Filter newly emerged `ResourceWarning` emitted from implicit cleanup of
+    `tempfile` resources ([#333]).
+
+  * Add tests exercising the new `sphobjinv-textconv` CLI entrypoint ([#331]).
+    * Required generalizing the `run_cmdline_test` fixture so that tests can
+      choose between the core and textconv entrypoints.
+
+  * Update `tox` env test matrix for `py310` to `py314` ([#325]).
+
+  * Update test path calculations to always be relative to `__file__` ([#325]).
+
+  * Relocate `conftest.py` into `tests` ([#325]).
+    * Since the new HTTP server fixtures are going in their own source file, it
+      made the most sense to pull `conftest.py` into the `tests/` directory
+      also.
+    * Required some updates to paths in fixtures &c.
+
+  * Convert HTTP/URL nonloc tests to use a transient local HTTP server ([#325]).
+    * See `tests/fixtures_http.py`.
+    * With the increased caution many sites, including GitHub, are applying to
+      incoming traffic, using 'raw' GitHub assets in the `sphobjinv` repository
+      has become too flaky.
+    * So, we stand up our own HTTP server as a session-scope fixture, and point
+      (nearly) all of the URL tests at the local server.
+       * A small number of tests remain that do still reach out to an internet
+         `objects.inv`.
+    * A small number of outside-world URL tests remain, to docsets that (so far)
+      have been cooperative. Time will tell if we need to find others.
+
+#### Internal
+
+  * Convert `build` call into a `tox` env and remove `build` from
+    `requirements-dev.txt` ([#336]).
+
+  * Remove redundant packages from `requirements-dev.txt` and
+    `requirements-ci.txt` that are pulled in by the `-e .` line ([#336]).
+
+  * Add `tests/resource/objects_pdfminer*` to `MANIFEST.in`, to make that
+    inventory available to the docs build in the sdist unpack-and-test workflow
+    job ([#336]).
+    * Otherwise the docs job emits a warning. Not fatal, but better to have a
+      clean build.
+
+  * Pin Actions versions to SHAs and de-persist credentials ([#336]).
+    * Closes [#322].
+
+  * Add Actions workflow to error on a non-draft release branch if any `#VER#`
+    markers remain in docs source ([#331]).
+
+  * Augment `black` and `flake8` `tox` envs to run `--version` first ([#327]).
+
+  * Remove `-r requirements-flake.txt` from `requirements-dev.txt` ([#327]).
+    * `flake8` should always be run via `tox`.
+
+  * Add `tox` env to run `isort` and execute across codebase ([#327]).
+
+  * Add `flake8-isort` to `flake8` requirements and remove `flake8-import-order`
+    ([#327]).
+    * Also remove `flake8-import-order` config from `tox.ini`.
+
+  * Bump dev-pin Sphinx to v8.1.3 ([#325]).
+    * Two different version constraints at the moment:
+      * Sphinx v8.2 doesn't support Python 3.10 (primary constraint)
+      * Newest `sphinx-rtd-theme` only supports Sphinx `<9` (secondary).
+
+  * Add `push` trigger for `all_core_tests.yml` workflow for `main` branch
+    ([#320]).
+    * This will provide `main` branch CI results for this workflow, for the
+      GitHub badge to report.
+
+#### Documentation
+
+  * Update Sphinx, attrs, Python, etc. content to freshen and to match the new
+    inventories in the test resources ([#336]).
+
+  * Dynamically retrieve the current values of `PrsConst.SUGGEST_CONFIRM_LENGTH`
+    and `PrsConst.DEF_THRESH` to define their replaces in `conf.py` ([#331]).
+
+  * Add `cli/textconv.rst` to document the new `sphobjinv-textconv` CLI
+    entrypoint ([#331]).
+
+  * Cull some superfluous replaces in `conf.py` ([#331]).
+
+  * Relocate the 'help' and 'version' CLI usage documentation content to a new
+    'orphan' page ([#331]).
+    * This keeps the content in the `objects.inv`, for completeness, but keeps
+      it off of the docs nav.
+
+  * Revise 'CLI Usage' documentation to incorporate the `sphobjinv-textconv`
+    entrypoint ([#331]).
+
+  * Remove the 'CLI Implementation' "API reference" docs ([#331]).
+    * They're not part of the public API contract, and they don't actually help
+      understand how the CLI is implemented; so, why bother maintaining them?
+    * Also cull the various `replace` directives defined in `conf.py` for these
+      docs.
+
+#### Administrative
+
+  * Convert several `http://` to `https://` across the project ([#333]).
+
+  * Add formal support for Python 3.14 ([#325]).
+
+  * Drop support for Python 3.9 (EOL) ([#325]).
+
+  * Bump 'core' dev and CI Python version to 3.13 ([#325]).
+
+  * Update the GitHub badge to point to the new `all_core_tests.yml` workflow
+    ([#320]) instead of the now-removed `ci_tests.yml`.
 
 
 ### [2.3.1.3] - 2025-05-26
@@ -680,3 +814,10 @@ changes.
 [#306]: https://github.com/bskinn/sphobjinv/pull/306
 [#315]: https://github.com/bskinn/sphobjinv/pull/315
 [#316]: https://github.com/bskinn/sphobjinv/pull/316
+[#320]: https://github.com/bskinn/sphobjinv/pull/320
+[#322]: https://github.com/bskinn/sphobjinv/issues/322
+[#325]: https://github.com/bskinn/sphobjinv/pull/325
+[#327]: https://github.com/bskinn/sphobjinv/pull/327
+[#331]: https://github.com/bskinn/sphobjinv/pull/331
+[#333]: https://github.com/bskinn/sphobjinv/pull/333
+[#336]: https://github.com/bskinn/sphobjinv/pull/336

{sphobjinv-2.3.1.3 → sphobjinv-2.4}/CONTRIBUTING.md

@@ -39,12 +39,12 @@ $ git clone https://github.com/{you}/sphobjinv
 ```
 
 Then, create a virtual environment for the project, in whatever location you
-prefer. Any Python interpreter 3.9+ *should* work fine.
+prefer. Any Python interpreter 3.10+ *should* work fine.
 
 I prefer to use `virtualenv` and create in `./env`:
 
 ```bash
-$ python3.12 -m virtualenv env --prompt="sphobjinv"
+$ python3.13 -m virtualenv env --prompt="sphobjinv"
 ```
 
 Activate the environment:
@@ -122,6 +122,10 @@ flag:
 $ pytest --nonloc
 ```
 
+Most of these nonlocal tests now use an ephemeral local web server instead of
+reaching out to the web, and so should run even without network access and
+should just run faster in general.
+
 When putting together a PR, at minimum, please add/augment the test suite as
 necessary to maintain 100% test coverage. To the extent possible, please go
 beyond this and add tests that check potential edge cases, bad/malformed/invalid
@@ -140,16 +144,16 @@ Note that while [`tox`](https://tox.wiki/en/latest/) *is* configured for the
 project, it is **not** set up to be an everyday test runner. Instead, its
 purpose for testing is to execute an extensive matrix of test environments
 checking for the compatibility of different Python and dependency versions. You
-can run it if you want, but you'll need working versions of all of Python 3.9
-through 3.13 installed and on `PATH` as `python3.9`, `python3.10`, etc. The
-nonlocal test suite is run for each `tox` environment, so it's best to use at
-most two parallel sub-processes to avoid oversaturating your network bandwidth;
-e.g.:
+can run it if you want, but you'll need working versions of all of Python 3.10
+through 3.14 installed and on `PATH` as `python3.10`, `python3.11`, etc., as
+well as free-threaded versions for Python 3.13 onward as `python3.13t`, etc. The
+test matrix can be accelerated by using `tox`'s parallel execution mode; e.g.:
 
 ```bash
 $ tox -rp2
 ```
 
+
 ## Code Autoformatting
 
 The project is set up with a `tox` environment to blacken the codebase; run with:
@@ -244,20 +248,17 @@ with `make linkcheck`.
 
 ## Continuous Integration
 
-Both Github Actions and Azure Pipelines are set up for the project, and should
-run on any forks of the repository.
+Github Actions workflows are set up for the project, and should run on any forks
+of the repository. Note that the CI runs differently on draft versus non-draft
+PRs: on draft PRs, the only workflow that runs runs tests on Windows and Linux
+with one Python version; whereas on non-draft PRs, a complete test matrix of
+platforms and Python versions is run, as well as doctests and linting checks.
 
-Github Actions runs the test suite on Linux for Python 3.9 through 3.13, as well
+Github Actions runs the test suite on Linux for Python 3.10 through 3.14, as well
 as the `flake8` lints and the Sphinx doctests. By default, the Github Actions
 will run on all commits, but the workflows can be skipped per-commit by
 including `[skip ci]` in the commit message.
 
-The Azure Pipelines CI runs an extensive matrix of cross-platform and
-cross-Python-version tests, as well as numerous other checks. Due to its length,
-it is configured to run only on release branches and PRs to `main` or `stable`.
-The Azure Pipelines workflows now [also obey `[skip ci]`
-directives](https://learn.microsoft.com/en-us/azure/devops/pipelines/repos/azure-repos-git?view=azure-devops&tabs=yaml#skipping-ci-for-individual-pushes).
-
 
 ## CHANGELOG
 

{sphobjinv-2.3.1.3 → sphobjinv-2.4}/LICENSE.txt

@@ -1,6 +1,6 @@
 The MIT License (MIT)
 
-Copyright (c) 2016-2025 Brian Skinn and community contributors
+Copyright (c) 2016-2026 Brian Skinn and community contributors
 
 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

{sphobjinv-2.3.1.3 → sphobjinv-2.4}/MANIFEST.in

@@ -6,10 +6,9 @@ graft src/sphobjinv/_vendored/fuzzywuzzy
 graft doc/source
 include doc/make.bat doc/Makefile
 
-include conftest.py
 graft tests
 prune tests/resource
-include tests/resource/objects_attrs* tests/resource/objects_sarge*
+include tests/resource/objects_attrs* tests/resource/objects_sarge* tests/resource/objects_pdfminer*
 
 global-exclude __pycache__/*
 prune **/*.egg-info

{sphobjinv-2.3.1.3 → sphobjinv-2.4}/PKG-INFO

@@ -1,18 +1,16 @@
 Metadata-Version: 2.4
 Name: sphobjinv
-Version: 2.3.1.3
+Version: 2.4
 Summary: Sphinx objects.inv Inspection/Manipulation Tool
 Author-email: Brian Skinn <brian.skinn@gmail.com>
-License: MIT License
-Project-URL: Homepage, https://github.com/bskinn/sphobjinv
+License-Expression: MIT
 Project-URL: Changelog, https://github.com/bskinn/sphobjinv/blob/main/CHANGELOG.md
 Project-URL: Docs, https://sphobjinv.readthedocs.io/en/stable/
-Project-URL: Thank, https://fosstodon.org/@btskinn
 Project-URL: Donate, https://github.com/sponsors/bskinn
+Project-URL: Homepage, https://github.com/bskinn/sphobjinv
+Project-URL: Thank, https://fosstodon.org/@btskinn
 Keywords: sphinx,sphinx-doc,inventory,manager,inspector
 Platform: any
-Classifier: License :: OSI Approved
-Classifier: License :: OSI Approved :: MIT License
 Classifier: Natural Language :: English
 Classifier: Environment :: Console
 Classifier: Framework :: Sphinx
@@ -21,23 +19,23 @@ Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3 :: Only
-Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
 Classifier: Topic :: Documentation
 Classifier: Topic :: Documentation :: Sphinx
 Classifier: Topic :: Software Development
 Classifier: Topic :: Software Development :: Documentation
 Classifier: Topic :: Utilities
 Classifier: Development Status :: 5 - Production/Stable
-Requires-Python: >=3.9
+Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE.txt
 Requires-Dist: attrs>=19.2
 Requires-Dist: certifi
-Requires-Dist: jsonschema>=3.0
+Requires-Dist: jsonschema>=3.1.1
 Dynamic: description
 Dynamic: description-content-type
 Dynamic: license-file
@@ -86,26 +84,24 @@ For internal cross-references, locate `objects.inv` within `build/html`:
 ```none
 $ sphobjinv suggest doc/build/html/objects.inv as_rst -st 58
 
-------------------------------------------------
+-----------------------------------------------------------------------------------------------------------
 
 Cannot infer intersphinx_mapping from a local objects.inv.
 
-------------------------------------------------
+-----------------------------------------------------------------------------------------------------------
 
 Project: sphobjinv
-Version: 2.3
-
-220 objects in inventory.
+Version: 2.4
 
-------------------------------------------------
+151 objects in inventory.
 
-11 results found at/above current threshold of 58.
+-----------------------------------------------------------------------------------------------------------
 
+10 results found at/above current threshold of 58.
 
   Name                                                Score
 ---------------------------------------------------  -------
 :py:property:`sphobjinv.data.SuperDataObj.as_rst`      60
-:py:class:`sphobjinv.cli.parser.PrsConst`              59
 :py:class:`sphobjinv.data.DataFields`                  59
 :py:class:`sphobjinv.data.DataObjBytes`                59
 :py:class:`sphobjinv.data.DataObjStr`                  59
@@ -128,31 +124,31 @@ cross-reference the `linspace` function from numpy (see
 [here][numpy linspace]):
 
 ```none
-$ sphobjinv suggest https://numpy.org/doc/1.26/reference/index.html linspace -su
+$ sphobjinv suggest https://numpy.org/doc/2.4/reference/index.html linspace -su
 
-Attempting https://numpy.org/doc/1.26/reference/index.html ...
+Attempting https://numpy.org/doc/2.4/reference/index.html ...
   ... no recognized inventory.
-Attempting "https://numpy.org/doc/1.26/reference/index.html/objects.inv" ...
+Attempting "https://numpy.org/doc/2.4/reference/index.html/objects.inv" ...
   ... HTTP error: 404 Not Found.
-Attempting "https://numpy.org/doc/1.26/reference/objects.inv" ...
+Attempting "https://numpy.org/doc/2.4/reference/objects.inv" ...
   ... HTTP error: 404 Not Found.
-Attempting "https://numpy.org/doc/1.26/objects.inv" ...
+Attempting "https://numpy.org/doc/2.4/objects.inv" ...
   ... inventory found.
 
-----------------------------------------------------------------------------------
+-----------------------------------------------------------------------------------------------------------
 
 The intersphinx_mapping for this docset is LIKELY:
 
-  (https://numpy.org/doc/1.26/, None)
+  (https://numpy.org/doc/2.4/, None)
 
-----------------------------------------------------------------------------------
+-----------------------------------------------------------------------------------------------------------
 
 Project: NumPy
-Version: 1.26
+Version: 2.4
 
-8152 objects in inventory.
+8456 objects in inventory.
 
-----------------------------------------------------------------------------------
+-----------------------------------------------------------------------------------------------------------
 
 8 results found at/above current threshold of 75.
 
@@ -198,13 +194,13 @@ inventory creation/modification:
 >>> import sphobjinv as soi
 >>> inv = soi.Inventory('doc/build/html/objects.inv')
 >>> print(inv)
-<Inventory (fname_zlib): sphobjinv v2.3, 220 objects>
+<Inventory (fname_zlib): sphobjinv v2.4, 151 objects>
 >>> inv.project
 'sphobjinv'
 >>> inv.version
-'2.3'
+'2.4'
 >>> inv.objects[0]
-DataObjStr(name='sphobjinv.cli.convert', domain='py', role='module', priority='0', uri='cli/implementation/convert.html#module-$', dispname='-')
+DataObjStr(name='sphobjinv.data', domain='py', role='module', priority='0', uri='api/data.html#module-$', dispname='-')
 
 ```
 
@@ -221,7 +217,7 @@ Available on [PyPI][pypi link target] (`pip install sphobjinv`).
 Source on [GitHub][github repo]. Bug reports and feature requests are welcomed
 at the [Issues][github issue tracker] page there.
 
-Copyright (c) Brian Skinn 2016-2025
+Copyright (c) 2016-2026 Brian Skinn and community contributors
 
 The `sphobjinv` documentation (including docstrings and README) is licensed
 under a [Creative Commons Attribution 4.0 International License][cc-by 4.0]
@@ -231,8 +227,8 @@ under a [Creative Commons Attribution 4.0 International License][cc-by 4.0]
 
 [black badge]: https://img.shields.io/badge/code%20style-black-000000.svg
 [black link target]: https://github.com/psf/black
-[cc-by 4.0]: http://creativecommons.org/licenses/by/4.0/
-[soi docs inv export]: http://sphobjinv.readthedocs.io/en/v2.3.1.2/api_usage.html#exporting-an-inventory
+[cc-by 4.0]: https:/creativecommons.org/licenses/by/4.0/
+[soi docs inv export]: https://sphobjinv.readthedocs.io/en/v2.4/api_usage.html#exporting-an-inventory
 [github issue tracker]: https://github.com/bskinn/sphobjinv/issues
 [github repo]: https://github.com/bskinn/sphobjinv
 [gitter badge]: https://badges.gitter.im/sphobjinv/community.svg
@@ -242,11 +238,11 @@ under a [Creative Commons Attribution 4.0 International License][cc-by 4.0]
 [mit license]: https://opensource.org/licenses/MIT
 [numpy linspace]: https://numpy.org/doc/1.26/reference/generated/numpy.linspace.html
 [pepy badge]: https://pepy.tech/badge/sphobjinv/month
-[pepy link target]: https://pepy.tech/projects/sphobjinv?timeRange=threeMonths&category=version&includeCIDownloads=true&granularity=daily&viewType=chart&versions=2.0.*%2C2.1.*%2C2.2.*%2C2.3.*
+[pepy link target]: https://pepy.tech/projects/sphobjinv?timeRange=threeMonths&category=version&includeCIDownloads=true&granularity=daily&versions=2.3.*%2C2.4*
 [pypi badge]: https://img.shields.io/pypi/v/sphobjinv.svg?logo=pypi]
 [pypi link target]: https://pypi.org/project/sphobjinv
 [python versions badge]: https://img.shields.io/pypi/pyversions/sphobjinv.svg?logo=python
-[readthedocs badge]: https://img.shields.io/readthedocs/sphobjinv/v2.3.1.2.svg
-[readthedocs link target]: http://sphobjinv.readthedocs.io/en/v2.3.1.2/
-[workflow badge]: https://img.shields.io/github/actions/workflow/status/bskinn/sphobjinv/ci_tests.yml?logo=github&branch=main
+[readthedocs badge]: https://img.shields.io/readthedocs/sphobjinv/v2.4.svg
+[readthedocs link target]: https://sphobjinv.readthedocs.io/en/v2.4/
+[workflow badge]: https://img.shields.io/github/actions/workflow/status/bskinn/sphobjinv/all_core_tests.yml?logo=github&branch=main
 [workflow link target]: https://github.com/bskinn/sphobjinv/actions

{sphobjinv-2.3.1.3 → sphobjinv-2.4}/README.md

@@ -42,26 +42,24 @@ For internal cross-references, locate `objects.inv` within `build/html`:
 ```none
 $ sphobjinv suggest doc/build/html/objects.inv as_rst -st 58
 
-------------------------------------------------
+-----------------------------------------------------------------------------------------------------------
 
 Cannot infer intersphinx_mapping from a local objects.inv.
 
-------------------------------------------------
+-----------------------------------------------------------------------------------------------------------
 
 Project: sphobjinv
-Version: 2.3
+Version: 2.4
 
-220 objects in inventory.
+151 objects in inventory.
 
-------------------------------------------------
-
-11 results found at/above current threshold of 58.
+-----------------------------------------------------------------------------------------------------------
 
+10 results found at/above current threshold of 58.
 
   Name                                                Score
 ---------------------------------------------------  -------
 :py:property:`sphobjinv.data.SuperDataObj.as_rst`      60
-:py:class:`sphobjinv.cli.parser.PrsConst`              59
 :py:class:`sphobjinv.data.DataFields`                  59
 :py:class:`sphobjinv.data.DataObjBytes`                59
 :py:class:`sphobjinv.data.DataObjStr`                  59
@@ -84,31 +82,31 @@ cross-reference the `linspace` function from numpy (see
 [here][numpy linspace]):
 
 ```none
-$ sphobjinv suggest https://numpy.org/doc/1.26/reference/index.html linspace -su
+$ sphobjinv suggest https://numpy.org/doc/2.4/reference/index.html linspace -su
 
-Attempting https://numpy.org/doc/1.26/reference/index.html ...
+Attempting https://numpy.org/doc/2.4/reference/index.html ...
   ... no recognized inventory.
-Attempting "https://numpy.org/doc/1.26/reference/index.html/objects.inv" ...
+Attempting "https://numpy.org/doc/2.4/reference/index.html/objects.inv" ...
   ... HTTP error: 404 Not Found.
-Attempting "https://numpy.org/doc/1.26/reference/objects.inv" ...
+Attempting "https://numpy.org/doc/2.4/reference/objects.inv" ...
   ... HTTP error: 404 Not Found.
-Attempting "https://numpy.org/doc/1.26/objects.inv" ...
+Attempting "https://numpy.org/doc/2.4/objects.inv" ...
   ... inventory found.
 
-----------------------------------------------------------------------------------
+-----------------------------------------------------------------------------------------------------------
 
 The intersphinx_mapping for this docset is LIKELY:
 
-  (https://numpy.org/doc/1.26/, None)
+  (https://numpy.org/doc/2.4/, None)
 
-----------------------------------------------------------------------------------
+-----------------------------------------------------------------------------------------------------------
 
 Project: NumPy
-Version: 1.26
+Version: 2.4
 
-8152 objects in inventory.
+8456 objects in inventory.
 
-----------------------------------------------------------------------------------
+-----------------------------------------------------------------------------------------------------------
 
 8 results found at/above current threshold of 75.
 
@@ -154,13 +152,13 @@ inventory creation/modification:
 >>> import sphobjinv as soi
 >>> inv = soi.Inventory('doc/build/html/objects.inv')
 >>> print(inv)
-<Inventory (fname_zlib): sphobjinv v2.3, 220 objects>
+<Inventory (fname_zlib): sphobjinv v2.4, 151 objects>
 >>> inv.project
 'sphobjinv'
 >>> inv.version
-'2.3'
+'2.4'
 >>> inv.objects[0]
-DataObjStr(name='sphobjinv.cli.convert', domain='py', role='module', priority='0', uri='cli/implementation/convert.html#module-$', dispname='-')
+DataObjStr(name='sphobjinv.data', domain='py', role='module', priority='0', uri='api/data.html#module-$', dispname='-')
 
 ```
 
@@ -177,7 +175,7 @@ Available on [PyPI][pypi link target] (`pip install sphobjinv`).
 Source on [GitHub][github repo]. Bug reports and feature requests are welcomed
 at the [Issues][github issue tracker] page there.
 
-Copyright (c) Brian Skinn 2016-2025
+Copyright (c) 2016-2026 Brian Skinn and community contributors
 
 The `sphobjinv` documentation (including docstrings and README) is licensed
 under a [Creative Commons Attribution 4.0 International License][cc-by 4.0]
@@ -187,8 +185,8 @@ under a [Creative Commons Attribution 4.0 International License][cc-by 4.0]
 
 [black badge]: https://img.shields.io/badge/code%20style-black-000000.svg
 [black link target]: https://github.com/psf/black
-[cc-by 4.0]: http://creativecommons.org/licenses/by/4.0/
-[soi docs inv export]: http://sphobjinv.readthedocs.io/en/latest/api_usage.html#exporting-an-inventory
+[cc-by 4.0]: https:/creativecommons.org/licenses/by/4.0/
+[soi docs inv export]: https://sphobjinv.readthedocs.io/en/latest/api_usage.html#exporting-an-inventory
 [github issue tracker]: https://github.com/bskinn/sphobjinv/issues
 [github repo]: https://github.com/bskinn/sphobjinv
 [gitter badge]: https://badges.gitter.im/sphobjinv/community.svg
@@ -198,11 +196,11 @@ under a [Creative Commons Attribution 4.0 International License][cc-by 4.0]
 [mit license]: https://opensource.org/licenses/MIT
 [numpy linspace]: https://numpy.org/doc/1.26/reference/generated/numpy.linspace.html
 [pepy badge]: https://pepy.tech/badge/sphobjinv/month
-[pepy link target]: https://pepy.tech/projects/sphobjinv?timeRange=threeMonths&category=version&includeCIDownloads=true&granularity=daily&viewType=chart&versions=2.0.*%2C2.1.*%2C2.2.*%2C2.3.*
+[pepy link target]: https://pepy.tech/projects/sphobjinv?timeRange=threeMonths&category=version&includeCIDownloads=true&granularity=daily&versions=2.3.*%2C2.4*
 [pypi badge]: https://img.shields.io/pypi/v/sphobjinv.svg?logo=pypi]
 [pypi link target]: https://pypi.org/project/sphobjinv
 [python versions badge]: https://img.shields.io/pypi/pyversions/sphobjinv.svg?logo=python
 [readthedocs badge]: https://img.shields.io/readthedocs/sphobjinv/latest.svg
-[readthedocs link target]: http://sphobjinv.readthedocs.io/en/latest/
-[workflow badge]: https://img.shields.io/github/actions/workflow/status/bskinn/sphobjinv/ci_tests.yml?logo=github&branch=main
+[readthedocs link target]: https://sphobjinv.readthedocs.io/en/latest/
+[workflow badge]: https://img.shields.io/github/actions/workflow/status/bskinn/sphobjinv/all_core_tests.yml?logo=github&branch=main
 [workflow link target]: https://github.com/bskinn/sphobjinv/actions

{sphobjinv-2.3.1.3 → sphobjinv-2.4}/doc/make.bat

@@ -21,7 +21,7 @@ if errorlevel 9009 (
 	echo.may add the Sphinx directory to PATH.
 	echo.
 	echo.If you don't have Sphinx installed, grab it from
-	echo.http://sphinx-doc.org/
+	echo.https://sphinx-doc.org/
 	exit /b 1
 )
 

sphobjinv-2.4/doc/source/_templates/footer.html

@@ -0,0 +1,21 @@
+{% extends "!footer.html" %}
+
+{%-block extrafooter %}
+
+{{ super() }}
+
+<br /><br />
+
+<p class="footer-license">
+  Logo and favicon adapted from freely-available image at
+  https://heypik.com/images/hand-drawn-cartoon-color-tourist-attraction-sphinx_8ZU4501.html
+  (retrieved July 2019; now defunct).
+</p>
+
+<p class="footer-license">
+  <a rel="license" href="https://creativecommons.org/licenses/by/4.0/"><img alt="Creative Commons License" style="border-width:0" src="https://i.creativecommons.org/l/by/4.0/80x15.png" /></a>
+  &nbsp;&nbsp;
+  <span xmlns:dct="https://purl.org/dc/terms/" property="dct:title">The sphobjinv documentation</span> is licensed under a <a rel="license" href="https://creativecommons.org/licenses/by/4.0/">Creative Commons Attribution 4.0 International License</a>.
+</p>
+
+{% endblock %}

{sphobjinv-2.3.1.3 → sphobjinv-2.4}/doc/source/api/index.rst

@@ -1,7 +1,7 @@
 .. API page
 
-API
-===
+API Reference
+=============
 
 Most (all?) of the objects documented in the below submodules
 are also exposed at the |soi| package root. For example,