A utility for ensuring Google-style docstrings stay up to date with the source code.
Project description
# Darglint
A limited docstring linter which checks that function/method parameters
are defined in their docstrings. *Darglint* expects docstrings to be
formatted using the [Google Python Style Guide](https://google.github.io/styleguide/pyguide.html).
Darglint is in a very early stage, and fails for a lot of things.
Certain features, such as a robust command-line interface, still
do not exist.
## Installation
## Usage
Given a python source file, `serializers.py`, you would check the docstrings
as follows:
```
darglint serializers.py
```
## Features planned and implemented
- [x] Function definitions can be checked.
- [x] Methods definitions of top-level class can be checked.
- [x] Line number printout for function/method definition.
- [ ] Add type hint integration.
- [ ] Add support for python versions earlier than 3.6.
(The typing module is being used, which is the only real
limiting factor.)
- [ ] Syntastic support. (Syntastic is not accepting new checkers until
their next API stabilizes, so this may take some time.)
- [ ] Add command line interface.
## Development
Install `darglint`. First, clone the repository:
```
git clone https://github.com/terrencepreilly/darglint.git
```
`cd` into the directory, create a virtual environment (optional), then setup:
```
cd darglint/
virtualenv -p python3.6 .env
source .env/bin/activate
pip install -e .
```
You can run the tests using
```
python setup.py test
```
Or, install `pytest` manually, `cd` to the project's root directory,
and run
```
pytest
```
Contributions welcome.
A limited docstring linter which checks that function/method parameters
are defined in their docstrings. *Darglint* expects docstrings to be
formatted using the [Google Python Style Guide](https://google.github.io/styleguide/pyguide.html).
Darglint is in a very early stage, and fails for a lot of things.
Certain features, such as a robust command-line interface, still
do not exist.
## Installation
## Usage
Given a python source file, `serializers.py`, you would check the docstrings
as follows:
```
darglint serializers.py
```
## Features planned and implemented
- [x] Function definitions can be checked.
- [x] Methods definitions of top-level class can be checked.
- [x] Line number printout for function/method definition.
- [ ] Add type hint integration.
- [ ] Add support for python versions earlier than 3.6.
(The typing module is being used, which is the only real
limiting factor.)
- [ ] Syntastic support. (Syntastic is not accepting new checkers until
their next API stabilizes, so this may take some time.)
- [ ] Add command line interface.
## Development
Install `darglint`. First, clone the repository:
```
git clone https://github.com/terrencepreilly/darglint.git
```
`cd` into the directory, create a virtual environment (optional), then setup:
```
cd darglint/
virtualenv -p python3.6 .env
source .env/bin/activate
pip install -e .
```
You can run the tests using
```
python setup.py test
```
Or, install `pytest` manually, `cd` to the project's root directory,
and run
```
pytest
```
Contributions welcome.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
darglint-0.0.2.tar.gz
(7.2 kB
view hashes)