2.6 KiB
2.6 KiB
Reporting issues
- Consider joining the chat for instant help.
- Maybe your question is answered in the wiki somewhere. Search first!
- Otherwise, just ask what you want to know. We're happy if we can help you and glad that you're using
pmbootstrap
!
Development
See pmbootstrap's Development Guide.
Contributing code changes
- Fork this repository, commit your changes and then make a Merge Request.
- Please test your code before submitting a Merge Request.
Shell scripting
- We don't write scripts for
bash
, but forbusybox
'sash
shell, which is POSIX compliant (plus very few features frombash
). - Use
shellcheck
to test your changes for issues before submitting. There is even an online version. - We're looking into automatizing this more, some files already get checked automatically by the static code analysis script.
Python
- We use the PEP8 standard for Python code. Don't worry, you don't need to read all that, just run the
autopep8
program on your changed code, and confirm with the static code analysis script that everything is PEP8 compliant. This script will run automatically on Travis CI when you make a Merge Request, and it must pass for your code to get accepted. - We use the
reST
style fordocstrings
below functions (to comment what individual functions are doing, you'll see those when browsing through the code). Please stick to this format, and try to describe the important parameters and return values at least. Example from here:
"""
This is a reST style.
:param param1: this is a first param
:param param2: this is a second param
:returns: this is a description of what is returned
:raises keyError: raises an exception
"""
- If it is feasible for you, try to run the testsuite on code that you have changed. The
test/test_build.py
case will build full cross-compilers foraarch64
andarmhf
, so it may take a long time. Testcases can be started withpytest
and it's planned to run that automatically when making a new Merge Request (see #64).
If you need any help, don't hesitate to open an issue and ask!