Fully brandable to convince everyone that you tailor-made it to the needs of project XYZ
Lifts .md docs off the layout contract and displays them in the TUI in the appropriate context
Capabilities
These features afford a Nix DevOps professional the following capabilities:
Intuition over Documentation: contextual help is better than a readme
Onboarding and Discoverability: spare yourself and your users complicated instructions; let them self-service & -discover
Indexing Function: answers quickly what is it all that one can do with a repository?
Unstale: by consuming the flake attribute and at maximum a cache of short-ttl on the CLI completion, never let your users get stale on any of the above
Yes, that repository has one implementation that satisfies the required schema.
I’m in the process of rebasing it on Haumea as the currently most normalized file loader implementation, which is why I haven’t released it yet.
There are examples of its use, but I didn’t bother to mention them here, since they are really targeting very specialized use cases that don’t have a real mandatory connection with the capabilities delivered via this TUI & Schema.
As for the naming, I have a continued preference for associative storytelling over painstakingly descriptive nomenclature that overall does not perform any better in conveying the semantics. That hasn’t changed.
Upon paisano/core's release, I may tell that story.
No, it is the extracted core of Standard, in an effort to the pieces independantly useful, and also to focus development efforts.
I have been using and iterating on this for over a year now, but unfortunately our code base is still closed. We should be opening up sometime this year. I have a lot of examples I’ve wanted to share but haven’t been able to.
In any case, the description tries to be descriptive but perhaps its overkill for understanding. In general, it seeks to craft a solid foundation for Nix code that is well structured, specifically for the purpose of automating tasks for devops workflows, eliminating boilerplate, and hopefully wasted work.
One example where this all comes together is Standard Action, where we can use this schema to make assumptions and optmizations during any given CI run.
We tell Nix what we want to build in CI in the flake, and optionally we can filter out paths that already exist in a cache, or containers that already exist in a repo, or even tests that don’t need to run because no relavent code has changed.
In this CI model, we specifically opted to centralized evaluation, so that task runners can focus on actual work, and optionally eval state can be saved between runs in the case of heavy evals (IFD).
None of this would be possible, or at least not trivial without a well defined schema and typed outputs that we can reason about and map over safetly.
The logo of Paisano-Nix is AI on the prompt: “Colombian Coffee Farmer in the Fields with a Donkey”. Which is why the has a wired tail with an ear sprouting off its base.
A Paisano layout puts boundaries on how you name and layout your files under a root, commonly ./nix. One possible fulfillment of the schema contract can be obtained using paisano-nix/core (still unreleased).
A typical layout, then, looks like this:
./ops # or ./nix
./ops/local/configs.nix
./ops/local/packages.nix
./ops/local/envs.nix
./ops/local/envs.md # contextual help
./ops/backend/packages.nix
./ops/backend/entrypoints.nix
./ops/backend/oci-images.nix
./ops/backend/deployments.nix
But this example is misleading, at best: It maps the abstract capabilities to one particular use case. There are many more.
You can provide the required schema for .#__mything by any means that your heart desires. Even having a non-strict IFD fetch it from remote, if you wish (as long as you can fulfill derivations that way).
An implementation detail of schema v0 is: only __mything.init & __mything.actions are strictly required for the CLI / TUI. This will be clarified towards schema version v1.
For a test case schema snapshot, see this - unreleased!
has a wired tail with an ear sprouting off its base. 