# Premiers pas

Nous allons maintenant voir comment exécuter le traditionnel programme « Hello World » en Python. Cela vous apprendra comment écrire, enregistrer et exécuter un programme en Python.

Il y a deux façons d'utiliser Python pour lancer votre programme - utiliser l'interpréteur interactif ou un fichier source. Nous allons maintenant voir comment utiliser ces deux méthodes.

## Utiliser l'interpréteur interactif

Démarrez l'interpréteur interactif en entrant `python` dans l'invite de commande.

Pour les utilisateurs Windows, vous pouvez lancer l'interpréteur interactif si vous avez modifié la variable `PATH` correctement.

Ouvrez le terminal de votre système d'exploitation (comme indiqué précédemment dans le chapitre [Installation](/byte-of-python/a-byte-of-python/installation.md#installation)), puis ouvrez interpréteur interactif Python en tapant `python3` et en appuyant sur la touche `[Entrée]`.

Une fois que vous avez démarré Python, vous devriez voir `>>>` où vous pouvez commencer à taper des choses. Ceci s'appelle l'*invite de l'interpréteur Python*.

A l'invite de l'interpréteur Python, tapez:

```python
print("Hello World")
```

suivi de la touche `[Entrée]`. Vous devriez voir les mots `Hello World` imprimés à l'écran.

Voici un exemple de ce que vous devriez voir lorsque vous utilisez un ordinateur Mac OS X. Les détails concernant le logiciel Python varieront en fonction de votre ordinateur, mais la partie à partir de l'invite (c'est-à-dire à partir de `>>>`) devrait être la même quel que soit le système d'exploitation.

```python
$ python3
Python 3.6.0 (default, Jan 12 2017, 11:26:36)
[GCC 4.2.1 Compatible Apple LLVM 8.0.0 (clang-800.0.38)] on darwin
Type "help", "copyright", "credits" or "license" for more information.
>>> print("Hello World")
Hello World
```

Notez que Python vous donne la sortie de la ligne immédiatement! Ce que vous venez de saisir est une seule *instruction* Python. Nous utilisons `print` pour (sans surprise) imprimer toute valeur que nous lui fournissons. Ici, nous fournissons le texte `Hello World` et celui-ci est rapidement imprimé à l'écran.

### Comment quitter l'interpréteur interactif

Si vous utilisez un terminal GNU/Linux ou OS X, vous pouvez quitter interpréteur interactif en appuyant sur `[Ctrl + d]` ou en entrant `exit ()` (note: n'oubliez pas d'inclure les parenthèses, `()`), puis en appuyant sur `[Entrée]`.

Si vous utilisez l'invite de commande Windows, appuyez sur les touches `[Ctrl + z]` puis sur `[Entrée]`.

## Choisir un éditeur

Nous ne pouvons pas taper nos programmes dans l'interpréteur interactif à chaque fois que nous voulons exécuter quelque chose. Nous devons donc les enregistrer dans des fichiers et pouvoir exécuter nos programmes autant de fois que nécessaire.

Pour créer nos fichiers source Python, nous avons besoin d’un logiciel d’édition où vous pouvez taper et enregistrer. Un bon éditeur de programmeur vous facilitera la tâche d'écrire les fichiers source. Par conséquent, le choix d'un éditeur est crucial. Vous devez choisir un éditeur comme vous choisiriez une voiture que vous achèteriez. Un bon éditeur vous aidera à écrire facilement des programmes Python, ce qui rendra votre voyage plus confortable et vous aidera à atteindre votre destination de manière beaucoup plus rapide et plus sûre.

Une des exigences de base est la *coloration syntaxique*, où toutes les différentes parties de votre programme Python sont colorisées afin que vous puissiez *voir* votre programme et visualiser son exécution.

Si vous ne savez pas par où commencer, je vous recommanderais d'utiliser le logiciel [PyCharm Educational Edition](https://www.jetbrains.com/pycharm-edu/) disponible sous Windows, Mac OS X et GNU/Linux. Détails dans la section suivante.

Si vous utilisez Windows, *n'utilisez pas Notepad*. C'est un mauvais choix car il ne dispose pas de coloration syntaxique et, surtout, il ne prend pas en charge l'indentation du texte, ce qui est très important dans notre cas, comme nous le verrons plus tard. Les bons éditeurs le feront automatiquement.

