Development Setup

Before starting a development task, make sure you have completed each of the following steps.

  1. Fulfill the prerequisites for using the Belle II grid according to the instructions on the prerequisites page.

  2. Make sure you can access the official repository of BelleDIRAC.

  3. Fork the official repository in your stash account. Don’t forget to enable fork sync!

  4. For each development task, create a JIRA ticket in the BIIDCD Project.

  5. When your JIRA ticket is ready click on ‘Create branch’ and fill the following details:

    • Repository: Choose the forked repo you created in step 3.

    • Branch Type: Choose the approriate type, such as Bugfix, Feature, or Custom.

    • Branch From: Most of the time this willl be the master branch.

    • Branch name: This should start with the ticket number (BIIDCD-xxxx) and include a short, but descriptive, name.

For just working through the documentation, you can skip step 4 and 5.

Setup

If you want to work with the production BelleDIRAC, install the BelleDIRAC Client:

mkdir gbasf2dev && cd gbasf2dev
wget -N http://dirac.cc.kek.jp/dirac/dirac-install.py
python dirac-install.py -V Belle-KEK
source bashrc && dirac-proxy-init -x -N
dirac-configure defaults-Belle-KEK.cfg

This will create a directory that contains a folder named “BelleDIRAC”, which is the production repo. Next, change the BelleDIRAC directory to that you have forked in your stash space:

rm -rf BelleDIRAC/
git clone ssh://git@stash.desy.de:7999/~<username>/belledirac.git
mv belledirac BelleDIRAC

Then you can check out the branch that you created in step 5:

cd BelleDIRAC
git checkout -b <branch name>

Now you are ready to start the actual coding.