virtualenv --system-site-packages

[davin.git] / ateliers / debian-python-virtualenv / mtlpy-workshop-debian-dev-env-fr.ipynb

{
 "metadata": {
  "name": ""
 },
 "nbformat": 3,
 "nbformat_minor": 0,
 "worksheets": [
  {
   "cells": [
    {
     "cell_type": "markdown",
     "metadata": {},
     "source": [
      "# Debian + Python + virtualenv\n",
      "\n",
      "Debian + Python (+ virtualenv) = \u2661\n",
      "\n",
      "## Introduction\n",
      "\n",
      "Pr\u00e9requis\n",
      "\n",
      "* Avoir install\u00e9 une distribution Linux bas\u00e9e sur Debian\n",
      "* \u00catre administrateur du syst\u00e8me (\u00eatre sudoer)\n",
      "\n",
      "Objectifs\n",
      "\n",
      "* Installer les paquets Debian essentiels pour le d\u00e9veloppement Python\n",
      "* S'initier aux environnements virtuels Python \n",
      "\n",
      "## Environnement de d\u00e9veloppement Python sur une Linux bas\u00e9e Debian\n",
      "\n",
      "### Python\n",
      "\n",
      "Python est d\u00e9j\u00e0 install\u00e9 par d\u00e9faut... c'est bien!\n",
      "\n",
      "* Lancer un terminal<pre>\n",
      "$\n",
      "</pre>\n",
      "\n",
      "* Lancer Python<pre>\n",
      "$ python\n",
      "</pre>\n",
      "\n",
      "* Identifier la version par d\u00e9faut de Python<pre>\n",
      "$ python\n",
      "Python 2.7.3 (default, Jan  2 2013, 16:53:07) \n",
      "[GCC 4.7.2] on linux2\n",
      "Type \"help\", \"copyright\", \"credits\" or \"license\" for more information.\n",
      "<<<\n",
      "</pre>\n",
      "\n",
      "* Coder un truc<pre>\n",
      "<<< print \"Hello World!\"\n",
      "Hello World!\n",
      "</pre>\n",
      "\n",
      "* Dans la vraie vie on \u00e9crit des scripts... donc il faut installer au moins un \u00e9diteur de texte... mais rendu l\u00e0, on va se monter un environnement de d\u00e9veloppement complet\n",
      "\n",
      "### Debian : installer un paquet Debian\n",
      "\n",
      "Comment trouver un paquet\n",
      "\n",
      "* Web : tous les paquets : [http://packages.debian.org/fr/stable/allpackages](http://packages.debian.org/fr/stable/allpackages)\n",
      "* Web : tous les paquets par cat\u00e9gorie : [http://packages.debian.org/fr/stable/](http://packages.debian.org/fr/stable/)\n",
      "* Web : paquets Python : [http://packages.debian.org/fr/stable/python/](http://packages.debian.org/fr/stable/python/)\n",
      "\n",
      "Comment installer (mettre \u00e0 jour et supprimer) un paquet\n",
      "\n",
      "* Mode graphique : o\u00f9 aller<pre>\n",
      "Applications > Outils syst\u00e8me > Ajouter/supprimer des logiciels\n",
      "</pre>\n",
      "* Ligne de commande : voici la commande<br />\n",
      "(remplacer \"package-name\" avec le nom du paquet que vous voulez installer/mettre \u00e0 jour/supprimer)\n",
      "<pre>\n",
      "$ sudo apt-get install package-name\n",
      "</pre>\n",
      "<pre>\n",
      "$ sudo apt-get update package-name\n",
      "</pre>\n",
      "<pre>\n",
      "$ sudo apt-get remove package-name\n",
      "</pre>\n",
      "\n",
      "### \u00c9diteur texte\n",
      "\n",
      "Un \u00e9diteur pour \u00e9crire des scripts...<br />\n",
      "[http://packages.debian.org/fr/stable/editors/](http://packages.debian.org/fr/stable/editors/)\n",
      "\n",
      "* Mode graphique : gedit est d\u00e9j\u00e0 l\u00e0\n",
      "* Ligne de commande : emacs, vim, nano\n",
      "* Quel choisir? une question de go\u00fbt\n",
      "* Utile : coloration syntaxique, indentation en bloc, auto-compl\u00e9tion, masquer/afficher bloc de code...\n",
      "* Paquets Debian = \n",
      "<pre>\n",
      "$ sudo apt-get install emacs<br />\n",
      "$ sudo apt-get install vim<br />\n",
      "$ sudo apt-get install nano\n",
      "</pre>\n",
      "\n",
      "### Python : interpr\u00e9teur Python\n",
      "\n",
      "Interpr\u00e9teur Python d\u00e9j\u00e0 l\u00e0, mais pourquoi ne pas aller plus loin?\n",
      "\n",
      "* IPython : interpr\u00e9teur interactif<br />\n",
      "pourquoi IPython?\n",
      "* IPython notebook : pourrait \u00eatre utile pour les futurs ateliers de formation :)\n",
      "* Paquets Debian = \n",
      "<pre>\n",
      "$ sudo apt-get install ipython<br />\n",
      "$ sudo apt-get install ipython-notebook\n",
      "</pre>\n",
      "\n",
      "### Gestion des versions\n",
      "\n",
      "S'outiller pour suivre l'historique des versions de son code\n",
      "\n",
      "* Pourquoi g\u00e9rer les versions du code source?\n",
      "* Quel choisir? git, mercurial...\n",
      "* Paquets Debian = \n",
      "<pre>\n",
      "$ sudo apt-get install git<br />\n",
      "$ sudo apt-get install gitk<br />\n",
      "$ sudo apt-get install mercurial\n",
      "</pre>\n",
      "\n",
      "### Extensions Python\n",
      "\n",
      "* Les extensions Python \u00e9crites dans d'autres langages pourraient \u00eatre n\u00e9cessaires, donc il nous faut des outils pour pouvoir les compiler<br />\n",
      "ex.: gcc, pil...\n",
      "* build-essentials, python-dev (sources de Python)\n",
      "* Paquets Debian = \n",
      "<pre>\n",
      "$ sudo apt-get install build-essential<br />\n",
      "$ sudo apt-get install python-dev\n",
      "</pre>\n",
      "\n",
      "### Environnements virtuels\n",
      "\n",
      "* Pour installer des logiciels seulement au niveau projet\n",
      "* virtualenv\n",
      "* Paquet Debian = \n",
      "<pre>\n",
      "$ sudo apt-get install python-virtualenv\n",
      "</pre>\n",
      "\n",
      "### Outils Python offerts en paquet Debian\n",
      "\n",
      "Science\n",
      "\n",
      "* matplotlib, numpy\n",
      "* Pour quoi?\n",
      "* Paquets Debian =\n",
      "<pre>\n",
      "$ sudo apt-get install python-matplotlib<br />\n",
      "$ sudo apt-get install python-numpy\n",
      "</pre>\n",
      "\n",
      "Frameworks web\n",
      "\n",
      "* Django, Pyramid\n",
      "* Pour quoi? Quel choisir?\n",
      "* Paquets Debian =\n",
      "<pre>\n",
      "$ sudo apt-get install python-django<br />\n",
      "$ sudo apt-get install python-pyramid\n",
      "</pre>\n",
      "\n",
      "Pilotes de base de donn\u00e9es\n",
      "\n",
      "* mysqldb, psycopg, sqlalchemy\n",
      "* Pour quoi? Quel choisir?\n",
      "* Paquets Debian =\n",
      "<pre>\n",
      "$ sudo apt-get install python-mysqldb<br />\n",
      "$ sudo apt-get install python-psycopg2<br />\n",
      "$ sudo apt-get install python-sqlalchemy\n",
      "</pre>\n",
      "\n",
      "## Environnements virtuels Python\n",
      "\n",
      "Logiciels install\u00e9s au niveau syst\u00e8me (system-wide) vs install\u00e9s au niveau projet (project-wide)\n",
      "\n",
      "* Niveau syst\u00e8me : pour tous les projets, via paquets Debian (pourrait n\u00e9cessiter \"sudo\")\n",
      "* Niveau projet : propre au projet, via paquets Python dans un environnement virtuel Python, permet utilisation d'une version sp\u00e9cifique\n",
      "\n",
      "## Virtualenv\n",
      "\n",
      "[http://www.virtualenv.org](http://www.virtualenv.org)\n",
      "\n",
      "Cr\u00e9er un environnement virtuel Python\n",
      "\n",
      "* qui s'ajoute \u00e0 celui du syst\u00e8me\n",
      "<pre>\n",
      "$ virtualenv --system-site-packages env\n",
      "</pre>\n",
      "\n",
      "* compl\u00e8tement isol\u00e9 du syst\u00e8me\n",
      "<pre>\n",
      "$ virtualenv --no-site-packages env\n",
      "</pre>\n",
      "\n",
      "* instance locale de Python dans l'environnement virtuel\n",
      "\n",
      "* supprimer le distribute.tar.gz si ajout\u00e9 par virtualenv, ex.:\n",
      "<pre>\n",
      "$ rm distribute-0.6.10.tar.gz\n",
      "</pre>\n",
      "\n",
      "Supprimer un environnement virtuel Python\n",
      "\n",
      "* simplement supprimer le r\u00e9pertoire cr\u00e9\u00e9\n",
      "<pre>\n",
      "$ rm -r env\n",
      "</pre>\n",
      "\n",
      "Utiliser un environnement virtuel Python\n",
      "\n",
      "* activer l'environnement virtuel Python\n",
      "<pre>\n",
      "$ source env/bin/activate\n",
      "</pre>\n",
      "\n",
      "* installer, mettre \u00e0 jour ou d\u00e9sintaller des paquets Python avec pip\n",
      "\n",
      "* d\u00e9sactiver l'environnement virtuel Python\n",
      "<pre>\n",
      "(env)$ deactivate\n",
      "</pre>\n",
      "\n",
      "## pip\n",
      "\n",
      "[http://www.pip-installer.org](http://www.pip-installer.org)\n",
      "\n",
      "Installer et g\u00e9rer les paquets Python.\n",
      "\n",
      "* trouver les paquets \u00e0 installer : pypi<br />\n",
      "[https://pypi.python.org](https://pypi.python.org)<br />\n",
      "Exemple :<br />\n",
      "ipython : [https://pypi.python.org/pypi/ipython/1.0.0](https://pypi.python.org/pypi/ipython/1.0.0)\n",
      "* cr\u00e9er un fichier requirements.txt dans votre projet\n",
      "* ajouter un paquet requis par ligne (avec les versions autoris\u00e9es)<br />\n",
      "[http://www.pip-installer.org/en/latest/cookbook.html#requirements-files](http://www.pip-installer.org/en/latest/cookbook.html#requirements-files)<br />\n",
      "Exemple :\n",
      "<pre>\n",
      "ipython == 1.0.0\n",
      "</pre>\n",
      "\n",
      "* installer avec pip\n",
      "<pre>\n",
      "(env)$ pip install -r requirements.txt\n",
      "</pre>\n",
      "\n",
      "* voir les versions des paquets Python accessibles au projet\n",
      "<pre>\n",
      "(env)$ pip freeze\n",
      "</pre>\n",
      "\n",
      "* utiliser les paquets<br />\n",
      "Exemple :\n",
      "<pre>\n",
      "(env)$ ipython<br />\n",
      "(env)$ ipython notebook\n",
      "</pre>\n",
      "\n",
      "* ajouter autres d\u00e9pendances au besoin et les installer\n",
      "\n",
      "* supprimer des d\u00e9pendances\n",
      "<pre>\n",
      "(env)$ pip uninstall ipython\n",
      "</pre>\n",
      "\n",
      "\n",
      "## Conclusion\n",
      "\n",
      "Eh bien...\n",
      "\n",
      "* Pas besoin de grand chose\n",
      "* Tout est l\u00e0 dans Debian\n",
      "* On contr\u00f4le et comprend son environnement de d\u00e9veloppement avec virtualenv et pip\n",
      "* C'est simple et l'fun!\n",
      "\n",
      "## En suite?\n",
      "\n",
      "Pour aller plus loin :\n",
      "\n",
      "* paquets Debian pour Python : [http://packages.debian.org/fr/stable/python/](http://packages.debian.org/fr/stable/python/)\n",
      "\n",
      "* paquets Python : [https://pypi.python.org](https://pypi.python.org)\n",
      "\n",
      "* virtualenv : [http://www.virtualenv.org](http://www.virtualenv.org)\n",
      "\n",
      "* pip : [http://www.pip-installer.org](http://www.pip-installer.org)\n"
     ]
    }
   ],
   "metadata": {}
  }
 ]
}