lizardbyte-common

Common helper scripts and repository tooling for LizardByte projects

Overview

This repository contains shared helper scripts and repository-level tooling used across LizardByte projects.

The current tooling includes Python-managed helpers and reusable GitHub workflows:

• scripts/update_clang_format.py runs clang-format across supported source directories.
• scripts/localize.py updates gettext and Babel locale files.
• .github/workflows/localize.yml runs the locale helper from GitHub Actions and opens localization update pull requests.

Python Tooling

Install uv and sync the locked tool environment:

uv sync --locked

Run the clang-format helper:

uv run --locked python scripts/update_clang_format.py

Run gettext extraction:

uv run --locked --only-group locale python scripts/localize.py --extract

Workflows

Reusable GitHub workflows live under .github/workflows/.

• localize.yml extracts gettext strings with the shared locale helper and can open a localization update pull request.

name: localize
permissions: {}

on:
  push:
    branches:
      - master
    paths:
      - '.github/workflows/localize.yml'
      - 'src/**'
      - 'locale/sunshine.po'
  workflow_dispatch:

jobs:
  localize:
    name: Update Localization
    permissions:
      contents: read
    uses: LizardByte/lizardbyte-common/.github/workflows/localize.yml@master
    secrets:
      GH_TOKEN: ${{ secrets.GH_BOT_TOKEN }}

Tests

Run the pytest suite:

uv run --locked --only-group test-python pytest