Getting Started¶
To develop for quickBayes you will need to clone the github repository git clone https://github.com/ISISNeutronMuon/quickBayes.git.
This will place you onto the main branch.
If you want to make changes then you will need to create a branch by using the command git checkout --no-track -b <branch name> origin/main.
You can then add your changes to this branch and once it is ready to be merged into main, you create a pull request (PR) for review.
To reduce the chances of problems; Conda (alternatively you can use mamba) is used to manage the setup of the development environment (it is also used for the continuous integration).
To setup the developer’s environment use the command conda env create -f quickBayes-dev.yml (this will use the latest supported Python version).
If you want to use a different Python version, then you will need to use the command python tools/create_conda_yml.py <OS> <version> first.
This will then generate a new quickBayes-dev.yml.
After creating the conda environment you will need to use the command conda activate quickBayes-dev to get access to the environment.
This guarantees that your setup is correct and it is isolated from the rest of your machine (i.e. changes here wont break any of your other software).
To reduce wasted time this environment uses pre-commit to make sure that the code being committed meets a minimum standard (flake8).
However, some setup is required.
In your conda environment enter conda update pre-commit and once its complete type pre-commit install.
This will create a bash file that will produce an error when you try to use it (known issue for Windows).
To exit your conda environment type conda deactivate into the terminal.
Then you can reset your environment (but it keeps the bash file) with conda env update --file quickBayes-dev.yml --prune.
Once this is complete you will be able to use pre-commit.
To build your local version use python -m pip install -v -e ., the full stop is important.
To run all of the tests locally use python -m pytest