HiHAT Development

HiHAT Development Environment on xstg.modelado.org

Welcome to the development environment for HiHAT. This is a brief tutorial on how to set up a development environment and work with the existing development infrastructure on xstg. There are two HiHAT project repos:

* HiHAT - public repo for community development
* hihat_int - internal repo for special development

This wiki page provides information for working with the public HiHAT git repo intended for community use.

Software Tools

The HiHAT development environment uses the following tools for its Continuous Integration Pipeline:

• git - Git Book
• Gerrit - Gerrit Documentation
• Redmine - Redmine Overview
• OpenLDAP + LAM - LDAP Account Manager (LAM)

Pre-Requisites

• Git is a broadly used open source distributed version control utility. This page assumes you have a working knowledge of git.
• A brief introduction to the Gerrit Web User Interface is provided later in this document. You can use it to perform code reviews, check your submissions, check your permissions and membership, etc. You will need it before you start with git.

Before You Code, Caveats

• Please read the instructions here completely before you get started
• Note that you should not commit a patch to your local tree with a long commit message subject/body. Keep the total shorter than 80 chars and the subject line shorter than 70 characters. Your commit will succeed but your push to the upstream repo will fail with a "commit message length exceeded" error. We can configure this to be more flexible going forward.
• Make sure your xstg account user name and email match what you provide to the commits in your local git tree (configure your git environment correctly)
• Ensure your origin points to the correct repo URL after cloning

  $ git remote -v

Quick Start-Up: Cloning and Submitting Patches Upstream

1. Sync with the xstg team to ensure you have an account in LDAP on xstg.modelado.org
2. Login to XSTG Gerrit with that account. This is a necessary step to push your credentials to Gerrit before you undertake git operations from your client system.
3. Clone the HiHAT git repo on your local system

   $ git clone https://xstg.modelado.org/gerrit/HiHAT

4. In your top level HiHAT git clone directory, move (or use ln -s) the hooks repo to .git

   HiHAT$ mv git-hooks .git/hooks

5. Make your development changes in your git tree, and commit them to your tree via your usual preferred git operations. e.g.:

   $git add .; git commit .

   Note the git commit msg length limitation above in the Caveats section!

6. Push upstream

   git push origin HEAD:refs/for/master

7. Check the Gerrit Web UI to see your patch submission