| Name | dotbackup JSON |
| Version |
1.2.2
JSON |
| download |
| home_page | None |
| Summary | YAML config based backup utility. Easy to use yet flexible. With a primary focus on dotfile backup & setup, but not limited to dotfiles. |
| upload_time | 2024-11-19 13:28:53 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | >=3.8 |
| license | None |
| keywords |
yaml
backup
dotfiles
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
ruamel.yaml
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# dotbackup
[](https://pypi.org/project/dotbackup)
[](https://pypi.org/project/dotbackup)
[](https://aur.archlinux.org/packages/dotbackup)
[](https://github.com/psf/black)
[](https://github.com/PyCQA/flake8)
[](https://pycqa.github.io/isort)
[](https://pytest.org)
[](https://codecov.io/gh/jaxvanyang/dotbackup)
Usually people maintain backup and setup scripts along with their dotfiles. But
these scripts always contain a lot of repeat codes, and writing them is not fun!
`dotbackup` and `dotsetup` are here to help.
With these two tools, you only need to write a simple configuration and they
will know how to back up and set up your dotfiles. You can read [dotbackup(1)](dotbackup.1.adoc)
and [dotsetup(1)](dotsetup.1.adoc) for details.
## Highlights
- Simple configuration.
- Custom hooks.
- Detailed logs.
## Installation
You can install it from one of these package managers:
- [PyPI](https://pypi.org/project/dotbackup)
- [AUR](https://aur.archlinux.org/packages/dotbackup)
If you are using a Debian-based system, you can install the pre-built deb
package from [the latest release](https://github.com/jaxvanyang/dotbackup/releases/latest).
Installing from a package manager gives you the two commands - `dotbackup` and
`dotsetup`, and the manpages. But you can also download this single script:
[dotbackup.py](./src/dotbackup.py). In fact, `dotbackup` and `dotsetup` are just
shortcut commands of `dotbackup.py`, which means that `dotbackup` is equivalent
to `dotbackup.py backup` and `dotsetup` is equivalent to `dotbackup.py setup`.
## Quick Start
Write a simple configuration and place it to `~/.config/dotbackup/dotbackup.yml`:
```yml
backup_dir: ~/backup
apps:
vim:
files: [~/.vimrc]
nvim:
files:
- ~/.config/nvim/init.lua
- ~/.config/nvim/lua
```
Do backup:
```console
$ dotbackup
INFO: doing vim backup...
INFO: copying ~/.vimrc to /home/user/backup/.vimrc...
INFO: doing nvim backup...
INFO: copying ~/.config/nvim/init.lua to /home/user/backup/.config/nvim/init.lua...
INFO: copying ~/.config/nvim/lua to /home/user/backup/.config/nvim/lua...
```
Do setup:
```console
$ dotsetup
INFO: doing vim setup...
INFO: copying /home/user/backup/.vimrc to /home/user/.vimrc...
INFO: doing nvim setup...
INFO: copying /home/user/backup/.config/nvim/init.lua to /home/user/.config/nvim/init.lua...
INFO: copying /home/user/backup/.config/nvim/lua to /home/user/.config/nvim/lua...
```
## Documentation
For more information, please read [dotbackup(1)](dotbackup.1.adoc) and [dotsetup(1)](dotsetup.1.adoc).
## Show Your Support
If you're using dotbackup, consider adding the badge to your project's `README.md`:
```
[](https://github.com/jaxvanyang/dotbackup)
```
[](https://github.com/jaxvanyang/dotbackup)
Raw data
{
"_id": null,
"home_page": null,
"name": "dotbackup",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "YAML, backup, dotfiles",
"author": null,
"author_email": "Jax Young <jaxvanyang@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/9c/57/8383e558858c93c0163bbfff4fac47d7d7fc6ddb0a8f48fac855b76ed3bd/dotbackup-1.2.2.tar.gz",
"platform": null,
"description": "# dotbackup\n\n\n[](https://pypi.org/project/dotbackup)\n[](https://pypi.org/project/dotbackup)\n[](https://aur.archlinux.org/packages/dotbackup)\n\n[](https://github.com/psf/black)\n[](https://github.com/PyCQA/flake8)\n[](https://pycqa.github.io/isort)\n[](https://pytest.org)\n[](https://codecov.io/gh/jaxvanyang/dotbackup)\n\nUsually people maintain backup and setup scripts along with their dotfiles. But\nthese scripts always contain a lot of repeat codes, and writing them is not fun!\n`dotbackup` and `dotsetup` are here to help.\n\nWith these two tools, you only need to write a simple configuration and they\nwill know how to back up and set up your dotfiles. You can read [dotbackup(1)](dotbackup.1.adoc)\nand [dotsetup(1)](dotsetup.1.adoc) for details.\n\n## Highlights\n\n- Simple configuration.\n- Custom hooks.\n- Detailed logs.\n\n## Installation\n\nYou can install it from one of these package managers:\n\n- [PyPI](https://pypi.org/project/dotbackup)\n- [AUR](https://aur.archlinux.org/packages/dotbackup)\n\nIf you are using a Debian-based system, you can install the pre-built deb\npackage from [the latest release](https://github.com/jaxvanyang/dotbackup/releases/latest).\n\nInstalling from a package manager gives you the two commands - `dotbackup` and\n`dotsetup`, and the manpages. But you can also download this single script:\n[dotbackup.py](./src/dotbackup.py). In fact, `dotbackup` and `dotsetup` are just\nshortcut commands of `dotbackup.py`, which means that `dotbackup` is equivalent\nto `dotbackup.py backup` and `dotsetup` is equivalent to `dotbackup.py setup`.\n\n## Quick Start\n\nWrite a simple configuration and place it to `~/.config/dotbackup/dotbackup.yml`:\n\n```yml\nbackup_dir: ~/backup\napps:\n vim:\n files: [~/.vimrc]\n nvim:\n files:\n - ~/.config/nvim/init.lua\n - ~/.config/nvim/lua\n```\n\nDo backup:\n\n```console\n$ dotbackup\nINFO: doing vim backup...\nINFO: copying ~/.vimrc to /home/user/backup/.vimrc...\nINFO: doing nvim backup...\nINFO: copying ~/.config/nvim/init.lua to /home/user/backup/.config/nvim/init.lua...\nINFO: copying ~/.config/nvim/lua to /home/user/backup/.config/nvim/lua...\n```\n\nDo setup:\n\n```console\n$ dotsetup\nINFO: doing vim setup...\nINFO: copying /home/user/backup/.vimrc to /home/user/.vimrc...\nINFO: doing nvim setup...\nINFO: copying /home/user/backup/.config/nvim/init.lua to /home/user/.config/nvim/init.lua...\nINFO: copying /home/user/backup/.config/nvim/lua to /home/user/.config/nvim/lua...\n```\n\n## Documentation\n\nFor more information, please read [dotbackup(1)](dotbackup.1.adoc) and [dotsetup(1)](dotsetup.1.adoc).\n\n## Show Your Support\n\nIf you're using dotbackup, consider adding the badge to your project's `README.md`:\n\n```\n[](https://github.com/jaxvanyang/dotbackup)\n```\n\n[](https://github.com/jaxvanyang/dotbackup)\n",
"bugtrack_url": null,
"license": null,
"summary": "YAML config based backup utility. Easy to use yet flexible. With a primary focus on dotfile backup & setup, but not limited to dotfiles.",
"version": "1.2.2",
"project_urls": {
"Homepage": "https://github.com/jaxvanyang/dotbackup",
"Issues": "https://github.com/jaxvanyang/dotbackup/issues",
"Repository": "https://github.com/jaxvanyang/dotbackup.git",
"Source": "https://github.com/jaxvanyang/dotbackup"
},
"split_keywords": [
"yaml",
" backup",
" dotfiles"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "1c40e9b4109df368374e0f5a347e415d38efe7998af773e26bb761458e4d6e78",
"md5": "f2fac48d692f51546ec488590e1a3aa3",
"sha256": "ca6528c57f745fdb27cebf5f7457022f7e33ed99631d83a023495f5559707f1a"
},
"downloads": -1,
"filename": "dotbackup-1.2.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "f2fac48d692f51546ec488590e1a3aa3",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 11518,
"upload_time": "2024-11-19T13:28:52",
"upload_time_iso_8601": "2024-11-19T13:28:52.210793Z",
"url": "https://files.pythonhosted.org/packages/1c/40/e9b4109df368374e0f5a347e415d38efe7998af773e26bb761458e4d6e78/dotbackup-1.2.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "9c578383e558858c93c0163bbfff4fac47d7d7fc6ddb0a8f48fac855b76ed3bd",
"md5": "392cbcf63f0c3c9bd91348a6a125905d",
"sha256": "fe951eeb3362df99303d67dc2f07df82d27eed2b2d45f4cad09c65476fac477a"
},
"downloads": -1,
"filename": "dotbackup-1.2.2.tar.gz",
"has_sig": false,
"md5_digest": "392cbcf63f0c3c9bd91348a6a125905d",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 14660,
"upload_time": "2024-11-19T13:28:53",
"upload_time_iso_8601": "2024-11-19T13:28:53.615636Z",
"url": "https://files.pythonhosted.org/packages/9c/57/8383e558858c93c0163bbfff4fac47d7d7fc6ddb0a8f48fac855b76ed3bd/dotbackup-1.2.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-11-19 13:28:53",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "jaxvanyang",
"github_project": "dotbackup",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [
{
"name": "ruamel.yaml",
"specs": []
}
],
"lcname": "dotbackup"
}
