Skip to main content

A tool to backup/restore simple files, e.g. dot files.

Project description

Clibato: CLI Backup Tool

Clibato is a simple backup/restore tool. I created it to backup and restore my .dot files, and to have fun with Python 🐍.

The name Clibato stands for (CLI) (ba)ckup (to)ol.

Quick start

pip install clibato # Installation
clibato init --config=~/.clibato.yml
vim ~/.clibato.yml # Configuration (required)
clibato backup # Perform backup
clibato restore # Restore last backup

Installation

Clibato can easily be installed using pip.

pip install clibato

Once installed, you can run it as clibato or python -m clibato.

Configuration

To use the tool, start by creating a configuration file. The ~/.clibato.yml will automatically be detected so, it is the recommended location. However, you can place your configuration anywhere.

clibato init --config=~/.clibato.yml

The generated file contains comments to help you with the configuration.

Auto-detection

If --config is not specified, the following locations will be searched:

  • The directory from which the command was issued, i.e. ./.clibato.yml.
  • The user's home directory, i.e. ~/.clibato.yml.

If your configuration is not in one of those locations, you can use the --config flag with other clibato commands.

Suggestions

  • Place your config in ~/.clibato.yml.
    • This way, you don't have to specify --config all the time.
  • Include your .clibato.yml in your backup.

Usage

After you've installed and configured the tool, here's how you use it.

Backup

To perform a backup, run the following command:

clibato backup

Restore

To restore the last backup, run the following command:

clibato restore

Examples

For detailed documentation, and more examples, see .clibato.example.yml.

Backup to a directory

contents:
  .bashrc:
  .clibato.yml:
destination:
  type: 'directory'
  path: '~/backup/clibato'

Backup to a Git repository

contents:
  .bashrc:
  .clibato.yml:
destination:
  type: 'repository'
  path: '~/backup/clibato'
  remote: 'git@gitlab.com:jigarius/dotfiles.git'
  branch: 'main'

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

clibato-1.0.1.tar.gz (7.0 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page