From ffb64c45b42dda1edf44a0fbaf42c78f790d6869 Mon Sep 17 00:00:00 2001 From: Andrew Branson Date: Sun, 9 Aug 2026 17:37:37 +0200 Subject: Keep machine-local MCP config untracked Track a generic config.py.template and ignore the operational config.py so machine-specific build host defaults remain local. Document the bootstrap copy and replace personal OBS and Android test fixtures with neutral examples. --- README.md | 21 +++++++++++++++++---- 1 file changed, 17 insertions(+), 4 deletions(-) (limited to 'README.md') diff --git a/README.md b/README.md index ce5d1a3..0ffb37f 100644 --- a/README.md +++ b/README.md @@ -30,10 +30,11 @@ The server currently exposes tools for: - RPM spec metadata summaries - QML translation search and Sailfish ternary translation checks -The committed defaults are deliberately generic. Device tools default to the -placeholder SSH target `root@device`, the Sailfish user-session bus at -`/run/user/100000/dbus/user_bus_socket`, `~/git` as the local source root, -`~/OBS` as the OBS checkout root, and the vendored build helper at +The committed configuration template defaults are deliberately generic. +Device tools default to the placeholder SSH target `root@device`, the Sailfish +user-session bus at `/run/user/100000/dbus/user_bus_socket`, `~/git` as the +local source root, `~/OBS` as the OBS checkout root, and the vendored build +helper at `src/sailfish_devel_mcp/vendor/build_sailfishos.py`. Put a config file at `~/.config/sailfish-devel-mcp/config.json` or pass `--config` to provide your real device and OBS settings. Device entries can also carry the preferred user, @@ -44,6 +45,18 @@ back to a matching tag in the third-party coderus Docker mirror. Neither a configured device label nor mirror tag availability independently establishes the current official SailfishOS release or SDK target. +The Python configuration module is machine-local and intentionally ignored by +Git. Bootstrap a fresh checkout before running, testing, installing, or +packaging it: + +```sh +cp src/sailfish_devel_mcp/config.py.template src/sailfish_devel_mcp/config.py +``` + +Keep machine-specific Python defaults only in the ignored `config.py`. Prefer +the JSON configuration described below for ordinary device, SDK, and build-host +settings. + ## Running From a checkout: -- cgit v1.2.3