mirror of
https://github.com/kevinveenbirkenbach/computer-playbook.git
synced 2026-11-06 10:59:59 +00:00
kevinveenbirkenbachandClaude Opus 5
5137465c6f
3529 invalid comments in 528 files, grandfathered in while the linter only saw the working-tree diff. Removal ran through the linter's own collectors, so detection and deletion cannot drift: a comment whose opener line is blank before it and whose closer line is blank after it loses all its lines, anything else loses only the comment region, and a line left holding a bare delimiter goes with it. Five files keep their comments behind a nocheck marker instead. Four are upstream configs whose inline docs are upstream's own (mautrix, systemd journald, nextcloud-oidc-login, MediaWiki). In littlejs the commented-out entries ARE the deactivation mechanism for an example tile, so deleting them would delete configuration. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
56 lines
1.7 KiB
Python
56 lines
1.7 KiB
Python
from __future__ import annotations
|
|
|
|
from pathlib import Path
|
|
|
|
from ansible.errors import AnsibleError
|
|
from ansible.plugins.lookup import LookupBase
|
|
|
|
|
|
class LookupModule(LookupBase):
|
|
"""
|
|
Return a cache-busting string based on the LOCAL file's mtime.
|
|
|
|
Usage (single path → string via Jinja):
|
|
{{ lookup('local_mtime_qs', '/path/to/file.css') }}
|
|
-> "?version=1712323456"
|
|
|
|
Options:
|
|
param (str): query parameter name (default: "version")
|
|
mode (str): "qs" (default) → returns "?<param>=<mtime>"
|
|
"epoch" → returns "<mtime>"
|
|
|
|
Multiple paths (returns list, one result per term):
|
|
{{ lookup('local_mtime_qs', '/a.js', '/b.js', param='v') }}
|
|
"""
|
|
|
|
def run(self, terms, variables=None, **kwargs):
|
|
if not terms:
|
|
return []
|
|
|
|
param = kwargs.get("param", "version")
|
|
mode = kwargs.get("mode", "qs")
|
|
|
|
if mode not in ("qs", "epoch"):
|
|
raise AnsibleError("local_mtime_qs: 'mode' must be 'qs' or 'epoch'")
|
|
|
|
results = []
|
|
for term in terms:
|
|
path = str(Path(str(Path(str(term)).expanduser())).resolve())
|
|
|
|
if not Path(path).exists():
|
|
raise AnsibleError(f"local_mtime_qs: file does not exist: {path}")
|
|
if not Path(path).is_file():
|
|
raise AnsibleError(f"local_mtime_qs: not a regular file: {path}")
|
|
|
|
try:
|
|
mtime = int(Path(path).stat().st_mtime)
|
|
except OSError as e:
|
|
raise AnsibleError(f"local_mtime_qs: cannot stat '{path}': {e}") from e
|
|
|
|
if mode == "qs":
|
|
results.append(f"?{param}={mtime}")
|
|
else:
|
|
results.append(str(mtime))
|
|
|
|
return results
|