This repository contains a collection of of curated genomics tools and workflows. For more information about the project and instructions on how to use the tools, see the project wiki.
The source code is hosted on https://gitlab.com/gfanz/genomics-tools and a copy is kept in github.com for convenience. Please submit merge requests via GitLab.
If you are not familiar with git, please check the dedicated wiki page: https://gitlab.com/gfanz/genomics-tools/wikis/Git-basic
Thank you for contributing. Please read tools/README.md
for more information on the conventions and
structure required to add a tool to the repository.
- Clone the repository:
git clone [email protected]:gfanz/genomics-tools.git
- Change directory to the cloned repository:
cd genomics-tools
- Create a new branch:
git checkout -b [your-branch-name]
- Create a new directory with your tool name.
- Copy the contents of the template tool directory into the directory you just created.
- Use your favourite code editor to propose your changes
- Commit when done:
git add . && git commit
- Push changes back to Gitlab:
git push --set-upstream origin [your-branch-name]
- Confirm at https://gitlab.com/gfanz/genomics-tools/pipelines that the continuous integration tests passed for the changes you did
- Go to https://gitlab.com/gfanz/genomics-tools/merge_requests and click on
Create merge request
(blue button on the top right) - On the next page click on
Submit merge request
(green button at the bottom of the page) - Once the change has been accepted and merged by reviewer, clean up the local repository by:
- Change to the master branch:
git checkout master
- Fetch the remote, bringing the branches and their commits from the remote repository. The -p, --prune option deletes any remote-tracking references that no longer exist in the remote:
git fetch -p origin
- Merge the changes from origin/master into your local master branch. This brings your master branch in sync with the remote repository, without losing your local changes. If your local branch didn't have any unique commits, Git will instead perform a "fast-forward".
git merge origin/master
- Remove your working branch:
git branch -d [your-branch-name]
- Change to the master branch:
- Go to https://gitlab.com/gfanz/genomics-tools/merge_requests, find out the merge request to review and click on it
- Check the results of the tests:
- If the tests have failed, click on
Close merge request
(orange button on top right) and wait until the researcher can pass all tests - If the tests have succeeded:
- Review the code change by clicking on the
Changes
tab at the bottom of the page - If you are happy with the changes proposed, check the
Delete source branch
box and click on theMerge
button
- Review the code change by clicking on the
- If the tests have failed, click on