dotter

In this release, a lot of code has been refactored and new unit testing has been implemented.

As a result, there are improvements in how dry-run works (see #49 )

Since so much code has changed, for now I release this as a pre-release and encourage testing this out and looking for bugs.

New:

• MacOS Support

New Features:

• Hooks (see #42 and wiki)
• Dependencies (see #48 and wiki)

Bugfixes:

• #46
• #47
• Fixed an issue where sometimes line numbers were wrong in the diff shown in -v

New Features:

• Files can now have the owner field. When they are deployed, they will be owned by the user specified. (see wiki and #37)
• When ran as root, Dotter now displays a warning.
• --force can now be shortened to -f
• Environment variables now can be used in the target of a file. (see #41 )
• Complex targets now work for directories. (see wiki)

Additionally, a lot of code has been refactored and cleaned up.

Changes:

• The diff shown in --verbose and --dry-run is now much better!
  Instead of printing the whole file, it breaks the diff into hunks similar to git diff, with improved coloring and with line numbers.
  The visual style was inspired by delta, so props to them.
• Common flags can now be specified after the subcommands - no more dotter -v watch

Bugfixes:

• Fixed issue #28
• Fixed issue where dotter watch would continuously re-fire itself on windows

New Features:

• Added all the functions from the crate handlebars_misc_helpers, see their readme for more information.

New Features:

• -p/--patch flag that allows specifying additional "patches" to the configuration's files or variables.

Fixes:

• Dotter now correctly asks for confirmation for deleting directories it left empty
• dotter watch now correctly triggers when there's a change in .dotter directory

New Features:

• new -y or --noconfirm flag to assume "yes" response to deleting empty directories

Changes:

• Logging library changed, so instead of using RUST_LOG environment variable, -v or --verbose flag is used - up to 3 repetitions.
  Use -q to silence warnings.
• dotter diff is no more! Now dotter -v and dotter --dry-run (which implies -v) print the differences.
• dotter watch diff is now replaced with dotter -v watch and dotter --dry-run watch

Fixes:

• Now correctly overwrites parts of maps. See issue #29
• Now only filters packages after includes have been processed, so that packages in included.toml that don't appear in local.toml's packages variable don't cause an error anymore

New Features:

• dotter diff - read more on the wiki
• dotter watch diff - runs dotter diff whenever a file changes, read more on the wiki

Changes:

• Added include_template, command_success, and command_output helpers - read about them in the wiki
• Added dotter.os builtin variable
• When one of the files is skipped or a template fails, Dotter will now exit with a failed status

Changes:

• Added builtin variable dotter - read more in the wiki

BREAKING Changes:

• Dotter now supports including files in local.toml - read more about it in the wiki and the issue, together with a breaking change to local.tomls:
  local.toml contents are no longer broken down by packages.
  To adjust to the new format, remove the package. from [package.files] and [package.variables], then merge all [files] and [variables] sections.
  For example, before:

packages = ["package1", "package2"]
[package1.files]
file1 = "target1"

[package1.variables]
variable1 = "value1"

[package2.files]
file2 = "target2"

after:

packages = ["package1", "package2"]

[files]
file1 = "target1"
file2 = "target2"

[variables]
variable1 = "value1"

• Default configuration directory is now .dotter instead of dotter_settings. To migrate:
  • Move dotter_settings to .dotter
  • Change helper paths accordingly (if applicable)
  • Change included.toml paths accordingly (if applicable)
  • Adjust .gitignore

Changes:

• Added dotter watch - will run continuously, deploying whenever a file in the repository changes. Read more here

Changes:

• Started tracking Cargo.toml in the repo for reproducibility. see #27

Thanks orhun for maintaining the AUR package!

Changes:

• Added option to specify more information about the target of a file, read more in #18 and in the wiki

Changes:

• Fixed a bug where a suggestion to --force was missing after skipping while updating symlinks/templates

Changes:

• Missing variables in templates will now be reported as an error and will prevent that specific template from updating.
• Binaries are now built automatically using GitHub Actions! Yay!

Changes:

• Dotter now has subcommands: deploy, undeploy, init. (--undeploy is no longer a flag)
• Adjustment to error chain printing - no more Failed to prepended to every message since it didn't work with some underlying errors

Changes:

• Bugfixes
• Revamp of error reporting code and logging code

Changes:

• Added --undeploy flag - removes all currently cached files
• Fixed bug where template permission bits wouldn't get copied
• Fixed bug where deleting a template corrupted cache