Horde Git Tools

Toolchain for dealing with the split repository structure of Horde

Installation

Use Composer for dependency management. For instructions how to install Composer, see https://getcomposer.org/download/.

Make sure to install Composer version 1.x as Composer version 2 dropped PEAR support.

Hint:

php composer-setup.php --1

Then clone this repository and install the dependencies. If you are developing horde and using PHP 8, you need to set the flag --ignore-platform-reqs.

git clone https://github.com/horde/git-tools.git horde-git-tools
cd horde-git-tools
composer.phar install

Configuration

The main configuration is done in the horde-git-tools/config/ directory:

cp config/conf.php.dist config/conf.php

Then review config/conf.php and set values accordingly.

Per-directory configurations are possible too. Just add a .horde-git-tools.php file in the base directory of a (planned) Git checkout and set any configuration items there that you like to overwrite from the default global configuration. E.g. to use a different webroot to run different Horde versions in parallel:

<?php
// Secondary directory for git checkouts.
$conf['git_base'] = '/home/user/horde5';

// Secondary target webroot for the installation.
$conf['web_base'] = '/var/www/horde5';

Usage

Also see the --help text.

# The horde-git-tools command can be found at the horde-git-tools/bin directory.

# Options can also be given on command line. See usage for information.
horde-git-tools --help

# Clones all repositories locally to the configured git_base directory.
horde-git-tools git clone

# Links (or copies) to a web accessible directory (replacement for old
# install_dev script).
horde-git-tools dev install

# List available repositories on remote.
# Providing the --verbose flag will output full response from GitHub.
horde-git-tools --verbose git list

# Attempt to checkout a specific branch on all repositories.
horde-git-tools git checkout FRAMEWORK_5_2

# Attempt to git pull --rebase all repositories.
# Still need to add options like ability to ensure repo is on a specific
# branch before pulling, option to automatically stash/pop if repository is
# not clean etc...
horde-git-tools git pull

# Attempt to perform arbitrary git command on all repositories.
horde-git-tools git run "reset HEAD"

# Do the same, but only for imp and ansel.
horde-git-tools git run --repositories=imp,ansel "reset HEAD"

# Report on status of each repository.
# Still need to tweak and add options, better display etc...
horde-git-tools git status

# Perform a "component" action
horde-git-tools component /path/to/repository update
horde-git-tools component /path/to/repository changed '[mjr] Some change'
horde-git-tools component /path/to/repository release

Still to do

• Create install action that will perform a full pear install of the webmail or groupware bundle (or optionally a specified list of applications).