iamluc/buse

Execute git command in several repositories

BUSE

About

buse helps managing and executing git commands in several git repositories at the same time., _(*1)

buse is currently 'work in progress'. Command and arguments could change., _(*2)

Install

git clone https://github.com/iamluc/buse.git
cd buse
composer install

Use

bin/buse

# or if you have build the phar (see build section)
bin/buse.phar

It should display the help message. To have description of a specific command, just type:, _(*3)

$> bin/buse help the_command

status

Get status of your repositories, _(*4)

$> bin/buse status
buse: master                                                                                                                     
repo2: master / not clean (1 staged, 3 modified)
repo3: dev / not synchronized (1 ahead, 1 behind)

fetch

Fetch your repositories., _(*5)

pull

Pull your repositories., _(*6)

push

Push your repositories., _(*7)

git

Execute a git command in your repositories., _(*8)

Note: - 'git' must not be included in the command - you must write the command after '--', _(*9)

$> bin/buse git -- log --pretty=oneline -1
buse:
xxxxxxxxxxxx Last commit message buse

repo2:
xxxxxxxxxxxx Last commit message repo2

repo3:
xxxxxxxxxxxx Last commit message repo3

exec

Execute a command in your repositories., _(*10)

Note: - you must write the command after '--', _(*11)

$> bin/buse exec -- composer install
buse: | Loading composer repositories with package information

tag

Get and create tags., _(*12)

clone

Clone repositories. This command needs a configuration file .buse.yml, _(*13)

config

Get and set configuration., _(*14)

To exclude repositories, update your config typing:, _(*15)

$> 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., _(*16)

A basic .buse.yml looks like:, _(*17)

global:
    ignore_repositories:
        - workshop-serializer-todo
        - twgit

datatheke:
    repositories:
        datatheke: 'git@github.com:datatheke/datatheke.git'
        datatheke-cli: 'git@github.com:datatheke/datatheke-cli.git'

buse:
    repositories:
        buse: 'git@github.com:iamluc/buse.git'

other:
    repositories:
        super-project: ~

The global section contains the global configuration of buse., _(*18)

Others sections are called "groups"., _(*19)

If there are "groups" defined in the config file, buse will execute the command for all repositories defined in groups., _(*20)

But if buse is called 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., _(*21)

Without any "groups" found, buse will search for all git repositories in the working directory., _(*22)

Even with "groups" in the config file, you can force the search mode using the --no-group option., _(*23)

Build

composer install --no-dev
bin/compile