Developer Intro

PyPDFForm's targeted users are other Python developers. This section of the documentation is not for the users, but for people who want to start making contributions to PyPDFForm itself.

Installing requirements

It is advised that a virtual environment is created before running this command:

pip install -r requirements.txt

Running tests

See testing PyPDFForm with pytest.

Creating issues

When you create an issue on GitHub, try your best to follow these conventions:

  • The issue title should have the format PPF-<issue number>: <title of the issue>.
  • The issue description should be as descriptive as possible, preferably with the following:
    • A code snippet related to the issue.
    • A PDF form template used by the code snippet.
    • Screenshots that can help visualize the issue.

Opening pull requests

Please create an issue before making a pull request. Try your best to follow these conventions when doing so:

  • The PR title should be the same as its respective issue, so PPF-<issue number>: <title of the issue>.
  • The PR description should contain a brief explanation of the changes.
  • Once opened, the PR should be linked to its respective issue.