Skip to main content

sphinx autosummary extension to properly format pandas or xarray accessors

Project description

https://github.com/xarray-contrib/sphinx-autosummary-accessors/workflows/CI/badge.svg?branch=master https://img.shields.io/badge/code%20style-black-000000.svg Documentation Status

A sphinx extension to properly document pandas or xarray accessors.

autosummary is able to create summary and object pages for objects and their methods, but it doesn’t work well with accessor styled properties and methods (obj.accessor.attribute). pandas has accessor documentation built using autosummary templates, which xarray recently adopted by copying the templates and all related code.

To avoid even more duplicated code, and to make it easier for projects to document their custom accessors, this project aims to provide this functionality by way of a sphinx extension. Once it is finished, using it should be (almost) as simple as adding "accessors" to extensions in the project’s conf.py.

Most of the code was adapted from pandas.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

sphinx-autosummary-accessors-0.1.1.tar.gz (14.1 kB view details)

Uploaded Source

Built Distribution

File details

Details for the file sphinx-autosummary-accessors-0.1.1.tar.gz.

File metadata

  • Download URL: sphinx-autosummary-accessors-0.1.1.tar.gz
  • Upload date:
  • Size: 14.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/47.3.1.post20200616 requests-toolbelt/0.9.1 tqdm/4.48.2 CPython/3.8.3

File hashes

Hashes for sphinx-autosummary-accessors-0.1.1.tar.gz
Algorithm Hash digest
SHA256 965b1f50f02ae35aa3c734959948208332e94d8d39dd338765b44cce800090d4
MD5 c68295b0164268ab9475b750b1ea2187
BLAKE2b-256 08c605b4efe5d8b428a23e243174bc6c4e663b1299850ccf085cf2995bff800c

See more details on using hashes here.

File details

Details for the file sphinx_autosummary_accessors-0.1.1-py3-none-any.whl.

File metadata

  • Download URL: sphinx_autosummary_accessors-0.1.1-py3-none-any.whl
  • Upload date:
  • Size: 8.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/47.3.1.post20200616 requests-toolbelt/0.9.1 tqdm/4.48.2 CPython/3.8.3

File hashes

Hashes for sphinx_autosummary_accessors-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 c6c3b5189393dcd8b8e258514ce218c0ff30dc58af6209235af61886043977f1
MD5 05f4ae8c90618fed426f9b8f96c1a703
BLAKE2b-256 1ca5f7192e80b23266be5748752feb7b74e95171733f87a339c0aea1393a5489

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page