Contributing

Reporting bugs

Bugs are reported using the Issue tracker on GitHub.

When you report a bug, try to be as specific as possible, and provide all the relevant information:

  • Version of poppler

  • Version of python-poppler

  • Operating system name and version

  • Python version

If an exception occurred, provide the entire stack trace.

Before submitting a new bug, please verify it is not already reported. If it is, verify if you can provide additional information.

If you can, consider pull_request.

Requesting features

Suggestions and feature requests can be submitted using the Issue tracker on GitHub as well.

However, you should understand that the main goal of python-poppler is to provide a Python binding to the poppler-cpp library. Therefore, if you need a feature that is not currently in poppler-cpp, we will probably not implement it in python-poppler. But if you integrate a new feature in poppler-cpp, we will certainly add it to python-poppler.

Submitting a pull request

Pull requests are the preferred way for submitting patches, bug corrections, and new features.

When you submit a pull request, verify the following points:

  • You agree that the submitted code is under GPL 2.0 license;

  • Code is formatted using black. Ensure everything is well formatted, using tox -e lint command;

  • Please provide tests proving the bug is corrected, or covering the new feature, when it’s possible;

  • Ensure that all unit tests pass, using the tox command;

  • Add a line to the changelog, in docs/changelog.rst;

  • Update the documentation, when it applies.