Package 'retiaudit'

Title: Inspect Python Selection Hints Without Starting Python
Description: A read-only preflight for Python environment selection with reticulate. Identifies explicit overrides, project-local environment hints, and conflicts with a requested managed environment. Produces a report that omits local paths and environment values. Does not initialize Python, discover interpreters, install software, or modify configuration.
Authors: Daiki Kumakura [aut, cre]
Maintainer: Daiki Kumakura <[email protected]>
License: MIT + file LICENSE
Version: 0.1.0
Built: 2026-10-19 20:14:01 UTC
Source: https://github.com/DaikiKumakura/retiaudit

Help Index

Format a Python Selection Audit

Description

Formats the report without including local paths or environment values. Does not write files.

Usage

audit_markdown(report)

Arguments

report

A report from audit_python().

Value

A character vector of Markdown lines. Review before sharing.

Examples

lines <- audit_markdown(audit_python(tempdir()))
cat(paste(lines, collapse = "\n"))

Audit Visible Python Selection Hints

Description

Read-only preflight for reticulate selection hints. Does not load reticulate, start Python, run discovery, install software, or modify configuration.

Usage

audit_python(project = getwd(), intent = c("inspect", "managed", "existing"), expected = NULL)

Arguments

project

An existing project directory.
intent

Selection intention: inspect, managed, or existing.
expected

Optional expected interpreter file path.

Details

This is not an interpreter-selection prediction or dependency validation. Runtime use_python requests and delayed imports are not observed. Project startup files are not evaluated. A local virtualenv marker does not prove a valid interpreter. Guidance targets reticulate 1.41 and later.

Value

A retiaudit_report containing hints, markers, findings and scope. Environment values and paths are omitted.

Examples

report <- audit_python(tempdir(), intent = "managed")
report