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 <https://gbasf2.belle2.org/prerequisites.html>`__.
2. Make sure you can access the official repository of `BelleDIRAC <https://stash.desy.de/projects/B2DC/repos/belledirac/browse>`__.
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 <https://agira.desy.de/projects/BIIDCD/issues>`__.
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.

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.