# shallow-backup
[](http://pepy.tech/count/shallow-backup)
[](https://travis-ci.com/alichtman/shallow-backup)
[](https://www.codacy.com/app/alichtman/shallow-backup?utm_source=github.com&utm_medium=referral&utm_content=alichtman/shallow-backup&utm_campaign=Badge_Grade)
<!-- [](https://coveralls.io/github/alichtman/shallow-backup?branch=master) -->
`shallow-backup` lets you easily create lightweight backups of installed packages, applications, fonts and dotfiles, and automatically push them to a remote Git repository.
I use it to manage [my dotfiles](https://github.com/alichtman/dotfiles).
# Contents
- [Why?](#why)
- [Installation](#installation)
- [Method 1: <a href="https://pypi.org/project/shallow-backup/" rel="nofollow">pipx</a>](#method-1-pipx)
- [Method 2: Install From Source](#method-2-install-from-source)
- [Dependencies](#dependencies)
- [Usage](#usage)
- [Recipes](#recipes)
- [Maintain a separate repo for your dotfiles](#maintain-a-separate-repo-for-your-dotfiles)
- [Synchronize dotfiles on multiple computers](#synchronize-dotfiles-on-multiple-computers)
- [Reinstall dotfiles from a backup](#reinstall-dotfiles-from-a-backup)
- [What can I back up?](#what-can-i-back-up)
- [Configuration](#configuration)
- [Conditional Backup and Reinstallation](#conditional-backup-and-reinstallation)
- [Git Integration](#git-integration)
- [A Word of Caution](#a-word-of-caution)
- [.gitignore](#gitignore)
- [Output Structure](#output-structure)
- [Want to Contribute?](#want-to-contribute)
### Why?
I wanted a tool that allows you to:
- Back up dotfiles _from where they live on the system_.
- Back up files from _any_ path on the system, not just `$HOME`.
- Reinstall them from the backup directory idempotently.
- Backup and reinstall files conditionally, so you can easily manage dotfiles across multiple systems.
- Copy files on installation and backup, as opposed to symlinking them.
- Backup package installations in a highly compressed manner
- Not worry about accidentally doing something dangerous / destructive (is user-protective)
`shallow-backup` checks all of those boxes.
### Installation
---
> **Warning**
> Be careful running this with elevated privileges. Code execution can be achieved with write permissions on the config file.
#### Method 1: [`pipx`](https://pypi.org/project/shallow-backup/)
```bash
$ pipx install shallow-backup
```
#### Method 2: Install From Source
```bash
$ git clone https://www.github.com/alichtman/shallow-backup.git
$ cd shallow-backup
$ pip3 install .
```
### Dependencies
---
- `pre-commit`
- `trufflehog`
If you are missing the dependencies, you will be guided to install them.
### Usage
---
- To start the interactive program, run `$ shallow-backup`.
- To backup your dotfiles, run `$ shallow-backup --backup-dots`.
`shallow-backup` was built with scripting in mind. Every feature that's supported in the interactive program is supported with command line arguments.
```shell
Usage: shallow-backup [OPTIONS]
Easily back up installed packages, dotfiles, and more.
You can edit which files are backed up in ~/.shallow-backup.
Written by Aaron Lichtman (@alichtman).
Options:
--add-dot TEXT Add a dotfile or dotfolder to config by path.
--backup-all Full back up.
--backup-configs Back up app config files.
--backup-dots Back up dotfiles.
--backup-fonts Back up installed fonts.
--backup-packages Back up package libraries.
--delete-config Delete config file.
--destroy-backup Delete backup directory.
--dry-run Don't backup or reinstall any files, just give
verbose output.
--new-path TEXT Input a new back up directory path.
--no-new-backup-path-prompt Skip setting new back up directory path prompt.
--no-splash Don't display splash screen.
--reinstall-all Full reinstallation.
--reinstall-configs Reinstall configs.
--reinstall-dots Reinstall dotfiles and dotfolders.
--reinstall-fonts Reinstall fonts.
--reinstall-packages Reinstall packages.
--remote TEXT Set remote URL for the git repo.
--show Display config file.
-v, --version Display version and author info.
-h, -help, --help Show this message and exit.
```
### Recipes
---
#### Maintain a separate repo for your dotfiles
`shallow-backup` makes this easy! After making your first backup, `cd` into the `dotfiles/` directory and run `$ git init`. Create a `.gitignore`, and a create / set up (link the upstream remote, etc) a new repo on your favorite version control platform. With operations involving the parent `shallow-backup` repo, `shallow-backup` will prompt you interactively to update the nested submodule. After that is taken care of, `shallow-backup` will move on to updating the parent. The `dotfiles` repo will be tracked as a submodule.
#### Synchronize dotfiles on multiple computers
Run `shallow-backup --backup-dots` on the first computer. Make a commit and push to the remote. Then pull these changes down on the second computer. Run `shallow-backup --backup-dots` on the second computer, and resolve the merge conflicts. Once you have a final version you're happy with, make a commit, push it, and run `shallow-backup --reinstall-dots`. On the first computer, pull the changes and run `shallow-backup --reinstall-dots`. Your changes are now sync'd across both computers and the remote repository.
#### Reinstall dotfiles from a backup
To reinstall your dotfiles, clone your dotfiles repo and make sure your shallow-backup config path can be found at either `~/.config/shallow-backup.conf` or `$XDG_CONFIG_HOME/.shallow_backup.conf`. Set the `backup-path` key in the config to the path of your cloned dotfiles. Then run `$ shallow-backup --reinstall-dots`.
When reinstalling your dotfiles, the top level `.git/`, `.gitignore`, `img/` and `README.md` files and directories are ignored.
### `zsh` Completions
Available in [`zsh-users/zsh-completions`](https://github.com/zsh-users/zsh-completions/blob/master/src/_shallow-backup). Follow the [installation instructions here](https://github.com/zsh-users/zsh-completions/tree/master#using-zsh-frameworks).
### What can I back up?
---
By default, `shallow-backup` backs these up.
1. Dotfiles and dotfolders
- `.bashrc`
- `.bash_profile`
- `.gitconfig`
- `.pypirc`
- `.config/shallow-backup.json`
- `.ssh/`
- `.vim/`
- `.zshrc`
2. App Config Files
- VSCode
- Sublime Text 2/3
- Terminal.app
3. Installed Packages
- `brew` and `cask`
- `cargo`
- `gem`
- `pip`
- `pip3`
- `npm`
- `macports`
- `VSCode` Extensions
- `Sublime Text 2/3` Packages
- System Applications
4. User installed `fonts`.
### Configuration
If you'd like to modify which files are backed up, you have to edit the `JSON` config file, located at `~/.config/shallow-backup.json`. There are two ways to do this.
1. Select the appropriate option in the CLI and follow the prompts.
2. Open the file in a text editor and make your changes.
Editing the file in a text editor will give you more control and be faster.
#### Conditional Backup and Reinstallation
> **Warning**
> This feature allows code execution (by design). If untrusted users can write to your config, they can achieve code execution next time you invoke `shallow-backup` _backup_ or _reinstall_ functions. Starting in `v5.2`, the config file will have default permissions of `644`, and a warning will be printed if others can write to the config.
Every key under dotfiles has two optional subkeys: `backup_condition` and `reinstall_condition`. Both of these accept expressions that will be evaluated with `bash`. An empty string (`""`) is the default value, and is considered to be `True`. If the return value of the expression is `0`, this is considered `True`. Otherwise, it is `False`. This lets you do simple things like preventing backup with:
```javascript
// Because `$ false` returns 1
"backup_condition": "false"
```
And also more complicated things like only backing up certain files if an environment variable is set:
```javascript
"backup_condition": "[[ -n \"$ENV_VAR\" ]]"
```
Here's an example config based on my [dotfiles](https://www.github.com/alichtman/dotfiles):
```json
{
"backup_path": "~/shallow-backup",
"lowest_supported_version": "5.0.0a",
"dotfiles": {
".config/agignore": {
"backup_condition": "uname -a | grep Darwin",
"reinstall_condition": "uname -a | grep Darwin"
},
".config/git/gitignore_global": { },
".config/jrnl/jrnl.yaml": { },
".config/kitty": { },
".config/nvim": { },
".config/pycodestyle": { },
...
".zshenv": { }
},
"root-gitignore": [
".DS_Store",
"dotfiles/.config/nvim/.netrwhist",
"dotfiles/.config/nvim/spell/en.utf-8.add",
"dotfiles/.config/ranger/plugins/ranger_devicons",
"dotfiles/.config/zsh/.zcompdump*",
"dotfiles/.pypirc",
"dotfiles/.ssh"
],
"dotfiles-gitignore": [
".DS_Store",
".config/nvim/.netrwhist",
".config/nvim/spell/en.utf-8.add*",
".config/ranger/plugins/*",
".config/zsh/.zcompdump*",
".config/zsh/.zinit",
".config/tmux/plugins",
".config/tmux/resurrect",
".pypirc",
".ssh/*"
],
"config_mapping": {
"/Users/alichtman/Library/Application Support/Sublime Text 2": "sublime2",
"/Users/alichtman/Library/Application Support/Sublime Text 3": "sublime3",
"/Users/alichtman/Library/Application Support/Code/User/settings.json": "vscode/settings",
"/Users/alichtman/Library/Application Support/Code/User/Snippets": "vscode/Snippets",
"/Users/alichtman/Library/Application Support/Code/User/keybindings.json": "vscode/keybindings",
"/Users/alichtman/Library/Preferences/com.apple.Terminal.plist": "terminal_plist"
}
}
```
### Git Integration
---
#### A Word of Caution
This backup tool is git-integrated, meaning that you can easily store your backups remotely (on GitHub, for example.) Dotfiles and configuration files may contain sensitive information like API keys and ssh keys, and you don't want to make those public. To make sure no sensitive files are uploaded accidentally, `shallow-backup` creates a `.gitignore` file if it can't find one in the directory. It excludes `.ssh/` and `.pypirc` by default. It's safe to remove these restrictions if you're pushing to a remote private repository, or you're only backing up locally. To do this, you should clear the `.gitignore` file without deleting it.
_If you choose to back up to a public repository, look at every file you're backing up to make sure you want it to be public._
> [!NOTE]
> As of `v6.2`, `trufflehog` is run as a required precommit hook and will detect secrets.
#### .gitignore
As of `v4.0`, any `.gitignore` changes should be made in the `shallow-backup` config file. `.gitignore` changes that are meant to apply to all directories should be under the `root-gitignore` key. Dotfile specific gitignores should be placed under the `dotfiles-gitignore` key. The original `default-gitignore` key in the config is still supported for backwards compatibility, however, converting to the new config format is strongly encouraged.
### Output Structure
---
```shell
shallow_backup/
├── configs
│ ├── plist
│ │ └── com.apple.Terminal.plist
│ ├── sublime_2
│ │ └── ...
│ └── sublime_3
│ └── ...
├── dotfiles
│ ├── .bash_profile
│ ├── .bashrc
│ ├── .gitconfig
│ ├── .pypirc
│ ├── ...
│ ├── shallow-backup.json
│ ├── .ssh/
│ │ └── known_hosts
│ ├── .vim/
│ └── .zshrc
├── fonts
│ ├── AllerDisplay.ttf
│ ├── Aller_Bd.ttf
│ ├── ...
│ ├── Ubuntu Mono derivative Powerline Italic.ttf
│ └── Ubuntu Mono derivative Powerline.ttf
└── packages
├── brew-cask_list.txt
├── brew_list.txt
├── cargo_list.txt
├── gem_list.txt
├── installed_apps_list.txt
├── npm_list.txt
├── macports_list.txt
├── pip_list.txt
└── sublime3_list.txt
```
### Reinstalling Dotfiles
---
To reinstall your dotfiles, clone your dotfiles repo and make sure your shallow-backup config path can be found at either `~/.config/shallow-backup.json` or `$XDG_CONFIG_HOME/.shallow_backup.json`. Set the `backup-path` key in the config to the path of your cloned dotfiles. Then run `$ shallow-backup -reinstall-dots`.
When reinstalling your dotfiles, the top level `.git/`, `.gitignore`, `img/` and `README.md` files and directories are ignored.
### Want to Contribute?
---
Check out `CONTRIBUTING.md` and the `docs` directory.
Raw data
{
"_id": null,
"home_page": "https://github.com/alichtman/shallow-backup",
"name": "shallow-backup",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "backup documentation system dotfiles install list configuration",
"author": "alichtman",
"author_email": "aaronlichtman@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/d0/56/427960ea933c35b43b561d8f1379d4f7794b67f785ec3137adaf6ce5073e/shallow_backup-6.4.tar.gz",
"platform": null,
"description": "# shallow-backup\n\n[](http://pepy.tech/count/shallow-backup)\n[](https://travis-ci.com/alichtman/shallow-backup)\n[](https://www.codacy.com/app/alichtman/shallow-backup?utm_source=github.com&utm_medium=referral&utm_content=alichtman/shallow-backup&utm_campaign=Badge_Grade)\n\n<!-- [](https://coveralls.io/github/alichtman/shallow-backup?branch=master) -->\n\n`shallow-backup` lets you easily create lightweight backups of installed packages, applications, fonts and dotfiles, and automatically push them to a remote Git repository.\n\nI use it to manage [my dotfiles](https://github.com/alichtman/dotfiles).\n\n\n\n# Contents\n\n- [Why?](#why)\n- [Installation](#installation)\n - [Method 1: <a href=\"https://pypi.org/project/shallow-backup/\" rel=\"nofollow\">pipx</a>](#method-1-pipx)\n - [Method 2: Install From Source](#method-2-install-from-source)\n- [Dependencies](#dependencies)\n- [Usage](#usage)\n- [Recipes](#recipes)\n - [Maintain a separate repo for your dotfiles](#maintain-a-separate-repo-for-your-dotfiles)\n - [Synchronize dotfiles on multiple computers](#synchronize-dotfiles-on-multiple-computers)\n - [Reinstall dotfiles from a backup](#reinstall-dotfiles-from-a-backup)\n- [What can I back up?](#what-can-i-back-up)\n- [Configuration](#configuration)\n - [Conditional Backup and Reinstallation](#conditional-backup-and-reinstallation)\n- [Git Integration](#git-integration)\n - [A Word of Caution](#a-word-of-caution)\n - [.gitignore](#gitignore)\n- [Output Structure](#output-structure)\n- [Want to Contribute?](#want-to-contribute)\n\n### Why?\n\nI wanted a tool that allows you to:\n\n- Back up dotfiles _from where they live on the system_.\n- Back up files from _any_ path on the system, not just `$HOME`.\n- Reinstall them from the backup directory idempotently.\n- Backup and reinstall files conditionally, so you can easily manage dotfiles across multiple systems.\n- Copy files on installation and backup, as opposed to symlinking them.\n- Backup package installations in a highly compressed manner\n- Not worry about accidentally doing something dangerous / destructive (is user-protective)\n\n`shallow-backup` checks all of those boxes.\n\n### Installation\n\n---\n\n> **Warning**\n> Be careful running this with elevated privileges. Code execution can be achieved with write permissions on the config file.\n\n#### Method 1: [`pipx`](https://pypi.org/project/shallow-backup/)\n\n```bash\n$ pipx install shallow-backup\n```\n\n#### Method 2: Install From Source\n\n```bash\n$ git clone https://www.github.com/alichtman/shallow-backup.git\n$ cd shallow-backup\n$ pip3 install .\n```\n\n### Dependencies\n\n---\n\n- `pre-commit`\n- `trufflehog`\n\nIf you are missing the dependencies, you will be guided to install them.\n\n### Usage\n\n---\n\n- To start the interactive program, run `$ shallow-backup`.\n- To backup your dotfiles, run `$ shallow-backup --backup-dots`.\n\n`shallow-backup` was built with scripting in mind. Every feature that's supported in the interactive program is supported with command line arguments.\n\n```shell\nUsage: shallow-backup [OPTIONS]\n\n Easily back up installed packages, dotfiles, and more.\n You can edit which files are backed up in ~/.shallow-backup.\n\n Written by Aaron Lichtman (@alichtman).\n\nOptions:\n\n --add-dot TEXT Add a dotfile or dotfolder to config by path.\n --backup-all Full back up.\n --backup-configs Back up app config files.\n --backup-dots Back up dotfiles.\n --backup-fonts Back up installed fonts.\n --backup-packages Back up package libraries.\n --delete-config Delete config file.\n --destroy-backup Delete backup directory.\n --dry-run Don't backup or reinstall any files, just give\n verbose output.\n\n --new-path TEXT Input a new back up directory path.\n --no-new-backup-path-prompt Skip setting new back up directory path prompt.\n --no-splash Don't display splash screen.\n --reinstall-all Full reinstallation.\n --reinstall-configs Reinstall configs.\n --reinstall-dots Reinstall dotfiles and dotfolders.\n --reinstall-fonts Reinstall fonts.\n --reinstall-packages Reinstall packages.\n --remote TEXT Set remote URL for the git repo.\n\n --show Display config file.\n -v, --version Display version and author info.\n -h, -help, --help Show this message and exit.\n```\n\n### Recipes\n\n---\n\n#### Maintain a separate repo for your dotfiles\n\n`shallow-backup` makes this easy! After making your first backup, `cd` into the `dotfiles/` directory and run `$ git init`. Create a `.gitignore`, and a create / set up (link the upstream remote, etc) a new repo on your favorite version control platform. With operations involving the parent `shallow-backup` repo, `shallow-backup` will prompt you interactively to update the nested submodule. After that is taken care of, `shallow-backup` will move on to updating the parent. The `dotfiles` repo will be tracked as a submodule.\n\n#### Synchronize dotfiles on multiple computers\n\nRun `shallow-backup --backup-dots` on the first computer. Make a commit and push to the remote. Then pull these changes down on the second computer. Run `shallow-backup --backup-dots` on the second computer, and resolve the merge conflicts. Once you have a final version you're happy with, make a commit, push it, and run `shallow-backup --reinstall-dots`. On the first computer, pull the changes and run `shallow-backup --reinstall-dots`. Your changes are now sync'd across both computers and the remote repository.\n\n#### Reinstall dotfiles from a backup\n\nTo reinstall your dotfiles, clone your dotfiles repo and make sure your shallow-backup config path can be found at either `~/.config/shallow-backup.conf` or `$XDG_CONFIG_HOME/.shallow_backup.conf`. Set the `backup-path` key in the config to the path of your cloned dotfiles. Then run `$ shallow-backup --reinstall-dots`.\n\nWhen reinstalling your dotfiles, the top level `.git/`, `.gitignore`, `img/` and `README.md` files and directories are ignored.\n\n### `zsh` Completions\n\nAvailable in [`zsh-users/zsh-completions`](https://github.com/zsh-users/zsh-completions/blob/master/src/_shallow-backup). Follow the [installation instructions here](https://github.com/zsh-users/zsh-completions/tree/master#using-zsh-frameworks).\n\n### What can I back up?\n\n---\n\nBy default, `shallow-backup` backs these up.\n\n1. Dotfiles and dotfolders\n\n - `.bashrc`\n - `.bash_profile`\n - `.gitconfig`\n - `.pypirc`\n - `.config/shallow-backup.json`\n - `.ssh/`\n - `.vim/`\n - `.zshrc`\n\n2. App Config Files\n\n - VSCode\n - Sublime Text 2/3\n - Terminal.app\n\n3. Installed Packages\n\n - `brew` and `cask`\n - `cargo`\n - `gem`\n - `pip`\n - `pip3`\n - `npm`\n - `macports`\n - `VSCode` Extensions\n - `Sublime Text 2/3` Packages\n - System Applications\n\n4. User installed `fonts`.\n\n### Configuration\n\nIf you'd like to modify which files are backed up, you have to edit the `JSON` config file, located at `~/.config/shallow-backup.json`. There are two ways to do this.\n\n1. Select the appropriate option in the CLI and follow the prompts.\n2. Open the file in a text editor and make your changes.\n\nEditing the file in a text editor will give you more control and be faster.\n\n#### Conditional Backup and Reinstallation\n\n> **Warning**\n> This feature allows code execution (by design). If untrusted users can write to your config, they can achieve code execution next time you invoke `shallow-backup` _backup_ or _reinstall_ functions. Starting in `v5.2`, the config file will have default permissions of `644`, and a warning will be printed if others can write to the config.\n\nEvery key under dotfiles has two optional subkeys: `backup_condition` and `reinstall_condition`. Both of these accept expressions that will be evaluated with `bash`. An empty string (`\"\"`) is the default value, and is considered to be `True`. If the return value of the expression is `0`, this is considered `True`. Otherwise, it is `False`. This lets you do simple things like preventing backup with:\n\n```javascript\n// Because `$ false` returns 1\n\"backup_condition\": \"false\"\n```\n\nAnd also more complicated things like only backing up certain files if an environment variable is set:\n\n```javascript\n\"backup_condition\": \"[[ -n \\\"$ENV_VAR\\\" ]]\"\n```\n\nHere's an example config based on my [dotfiles](https://www.github.com/alichtman/dotfiles):\n\n```json\n{\n\t\"backup_path\": \"~/shallow-backup\",\n\t\"lowest_supported_version\": \"5.0.0a\",\n\t\"dotfiles\": {\n\t\t\".config/agignore\": {\n\t\t\t\"backup_condition\": \"uname -a | grep Darwin\",\n\t\t\t\"reinstall_condition\": \"uname -a | grep Darwin\"\n\t\t},\n\t\t\".config/git/gitignore_global\": { },\n\t\t\".config/jrnl/jrnl.yaml\": { },\n\t\t\".config/kitty\": { },\n\t\t\".config/nvim\": { },\n\t\t\".config/pycodestyle\": { },\n\t\t...\n\t\t\".zshenv\": { }\n\t},\n\t\"root-gitignore\": [\n\t\t\".DS_Store\",\n\t\t\"dotfiles/.config/nvim/.netrwhist\",\n\t\t\"dotfiles/.config/nvim/spell/en.utf-8.add\",\n\t\t\"dotfiles/.config/ranger/plugins/ranger_devicons\",\n\t\t\"dotfiles/.config/zsh/.zcompdump*\",\n\t\t\"dotfiles/.pypirc\",\n\t\t\"dotfiles/.ssh\"\n\t],\n\t\"dotfiles-gitignore\": [\n\t\t\".DS_Store\",\n\t\t\".config/nvim/.netrwhist\",\n\t\t\".config/nvim/spell/en.utf-8.add*\",\n\t\t\".config/ranger/plugins/*\",\n\t\t\".config/zsh/.zcompdump*\",\n\t\t\".config/zsh/.zinit\",\n\t\t\".config/tmux/plugins\",\n\t\t\".config/tmux/resurrect\",\n\t\t\".pypirc\",\n\t\t\".ssh/*\"\n\t],\n\t\"config_mapping\": {\n\t\t\"/Users/alichtman/Library/Application Support/Sublime Text 2\": \"sublime2\",\n\t\t\"/Users/alichtman/Library/Application Support/Sublime Text 3\": \"sublime3\",\n\t\t\"/Users/alichtman/Library/Application Support/Code/User/settings.json\": \"vscode/settings\",\n\t\t\"/Users/alichtman/Library/Application Support/Code/User/Snippets\": \"vscode/Snippets\",\n\t\t\"/Users/alichtman/Library/Application Support/Code/User/keybindings.json\": \"vscode/keybindings\",\n\t\t\"/Users/alichtman/Library/Preferences/com.apple.Terminal.plist\": \"terminal_plist\"\n\t}\n}\n```\n\n### Git Integration\n\n---\n\n#### A Word of Caution\n\nThis backup tool is git-integrated, meaning that you can easily store your backups remotely (on GitHub, for example.) Dotfiles and configuration files may contain sensitive information like API keys and ssh keys, and you don't want to make those public. To make sure no sensitive files are uploaded accidentally, `shallow-backup` creates a `.gitignore` file if it can't find one in the directory. It excludes `.ssh/` and `.pypirc` by default. It's safe to remove these restrictions if you're pushing to a remote private repository, or you're only backing up locally. To do this, you should clear the `.gitignore` file without deleting it.\n\n_If you choose to back up to a public repository, look at every file you're backing up to make sure you want it to be public._\n\n> [!NOTE]\n> As of `v6.2`, `trufflehog` is run as a required precommit hook and will detect secrets.\n\n#### .gitignore\n\nAs of `v4.0`, any `.gitignore` changes should be made in the `shallow-backup` config file. `.gitignore` changes that are meant to apply to all directories should be under the `root-gitignore` key. Dotfile specific gitignores should be placed under the `dotfiles-gitignore` key. The original `default-gitignore` key in the config is still supported for backwards compatibility, however, converting to the new config format is strongly encouraged.\n\n### Output Structure\n\n---\n\n```shell\nshallow_backup/\n\u251c\u2500\u2500 configs\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 plist\n\u2502\u00a0\u00a0 \u2502\u00a0\u00a0 \u2514\u2500\u2500 com.apple.Terminal.plist\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 sublime_2\n\u2502\u00a0\u00a0 \u2502\u00a0\u00a0 \u2514\u2500\u2500 ...\n\u2502\u00a0\u00a0 \u2514\u2500\u2500 sublime_3\n\u2502\u00a0\u00a0 \u2514\u2500\u2500 ...\n\u251c\u2500\u2500 dotfiles\n\u2502 \u251c\u2500\u2500 .bash_profile\n\u2502 \u251c\u2500\u2500 .bashrc\n\u2502 \u251c\u2500\u2500 .gitconfig\n\u2502 \u251c\u2500\u2500 .pypirc\n\u2502 \u251c\u2500\u2500 ...\n\u2502 \u251c\u2500\u2500 shallow-backup.json\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 .ssh/\n\u2502\u00a0\u00a0 \u2502\u00a0\u00a0 \u2514\u2500\u2500 known_hosts\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 .vim/\n\u2502 \u2514\u2500\u2500 .zshrc\n\u251c\u2500\u2500 fonts\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 AllerDisplay.ttf\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 Aller_Bd.ttf\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 ...\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 Ubuntu Mono derivative Powerline Italic.ttf\n\u2502\u00a0\u00a0 \u2514\u2500\u2500 Ubuntu Mono derivative Powerline.ttf\n\u2514\u2500\u2500 packages\n \u251c\u2500\u2500 brew-cask_list.txt\n \u251c\u2500\u2500 brew_list.txt\n \u251c\u2500\u2500 cargo_list.txt\n \u251c\u2500\u2500 gem_list.txt\n \u251c\u2500\u2500 installed_apps_list.txt\n \u251c\u2500\u2500 npm_list.txt\n \u251c\u2500\u2500 macports_list.txt\n \u251c\u2500\u2500 pip_list.txt\n \u2514\u2500\u2500 sublime3_list.txt\n```\n\n### Reinstalling Dotfiles\n\n---\n\nTo reinstall your dotfiles, clone your dotfiles repo and make sure your shallow-backup config path can be found at either `~/.config/shallow-backup.json` or `$XDG_CONFIG_HOME/.shallow_backup.json`. Set the `backup-path` key in the config to the path of your cloned dotfiles. Then run `$ shallow-backup -reinstall-dots`.\n\nWhen reinstalling your dotfiles, the top level `.git/`, `.gitignore`, `img/` and `README.md` files and directories are ignored.\n\n### Want to Contribute?\n\n---\n\nCheck out `CONTRIBUTING.md` and the `docs` directory.\n",
"bugtrack_url": null,
"license": null,
"summary": "Easily create lightweight backups of installed packages, dotfiles, and more.",
"version": "6.4",
"project_urls": {
"Bug Reports": "https://github.com/alichtman/shallow-backup/issues",
"Donations": "https://www.patreon.com/alichtman",
"Homepage": "https://github.com/alichtman/shallow-backup"
},
"split_keywords": [
"backup",
"documentation",
"system",
"dotfiles",
"install",
"list",
"configuration"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "d056427960ea933c35b43b561d8f1379d4f7794b67f785ec3137adaf6ce5073e",
"md5": "750ab3c50246d2c199f61b9063473c72",
"sha256": "b933d19d7238d04eb1bf3943078ee74933dbe6faf2d5b503a865242d0d6bd2e6"
},
"downloads": -1,
"filename": "shallow_backup-6.4.tar.gz",
"has_sig": false,
"md5_digest": "750ab3c50246d2c199f61b9063473c72",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 5459312,
"upload_time": "2024-07-12T02:45:11",
"upload_time_iso_8601": "2024-07-12T02:45:11.623337Z",
"url": "https://files.pythonhosted.org/packages/d0/56/427960ea933c35b43b561d8f1379d4f7794b67f785ec3137adaf6ce5073e/shallow_backup-6.4.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-07-12 02:45:11",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "alichtman",
"github_project": "shallow-backup",
"travis_ci": true,
"coveralls": true,
"github_actions": true,
"requirements": [],
"lcname": "shallow-backup"
}
JSON
