Home

Welcome to the pygtftk wiki!

For users

Please look at the git repository.

For developpers

For git hubflow usage see 'https://datasift.github.io/gitflow/GitFlowForGitHub.html'.

Creating a release

Preparing the new release tag on github

Example with release 0.9.0

When everything seems to be ok you can go for a release. Follow these rules.

• Start a new release from develop branch (git hf release start 0.9.0).
• Ensure you have all python packages required for developement pip install "pygtftk[dev]"
• Try installing the current version make install
• type make release VER=x.x.x
• type make release_bump VER=x.x.x
• type make release_test and check the tests.
• type make release_nose and check the tests.
• type make release_doc and check the doc.
• Under OSX, check this release is pypiable.
  • rm -rf dist; python setup.py bdist_wheel
  • try to install the package using pip install dist/pygtftk-....whl
• Publish the release to master using git hf release finish x.x.x
• On the github page. Delete the tag.
• Create the tag through the gitub interface.

Creating Pypi/manylinux compliant packages for Linux

Simply type:

• type make release_pip_unix and check the log in the wheels directory and the version.
• type make release_pip_osx. Check the version.
• Upload the package on Pypi using twine upload wheelhouse_manylinux

Creating conda build

The sha256 needs to be computed from the archive available from github using:

• openssl sha256 pygtftk-0.9.10.tar.gz

Change the sha256 in the meta.yaml, add, push.

• For UNIX:

  • docker pull bioconda/bioconda-utils-build-env
  • docker run -i -t afaba8d50ce4 /bin/bash
  • mkdir -p /io & cd /io
  • git clone https://github.com/dputhier/pygtftk.git .
  • cd conda & conda-build .

• Under OSX do:

  • Go to the conda folder and conda-build --python=3.6 .

Hotfix

A special case of branch starting from master with modifications not to be directly included in develop branch (but upon merge with master).

• git hf hotfix start "x.x.x"
• git hf hotfix finish "x.x.x"

Merge if required and type:

• git push origin:hotfix/x.x.x
• git push origin "x.x.x"