File: CONTRIBUTING.md

package info (click to toggle)
game-data-packager 87
  • links: PTS, VCS
  • area: contrib
  • in suites: sid
  • size: 33,392 kB
  • sloc: python: 15,387; sh: 704; ansic: 95; makefile: 50
file content (33 lines) | stat: -rw-r--r-- 1,054 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
# Contributing to game-data-packager

Please send merge requests to
<https://salsa.debian.org/games-team/game-data-packager>,
or bug reports to the Debian bug tracking system.

## Compatibility guidelines

The oldest dependency versions we aim to support are whatever is in
Debian stable or Ubuntu LTS, whichever is older. As of mid 2025 this means:

* Debian 13: Python 3.13
* Ubuntu 24.04: Python 3.12

## Coding style

Please follow [PEP8](https://www.python.org/dev/peps/pep-0008/) for new code.

## Python features to adopt

Now that Ubuntu 24.04 has been released, we can start using Python
3.11 features:

* `Self` type: <https://realpython.com/python-type-self/>
* `TypedDict`: make items as optional <https://peps.python.org/pep-0655/>

Similarly now that Python >=3.12 is the baseline, we can annotate **kwargs
with `Unpack` + `TypedDict`: <https://peps.python.org/pep-0692/>

## Checking typing annotations

    sudo apt install python3-typeshed
    sudo pip3 install pygobject-stubs --config-settings=config=Gtk4,Gdk4 --break-system-packages