Skip to content

Describe dependencies and the closure lib - #92

Merged
clhodapp merged 3 commits into
mainfrom
docs/dependencies
Nov 11, 2026
Merged

clhodapp merged 3 commits into
mainfrom
docs/dependencies

Conversation

@clhodapp

@clhodapp clhodapp commented Nov 1, 2026 •

Copy link
Copy Markdown
Contributor

nix-caisson/caisson-core#59 and nix-caisson/caisson#144 name the pinned trees of a flake dependencies. A registered file reads them as closure-lib.caisson.dependencies.<name>. This pull request describes that API.

The concept page is now titled "Closed-over Dependencies", and its file is concepts/closed-over-dependencies.md. The deep dive is now titled "How dependencies are closed over", and its file is deep-dives/how-dependencies-are-closed-over.md. Every link to either page points at the new path.

Every example reads closure-lib.caisson.dependencies inside a module body or an overlay function. A library overlay's imports list is read while the overlay is registered, so overlay examples name their imports with registry names such as "some-flake/default".

Running mdbook build on this branch produces no warnings.

🤖 Generated with Claude Code

A flake passes its pinned trees to mkLib as `dependencies`, and a
registered file reads them as `closure-lib.caisson.dependencies`. The
concept page is now "Closed-over Dependencies"
(concepts/closed-over-dependencies.md) and the deep dive is "How
dependencies are closed over" (deep-dives/how-dependencies-are-closed-over.md).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
clhodapp and others added 2 commits November 10, 2026 17:31
The overlay of examples/literate-flake reads nothing from the closure.
Its flake.nix passes the dependencies to mkLib and explains in a comment
how a file reads them.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The members of an attribute set have no order.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@clhodapp
clhodapp merged commit 594537e into main Nov 11, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant