Adam Turner
c4daa95c09
Enable the entire D category in Ruff
2025-01-14 15:55:02 +00:00
Adam Turner
c66d3e85d1
Enable 11 more categories in Ruff
...
* flake8-builtins ('A')
* flake8-blind-except ('BLE')
* flake8-copyright ('CPY')
* eradicate ('ERA')
* flake8-boolean-trap ('FBT')
* flake8-fixme ('FIX')
* flake8-implicit-str-concat ('ISC')
* pep8-naming ('N')
* flake8-use-pathlib ('PTH')
* flake8-self ('SLF')
* tryceratops ('TRY')
2025-01-14 14:43:02 +00:00
Adam Turner
72ce43619c
Remove unneeded runtime typing imports ( #13233 )
2025-01-12 01:04:14 +00:00
Adam Turner
74ec220479
apidoc: Rename test roots
2025-01-07 11:06:29 +00:00
Adam Turner
8732b2324a
Split out `sphinx.ext.apidoc._generate`
2025-01-07 08:33:20 +00:00
Adam Turner
2bd70193b7
Split out `sphinx.ext.apidoc._cli`
2025-01-07 08:32:11 +00:00
Adam Turner
47599df1bc
apidoc: Add `--automodule-options`
2025-01-07 08:05:20 +00:00
Adam Turner
df06e6d628
Add `InventoryFile.loads()` ( #13215 )
2025-01-07 00:40:57 +00:00
Adam Turner
5ff3740063
Adapt tests for Pygments 2.19
2025-01-06 06:56:10 +00:00
ProGamerGov
fec4d7c2f1
Viewcode: Fix issue with import paths that differ from the directory structure ( #13195 )
...
Co-authored-by: Adam Turner <9087854+aa-turner@users.noreply.github.com>
2025-01-05 10:43:57 +00:00
Adam Turner
83bf866059
Avoid attribute indirection with `env` ( #13212 )
2025-01-05 09:10:55 +00:00
Adam Turner
849d309db4
Napoleon: Use `:py:{...}` in type preprocessing
2025-01-05 02:13:15 +00:00
Chris Barrick
8d75ae2d6b
Napoleon: Unify the type preprocessing logic
...
Previously, there were two type preprocessing functions:
`_convert_type_spec` (used in Google-style docstrings) and
`_convert_numpy_type_spec` (used in Numpy-style docstrings).
The Google version simply applied type-alias translations or wrapped
the text in a `:py:class:` role.
The Numpy version does the same, plus adds special handling for keywords
`optional` and `default` and delimiter words `or`, `of`, and `and`. This
allows one to write in natural language, like `Array of int` instead of
`Array[int]` or `Widget, optional` instead of `Optional[Widget]` or
`Widget | None`. Numpy style is described in full at:
https://numpydoc.readthedocs.io/en/latest/format.html#parameters
This commit eliminates the distinction and allows Google-style
docstrings to use these preprocessing rules.
2025-01-05 01:18:29 +00:00
Adam Turner
02beccac0a
intersphinx: Define a restricted subset of Config as `InvConfig` ( #13210 )
2025-01-05 01:06:51 +00:00
Adam Turner
619a10efa7
intersphinx: Simplify `_fetch_inventory()` ( #13209 )
...
The streams-based interfaces in intersphinx and ``sphinx.util.inventory``
are clever, but also complex and prevent using compression methods
that don't support incrememntal decoding. This change refactors
``_fetch_inventory()`` to read all inventory content from disk or an
HTTP request at once.
2025-01-05 00:34:49 +00:00
Adam Turner
e17ed74fe0
Remove unneeded content from within `with` statements
2025-01-04 09:11:33 +00:00
Adam Turner
e65bbb96ae
Create a new type for the current document's environment state ( #13151 )
2025-01-04 00:28:03 +00:00
Nicolas Peugnet
0fbf88a59f
Allow extensions to define the keys returned by linkcode ( #11824 )
...
Co-authored-by: Adam Turner <9087854+aa-turner@users.noreply.github.com>
2025-01-03 21:28:34 +00:00
Adam Turner
3028e818c9
Remove test skips for Python 3.14 ( #13041 )
2025-01-03 07:31:40 +00:00
Adam Turner
00ad109a39
Run Ruff on `tests/roots/`
2025-01-03 01:33:14 +00:00
Adam Turner
2aad3a87f4
Enable the entire Q category in Ruff
2025-01-02 23:49:44 +00:00
Adam Turner
b5f9ac8afc
Enable the RUF100 lint in Ruff
2025-01-02 23:49:43 +00:00
Adam Turner
51bbfe259e
Avoid using camelCase names in napoleon tests
2024-12-09 14:59:36 +00:00
Adam Turner
34f5a8d503
Avoid using camelCase names in autodoc tests
2024-12-09 14:59:25 +00:00
Adam Turner
2d2b73c706
Avoid using camelCase names in autosummary tests
2024-12-09 14:57:08 +00:00
Adam Turner
19dfc3f5af
Enable the RUF031 lint in Ruff
2024-11-30 19:22:30 +00:00
Adam Turner
2f1cd36798
Enable the RUF015 lint in Ruff
2024-11-30 19:19:34 +00:00
Adam Turner
3af48520d2
Require the PEP 563 'annotations' future import
2024-11-22 21:54:26 +00:00
Adam Turner
15b46dc81e
Enable the entire PYI category in Ruff
2024-11-15 01:00:36 +00:00
Adam Turner
efc36ac38f
Bump Ruff to 0.7.3
2024-11-14 16:40:34 +00:00
Dimitri Papadopoulos Orfanos
c427edb0bd
Emend spelling errors ( #13113 )
...
Co-authored-by: Adam Turner <9087854+aa-turner@users.noreply.github.com>
2024-11-08 12:11:42 +00:00
Adam Turner
1094556afb
Bump Ruff to 0.7.2
2024-11-03 02:55:19 +00:00
Adam Turner
71c0fcfbc5
Use pathlib in the tests ( #13051 )
2024-10-25 22:41:08 +01:00
Adam Turner
e58dd58f35
Enable the PLR6201 lint in Ruff
2024-10-19 19:05:43 +01:00
Adam Turner
c5dce468bc
Enable the PLW3201 lint in Ruff
2024-10-19 19:05:42 +01:00
Adam Turner
3920af4700
Enable the PLW0603 lint in Ruff
2024-10-19 19:05:42 +01:00
Adam Turner
c78b4c5404
Enable the PLE0704 lint in Ruff
2024-10-19 01:15:09 +01:00
Adam Turner
dc29ad1fde
Format test_sphinx_admonitions()
2024-10-18 20:48:41 +01:00
Adam Turner
ed8045ceea
Test on Python 3.14 ( #12978 )
2024-10-18 01:22:37 +01:00
Adam Turner
6c52c922e5
Support Enum signatures in Python 3.12 and 3.13
2024-10-18 00:42:21 +01:00
Adam Turner
cef2bcec36
Refactor `_EnumFormatter`
2024-10-18 00:29:03 +01:00
Adam Turner
d3956894d7
Use the non-deprecated name for EnumType
2024-10-17 23:42:21 +01:00
Adam Turner
541bf7bc67
Drop support for Python 3.10 ( #13000 )
2024-10-17 20:59:41 +01:00
Adam Turner
62e9606d63
Restore support for `cut_lines()` with no object type ( #13015 )
2024-10-12 23:14:24 +01:00
Übertreiber
cc1b13ccbf
intersphinx: fix flipped use of intersphinx_cache_limit. ( #12905 )
...
Co-authored-by: Nico Madysa <nico.madysa@cern.ch>
Co-authored-by: Adam Turner <9087854+aa-turner@users.noreply.github.com>
2024-10-07 21:19:20 +01:00
danieleades
7546545876
Further improve typing in tests/ ( #12816 )
...
Co-authored-by: Adam Turner <9087854+aa-turner@users.noreply.github.com>
2024-10-03 20:17:40 +01:00
James Addison
80c4b65a2a
apidoc: Restore support for legacy '_t'-suffix template files ( #12929 )
...
Co-authored-by: Adam Turner <9087854+aa-turner@users.noreply.github.com>
2024-10-03 00:21:03 +01:00
Adam Dangoor
7487e764cb
Resolve a few mypy issues in tests ( #12912 )
...
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
2024-09-25 08:57:11 +01:00
Adam Turner
76110c3ea0
Add `_DomainsContainer` for better static typing ( #12783 )
...
Co-authored-by: Daniel Eades <danieleades@hotmail.com>
2024-09-18 03:50:27 +01:00
Adam Dangoor
b5617c0d15
Remove unused `make_app` fixtures ( #12842 )
2024-08-31 07:46:38 +01:00
