Baller

Note: This project is no longer maintained.

Baller organizes your configuration files.

Use Baller to create a "ball" for your configuration files. Once you've created a ball for your configuration files, it's easy to install and update them across multiple computers.

Balls contain:

• A files subdirectory containing configuration files
• Scripts to manage the configuration files: install to home directory, update to the latest changes, uninstall from home directory
• A hooks directory of optional scripts that will be called before/after corresponding ball scripts (e.g., pre-install, post-update)
• A README.md file documenting how to use the ball

For a more detailed example, see an existing ball.

Balls require a Bash environment with git installed.

Install Baller

$ npm install -g baller

Create a Ball

There are two ways to create a ball: Create from scratch, or create from existing files. To create a new ball in a new directory:

$ baller create <name>

This will create a new directory with a README and all of the Baller scripts. The Baller scripts will have no effect, however, until files are added to the files subdirectory.

Alternatively, a ball can be created from an existing directory which will be functional immediately:

$ baller init

This adds a README and the Baller scripts to the current directory and also adds an entry to each of the initial files to files.

Destroy a Ball

Remove all Baller-introduced files and structure from current ball:

$ baller destroy

Development

Test

$ npm test

Deploy

• Bump version in package.json
• $ npm publish