Commit Graph

700 Commits (1556b17ca8ae3de6a8f0d129774bb49edc76a737)
 

Author SHA1 Message Date
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>
2 years ago
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)
2 years ago
Ashley Whetter 94295a48cd Don't document module level class attribute assignments
Fixes #341
2 years ago
Ashley Whetter 0963c6d8a7 Added missing changelog entry 2 years ago
Jakob Lykke Andersen 377a38550f
Add option autoapi_add_objects_to_toctree (#284) 2 years ago
Ashley Whetter 6af1ca718a Remove some autogenerated test data 2 years ago
Ashley Whetter 847b6e5626 Correctly render tuples as tuples, not lists
Fixes #330
2 years ago
Ashley Whetter bf7bb08ef8 Version 2.0.0 2 years ago
Ashley Whetter a23e2ffe73 Render Python properties with the property directive
Fixes #352.
2 years ago
Ashley Whetter d91c7aaa5c Added missing changelog entry 2 years ago
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
2 years ago
Ashley Whetter 991ac220fd Streamlined release process slightly 2 years ago
Ashley Whetter deb6944644 Version 1.9.0 2 years ago
Ashley Whetter ef1d4cb28e Added changelog entry 2 years ago
Jeff Epler 0ac4dc5389 Fix kw-only marker getting ignored if first in the signature (#340)
Closes: #328
2 years ago
Ashley Whetter 610bd10854 Added changelog entries 2 years ago
Ash Berlin-Taylor c40c3edd5c
Mark extension as parallel_read_safe (#332) 2 years ago
Kian-Meng Ang 075736619f
Fix typos (#331) 2 years ago
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.
2 years ago
Ashley Whetter 0e4f121a5d Added missing changelog entries 2 years ago
Zachary Moon 185876a047
Limit signatures to 60 characters in summaries (#311) 2 years ago
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>
2 years ago
Ashley Whetter 517a6be383 Stop calling ``autodoc-process-docstring`` when docstring is empty 2 years ago
Ashley Whetter cd4e1fa59f Fixed tests in Sphinx 5 2 years ago
Ashley Whetter 17ad4b988e Added new changelog entry 3 years ago
Ashley Whetter 6028cb104c Fail elegantly when no source files are found
Fixes #324
3 years ago
Ashley Whetter 685d1d34c8 Updated to latest black formatting 3 years ago
Ashley Whetter 71c6ceebe0 Fixed Python 3.10 erroring on Github 3 years ago
Ashley Whetter 0b214b2ffd Drop Python 3.6 and test in Python 3.10 3 years ago
Ashley Whetter 19d217e177 Version 1.8.4 3 years ago
Ashley Whetter 948f753a20 Fixed compatibility with astroid 2.7+.
Fixes #301
3 years ago
Ashley Whetter 4d8f6387ca Version 1.8.3 3 years ago
Ashley Whetter 7cdc0dfae3 Fixed broken link to Jinja objects.inv 3 years ago
Ashley Whetter 38c2089476 Removed prepare_docstring filter used for testing 3 years ago
Ashley Whetter 7d7f042805 Fixed possible incorrect indentation in generated documentation.
Closes #299.
3 years ago
Ashley Whetter 354535190c Version 1.8.2 3 years ago
Ashley Whetter 2c5c87157a Explicitly use the domain for generated directives
Closes #292
3 years ago
Ashley Whetter 26b7d729a2 Fixed AttributeError using inheritance diagrams on a module with plain imports
Fixes #289
3 years ago
Ashley Whetter 17ffa2d1b6 Fixed failure to build out of source conf.py files
Closes #293
3 years ago
Ashley Whetter 08e61b93ef Fixed displaying "self" in class signatures 3 years ago
Ashley Whetter 5faec73073 Fixed error when parsing a class with no constructor 3 years ago
Ashley Whetter 83b1260e67 Version 1.8.1 3 years ago
Ashley Whetter 613eff53a7 Fixed type annotations being shown for only a single module
Closes #273
3 years ago
Ashley Whetter 48ec2b341e Version 1.8.0 4 years ago
Ashley Whetter dafd0cc89c Added missing changelog entries 4 years ago
Sam Morley-Short 3fb14a24fc Added attribute summary table to python module template 4 years ago
Kamil Breguła 57253a9f84 Generate rst files in src directory 4 years ago
Ashley Whetter 86a6d1059c Refactored dotnet error to raise an exception properly 4 years ago
René Fritze 099e6e89c1 Add descriptions for logging warning subtypes 4 years ago
René Fritze 5777e43347 remove (sub-) types for "Unknown type" warnings 4 years ago