Borehole · Project · free tier
xonsh/xonsh
Free reading: not for reliance
52c7019 · 11,992 commits · 602 files
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.

DimensionRating
Architecture & Codebase — including AI provenancestrong
Engineering Process & SDLC Maturitystrong
Product & Engineering Maturitystrong
Security & Reliability Posturestrong
Observability & Operationsnot assessable
Fit with the Acquirernot assessable

What the repository says

  • AI_POLICY.md:135: states a policy on AI-generated contributions

Architecture & Codebase — including AI provenance

strong
01.6

xonsh/parsers/base.py is 4,103 lines, 28× this codebase's median file

adequate

The 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.

Evidence
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)
01.15

83 errors caught and discarded in product code

adequate

83 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.

Evidence
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

strong
02.16

Tests are retried until they pass

adequate

34 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.

Product & Engineering Maturity

strong

No finding.

Security & Reliability Posture

strong
05.21

5 shell commands built from strings

adequate

5 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.

Evidence
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
05.22

6 deserialisers that can run code

adequate

6 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.

Evidence
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 assessable

Not 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 assessable

Not 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.