|
| 1 | +<!--- --8<-- [start:description] --> |
1 | 2 | # mkdocstrings-python-accessors |
2 | 3 |
|
| 4 | +Support for documenting accessors with mkdocstrings. |
| 5 | + |
| 6 | +**Key info :** |
| 7 | +[](https://mkdocstrings-python-accessors.readthedocs.io) |
| 8 | +[](https://github.com/climate-resource/mkdocstrings-python-accessors/blob/main/pyproject.toml) |
| 9 | +[](https://github.com/climate-resource/mkdocstrings-python-accessors/blob/main/LICENCE) |
| 10 | + |
| 11 | +**PyPI :** |
| 12 | +[](https://pypi.org/project/mkdocstrings-python-accessors/) |
| 13 | +[](https://github.com/climate-resource/mkdocstrings-python-accessors/actions/workflows/install-pypi.yaml) |
| 14 | + |
| 15 | +**Tests :** |
| 16 | +[](https://github.com/climate-resource/mkdocstrings-python-accessors/actions/workflows/ci.yaml) |
| 17 | +[](https://codecov.io/gh/climate-resource/mkdocstrings-python-accessors) |
| 18 | + |
| 19 | +**Other info :** |
| 20 | +[](https://github.com/climate-resource/mkdocstrings-python-accessors/commits/main) |
| 21 | +[](https://github.com/climate-resource/mkdocstrings-python-accessors/graphs/contributors) |
| 22 | +## Status |
| 23 | + |
| 24 | +<!--- |
| 25 | +
|
| 26 | +We recommend having a status line in your repo |
| 27 | +to tell anyone who stumbles on your repository where you're up to. |
| 28 | +Some suggested options: |
| 29 | +
|
| 30 | +- prototype: the project is just starting up and the code is all prototype |
| 31 | +- development: the project is actively being worked on |
| 32 | +- finished: the project has achieved what it wanted |
| 33 | + and is no longer being worked on, we won't reply to any issues |
| 34 | +- dormant: the project is no longer worked on |
| 35 | + but we might come back to it, |
| 36 | + if you have questions, feel free to raise an issue |
| 37 | +- abandoned: this project is no longer worked on |
| 38 | + and we won't reply to any issues |
| 39 | +--> |
| 40 | + |
| 41 | +- development: the project is actively being worked on |
| 42 | + |
| 43 | +<!--- --8<-- [end:description] --> |
| 44 | + |
| 45 | +## Installation |
| 46 | + |
| 47 | +<!--- --8<-- [start:installation] --> |
| 48 | + |
| 49 | +The latest version of mkdocstrings-python-accessors can be installed with |
| 50 | + |
| 51 | +=== "pip" |
| 52 | + ```sh |
| 53 | + pip install mkdocstrings-python-accessors |
| 54 | + ``` |
| 55 | + |
| 56 | +### For developers |
| 57 | + |
| 58 | +This package isn't maintained in our usual way. |
| 59 | +It's super thin and not subject to any of our usual tests etc. |
| 60 | +Hence there are no installation instructions here. |
| 61 | + |
| 62 | +<!--- --8<-- [end:installation] --> |
| 63 | + |
3 | 64 | Python handler for [mkdocstrings](https://github.com/mkdocstrings/mkdocstrings) |
4 | 65 | supporting documentation of accessors. |
5 | 66 | Takes inspiration from [sphinx-autosummary-accessors](https://github.com/xarray-contrib/sphinx-autosummary-accessors). |
@@ -66,3 +127,10 @@ to modify the appearance as you wish. |
66 | 127 | show_root_full_path: false |
67 | 128 | show_root_heading: true |
68 | 129 | ``` |
| 130 | + |
| 131 | +## Original template |
| 132 | + |
| 133 | +This project was generated from this template: |
| 134 | +[copier core python repository](https://gitlab.com/znicholls/copier-core-python-repository). |
| 135 | +[copier](https://copier.readthedocs.io/en/stable/) is used to manage and |
| 136 | +distribute this template. |
0 commit comments