Macintosh-HW/RASCSI
1
0
Fork 0
mirror of https://github.com/akuker/RASCSI.git synced 2026-04-25 14:26:28 +00:00
Code Issues Projects Releases Wiki Activity

Add concrete instructions on how to contribute code. (#797)

Browse Source 
* Add concrete instructions on how to contribute code.

* Document the Python interpreter support policy

* Clarify contribution guidelines
This commit is contained in:
Daniel Markstedt
2022-08-25 17:57:44 -07:00
committed by GitHub
parent 8846871e47
commit 9302955416
3 changed files with 24 additions and 7 deletions
Download Patch File Download Diff File Expand all files Collapse all files
python/README.md
+13 -4
View File
@@ -1,12 +1,21 @@
# RaSCSI Python Apps
# RaSCSI Reloaded Python Apps
This directory contains Python-based clients for RaSCSI as well as common
This directory contains Python-based clients for RaSCSI Reloaded as well as common
packages that are shared among the clients.
The following paragraphs in this README contain instructions that are shared
among all Python apps.
### Static analysis with pylint
## Supported Python interpreter
The policy in this project is to support the Python 3 interpreter that comes
standard with the current stable, as well as previous stable release of Debian.
At the time of writing they are:
- Python 3.9.2 in [Debian Bullseye](https://packages.debian.org/bullseye/python3)
- Python 3.7.3 in [Debian Buster](https://packages.debian.org/buster/python3)
## Static analysis with pylint
It is recommended to run pylint against new code to protect against bugs
and keep the code readable and maintainable.
@@ -29,4 +38,4 @@ pylint web/src/web.py
pylint common/src
pylint web/src
pylint oled/src
```
```
python/web/README.md
+5 -1
View File
@@ -40,7 +40,7 @@ $ git push pi master
## Localizing the Web Interface
We use the Flask-Babel library and Flask/Jinja2 extension for i18n.
We use the Flask-Babel library and Flask/Jinja2 extension for internationalization (i18n).
It uses the 'pybabel' command line tool for extracting and compiling localizations. The Web Interface start script will automatically compile localizations upon launch.
@@ -114,6 +114,10 @@ msgstr ""
"drivrutiner och inställningar</a>."
```
### Contributing to the project
New or updated localizations are treated just like any other code change. See the [project README](https://github.com/akuker/RASCSI/tree/rdmark-readme-contributions#how-do-i-contribute) for further information.
### (Optional) See translation stats for a localization
Install the gettext package and use msgfmt to see the translation progress.
```