"Link" core plugin

[arcticicestudio]

Implement the core plugin Link(snowsaw.Plugin) in the snowsaw.plugins package to symbolically link dotfiles.

Links should specify how files and directories should be symbolically linked. If desired, items should be ablte to be specified to be forcibly linked, overwriting existing files if necessary. Environment variables in paths should be automatically expanded.

Format

Links should be specified as a dictionary mapping targets to source locations. Source locations should be specified relative to the base snowblock directory that is specified as terminal parameter. Directory names should not contain a trailing / character.

Links should support an optional extended configuration. In this type of configuration, instead of specifying source locations directly, targets should be mapped to extended configuration dictionaries.
These dictionaries should support the following options:

Option	Values	Default Value	Required	Description
create	true, false	false	No	Specifies if the parent directory should be created if necessary.
force	true, false	false	No	Specifies if the file or directory should be forcibly linked. This can cause irreversible data loss! Use with caution!
host	string[]	[]	No	Contains hostnames this link should be processed for. Links with an empty array will be processed irrespective of the host.
path	string, null	null	No	The path to map the source path. If the path is omitted or null, snowsaw will use the basename of the destination, with a leading . stripped if present.
relink	true, false	No	false	Specifies if incorrect symbolic links should be automatically overwritten.
relative	true, false	No	false	Specifies if the symbolic link should have a relative path.

Example

[
  {
    "link": {
      "~/.gitconfig": {
        "create": true,
        "host": ["archlinux-work"],
        "path": "gitconfig-work"
      },
      "~/.gitignore": {
        "force": true,
        "relink": true
      },
      "~/.git-commit-message": {
        "relative": true
      }
    }
  }
]