Skip to content

Commit

Permalink
Update README
Browse files Browse the repository at this point in the history
  • Loading branch information
iamluc committed Feb 4, 2016
1 parent 9c8c802 commit 4e34e59
Showing 1 changed file with 44 additions and 11 deletions.
55 changes: 44 additions & 11 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ BUSE

About
-----
buse helps managing and executing git command in several repositories at the same time.
buse helps managing and executing git commands in several git repositories at the same time.

buse is currently 'work in progress'. Command and arguments could change.

Expand Down Expand Up @@ -32,19 +32,12 @@ To have description of a specific command, just type:
$> bin/buse help the_command
```

All commands take as first argument an optional path.
i.e.

```
$> bin/buse status ../other/path
```

## status

Get status of your repositories

```
$> bin/buse status ..
$> bin/buse status
buse: master
repo2: master / not clean (1 staged, 3 modified)
repo3: dev / not synchronized (1 ahead, 1 behind)
Expand All @@ -71,7 +64,7 @@ Note:
- you must write the command after '--'

```
$> bin/buse exec .. -- log --pretty=oneline -1
$> bin/buse exec -- log --pretty=oneline -1
buse:
xxxxxxxxxxxx Last commit message buse
Expand All @@ -86,16 +79,56 @@ xxxxxxxxxxxx Last commit message repo3

Get and create tags.

## clone

Clone repositories. *This command needs a configuration file `.buse.yml`*

## config

Get and set configuration.

To exclude repositories, update your config typing:

```
$> bin/buse config .. "repositories.exclude" "repo1,repo2"
$> bin/buse config "global.ignore_repositories" "repo1,repo2"
```

Configuration
-------------

Buse will check if a file `.buse.yml` exists in the current directory.
Note: You can use the `--config` (ie. `buse status --config ~/my-dir`) option to change the directory of the config file.

A basic `.buse.yml` looks like:
```yaml
global:
ignore_repositories:
- workshop-serializer-todo
- twgit

datatheke:
repositories:
datatheke: '[email protected]:datatheke/datatheke.git'
datatheke-cli: '[email protected]:datatheke/datatheke-cli.git'

buse:
repositories:
buse: '[email protected]:iamluc/buse.git'

other:
repositories:
super-project: ~
```
The `global` section contains the global configuration of buse.

Others sections are called "groups".

If you call buse with the `--group` option (ie. `buse status --group datatheke --group buse`),
the command will be executed only for the repositories defined in the selected groups.

Without any `--group` option, buse will search all git repositories in the working directory.

Build
-----

Expand Down

0 comments on commit 4e34e59

Please sign in to comment.