Bottles/CODING_GUIDE.md

Build & Run locally

use flatpak

Build & install

flatpak-builder --install --user --force-clean ./.flatpak-builder/out ./build-aux/com.usebottles.bottles.Devel.json

Run

flatpak run com.usebottles.bottles.Devel

Uninstall devel version

flatpak uninstall com.usebottles.bottles.Devel

Unit Test

run all tests

pytest .

Dependencies

Regenerate PYPI dependency manifest when requirements.txt changed

python ./build-aux/req2flatpak/req2flatpak.py --requirements-file requirements.txt --yaml --target-platforms 312-x86_64 -o build-aux/pypi-deps.yaml

I18n files

po/POTFILES

List of source files containing translatable strings. Regenerate this file when you added/moved/removed/renamed files that contains translatable strings.

cat > po/POTFILES <<EOF
# List of source files containing translatable strings.
# Please keep this file sorted alphabetically.
EOF
grep -rlP "_\(['\"]" bottles | sort >> po/POTFILES
cat >> po/POTFILES <<EOF
data/com.usebottles.bottles.desktop.in.in
data/com.usebottles.bottles.gschema.xml
data/com.usebottles.bottles.metainfo.xml.in.in
EOF

po/bottles.pot and po/*.po

We have a main pot file, which is template for other .po files And for each language listed in po/LINGUAS we have a corresponding .po file Regenerate these files when any translatable string added/changed/removed

# make sure you have `meson` and `blueprint-compiler` installed
meson setup /tmp/i18n-build
meson compile -C /tmp/i18n-build/ bottles-pot
meson compile -C /tmp/i18n-build/ bottles-update-po