Mettre en place son environnement de travail
=============================================

un framework de développement intégré : :term:`IDLE`

.. glossary::

    IDLE
        IDLE_ est un IDE (environnement de développement intégré) mis à disposition
        dans la :term:`librairie standard` de python

.. _IDLE: http://docs.python.org/2/library/idle.html

.. glossary::

    librairie standard

        Une des règles de base de python est qu'il existe certainement une manière
        conseillé de faire une tâche en python. Le premier réflexe est d'aller
        voir dans la `librairie standard`_

.. _`librairie standard`: http://docs.python.org/2.7/library/index.html

Premier réflexe : la doc en ligne ou bien installée sur votre disque dur.

la page d'accueil de la doc officielle python :

.. image:: images/DocPython.png

et surtout, une fois la librairie standard abordée, la page d'index des
modules :

.. image:: images/ModuleIndex.png

configurer son éditeur
----------------------

- les fichiers sources ont l'extenstion `.py`
- une instruction par ligne
- les blocs sont marqués par l'indentation (utilser 4 espaces), règler
  l'éditeur pour transformer les tabulations en espaces

configurer son prompt python
-------------------------------

.. envvar:: PYTHONPATH

    pointe par défaut sur le répertoire courant, il est possible d'ajouter
    un path

à mettre dans votre `.bashrc` :

::

    export PYTHONPATH:`pwd`

    export PYTHONPATH=$PYTHONPATH:'/usr/share':'/toto/titi/tata'

    alias pyenv='export PYTHONPATH=`pwd`:$PYTHONPATH'

    export PYTHONSTARTUP='/home/gwen/.pystartup'

.. envvar:: PYTHONSTARTUP

    les trucs à mettre dans vos pytstartups (comme dans vos .bashrc)

    - autocomplétion
    - affichage de l'historique

exemple de `.pystartup`

à télécharger ici : :download:`snippets/pystartup`

::

    # Store the file in ~/.pystartup, and set an environment variable to point to
    # it, e.g. "export PYTHONSTARTUP=/max/home/itamar/.pystartup" in bash.
    #
    # Note that PYTHONSTARTUP does *not* expand "~", so you have to put in the full
    # path to your home directory.
    import rlcompleter
    import readline
    readline.parse_and_bind("tab: complete")

    import os
    histfile = os.path.join(os.environ["HOME"], ".pyhist")
    try:
        readline.read_history_file(histfile)
    except IOError:
        pass

    import atexit
    atexit.register(readline.write_history_file, histfile)
    del os, histfile

    # enhanced completion
    #import rlcompleter2
    #rlcompleter2.setup()