Read 2026-10-23
xonsh/xonsh: technical due diligence, read from its repository
What Borehole read in xonsh/xonsh's code and history at 52c7019: its licence, security advisories, releases, review practice, tests, dependencies and operations. Every finding cites the file and line it rests on. The full report also covers the team and asks the questions the code cannot answer.
| Dimension | Rating |
|---|---|
| Architecture & Codebase — including AI provenance | strong |
| Engineering Process & SDLC Maturity | strong |
| Product & Engineering Maturity | strong |
| Security & Reliability Posture | strong |
| Observability & Operations | not assessable |
| Fit with the Acquirer | not assessable |
What the repository says
AI_POLICY.md:135: states a policy on AI-generated contributions
Architecture & Codebase — including AI provenance
strongxonsh/parsers/base.py is 4,103 lines, 28× this codebase's median file
adequateThe median source file here is 142 lines. 9 files exceed 1,420 lines, the largest being 4,103. Size is not a defect on its own — some problems genuinely live in one place — but these are where merge conflicts, review fatigue and single-owner knowledge concentrate, and they are the first thing that slows an inheriting engineer down.
xonsh/parsers/base.py:1 — 4,103 lines (28× median) |
xonsh/environ.py:1 — 3,629 lines (25× median) |
xonsh/parsers/ply/yacc.py:1 — 3,505 lines (24× median) |
xonsh/tools.py:1 — 3,315 lines (23× median) |
xonsh/pyghooks.py:1 — 2,309 lines (16× median) |
83 errors caught and discarded in product code
adequate83 places catch an error and do nothing with it, across 32 files (0.6 per thousand lines). Each is a failure the system will not report. They surface later as problems nobody can explain, and they are cheap to fix now.
xonsh/aliases.py:1461 — error caught and discarded |
xonsh/built_ins.py:275 — error caught and discarded |
xonsh/completers/emoji.py:73 — error caught and discarded |
Engineering Process & SDLC Maturity
strongTests are retried until they pass
adequate34 tests are individually marked to retry. A retry turns a flaky test green without saying why it failed, so a green build means the tests passed eventually. Ask how many retries a typical run needs, and which tests need them.
tests/completers/test_python.py:111 — test retry |
tests/procs/test_pipeline_llm.py:57 — test retry |
Product & Engineering Maturity
strongNo finding.
Security & Reliability Posture
strong5 shell commands built from strings
adequate5 places run a command through a shell (`shell=True`, `os.system`, `exec` with a template) rather than passing arguments. Where any part comes from outside, it is command injection. Ask where each one's input comes from.
xonsh/shells/ptk_shell/__init__.py:773 — command run through a shell |
xonsh/shells/ptk_shell/__init__.py:791 — command run through a shell |
xonsh/shells/readline_shell.py:828 — command run through a shell |
6 deserialisers that can run code
adequate6 places read data with a deserialiser that executes what it reads (pickle). That is safe on data the system wrote itself and remote code execution on anything else. Ask where each one's input comes from.
xonsh/parsers/ply/yacc.py:2013 — code-executing deserialiser |
xonsh/parsers/ply/yacc.py:2016 — code-executing deserialiser |
xonsh/parsers/ply/yacc.py:2017 — code-executing deserialiser |
Observability & Operations
not assessableNot rated: only 5 of 16 checks could reach a conclusion here; the rest do not apply to this repository or could not read it.
Fit with the Acquirer
not assessableNot rated: structurally not assessable from a repository.
Read more, or read your own
The full report on xonsh/xonsh: every dimension, the questions for the room, and the audit log.
Survey a repository: free on public repositories. Private code is read on your own machine by a collector whose source you can read first.