Contributing

Code

Be sure to follow the code style of the project.

Adding a feature

Create an issue or join the Discord to discuss it with the maintainers. We will provide additional guidance.

Fixing a bug

Fork the repository, make your changes, then create a pull request. Be sure to mention the issue you're fixing if one was already open.

Translations

Weblate

The project can be translated on Weblate.

Manually

Clone the repository.
If it isn't already there, add your language to /po/LINGUAS.
Create a new translation from the /po/cartridges.pot file with a translation editor such as Poedit.
Save the file as [YOUR LANGUAGE CODE].po to /po/.
Create a pull request with your translations.

Building

GNOME Builder

Install GNOME Builder.
Click "Clone Repository" with https://git.kramo.page/cartridges.git as the URL.
Click on the build button (hammer) at the top.

For Windows

Install MSYS2.
From the MSYS2 shell, install the required dependencies listed here.
Build it via Meson.

For macOS

Install Homebrew.
Using brew and pip3, install the required dependencies listed here.
Build it via Meson.

Meson

git clone https://git.kramo.page/cartridges.git
cd cartridges
meson setup build
ninja -C build install

Code style

All code is auto-formatted with Black and linted with Pylint. Imports are sorted by isort.

VSCode extensions are available for all of these and you can set them up with the following settings.json configuration:

"python.formatting.provider": "none",
"[python]": {
    "editor.defaultFormatter": "ms-python.black-formatter",
    "editor.formatOnSave": true,
    "editor.codeActionsOnSave": {
        "source.organizeImports": true
    },
},
"isort.args":["--profile", "black"],

For other code editors, you can install them via pip and invoke them from the command line.

2.4 KiB Raw Blame History