Introduction
************

La "Bibliothèque Python" contient divers composants dans différentes
catégories.

Elle contient des types de données qui seraient normalement considérés
comme "fondamentaux" au langage, tel que les nombres et les listes.
Pour ces types, le cœur du langage en définit les écritures littérales
et impose quelques contraintes sémantiques, sans les définir
exhaustivement. (Cependant le cœur du langage impose quelques
propriétés comme l'orthographe des attributs ou les caractéristiques
des opérateurs.)

La bibliothèque contient aussi des fonctions et des exceptions
natives, pouvant être utilisées par tout code Python sans "import".
Certaines sont définies par le noyau de Python, bien qu'elles ne
soient pas toutes essentielles.

La grande majorité de la bibliothèque consiste cependant en une
collection de modules. Cette collection peut être parcourue de
différentes manières. Certains modules sont rédigés en C et inclus
dans l'interpréteur Python, d'autres sont écrits en Python et leur
source est importée. Certains modules fournissent des interfaces
extrêmement spécifiques à Python, tel que l'affichage d'une pile
d'appels, d'autres fournissent des interfaces spécifiques à un système
d'exploitation, comme l'accès à du matériel spécifique. D'autres
fournissent des interfaces spécifiques à un domaine d'application,
comme le *World Wide Web*. Certains modules sont disponibles dans
toutes les versions et implémentations de Python, d'autres ne sont
disponibles que si le système sous-jacent les gère ou en a besoin.
Enfin, d'autres ne sont disponibles que si Python à été compilé avec
une certaine option.

Cette documentation organise les modules "de l'intérieur vers
l'extérieur", documentant en premier les fonctions natives, les types
de données et exceptions, puis les modules, groupés par chapitre, par
thématiques.

Ça signifie que si vous commencez à lire cette documentation du début,
et sautez au chapitre suivant lorsqu'elle vous ennuie, vous aurez un
aperçu global des modules et domaines couverts par cette bibliothèque.
Bien sûr vous n'avez pas à la lire comme un roman, vous pouvez
simplement survoler la table des matières (au début), ou chercher une
fonction, un module, ou un mot dans l'index (à la fin). Et si vous
appréciez apprendre sur des sujets au hasard, choisissez une page au
hasard (avec le module "random") et lisez un chapitre ou deux. Peu
importe l'ordre que vous adopterez, commencez par le chapitre
Fonctions natives, car les autres chapitres présument que vous en avez
une bonne connaissance.

Que le spectacle commence !


Notes sur la disponibilité
==========================

* Une note "Disponibilité : Unix " signifie que cette fonction est
  communément implémentée dans les systèmes Unix. Une telle note ne
  prétend pas l'existence de la fonction sur un système d'exploitation
  particulier.

* Si ce n'est pas mentionné séparément, toutes les fonctions se
  réclamant "Disponibilité : Unix" sont gérées sur macOS, qui est basé
  sur Unix.
