Vous avez toujours rêvé de distribuer votre lib Python sur PyPI sans jamais oser le faire ?

Travis-CI, un service bien connu de la communauté open-source, assure l'intégration continue (les tests, le build) de vos projets hébergés sur GitHub. Vous vous en doutez, il est aussi capable de pousser votre lib sur PyPI. Retour d'expérience.

Fordisme 2.0#

Le monde est bien fait, je souhaitais brancher un minuscule projet perso avec Travis. Pour ça, rien de plus simple. Rendez-vous sur travis-ci.org et connectez-vous avec votre compte GitHub.

Depuis la barre latérale de gauche, selectionnez le "+" et laissez vous guider par l'interface.

On est plutôt bien accueilli par ce bandeau sympa qui nous résume les étapes de configuration.

Un clic suffit pour dire à Travis de surveiller notre dépôt; le service récupère automatiquement la liste des dépots de notre compte GitHub.

Revenons un instant au code. On va ajouter un fichier .travis.yml à la racine de notre dépot avec quelques infos dedans :

language: python

python:
  - "3.4"
  - "3.5"
  - "nightly" # currently points to 3.6-dev

# command to install dependencies
install: "pip install -e ."

# command to run tests
script: py.test

On commit/push et... Magie ! Travis se lance dans les tests avec py.test (arme de choix pour les tests en Python !), sur les versions de Python qu'on a renseigné dans le précédent fichier.

Une fois les tests joués, on a un retour clair sur les résultats des tests, un badge pour notre README en bonus et tout ça sans lever le petit doigt.

Une petite envie de PyPI#

Coup de chance, Travis permet de déployer out-of-the-box vers une flopée de services.

Dans notre .travis.yml donc, on va ajouter ce petit bloc pour que Travis déploie notre projet sur PYPI - et uniquement les tags pour éviter de polluer le registre Python :

deploy:
  provider: pypi
  user: $PYPI_USER
  password: $PYPI_PASS
  skip_cleanup: true
  on:
    tag: true
    branch: master
    python: "3.5"

Remarquez qu'on utilise ici deux variables d'environnement définies dans l'interface de Travis; dont l'une est encryptée pour des raisons évidentes :). Le skip_cleanup a toute son importance car c'est grâce à lui qu'on va pouvoir pousser notre package vers PyPI. Enfin, les conditions listés dans on: s'assure que seul les tags sur la branche master construit avec python35 seront publiés sur PyPI.

Hop, commit/push et Travis s'occupe du reste ! Le projet est dispo en quelques instants sur https://pypi.python.org/pypi/vvvv[PyPI] :

Le mot de la fin#

On peut faire travailler un paquet de services pour nous autour de nos dépots pour automatiser pleins d'actions d'intégration différentes. On peut même demander au Hub Docker de construire une image tout seul... Mais ceci est une autre histiore.

En bonus, pensez à ajouter un beau badge au README.md de votre projet pour montrer à tout le monde que votre code est distribué sur PYPI en faisant un tour sur Shields.io.

[![PyPI](https://img.shields.io/pypi/v/vvvv.svg)](https://pypi.python.org/pypi/vvvv)

Quelques liens plus complet :

• http://docs.travis-ci.com/user/languages/python/
• http://docs.travis-ci.com/user/deployment/pypi/
• https://github.com/Djiit/vvvv/ (le projet cobaye)

A bientôt !