Commit Graph

435 Commits

Author SHA1 Message Date
Brandon Wiebe
6317148f0d Replace usage of deprecated astroid.NodeNG.doc in inheritance_diagrams.py 2023-09-26 12:50:57 -07:00
Ashley Whetter
4d1bec044a Removed support for Python 3.7 2023-09-24 08:57:47 -07:00
Niels Wouda
cf8abe579f Import fallback for older versions of Sphinx 2023-09-24 08:42:57 -07:00
Niels Wouda
0186a3c978 Replace usage of deprecated sphinx.util.status_iterator 2023-09-24 08:42:57 -07:00
Ashley Whetter
92437c9af7 Removed old pylint pragmas 2023-07-08 10:38:24 -07:00
Ashley Whetter
a22ae9262a Removed support for documenting languages other than Python
For the reasons why, see #248
2023-07-08 10:35:38 -07:00
Ken Odegard
4ea04f241e Ensure tooltip is always a str 2023-07-08 10:01:55 -07:00
Ashley Whetter
2219dcdd7a Fix compatibility with astroid v3 2023-07-06 21:25:32 -07:00
Ashley Whetter
0ba883ab89 Replace usage of deprecated astroid.NodeNG.doc
Closes #392
2023-07-06 21:14:32 -07:00
Ashley Whetter
0ac1e11359 Version 2.1.1 2023-06-10 10:58:13 -07:00
Ashley Whetter
c3c6e15d16 Added missing changelog entry 2023-06-10 10:36:30 -07:00
Z-Fran
86cf7e2b87 Fix getting 'orig_path' for 'viewcode_follow_imported' 2023-06-10 10:18:17 -07:00
Ashley Whetter
38a615ff74 Types used in PEP-604 union syntax can be linked with intersphinx
Closes #366
2023-06-10 10:07:20 -07:00
Ashley Whetter
7fa3998438 Fix separated type comments for arguments not merging correctly in Python 3.7 2023-05-30 20:33:59 -07:00
Ashley Whetter
1ae7b78128 Fix class overrides not rendering correctly 2023-05-22 19:58:40 -07:00
Ashley Whetter
0a557fc95e Replaced usage of unidecode with anyascii to fix license incompatibilities
Closes #382
2023-05-22 10:10:05 -07:00
Ashley Whetter
1715dfe0b5 Fix "document isn't included" warning when using autoapi_add_toctree_entry
Closes #319
2023-04-10 16:49:21 -07:00
Ashley Whetter
336f52e2e9 Added missing deprecation warning for other language support 2023-04-07 10:23:12 -07:00
Ashley Whetter
85739d513e Switched to Google style docstrings 2023-03-29 17:44:57 -07:00
Ashley Whetter
a43c6fde2b Switched linter from pylint to ruff 2023-03-29 17:30:21 -07:00
Ashley Whetter
47e5dcd707 Version 2.1.0 2023-03-28 09:45:29 -07:00
Brandon Wiebe
6b16e02de4
Let Sphinx handle adding domain directives to the toctree (#374)
* Remove ability to add domains to the toctree

* Add towncrier news fragment
2023-03-28 09:13:28 -07:00
Ashley Whetter
58d653e557 Added basic type checking 2023-03-22 22:33:11 -07:00
Ashley Whetter
2335e002f8 Version 2.0.1 2023-01-16 21:36:19 -08:00
Ashley Whetter
3f8730aadd Fix tests 2023-01-16 21:14:38 -08:00
Ashley Whetter
94b255aecc Added support for Python 3.11 2023-01-16 20:16:19 -08:00
davfsa
1556b17ca8
Use the correct directives for a variable type and value (#353)
* Use the correct directives for a variable type and value

Co-authored-by: PerchunPak <perchunpak@gmail.com>

* Improve multiline value

* Add colons for strings

* Add another testcase

Co-authored-by: PerchunPak <perchunpak@gmail.com>
2023-01-04 20:35:40 -08:00
Ash Berlin-Taylor
d732b49fd5
Don't force member sort order to alphabetic (#362)
* Don't force member sort order to alphabetic

sphinx.ext.autodoc has a `sort_member` function[1] that will sort the object
members for us -- by removing the `sorted` call ourselves we allow the
"bysource" mode to work (with the `sorted` call, since we don't set
`self.analyzer` no extra sorting happens.)

The default sort mode for autodoc is alphabetical, so this should result in no
changes to docs by default

[1]: 9844162473/sphinx/ext/autodoc/__init__.py (L816-L836)
2023-01-04 20:33:25 -08:00
Ashley Whetter
94295a48cd Don't document module level class attribute assignments
Fixes #341
2022-10-23 15:13:53 -07:00
Jakob Lykke Andersen
377a38550f
Add option autoapi_add_objects_to_toctree (#284) 2022-10-23 14:16:42 -07:00
Ashley Whetter
847b6e5626 Correctly render tuples as tuples, not lists
Fixes #330
2022-10-23 14:09:48 -07:00
Ashley Whetter
bf7bb08ef8 Version 2.0.0 2022-09-27 16:31:33 -07:00
Ashley Whetter
a23e2ffe73 Render Python properties with the property directive
Fixes #352.
2022-09-27 15:57:44 -07:00
Bruno P. Kinoshita
c9edd8d1c6
Minor fixes (typos, http->https in links, types) (#348)
* Avoid http->https redirect, use https where possible

* Add autoapi_template_dir to existing array instead of re-declaring

* Typos

* Sphinx util uses int for verbosity in status_iterator

* Sphinx utils uses tuples for TypeField arguments
2022-09-27 12:18:48 -07:00
Ashley Whetter
deb6944644 Version 1.9.0 2022-07-25 11:53:50 -07:00
Jeff Epler
0ac4dc5389 Fix kw-only marker getting ignored if first in the signature (#340)
Closes: #328
2022-07-25 11:46:30 -07:00
Ash Berlin-Taylor
c40c3edd5c
Mark extension as parallel_read_safe (#332) 2022-07-25 11:36:28 -07:00
Kian-Meng Ang
075736619f
Fix typos (#331) 2022-07-25 11:34:17 -07:00
Nathan Glenn
432b9af5d5
Fix keyerror when using markdown sources (#321)
Setting `source_suffix = ".md"` led to the following cryptic error output:

    Handler <function run_autoapi at 0x10841fc10> for event 'builder-inited' threw an exception (exception: 0)

This issue was that `app.config.source_suffix` is an `OrderedDict` object, which cannot be subscripted
using `[0]`, etc. Instead, use `next(iter(...))` to get the first element of the dictionary.
2022-07-25 11:32:11 -07:00
Zachary Moon
185876a047
Limit signatures to 60 characters in summaries (#311) 2022-07-25 10:30:57 -07:00
Mathieu Bouzard
fc6b8aec77
Fix comment typehints for methods/classmethods (#300)
* Fix comment typehints for methods and classmethods

Co-authored-by: Mathieu <923463-mathbou@users.noreply.gitlab.com>
2022-07-25 10:27:03 -07:00
Ashley Whetter
517a6be383 Stop calling `autodoc-process-docstring` when docstring is empty 2022-07-25 10:22:38 -07:00
Ashley Whetter
6028cb104c Fail elegantly when no source files are found
Fixes #324
2022-02-08 21:44:16 -08:00
Ashley Whetter
685d1d34c8 Updated to latest black formatting 2022-02-08 19:37:55 -08:00
Ashley Whetter
19d217e177 Version 1.8.4 2021-08-16 10:29:05 -07:00
Ashley Whetter
948f753a20 Fixed compatibility with astroid 2.7+.
Fixes #301
2021-08-16 10:23:20 -07:00
Ashley Whetter
4d8f6387ca Version 1.8.3 2021-07-31 18:27:38 -07:00
Ashley Whetter
38c2089476 Removed prepare_docstring filter used for testing 2021-07-31 18:25:25 -07:00
Ashley Whetter
7d7f042805 Fixed possible incorrect indentation in generated documentation.
Closes #299.
2021-07-31 18:06:12 -07:00
Ashley Whetter
354535190c Version 1.8.2 2021-07-26 18:10:22 -07:00