#ansible #dotfiles

app tuning

ansible-like tool with a smaller scope, focused primarily on complementing dotfiles for cross-machine bliss

9 releases

0.1.12 Apr 10, 2021
0.1.11 Apr 9, 2021
0.1.8 May 3, 2020
0.1.7 Apr 6, 2020
0.1.5 Aug 18, 2019

#92 in Command line utilities

43 downloads per month

MIT license

67KB
2K SLoC

tuning badge

ansible-like tool with a smaller scope, focused primarily on complementing dotfiles for cross-machine bliss

status

  • some functionality, but still missing some basics that will make it actually useful

what?

  • inspired by ansible, with jobs defined in a declarative file format

  • will focus on the dotfiles use-case: maintaining the same user preferences across machines, or restoring user preferences to a fresh machine

  • no remote or fleet functionality / complexity

  • not aiming to do anything that requires root / Administrator permissions (yet)

  • named after the reality-bending ability in Dark City

why?

  • my dotfiles started as a whole bunch of shell-scripts, but didn't have any support for Windows,

  • I'd partially moved to my second attempt, which is cross-platform, but required too much work for new jobs

  • other existing tools use interpretted languages, which are fine for web services that run in containers, but can be overly-sensitive to interpreter versions and globally-installed packages

  • yes, I am firmly trapped in The Code/Data Cycle

prerequisites

getting started

$ cargo install tuning
$ tuning

documentation

roadmap

  • read config from user's HOME directory
  • needs to support optional sequencing of jobs
  • support the "command" job
  • support the "file" job
  • resolve references to path expressions (e.g. ~) (#9)
  • when to support conditional jobs
  • specify that a job needs a certain OS
  • specify that a job needs certain executables
  • needs_any for flexible sequencing of jobs
  • support the "git" job
  • flag to point at a different config file
  • import or include to help decompose large config files

see also

Dependencies

~7MB
~155K SLoC