0 Fork 0

mirror of https://github.com/kevinveenbirkenbach/computer-playbook.git synced 2026-11-10 04:36:40 +00:00

Files

T

kevinveenbirkenbachandClaude Opus 5 d4ae5cf9f0 fix(lint): put the cache-read markers where the rule reads them

suppressed_line_numbers matches the marker on the flagged line itself, and
ruff had split two of the calls so the comment landed behind the closing
paren, one line too low. The reads that can be cached now go through
utils.cache.files, which the bare interpreter imports fine; the two that
cannot keep a marker on a line short enough to stay whole.

The parser also gains the two guards utils/install/lint/pinned.py already
carries for the same bootstrap problem: its reading is cross-checked
against PyYAML on both requirements files, and a subprocess with yaml
made unimportable proves the module still works without it. That turns
the manual venv check into a standing test.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

2026-09-16 22:00:30 +02:00

lint

feat(install): pin the collections and stop refetching what is already there

2026-09-16 20:38:50 +02:00

__init__.py

feat(install/lint): Python-ize lint install + host/docker dispatcher

2026-05-20 20:40:34 +02:00

collections.py

fix(lint): put the cache-read markers where the rule reads them

2026-09-16 22:00:30 +02:00

github_release.py

style: delete every comment the comments-valid policy rejects

2026-08-18 03:22:02 +02:00

interpreters.py

feat(image): bake the php and ruby interpreters into the image

2026-08-22 20:56:55 +02:00

node.py

fix(test): install php and ruby instead of skipping their suites

2026-08-22 20:30:40 +02:00

npm.py

feat(install/lint): Python-ize lint install + host/docker dispatcher

2026-05-20 20:40:34 +02:00

php.py

fix(test): resolve the PHP vendor tree against a declared floor

2026-09-09 02:15:56 +02:00

pip.py

feat(install/lint): Python-ize lint install + host/docker dispatcher

2026-05-20 20:40:34 +02:00

primitives.py

fix(install): retry transient download failures, keep 4xx fatal

2026-08-10 10:12:20 +02:00

README.md

refactor(layout): sort shipped scripts by language and split the unit suite

2026-08-22 01:31:09 +02:00

ruby.py

fix(test): install php and ruby instead of skipping their suites

2026-08-22 20:30:40 +02:00

system_pkg.py

fix(install): refresh the apt index once before giving up on a package

2026-09-12 10:00:08 +02:00

README.md

utils/install

This directory hosts the Python implementation behind make install-lint. For the general rules that govern READMEs in code directories see documentation.md.

Purpose

The package installs the lint toolchain (actionlint, shfmt, ruff, ansible-lint, mbake, markdownlint-cli2, eslint, shellcheck, ansible-playbook, ansible-galaxy) using the right channel per tool (system package manager, pip, npm, or GitHub release). Modules at this level are channel-agnostic primitives; per-tool policy lives one level down in lint/.

Structure

File	Role
`primitives.py`	Logging, sudo wrapping, PATH mutation, and stdlib-based URL download.
`pip.py`	Venv-aware pip installer with `--break-system-packages` and `--user` fallback.
`npm.py`	Global / local npm install with per-user `--prefix` fallback.
`github_release.py`	Latest-tag resolver and asset downloader for GitHub releases.
`system_pkg.py`	Per-manager dispatch for `pacman` / `apt-get` / `dnf` / `yum` / `brew`.
`lint/`	One module per tool, each exposing `ensure()`. See lint README.

The CLI entry point lives at __main__.py, invoked from lint.sh as python3 -m utils.install.lint. The matching dispatcher wrapper.sh routes make install-lint host vs container based on INFINITO_LINT_RUNNER.

File Naming

Module names MUST stay lowercase snake_case.
Channel-agnostic helpers MUST live directly under utils/install/.
Per-tool policy (one tool per file) MUST live under lint/ (see lint README).
Test files live in tests/unit/python/utils/install/ and mirror the module name with a test_ prefix.

Import Rules

primitives.py MUST NOT import from any other module in this package.
pip.py, npm.py, github_release.py, and system_pkg.py MAY import from primitives.py.
npm.py MAY import from system_pkg.py to bootstrap npm itself; no other cross-imports between these four are allowed.
Per-tool modules under lint/ MUST NOT import each other (see lint README).