piku/CONTRIBUTING.md

1.4 KiB

Contributing

piku is a stable project, but we welcome contributions that:

  • Help us move beyond Python 3.8+ (which is the current target due to Linux LTS distribution alignment)
  • Help us do better automated testing
  • Improve documentation (some docs are a bit old by now)
  • Help us deploy piku in various Linux distributions and environments (check the sister repositories in the project)
  • Provide sample deployments of common applications (again, check the sister repositories in the project)
  • Allow us to better support more language runtimes
  • Allow us to support different web servers or process supervisors (Caddy springs to mind as a popular alternative for small VPSes)

Code Size / Style

By its very nature, piku is a very small program. By today's standards of all-encompassing solutions this may seem strange, but it would benefit from being kept that way.

  • Small and focused PRs. Please don't include changes that don't address the subject of your PR.
  • Follow the style of importing functions directly e.g. from os.path import abspath
  • Follow PEP8.

So please keep that in mind when contributing.

For instance, if your runtime or framework needs additional setup, it might be better to contribute an utility script to run in a release entry in the Procfile rather than patching piku.py--but do hack at it if that is the best way to achieve it.