json2dir : a JSON-to-directory converter, a fast alternative to home-manager for managing dotfiles
TL;DR:
file.json :
{ "file" : " Hello, world! " , "dir" : { "subfile" : " Content.
" , "subdir" : {} }, "symlink" : [ " link " , " target path " ], "script" : [ " script " , " #!/bin/sh
echo Howdy! " ] }
cat file.json | json2dir
Here, four files will be added to the current directory: file , dir , symlink , and script .
Using json2dir as a home-manager alternative.
Input schema
Objects represent directories.
Strings represent contents of files.
Arrays are used to represent symlinks and executable files.
Arrays of the form ["link", target] represent symlinks, second element representing the target of the symlink.
represent symlinks, second element representing the target of the symlink. Arrays of the form ["script", content] represent executable files, second representing the content of the script.
Caveats
Regular JSON constraints apply. In particular, the input must be UTF-8. Currently, there's no way to represent files containing non-UTF-8 content.
When using this utility to create files for other users, care must be taken in order to prevent TOCTOU (time of check, time of use) attacks (e.g. with symlinks).
Packaging
flake.nix contains a Nix package for json2dir .
Development
To build the project, run cargo build or nix build . If you're using rustup , rust-toolchain.toml is provided.
Useful scripts may be found in the scripts folder.
A Nix cache is available at https://json2dir.cachix.org.
Feel free to fork/open issues/submit PRs/etc.