`config-mapper` is CLI utility tool to help you manage your configuration between systems.
It provides a set of tools to load your configuration from a system, save it on a git repository and then save it to a new system. This configuration can be a set of files, folders or even dependencies.
## Usage
Before going any further, you need to create a repository to store your configuration. You can choose any supplier as long it's a git repository :).
When copying a file from your configuration repository to your system, it's performing a copy. If the file exists on the system, it's content will be replaced by your configuration's one.
The system is detected automatically. You just need to specify whether the related field in case of `files` or folders `sections` (fields: `darwin` | `linux`).
You can get a configuration template [here](https://raw.githubusercontent.com/DataHearth/config-mapper/main/.config-mapper.yml.template).
### Setup
Create a file called `.config-mapper.yml` in your `home` directory (it is the default search path for config-mapper).
If you wish to move it to another directory, you can have to choice to inform the tool. By either set an environment like this one: `CONFIG_MAPPER_CFG=/path/to/config/.config-mapper.yml`. Or by providing the `-c /path/to/config/.config-mapper.yml` flag to the tool.
Once the configuratio file created, run this command to initialize the repository localy:
```bash
config-mapper init
```
If the folder is already present and is a git directory, clone instruction will be ignored.
template for storage part:
```yaml
storage:
# Where will be the repository folder located ? [DEFAULT: MacOS($TMPDIR/config-mapper) |Linux(/tmp/config-mapper)]
location: /path/to/folder
git:
# * by default, if ssh dict is set with its keys filled, I'll try to clone with SSH
If you want to exclude one part of your configuration file (files, folders), you can use these flags to ignore them `--disable-files``--disable-folders`. Note, package managers are disable by default. You can enable this option using the `--pkgs` flag.
You can also exclude files and folders from a given directory with a `.gitignore` like file named `.ignore`. Put it in the root directory of an included folder and add relative path to exclude (does not support glob for now). E.g:
If `homebrew` is provided in the `installation-order` (default: `["apt", "homebrew"]`), it will override the `homebrew` field with all user installed packages (`brew leaves --installed-on-request`). The same principle will be implemented with `aptitude`.
template for your configuration:
```yaml
# NOTE: the $LOCATION if refering to the "storage.location" path. It'll be replaced automatically
# The left part of ":" is your repository location and right part when it should be on your system
files:
- darwin: "$LOCATION/macos/.zshrc:~/.zshrc"
linux: "$LOCATION/linux/.zshrc:~/.zshrc"
folders:
- darwin: "$LOCATION/macos/.config:~/.config"
linux: "$LOCATION/macos/.config:~/.config"
package-managers:
installation-order: ["homebrew"]
homebrew:
- bat
- hexyl
- fd
- hyperfine
- diskus
- jq
- k9s
- go
- starship
- exa
- httpie
- neovim
- nmap
- pinentry
- zsh
apt-get: []
```
### Load your configuration onto the system
Once your repository is populated with your configurations, you can now load them onto a new system by using:
```bash
config-mapper load
```
The same ignore flags are used in the `save` command.