Skip to main content

Package providing autocompletion capabilities for python docstrings

Project description

https://travis-ci.org/robodair/pydocstring.svg?branch=master https://codecov.io/gh/robodair/pydocstring/branch/master/graph/badge.svg https://readthedocs.org/projects/pydocstring/badge/?version=latest https://img.shields.io/pypi/l/pydocstring.svg https://img.shields.io/pypi/v/pydocstring.svg https://img.shields.io/pypi/pyversions/pydocstring.svg https://img.shields.io/pypi/status/pydocstring.svg

Python package for autogenerating python docstrings, built on top of Parso.

This project can be wrapped by an editor extension to provide docstrings as autocompletion or in response to a shortcut command.

Status

Ready for basic use - Supports Google, Numpy, and reST docstring formats are supported, and it’s pretty simple to create your own formatter.

Types are able to be inferred for some things, but if they can’t be worked out ‘TYPE’ is just inserted instead.

Doesn’t support more complicated things like converting between styles or updating docstrings.

Future

Check the issues for any more, but the nice-to-haves are:

  • Docstring insertion for a whole file
  • Updating docstrings for methods with changed paramenters/exeptions/Types
  • Conversion between docstring styles

Docs

Documentation is on Read The Docs

API

For integration with editors, there’s a really simple api avaialble (just a single call), check out the docs for more on that.

Download

pydocstring is on PyPI and can be installed with pip:

pip install pydocstring

Development

Testing/Coverage is automanted with tox. Pull requests are welcome.

Project details


Release history Release notifications

Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date
pydocstring-0.1.5-py2.py3-none-any.whl (12.2 kB) Copy SHA256 hash SHA256 Wheel py2.py3
pydocstring-0.1.5.tar.gz (6.9 kB) Copy SHA256 hash SHA256 Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page