https://github.com/nonlogicaldev/cli.dotter

Dotfile link manager.
https://github.com/nonlogicaldev/cli.dotter

Last synced: 2 months ago
JSON representation

Dotfile link manager.

• Host: GitHub
• URL: https://github.com/nonlogicaldev/cli.dotter
• Owner: NonLogicalDev
• Created: 2018-12-17T19:10:35.000Z (about 6 years ago)
• Default Branch: master
• Last Pushed: 2024-06-20T02:20:42.000Z (7 months ago)
• Last Synced: 2024-11-08T01:07:12.247Z (2 months ago)
• Language: Python
• Homepage: https://pypi.org/project/nl-dotter/
• Size: 75.2 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 1
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# A Dotfile Link Farm Manager

[Example Dotfile Repo](https://github.com/NonLogicalDev/conf.dotfiles)

## Example Usage:

```

git clone https://github.com/NonLogicalDev/conf.dotfiles ~/.config/dotter

python3 -m pip install --user nl-dotter

dotter link

```

## Usage Output:

### Root Command:

```

usage: dotter [-h] {version,link,config} ...

A dotfile linker. This utility creates a link farm from a data root to users home directory.

It's intended use is to keep dotfiles neatly organized and separated by topics.

optional arguments:

  -h, --help            show this help message and exit

command:

  {version,link,config}

    version             print version and exit

    link                link dotfiles from $HOME/.config/dotter

    config              query configuration values

```

### Link Command:

```

usage: dotter link [-h] [--root ROOT_DIR] [--conf-dir CONF_DIR] [-c CATEGORY]

                   [-t TOPIC] [-f] [-d] [-b]

links files into the home directory from the data root.

optional arguments:

  -h, --help           show this help message and exit

  --root ROOT_DIR      Alternative root location (for testing configuration)

  --conf-dir CONF_DIR  Alternative configuration location (for testing configuration)

  -c CATEGORY          Specify a category to sync (defaults to common)

  -t TOPIC             Specify a topic to sync (inside a category)

  -f                   Force execution

  -d                   Dry run current setup

  -b                   Backup files and place new ones in place, appends ".backup"

```