nix-uri
nix-uri is a rust crate that parses
the nix-uri-scheme
into a FlakeRef
struct.
Also allows for building a nix-uri
through the FlakeRef
struct.
Convenience functionality for working with nix flake.nix
references (flakerefs).
Provides types for the generic attribute set representation, but does not parse it:
Installation
To use nix-uri
, add it as a dependency in your Cargo.toml
file:
-uri = "0.1.4"
nix
or use cargo add
:
cargo add nix-uri
Examples
Check out the examples directory, for more information, or run an example:
cargo run --example simple
cargo run --example cli github:nixpkgs/nixos
The uri syntax representation is parsed by this library:
Example: Parsing from github:nixos/nixpkgs
:
let uri = "github:nixos/nixpkgs";
let expected = new;
let parsed: FlakeRef = uri.try_into.unwrap;
assert_eq!;
It can also be generated from FlakeRef
.
Example: Constructing the following uri github:nixos/nixpkgs
:
let expected = "github:nixos/nixpkgs";
let uri = new.to_string;
assert_eq!;
Note
This library is still an early WIP and not all cases are covered yet. Especially error handling is not properly implemented at this time.