CONTRIBUTING.md

Contributing to Python JSONPath RFC 9535

Hi. Your contributions and questions are always welcome. Feel free to ask questions, report bugs or request features on the issue tracker or on Github Discussions. Pull requests are welcome too.

Table of contents

• Development
• Documentation
• Style Guides

Development

We use hatch to manage project dependencies and development environments.

Run tests with the test script.

$ hatch run test

Lint with ruff.

$ hatch run lint

Typecheck with Mypy.

$ hatch run typing

Check coverage with pytest-cov.

$ hatch run cov

Or generate an HTML coverage report.

$ hatch run cov-html

Then open htmlcov/index.html in your browser.

Documentation

Documentation is currently in the README and project source code only.

Style Guides

Git Commit Messages

There are no hard rules for git commit messages, although you might like to indicate the type of commit by starting the message with docs:, chore:, feat:, fix: or refactor:, for example.

Python Style

All Python files are formatted using Black, with its default configuration.

Docstrings must use Google style docstrings.