4 releases
0.1.3 | Nov 7, 2020 |
---|---|
0.1.2 | Dec 3, 2019 |
0.1.1 | Oct 27, 2019 |
0.1.0 | Oct 27, 2019 |
#1091 in Development tools
49KB
224 lines
scaff
Painless scaffolding of the boring part of setting up projects that people other than you can use.
Scaff can be used to generate licenses, initial READMEs, makefiles, build derivations, whatever really. All thanks to the awesome Tera templating engine!
Example use
How it works
scaff
will basically download a tarball, run tera on everything, and
extract out everything from any directory named scaff-out
. The
reason for not extracting the whole tarball is to support hidden files
that you could potentially include from tera, and also to support
downloading a git repository directly from GitHub/GitLab without
including the root directory or any other non-relevant files like
readmes.
Standard library
The following parameters are passed into Tera:
Name | Type | Value |
---|---|---|
dirname | string | Name of the current directory |
user | string | git config --global user.name |
query | fn (prompt?, default?) -> value | Query the user for input |
Getting it
In order to fetch scaff
with all its system dependencies, I
recommend using the Nix package manager. There's also an optional
binary cache available through Cachix.
cachix use jd91mzm2 # optional
nix-env -if https://gitlab.com/jD91mZM2/scaff/-/archive/master.tar.gz
Alternatively, you can use the official rust package manager cargo, although that will require you to install rust, a C compiler, and openssl.
cargo install scaff
Don't bloat down your repositories
It might be easy to think I'm condoning bloat when I literally make a tool to dumb code into your perhaps already filled code repos. This is not the case - I do not endorse bloat and I wouldn't recommend using this tool to extract 100 lines of code or whatever. That's part of the reason this tool doesn't allow updating any changes in the archives; it should only be used as a base, not as something that you sync between repositories.
For config files you intend to reuse and sync, I recommend the dhall configuration language to keep everything modular. This is not a replacement for dhall, it's merely a way to dump a base dhall file for modification later.
Dependencies
~23–34MB
~630K SLoC