Files
computer-playbook/utils/install/lint/php.py
T
kevinveenbirkenbachandClaude Opus 5 6fee7ca136 feat(quality): parse every shipped language and run its unit suite
Four parse checks join the `lint-*` family, each using the language's own
parser rather than a reimplementation: `php -l`, `ruby -c`, `sqlfluff parse`,
and stylelint with an empty rule set (it raises CssSyntaxError whatever the
rules say, so the check stays syntax-only and grows no style opinion). Three
unit runners join `test-unit`: node:test, PHPUnit, minitest -- the first and
third ship with their runtime, so only PHPUnit adds a dependency.

Provisioning is best effort and the lint script decides whether it can run. A
machine without PHP must not fail the gate, but it must not look like success
either: the skip names how many files went unchecked. The first version of
these scripts read `git ls-files`, which inside the compose container returns
nothing (git refuses the bind-mounted repo as "dubious ownership") and reported
"No SQL files found." over 52 files -- green, and a lie. They use `find` now,
as the surrounding lint scripts already did.

sqlfluff needed two corrections before it parsed anything real. `%(name)s` is a
psycopg parameter marker, not SQL, so the placeholder templater is configured
rather than the files exempted; and the dialect follows each role's declared
engine (`meta/services.yml`), which is postgres for six roles and mysql for
svc-db-mariadb and pixelfed.

Recipes stay in scripts, not in the Makefile: the targets delegate, matching
every other target in the file.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-08-22 01:31:10 +02:00

25 lines
760 B
Python

"""Install the PHP CLI via system package manager (parser for lint-php).
Provisioning is best effort: a host without PHP, or one that cannot install it,
must not fail the whole gate. scripts/lint/php.sh skips loudly instead.
"""
from __future__ import annotations
from utils.install.primitives import log, warn, which
from utils.install.system_pkg import install_command_via_pkg
def ensure() -> None:
if which("php"):
return
log("Missing command 'php'. Attempting system package installation.")
try:
install_command_via_pkg("php")
except RuntimeError as exc:
warn(f"[install-lint] php could not be installed: {exc}")
if not which("php"):
warn("[install-lint] php is unavailable; lint-php will skip.")