Commit Graph

167 Commits

Author SHA1 Message Date
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
cd4e1fa59f Fixed tests in Sphinx 5 2022-07-25 10:20:51 -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
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
2c5c87157a Explicitly use the domain for generated directives
Closes #292
2021-06-27 17:25:36 -07:00
Ashley Whetter
17ffa2d1b6 Fixed failure to build out of source conf.py files
Closes #293
2021-06-25 20:14:33 -07:00
Ashley Whetter
08e61b93ef Fixed displaying "self" in class signatures 2021-06-25 19:30:54 -07:00
Ashley Whetter
5faec73073 Fixed error when parsing a class with no constructor 2021-06-21 23:10:52 -07:00
Ashley Whetter
613eff53a7 Fixed type annotations being shown for only a single module
Closes #273
2021-04-24 19:43:39 -07:00
Ashley Whetter
86a6d1059c Refactored dotnet error to raise an exception properly 2021-04-12 20:32:37 -07:00
Ashley Whetter
826bb2badd Converted tests to pytest style 2021-04-03 19:01:27 -07:00
Ashley Whetter
bf8f50dc97 Fixed type hints still showing when setting autodoc_typehints
Closes #273
2021-04-02 20:08:34 -07:00
Ashley Whetter
643fed0ccd Can resolve the qualified paths of parameters to generics
Closes #265
2021-03-19 23:11:52 -07:00
Joseph Yu
5435536988 Multiline string are displayed correctly 2021-03-19 22:03:04 -07:00
Joseph Yu
b9a6fcd350 Minor internal test warnings fixes 2021-03-19 21:56:04 -07:00
Ashley Whetter
471c870a53 Do not inherit redundant docstrings
Closes #240
2021-01-31 16:12:19 -08:00
Ashley Whetter
24109875e1 The overload signatures of __init__ methods are documented
Fixes #260
2021-01-31 15:34:40 -08:00
Ashley Whetter
73bb2d6105 The fully qualified path of objects are included type annotations 2021-01-31 10:14:52 -08:00
Ashley Whetter
a8d07b610f Can edit the Jinja environment
Closes #200
2020-11-13 22:47:32 -08:00
Ashley Whetter
78b79583af Implmented basic incremental building
Closes #191
2020-10-26 16:13:38 -07:00
Ash Berlin-Taylor
5ee7dbef59 Correctly parse Metaclasses
Fixes #246
2020-10-25 19:17:07 -07:00
Ashley Whetter
7330297a83 Fixed tests on Python <3.8 2020-10-07 22:46:58 -07:00
Ashley Whetter
8256daa090 Fixed test setup 2020-10-07 22:18:43 -07:00
Ashley Whetter
6f0299356a Can use type hints as parameter types and return types 2020-10-05 13:18:35 -07:00
Ashley Whetter
8e4cd49e1a Dropped support for Python 2 and Sphinx 1.x/2.x.
Removed all old compatibility code.
2020-10-03 12:21:25 -07:00
Ashley Whetter
9a5f22d7d6 One day I'll learn to run black before pushing... 2020-08-31 22:07:51 -07:00
Ashley Whetter
0667de4037 Release preparation 2020-08-31 21:59:16 -07:00
Ashley Whetter
fc634afc0d Fix formatting after black upgrade 2020-08-31 21:24:27 -07:00
Ashley Whetter
0a5b84b8be autoapi_file_patterns is in order of preference
Closes #243
2020-08-31 21:18:36 -07:00
Taku Fukada
7270718374 Add support for overloaded functions 2020-08-17 12:48:36 -07:00
Haggai Nuchi
d0de570660 Remove xfail designation 2020-08-14 22:09:28 -07:00
Ashley Whetter
ac70ea056e Fixed incorrect formatting of properties on generated method directives. 2020-07-31 23:28:53 -07:00
Ashley Whetter
6fa5cb941d Fixed tests 2020-07-12 16:02:30 -07:00
Ashley Whetter
f5182a2291 Declare the extension as parallel safe
Closes #222
2020-07-11 19:53:00 -07:00
Ashley Whetter
3faa27053b Fixed return types not showing for methods.
Fixes #219
2020-07-11 19:27:59 -07:00
Ashley Whetter
f5823855ba Added Sphinx 3.1 testing 2020-07-11 19:14:03 -07:00
Matthijs van der Burgh
827297433a don't find in class summary 2020-06-13 10:04:03 -07:00
Ashley Whetter
cd9b9ca0fe Added the imported-members AutoAPI option
Closes #204
2020-05-16 17:36:52 -07:00
Ashley Whetter
fca36aa664 Classes and methods inherit docstrings from their parent
Closes #203
2020-05-16 16:24:16 -07:00
Ashley Whetter
b52378fa51 Added autoapi_member_order option
Closes #201
2020-05-16 15:28:43 -07:00
Matthijs van der Burgh
8565616f98 Fix formatting of test_pyintegration.py 2020-05-16 14:09:22 -07:00
Ashley Whetter
2e875f81c3 Updated tests for latest Sphinx 3.0.x fixes 2020-05-14 20:32:24 -07:00
Ashley Whetter
5794902b23 Support Sphinx 2.4 and 3.0 2020-04-05 20:03:05 -07:00
Ashley Whetter
4ba45cfacb Can document inherited members
Closes #183
2020-02-01 12:53:40 -08:00
Ashley Whetter
c5d5fb5346 Made passing of options to templates more sane 2020-01-25 17:36:06 -08:00
Ashley Whetter
265b4ae562 Added show-inheritance
Also turned autoapi_include_inheritance_graphs into a
show-inheritance-diagram AutoAPI option to be more consistent
with show-inheritance.

Partially implements #183
2020-01-25 14:38:22 -08:00