Si vous êtes un programmeur expérimenté, vous devez déjà utiliser [Vim](http://www.vim.org) ou [Emacs](http://www.gnu.org/software/emacs/). Il va sans dire que ce sont deux des éditeurs les plus puissants et qu’il vous sera utile de les utiliser pour écrire vos programmes Python. Personnellement, j'utilise les deux pour la plupart de mes programmes et j'ai même écrit un [livre entier sur Vim](https://vim.swaroopch.com/).

Si vous êtes prêt à consacrer du temps à apprendre Vim ou Emacs, je vous recommande fortement d'apprendre à les utiliser, car cela vous sera très utile à long terme. Cependant, comme je l’ai déjà mentionné, les débutants peuvent commencer par PyCharm et se concentrer sur l’apprentissage en Python plutôt que sur celui de leur éditeur en ce moment.

Pour réitérer, choisissez un éditeur approprié. L'écriture de programmes Python en sera d'autant plus amusante et plus facile.

Si vous êtes intéressé par une discussion détaillée sur ce sujet, consultez [Finding the Perfect Python Code Editor](https://realpython.com/courses/finding-perfect-python-code-editor/).

## PyCharm <a href="#pycharm" id="pycharm"></a>

[PyCharm Educational Edition](https://www.jetbrains.com/pycharm-edu/) est un éditeur gratuit que vous pouvez utiliser pour écrire des programmes Python.

Lorsque vous ouvrez PyCharm, vous verrez ceci, cliquez sur `Create New Project`:

![Lorsque vous ouvrez PyCharm](/files/-LXj6AzaTYZ_yNKuwhtA)

Sélectionnez `Pure Python`:

![Nouveau projet PyCharm](/files/-LXj6Azc9dJ4wS5UgRFc)

Changez `untitled` en `helloworld` comme emplacement du projet, vous devriez voir des détails similaires à ceux-ci:

![PyCharm Détails projet](/files/-LXj6Aze4Z-vpatBpEg4)

Cliquez sur le bouton `Create`.

Cliquez avec le bouton droit de la souris sur le `helloworld` dans la barre latérale et sélectionnez `New` -> `Python File`:

![PyCharm -> New -> Python File](/files/-LXj6AzgRBG19mEuSes_)

Il vous sera demandé de taper le nom, tapez `hello`:

![PyCharm Dialogue « New File »](/files/-LXj6Azi-QTF1g4dkIHH)

Vous pouvez maintenant voir un fichier ouvert pour vous:

![PyCharm Fichier hello.py](/files/-LXj6Azk2PQp1FWHOaXC)

Supprimez les lignes déjà présentes et tapez maintenant le texte suivant:

```python
print("hello world")
```

Maintenant, faites un clic droit sur ce que vous avez tapé (sans sélectionner le texte), puis cliquez sur `Run 'hello'`.

![PyCharm Run 'hello'](/files/-LXj6AzmVqP3WJf23g_z)

Vous devriez maintenant voir la sortie (ce qu’elle affiche) de votre programme:

![PyCharm output](/files/-LXj6AzoL_aegnR2svop)

Phew! Ça fait beaucoup d'étapes pour commencer, mais désormais, chaque fois que nous vous demandons de créer un nouveau fichier, n’oubliez pas de cliquer avec le bouton droit de la souris sur `helloworld` à gauche -> `New` -> `Python File` et de continuer. Suivez les mêmes étapes pour taper et exécuter comme indiqué ci-dessus.

Pour plus d'informations sur PyCharm, consultez la page [Démarrage rapide PyCharm](https://www.jetbrains.com/pycharm-educational/quickstart/).

## Vim

1. Installez [Vim](http://www.vim.org)
   * Les utilisateurs de Mac OS X doivent installer le paquet `macvim` via [HomeBrew](http://brew.sh/)      \* Les utilisateurs Windows doivent télécharger l'*installeur executable* depuis le [site Web Vim](http://www.vim.org/download.php).      \* Les utilisateurs de GNU/Linux doivent obtenir Vim à partir du gestionnaire de paquets de leur distribution, par exemple, les utilisateurs de Debian et Ubuntu peuvent installer le paquet `vim`.
2. Installez le plug-in [jedi-vim](https://github.com/davidhalter/jedi-vim) pour l'auto-complétion.
3. Installez le paquet python `jedi` correspondant: `pip install -U jedi`

## Emacs

1. Installez [Emacs 24+](http://www.gnu.org/software/emacs/).
   * Les utilisateurs de Mac OS X doivent obtenir Emacs à l'adresse <http://emacsformacosx.com>
   * Les utilisateurs de Windows doivent obtenir Emacs à l'adresse <http://ftp.gnu.org/gnu/emacs/windows/>
   * Les utilisateurs de GNU/Linux doivent obtenir Emacs à partir des gestionnaire de paquets de leur distribution. Par exemple, les utilisateurs de Debian et Ubuntu peuvent installer le paquet `emacs24`.
2. Installez [ELPY](https://github.com/jorgenschaefer/elpy/wiki)

## Utiliser un fichier source

Revenons à la programmation. La tradition veut que, lors de l'apprentissage d'un nouveau langage, le premier programme écrit et lancé est le programme « Hello World ». Tout ce qu'il fait est d'afficher « Hello World » quand vous le lancez. Comme le dit Simon Cozens (l'auteur de l'incroyable livre « Beginning Perl »), c'est la « traditionnelle incantation aux dieux de la programmation pour vous aider à mieux apprendre le langage ».

Lancez l'éditeur de votre choix, saisissez le programme suivant et enregistrez-le en tant que `hello.py`

Si vous utilisez PyCharm, nous avons déjà [vu comment lancer un fichier source](#pycharm).

Pour les autres éditeurs, ouvrez un nouveau fichier `hello.py` et tapez ceci:

```python
print("hello world")
```

Où devriez-vous sauvegarder le fichier? Dans n'importe quel dossier dont vous connaissez l'emplacement. Si vous ne comprenez pas ce que cela signifie, créez un nouveau dossier et utilisez cet emplacement pour enregistrer et exécuter tous vos programmes Python:

* `/tmp/py` sous Mac OS X
* `/tmp/py` sous GNU/Linux
* `C:\py` sous Windows

Pour créer le dossier ci-dessus (pour le système d'exploitation que vous utilisez), utilisez la commande `mkdir` dans un terminal, par exemple, `mkdir /tmp/py`.

IMPORTANT: veillez toujours à attribuer l’extension de fichier `.py`, par exemple, `foo.py`.

Pour exécuter votre programme Python:

1. Ouvrez une fenêtre de terminal (voir le chapitre précédent [Installation](/byte-of-python/a-byte-of-python/installation.md#installation) pour savoir comment procéder).
2. Déplacez vous dans le répertoire où vous avez enregistré le fichier, par exemple, `cd /tmp/py`. En anglais `cd` est la sigle de **C**hange **D**irectory.
3. Exécutez le programme en entrant la commande `python hello.py`. La sortie est comme ci-dessous.

```
$ python hello.py
hello world
```

![Capture d'écran du programme en cours d'exécution dans le terminal](/files/-LXj6AzqLNJOQC_eWWoX)

Si vous obtenez le résultat ci-dessus, félicitations! - vous avez exécuté avec succès votre premier programme Python. Vous avez traversé avec succès la partie la plus difficile de l'apprentissage de la programmation, à savoir, lancer votre premier programme!

Au cas où vous auriez une erreur, veuillez taper votre programme *exactement* comme indiqué ci-dessus et relancez le. Notez que Python est sensible à la casse, c'est-à-dire que `print` n'est pas identique à `Print` (notez la minuscule dans le premier et la majuscule dans le second). Assurez-vous également qu'il n'y a pas d'espaces ni de tabulations avant le premier caractère de chaque ligne - nous verrons plus tard pourquoi [cela est important](/byte-of-python/a-byte-of-python/basics.md#indentation).

**Comment ça marche**

Un programme Python est composé d'*instructions*. Dans notre premier programme, nous n’avons qu’une instruction. Dans cette instruction, nous appelons l'*instruction* `print` à laquelle nous fournissons le texte « hello world ».

## Obtenir de l'aide

Si vous avez besoin rapidement d'information sur n'importe quelle fonction ou instruction dans Python, alors vous pouvez utiliser la fonctionnalité `help`. Cela est très utile particulièrement quand on utilise l'interpréteur interactif. Par exemple, tapez `help(print)` - cela affiche l'aide pour la fonction print qui est utilisée pour afficher des choses à l'écran.

Note: Tapez `q` pour sortir de l'aide.

De la même manière, vous pouvez obtenir de l'information sur pratiquement n'importe quoi dans Python. Utilisez `help()` pour apprendre plus de choses sur le `help` lui-même !

Pour avoir de l'aide sur les opérateurs comme `return`, il faut mettre des quotes à l'intérieur comme dans `help('return')` pour que Python comprenne ce que l'on veut faire.

## Récapitulatif

Vous devriez être maintenant capable d'écrire, enregistrer et exécuter facilement des programmes Python.

Maintenant que vous êtes un utilisateur Python, apprenons quelques concepts Python supplémentaires.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://rgilliotte.gitbook.io/byte-of-python/a-byte-of-python/first_steps.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
