pybel-git 0.0.1

PyBEL Git utilities

Git and continuous integration tools for PyBEL to assist in curating BEL.

Using GitHub and Travis-CI

To configure Travis-CI to evaluate the BEL files that have changed in the latest commit to a in a GitHub repository on each commit, the following travis.yml file can be used:

sudo: false
cache: pip
language: python
python:
- 3.6
install:
- pip install git+https://github.com/cthoyt/pybel-git
script:
- pybel-git ci

Currently, the build doesn’t use a cached resource file, so this job might take a long time. The travis_wait command can be used so the script reads travis_wait 30 pybel-git ci and the job will be allowed to run for thirty (30) minutes.

An example can be found at https://github.com/cthoyt/pybel-git-test.

Using GitLab with GitLab CI/CD

To configure GitLab CI/CD to evaluate the BEL files that have changed in the latest commit to a GitLab repository, the following .gitlab-ci.yml can be used:

test:
  image: python:3.6
  script:
  - pip install git+https://github.com/cthoyt/pybel-git
  - pybel-git ci

As with GitHub/Travis-CI, this configuration does not use a cached resource file. GitLab CI/CD doesn’t seem to offer a wait time, but it might also not have an issue with timing out, either.

An example can be found at https://gitlab.com/cthoyt/pybel-gitlab-example

Deeper Integration with GitLab

PyBEL-Git contains extra scripts to assist in automatic checking and feedback for projects residing in GitLab that are using the Git Flow workflow of branching and making merge requests.

This script checks each branch, compiles the BEL documents that have changed compared to master, and puts comments on the merge request with the warnings and feedback on the syntactic and semantic correctness of the BEL files.

It can be run with:

pybel-git ci_gitlab \
    --url "https://gitlab.scai.fraunhofer.de"  # the url of the desired gitlab instance \
    --project-id 449  # the gitlab project id, shown at the top of the page for the repository \

This script uses EasyConfig and can also be configured via the environment variables GITLAB_URL, GITLAB_PROJECT_ID, and GITLAB_TOKEN.