diff --git a/pkgbuilds/elsewhen/.omarchy/README.md b/pkgbuilds/elsewhen/.omarchy/README.md new file mode 100644 index 0000000..21b3341 --- /dev/null +++ b/pkgbuilds/elsewhen/.omarchy/README.md @@ -0,0 +1,17 @@ +# elsewhen + +Installs the Elsewhen world clock plugin from the `v{pkgver}` GitHub tag archive into `/usr/share/omarchy/plugins/omacom.elsewhen/` (the directory name is the plugin id the shell scans for, not the package name), plus `LICENSE` under `/usr/share/licenses/elsewhen/` and the upstream `README.md` under `/usr/share/doc/elsewhen/`. That directory is the packaged plugin root that omarchy PR [#12051](https://github.com/omacom/omarchy/pull/12051) teaches the shell to scan between its bundled plugins and `~/.config/omarchy/plugins`; on an Omarchy without it the package installs cleanly and the shell never looks, so it must ship alongside that change. `depends` carries no version floor for `omarchy` because no release carries #12051 yet; add one once it does. + +`package()` copies an explicit allow-list (`manifest.json`, every `*.qml` and `*.js`, `cities.json`, `world.json`, `worldclock-data.py`), so `tests/`, `.github/` and `.gitignore` never ship, and it fails the build if `manifest.json` is missing, does not declare `omacom.elsewhen`, or does not name a present `Panel.qml` as the entry point. An upstream release that adds a runtime file outside those patterns needs the allow-list extended here; the sync only moves versions and checksums. Every file is 0644: `Panel.qml` runs the script as `python3 /worldclock-data.py`, so it needs no execute bit. No install hook: Omarchy restarts the shell after `omarchy update`, and nothing here may write into a user home. The script's only writes go to `$XDG_CACHE_HOME/omacom-elsewhen/`, which it creates itself at runtime. + +Dependencies, cited as `file: tool` in the upstream tree: + +- `omarchy`: `ArcText.qml`, `Chip.qml`, `EarthRow.qml`, `Globe.qml`, `MiniGlobe.qml`, `MoonDot.qml`, `Panel.qml: import qs.Commons`; `EarthRow.qml`, `Globe.qml`, `Panel.qml: import qs.Ui`. Owns `/usr/share/omarchy` and the packaged plugin root the shell scans. +- `quickshell`: `Globe.qml`, `Panel.qml: import Quickshell`; `Globe.qml`, `MiniGlobe.qml`, `Panel.qml: import Quickshell.Io` (`Process`, `FileView`, `StdioCollector`). +- `python`: `Panel.qml: python3 /worldclock-data.py` (the facts process). `worldclock-data.py` imports only `json`, `os`, `sys`, `time`, `urllib`. +- Left implicit as members of `base`, per Arch convention: `bash` (`Panel.qml`, `Globe.qml: bash -c` wraps every probe), `coreutils` (`Panel.qml`, `Globe.qml: date`, one probe per refresh), `systemd` (`Panel.qml: timedatectl show`, `timedatectl list-timezones`, each with a fallback: `/etc/localtime` for the home zone and `find /usr/share/zoneinfo` for the catalog), `sed` and `grep` (`Panel.qml`: the symlink target of `/etc/localtime` and the zoneinfo catalog filter), `findutils` and `tzdata` (that fallback; `worldclock-data.py: /usr/share/zoneinfo/zone1970.tab`). `omarchy` cannot run without any of them either. +- Not a dependency: `iso-codes`. Only `tests/currency_check.py` reads `/usr/share/iso-codes/json`, to validate the currency table before a release; the runtime never touches it. + +Release tracking: `bin/sync-upstream` follows `omacom/elsewhen` through the `upstream.watch.github` provider, which reads the GitHub Releases feed (drafts and prereleases excluded; a tag with no published Release is not seen) and matches exactly `vX.Y.Z`, the grammar upstream's `scripts/set-version.sh` enforces. A newer release rewrites `pkgver`, resets `pkgrel` to 1, fetches `archive/refs/tags/v{pkgver}.tar.gz` again and rewrites `sha256sums` from the download. The Release's `published_at` is what lets `min_release_age: 24h` hold a fresh release for a day; `release_ring: fast` builds it straight to rc and stable as well as edge. + +The watch only moves on a version increase, so the first release's digest is filled in by hand (`curl -fsSL | sha256sum`), which is why the recipe carries a placeholder until the `v0.1.0` tag exists. Until upstream has published at least one Release, the watch finds nothing and fails the scheduled `sync-upstream` run for every package in the batch, so this recipe stays a draft until then. diff --git a/pkgbuilds/elsewhen/.omarchy/package.json b/pkgbuilds/elsewhen/.omarchy/package.json new file mode 100644 index 0000000..b1e7e71 --- /dev/null +++ b/pkgbuilds/elsewhen/.omarchy/package.json @@ -0,0 +1,11 @@ +{ + "source": "local", + "release_ring": "fast", + "min_release_age": "24h", + "upstream": { + "watch": { + "github": "omacom/elsewhen", + "pattern": "v(?P[0-9]+\\.[0-9]+\\.[0-9]+)" + } + } +} diff --git a/pkgbuilds/elsewhen/PKGBUILD b/pkgbuilds/elsewhen/PKGBUILD new file mode 100644 index 0000000..703a24c --- /dev/null +++ b/pkgbuilds/elsewhen/PKGBUILD @@ -0,0 +1,70 @@ +# Maintainer: Spencer Bull + +pkgname=elsewhen +pkgver=0.1.0 +pkgrel=1 +pkgdesc='World clock plugin for the Omarchy shell' +arch=('any') +url='https://github.com/omacom/elsewhen' +license=('MIT') + +# What the plugin needs to load and run. It also shells out to bash, date +# (coreutils) and timedatectl (systemd) and reads /usr/share/zoneinfo +# (tzdata); those are members of the base group and stay implicit, per Arch +# convention. The citations for each entry are in .omarchy/README.md. +depends=( + 'omarchy' + 'python' + 'quickshell' +) + +options=('!debug') + +source=("$pkgname-$pkgver.tar.gz::$url/archive/refs/tags/v$pkgver.tar.gz") +# Fill once the v0.1.0 tag exists: +# curl -fsSL https://github.com/omacom/elsewhen/archive/refs/tags/v0.1.0.tar.gz | sha256sum +# bin/sync-upstream rewrites this array only when it moves pkgver forward, so +# the first release's digest has to be entered by hand. +sha256sums=('FILL_FROM_RELEASE_ARCHIVE') + +package() { + # The packaged plugin root, scanned by the shell between its bundled + # plugins and ~/.config/omarchy/plugins since omarchy PR #12051. An older + # shell never looks here, so on it this package installs cleanly and does + # nothing; there is no omarchy version to pin until a release carries #12051. + local plugin="$pkgdir/usr/share/omarchy/plugins/omacom.elsewhen" + cd "$srcdir/$pkgname-$pkgver" || return 1 + + # The shell loads the entry point each manifest declares. A tree without + # either would install cleanly and never load, so fail the build instead of + # shipping it. + [[ -f manifest.json ]] || { + echo "release tree is missing manifest.json" >&2 + return 1 + } + grep -Eq '"id"[[:space:]]*:[[:space:]]*"omacom\.elsewhen"' manifest.json || { + echo "manifest.json does not declare the plugin id omacom.elsewhen" >&2 + return 1 + } + grep -Eq '"barWidget"[[:space:]]*:[[:space:]]*"Panel\.qml"' manifest.json || { + echo "manifest.json does not name Panel.qml as the bar widget entry point" >&2 + return 1 + } + [[ -f Panel.qml ]] || { + echo "release tree is missing the entry point Panel.qml" >&2 + return 1 + } + + # An explicit allow-list of runtime files, so tests/, .github/ and the rest + # of the repository never reach the package. Directories end up 0755 and + # every file 0644: worldclock-data.py runs as `python3 ` and needs no + # execute bit. An unmatched glob is left literal and fails install, which + # is the right outcome for a release tree missing its QML or JS. + local file + for file in manifest.json cities.json world.json worldclock-data.py *.qml *.js; do + install -Dm644 "$file" "$plugin/$file" + done + + install -Dm644 LICENSE "$pkgdir/usr/share/licenses/$pkgname/LICENSE" + install -Dm644 README.md "$pkgdir/usr/share/doc/$pkgname/README.md" +}