Module preview 

The system change preview: what a plan is expected to change on this machine, step by step: files (side by side where the new contents can be worked out without writing anything), packages, services and when it takes effect. Every change says how it is known: worked out here, declared by the entry, or impossible to tell before the step runs. It only reads files and asks package managers read-only questions.

Structs

Change

One expected change.

Diff

A side-by-side comparison of a file now and after the step.

Look

What the preview asks the machine; tests answer instead.

Row

StepPreview

One step’s changes.

Enums

Area

What a change touches.

Certainty

How a change is known.

Pinned

A pinned source, as found on this machine.

Tag

Functions

diff

Compare a file’s lines now and after, side by side. None when either is too long to compare line by line.

fetch_source

Download a pinned source into the folder the installers read it from, with the installers’ own fetch_source, which checks the revision. It changes nothing else. scripts is the unpacked scripts folder.

pinned_source

Find a pinned source on this machine, as fetch_source would before using it: at its revision and unedited. scripts is the unpacked scripts folder. Only reads.

preview

Preview a plan’s changes.

render_with

Run a renderer from the installers’ folder: python3 configure.py ARGS, which only prints. scripts is the unpacked scripts folder.

sources_for

The pinned sources a plan’s dotfiles entries read.