Archives/sphinx-autoapi
2
0
Fork 0
mirror of https://github.com/readthedocs/sphinx-autoapi synced 2024-11-10 01:10:27 +00:00
Code Issues Packages Projects Releases Wiki Activity
627 Commits 14 Branches 43 Tags 5 MiB
a8d07b610f
Commit Graph

356 Commits

Author SHA1 Message Date
Ashley Whetter
28301f1ba4 Fix linting again 2019-10-05 17:00:05 -07:00
Ashley Whetter
520f3b0469 Fixed formatting 2019-10-05 16:09:26 -07:00
Ashley Whetter
a122f00d4a Fix linting 2019-10-05 16:05:37 -07:00
Daniel Daniels
a114af76dc Added autoapi-skip-member event 2019-10-05 13:55:18 -07:00
谷月轩
f6649ebde4 Include methods in child class (#176) 2019-10-05 12:39:50 -07:00
Armand BENETEAU
fa3b0b3f70 Fix Go documentation generation (#172) 
* Correction of the "parameters" accessibility problem in the Go mapper

The "parameters" attributes of the GoPythonMapper class instance was
not accessible from the "output_rst" function used to create the .rst
file. Thanks to this correction, the parameters are now accessible.

* Enhance the template used to genertae the .rst file from the .go source file

This modification allows to create a .rst file compatible with the
last version of Sphinx. Without this correction, the creation of documentation
was not possible. A "make html" command lead to an "AssertionError" Exception.
 2019-09-03 20:55:52 -07:00
danields761
be324b10bf Made dependencies of other languages optional (#171) 
* Fixes #170

* Makes sphinxcontrib-golangdomain and
sphinxcontrib-dotnetdomain to be optional
packages
* Adds check that appropriate dependencies of
a specified api-type installed during the
extension initialisation
* Adds appropriate tests
 2019-09-01 14:44:17 -07:00
Ashley Whetter
02b0c0a098 Made it more clear which file causes an error 2019-08-25 17:04:30 -07:00
Ashley Whetter
86a2aeb6d7 Fixed some unicode decode errors 2019-08-25 15:53:58 -07:00
Ashley Whetter
fd1cef5ced Updated Autodoc directives for Sphinx 2.1 features 
Added autoapidecorator directive.
Abides by autodoc_docstring_signature.
autoapifunction documents async functions.

Closes #166.
 2019-08-10 23:08:03 -07:00
Ashley Whetter
34d02faa2f Custom argument formatting 
Closes #162
 2019-08-07 23:23:21 -07:00
Ashley Whetter
46c577eda1 Support for async and other Sphinx 2.1 method directive options 2019-07-17 20:59:20 -07:00
Ashley Whetter
9fc96f2ddf Added support for Sphinx 2.1 2019-06-23 13:25:25 -07:00
Ashley Whetter
589826e90c Can override ignoring local imports in modules by using __all__ 2019-06-23 12:36:58 -07:00
Ashley Whetter
9d45eed4d0 Fixed incorrect formatting of functions and methods 2019-06-23 11:55:15 -07:00
Ashley Whetter
2084f695bd Can set an empty function signature in autodoc directives 2019-04-21 23:01:46 -07:00
Ashley Whetter
cac774c072 Added type annotation support to autodoc directives 2019-04-21 22:45:29 -07:00
Ashley Whetter
b90284f0fe Support basic type annotations 
Closes #139
 2019-04-21 21:58:25 -07:00
Ashley Whetter
b5dfea1c6d Removed some dead code 2019-04-21 15:40:00 -07:00
Ashley Whetter
0cee730693 Do not add a toctree entry when not generating docs 2019-04-21 15:40:00 -07:00
Ashley Whetter
3db1fd1226 Fixed error when an invalid object is given to an autodoc directive 2019-04-21 15:38:22 -07:00
Ashley Whetter
7230330686 Documentation overhaul 2019-04-21 15:38:22 -07:00
Ashley Whetter
dd58809d89 Added support for parsing stub files 
Closes #100
 2019-04-06 11:25:39 -07:00
Ashley Whetter
3b299be332 Tidied up index page 2019-04-06 10:33:38 -07:00
Ashley Whetter
8242f2ea13 Added Sphinx 2.0 support 2019-04-06 10:04:15 -07:00
Ashley Whetter
c6b46969f8 Fixed decoding of binary data on Python 2 
Fixes #159
 2019-03-30 13:43:26 -07:00
Ashley Whetter
a4f798183c Fixed private submodules displaying when private-members turned off 
Also fixed whitespace issues in templates.
 2019-03-05 22:52:13 -08:00
Alexander Gor
b94acc6019 Properly pass file patterns to godocjson utility (#161) 
* Properly pass  file patterns to godocjson utility

* Go integration tests fixed during to new *ignore* argument
 2019-02-20 07:26:20 -08:00
Ashley Whetter
80fd76bd1e Fixed false warning when importing a local module 2019-02-04 21:21:32 -08:00
Ashley Whetter
68e1f79ed5 Added render log messages 2019-01-30 21:53:08 -08:00
Ashley Whetter
f77bf19800 Added Black formatting 2019-01-26 21:20:45 -08:00
Ashley Whetter
c4fe76ef23 Removed references to old css and js files 2019-01-26 17:16:22 -08:00
Ashley Whetter
2cf80b1569 Fixed Sphinx logger deprecation warnings 2019-01-26 17:11:12 -08:00
Ashley Whetter
dfe82ae94e Dropped support for Sphinx<1.6 2019-01-26 16:26:39 -08:00
Ashley Whetter
00894a959e Overhauled Python import resolution logic 
Stable in more complex cases.
Capable of giving more detailed warnings.
More closely matches real import logic.

Closes #156
 2019-01-26 16:18:16 -08:00
Ashley Whetter
9fe8489bfe Fixed lint errors 2019-01-26 16:18:16 -08:00
Ashley Whetter
1caa6d22e1 Fixed some import chains failing to resolve depending on resolution order 2018-11-15 13:31:33 -08:00
Ashley Whetter
3b52975340 Fixed unicode decoding on Python 3.7 2018-11-14 22:40:22 -08:00
Ashley Whetter
c6f34398b5 Fixed autodoc not documenting top level packages or modules 2018-11-14 22:39:18 -08:00
Ashley Whetter
aac53178eb Fixed error parsing files with unicode docstrings 2018-11-13 11:07:36 -08:00
Ashley Whetter
66cf2ed4d0 Fixed autodoc not documenting anything in submodules or subpackages 2018-09-24 14:52:18 -07:00
Ashley Whetter
a1f1fd8651 Fixed properly resolving definitions imported more than once 2018-09-07 17:36:20 -07:00
Ashley Whetter
2799fb32cc Fixed error when documenting something that's imported in more than one place 2018-09-07 16:56:11 -07:00
Ashley Whetter
007ef746f4 Fixed linter again 2018-08-20 11:01:07 -07:00
Ashley Whetter
fb8892ccad Fixed lint error 2018-08-20 09:48:24 -07:00
Ashley Whetter
c3f3cc33de Added viewcode support for imported members 2018-08-20 09:37:43 -07:00
Ashley Whetter
92b4ea9dc8 Fixed linking to builtin bases 2018-08-13 17:26:54 -07:00
Ashley Whetter
616267726b No longer document __init__ attributes without a docstring 
Fixes #146
Also fixed duplicates when a property is set in __init__.
 2018-08-13 14:22:11 -07:00
Ashley Whetter
8d4fb4b1c3 Can document a public python API 
Closes #153
 2018-08-13 12:18:56 -07:00
Ashley Whetter
9e9c28e15b Can opt to write manual documentation 2018-08-10 09:00:54 -07:00
Ashley Whetter
b789dcaa73 Fixed autodoc being unable to discover nested classes 2018-08-07 14:39:38 -07:00
Ashley Whetter
c3ef72ee14 Fixed nested classes not getting displayed in autogenerated docs 2018-08-07 14:39:38 -07:00
Ashley Whetter
8a965bb15a Fixed lint error 2018-08-07 14:33:42 -07:00
Ashley Whetter
bc65e766c3 Made it easier to remove default index page 
Also removed autoapi_add_api_root_toctree config option
because it is less useful now.

Closes #152
 2018-08-06 16:23:33 -07:00
Ashley Whetter
7dd822eef4 Can still link to public items in private modules 2018-08-06 15:02:01 -07:00
Ashley Whetter
75ebcfc903 private-members also controls private subpackages and submodules 
Closes #150
 2018-08-06 14:52:42 -07:00
Ashley Whetter
6ffec93569 Fixed lint errors 2018-08-06 14:19:12 -07:00
Ashley Whetter
4ac85dd7af Added autoapi directives for Python 2018-08-06 14:19:12 -07:00
Ashley Whetter
4edf45af35 Added support for static and class methods 2018-08-06 14:19:12 -07:00
Ashley Whetter
9cb2f7d50e Methods include self in their arguments 
autodoc does this by default so it makes sense to do it in autoapi also.
 2018-08-06 14:19:12 -07:00
Ashley Whetter
af4263457e Full path is resolved for bases from same module 2018-08-06 14:19:12 -07:00
Ashley Whetter
a1825cd98d Fixed astroid 2.0 compatibility 
Closes #148
 2018-08-06 14:19:12 -07:00
Ashley Whetter
d8f4847a5c
Added support for detecting Python exceptions (#147) 
Closes #145
 2018-07-31 16:57:24 -07:00
Ashley Whetter
6b8ccf62ae Fixed filtered classes and attributes getting displayed 2018-07-24 12:05:57 -07:00
Ashley Whetter
f2d3352801 Fixed incorrect display of long lists 
Stop pretty printing because the annotation option cannot accept
multiline strings.
 2018-07-16 12:45:17 -07:00
fredbi
9dd26fd32b Fixed running incorrect jsdoc command on Windows 
Issue #125.
jsdoc on windows is deployed as jsdoc.cmd
 2018-07-12 14:53:19 -07:00
Sam Lai
974bae1f20 Support specifying package directories in autoapi_dirs (#135) 
* Support specifying package directories as well

Fixes #108.

* Use os.sep instead of the hardcoded '/'

This was making the tests fail on Windows because the necessary '/'
replacements were not happening on Windows due to os.sep being '\\'.
 2018-07-03 21:34:31 -07:00
Ashley Whetter
ea6f1d322e Fix lint errors 2018-06-05 23:15:45 -07:00
Ashley Whetter
6ca62f16c9 Can control how __init__ docstring is displayed 2018-06-05 22:47:32 -07:00
Ashley Whetter
6eb18467f7 Fixed undoc members logic 2018-06-02 10:57:45 -07:00
Ashley Whetter
9f6f7d0b5d Added support for viewcode 2018-05-24 07:50:39 -07:00
Ashley Whetter
741dfaffb3 Source files no longer need to be in sys.path 2018-05-08 22:41:35 -07:00
Ashley Whetter
b19b9ea28b Extended ast parsing with astroid 2018-05-08 22:41:35 -07:00
Sam Lai
ea8efe91dc Fix lint errors 
There should be no behavioural changes - this is just explicitly returning what would've been returned anyway.
 2018-04-21 20:48:06 +01:00
Ashley Whetter
b06d4f801b Started autoloading autosummary extension 2017-11-10 14:57:43 -08:00
Ashley Whetter
5075467441 Formats napoleon docstrings in Python 2017-11-10 13:05:35 -08:00
Anthony
ae1c6276df
Merge pull request #116 from AWhetter/py_hierarchy 
Py hierarchy
 2017-11-09 16:24:09 -07:00
Ashley Whetter
7b3e6fca6d Added basic class signature discovery 2017-11-09 14:18:11 -08:00
Ashley Whetter
b792463cc9 Can turn off autoapisummary directives in output 2017-11-09 12:48:21 -08:00
Ashley Whetter
4adcdc5351 Python documentation is now hierarchical 2017-11-09 12:48:21 -08:00
Ashley Whetter
b5be7b6d9a Fixed a warning 2017-11-09 12:21:52 -08:00
Ashley Whetter
958fe10103 Added autoapisummary directive 2017-11-09 12:21:52 -08:00
Ashley Whetter
5a86878811 Fixed Python subpackages having incomplete names 2017-11-09 11:54:16 -08:00
Eric Holscher
e5cce2c7dd Fix lint 2017-11-09 10:56:42 -07:00
Eric Holscher
d803b28d00 Kill janky napolean overlay 2017-11-09 10:54:20 -07:00
Eric Holscher
3531f5560a Merge remote-tracking branch 'origin/master' into cleanup-june 2017-11-09 10:51:24 -07:00
Ashley Whetter
86a9ffdd60 Fixed lint errors 2017-11-08 16:04:25 -08:00
Ashley Whetter
ae1e4f556d Fixed usage of deprecated status_indicator 
This fixes a compatibiity issue with Sphinx 1.7
 2017-11-05 15:11:06 -08:00
Ashley Whetter
a1a3f05202 Fix for Sphinx 1.6 2017-11-05 14:18:43 -08:00
Eric Holscher
3875cf495d Fix noting the toctree 2017-06-29 15:10:06 -07:00
Eric Holscher
21a82718ab Fix linting 2017-06-29 14:48:06 -07:00
Eric Holscher
8c1016f8c7 Fix linting 2017-06-29 14:37:59 -07:00
Eric Holscher
ed57a216ec Fix lint 2017-06-29 13:01:23 -07:00
Eric Holscher
0e3e5df437 Fix linting 2017-06-29 10:57:38 -07:00
Eric Holscher
86a4de1668 Don’t show modules with no content. 2017-06-29 10:45:54 -07:00
Eric Holscher
4428ecd6e8 Add ability to process Napolean docstrings. 2017-06-27 17:40:34 -07:00
Eric Holscher
efb541f78a Add ability to add API to top-level TOC. 2017-06-27 17:12:47 -07:00
Eric Holscher
3233bc0ac7 Fix templates to nest functions and use short names 2017-06-27 17:12:17 -07:00
Anthony
152ea1a521 Merge pull request #104 from rtfd/python-ast 
Start altering the pydocstyle AST parser for our needs
 2017-04-07 18:06:17 -07:00
Anthony
e7a624254a Merge pull request #106 from rtfd/fix-argument-call 
Fix Python argument parsing for Call nodes
 2017-04-07 17:55:25 -07:00