python
diff --git a/‎c-api.po
Lines changed: 8 additions & 0 deletions b/‎c-api.po
Lines changed: 8 additions & 0 deletions
diff --git a/‎extending.po
Lines changed: 158 additions & 1 deletion b/‎extending.po
Lines changed: 158 additions & 1 deletion
@@ -75,6 +75,11 @@ msgid ""
 "detector's set of observed objects. Other fields of the object are not "
 "affected."
 msgstr ""
+"Permet d'initialiser un objet *op* nouvellement alloué ainsi que son type et "
+"sa référence initiale.  Retourne l'objet initialisé.  La présence de *type* "
+"indique que l'objet doit être traité par le détecteur d'ordures cycliques, "
+"il est de ce fait ajouté à l'ensemble du détecteur d'objets observés. Les "
+"autres champs de l'objet ne sont pas affectés."
 
 #: c-api/allocation.rst:33
 msgid ""
@@ -6543,6 +6548,9 @@ msgid ""
 "standard headers on some systems, you *must* include :file:`Python.h` before "
 "any standard headers are included."
 msgstr ""
+"Python pouvant définir certaines définitions pré-processeur qui affectent "
+"les têtes standard sur certains systèmes, vous *devez* inclure :file:`Python."
+"h` avant les en-têtes standards."
 
 #: c-api/intro.rst:53
 msgid ""
 
@@ -302,6 +302,17 @@ msgid ""
 "which saves you the trouble of allocating memory space and loading the file "
 "contents."
 msgstr ""
+"La  fonction :c:func:`Py_SetProgramName` devrait être appelée avant :c:func:"
+"`Py_Initialize` pour informer l'interpréteur des chemins vers les "
+"bibliothèque Python. Ensuite, l'interpréteur Python est initialisé avec :c:"
+"func:`Py_Initialize`, suivi par l'exécution d'un script Python, codé en dur, "
+"qui affiche la date et l'heure. Ensuite, l'interpréteur est arrêté par un "
+"appel à :c:func:`Py_Finalize`, puis le programme se termine. Dans un vrai "
+"programme, vous voudrez peut-être obtenir le script Python d'une autre "
+"source, peut-être d'une fonction d'un éditeur de texte, un fichier ou une "
+"base de données. Obtenir le code Python à partir d'un fichier se fait plus "
+"aisément avec :c:func:`PyRun_SimpleFile`,ce qui vous évite d'avoir à allouer "
+"la mémoire et d'y charger le contenu du fichier."
 
 #: extending/embedding.rst:87
 msgid "Beyond Very High Level Embedding: An overview"
@@ -493,6 +504,15 @@ msgid ""
 "and write some glue code that gives Python access to those routines, just "
 "like you would write a normal Python extension.  For example::"
 msgstr ""
+"Jusqu'à présent, l'interpréteur Python intégré n'avait pas accès aux "
+"fonctionnalités de l'application elle-même. L'API Python le permet en "
+"étendant l'interpréteur intégré. Autrement dit, l'interpréteur intégré est "
+"étendu avec des fonctions fournies par l'application. Bien que cela puisse "
+"sembler complexe, ce n'est pas si dur. Il suffit d'oublier que l'application "
+"démarre l'interpréteur Python, au lieu de cela, voyez l'application comme un "
+"ensemble de fonctions, et rédigez un peu de code pour exposer ces fonctions "
+"à Python, tout comme vous écririez une extension Python normale. Par "
+"exemple ::"
 
 #: extending/embedding.rst:226
 msgid ""
@@ -600,6 +620,15 @@ msgid ""
 "extract the configuration values that you will want to combine together.  "
 "For example:"
 msgstr ""
+"Si cette procédure ne fonctionne pas pour vous (il n'est pas garanti "
+"qu'ellefonctionne pour toutes les plateformes Unix, mais nous traiteront "
+"volontiers les :ref: `rapports de bugs <reporting-bugs>`), vous devrez lire "
+"ladocumentation de votre système sur la liaison dynamique (*dynamic "
+"linking*) et / ouexaminer le :file:`Makefile` de Python (utilisez :func:"
+"`sysconfig.get_makefile_filename` pour trouver son emplacement) et les "
+"options de compilation. Dans ce cas, le module :mod:`sysconfig` est un outil "
+"utile pour extraire automatiquement les valeurs de configuration que vous "
+"voudrez combiner ensemble. Par example :"
 
 #: extending/extending.rst:8
 msgid "Extending Python with C or C++"
@@ -625,12 +654,19 @@ msgid ""
 "aspects of the Python run-time system.  The Python API is incorporated in a "
 "C source file by including the header ``\"Python.h\"``."
 msgstr ""
+"Pour gérer les extensions, l'API Python (*Application Programmer Interface*) "
+"définit un ensemble de fonctions, macros et variables qui donnent accès à la "
+"plupart des aspects du système d'exécution de Python. L'API Python est "
+"incorporée dans un fichier source C en incluant l'en-tête ``\"Python.h\"``."
 
 #: extending/extending.rst:20
 msgid ""
 "The compilation of an extension module depends on its intended use as well "
 "as on your system setup; details are given in later chapters."
 msgstr ""
+"La compilation d'un module d'extension dépend de l'usage prévu et de la "
+"configuration du système, plus de détails peuvent être trouvés dans les "
+"chapitres suivants."
 
 #: extending/extending.rst:25
 msgid ""
@@ -644,6 +680,17 @@ msgid ""
 "with C code and are more portable between implementations of Python than "
 "writing and compiling a C extension module."
 msgstr ""
+"L'interface d'extension C est spécifique à CPython, et les modules "
+"d'extension ne fonctionne pas sur les autres implémentations de Python. Dans "
+"de nombreux cas, il est possible d'éviter la rédaction des extensions en C "
+"et ainsi préserver la portabilité vers d'autres implémentations. Par "
+"exemple, si vous devez appeler une fonction de la bibliothèque C ou faire un "
+"appel système, vous devriez envisager d'utiliser le module :mod:`ctypes` ou "
+"d'utiliser la bibliothèque `CFFI <http://cffi.readthedocs.org>`_ plutôt que "
+"d'écrire du code C sur mesure. Ces modules vous permettent d'écrire du code "
+"Python s'interfaçant avec le code C et sont plus portables entre les "
+"implémentations de Python que l'écriture et la compilation d'une d'extension "
+"C."
 
 #: extending/extending.rst:39
 #, fuzzy
@@ -658,6 +705,12 @@ msgid ""
 "terminated character string as argument and returns an integer.  We want "
 "this function to be callable from Python as follows::"
 msgstr ""
+"Créons un module d'extension appelé ``spam`` (la nourriture préférée de fans "
+"des Monty Python ...) et disons que nous voulons créer une interface Python "
+"à la fonction de la bibliothèque C :c:func:`system`. [#] _ Cette fonction "
+"prend une chaîne de caractères terminée par NULL comme argument et renvoie "
+"un entier. Nous voulons que cette fonction soit appelable à partir de Python "
+"comme suit ::"
 
 #: extending/extending.rst:50
 msgid ""
@@ -666,6 +719,10 @@ msgid ""
 "`spammodule.c`; if the module name is very long, like ``spammify``, the "
 "module name can be just :file:`spammify.c`.)"
 msgstr ""
+"Commencez par créer un fichier :file:`spammodule.c`. (Historiquement, si un "
+"module se nomme ``spam``, le fichier C contenant son implémentation est "
+"appelé :file:`spammodule.c`. Si le nom du module est très long, comme "
+"``spammify``, le nom du module peut être juste :file: `spammify.c`.)"
 
 #: extending/extending.rst:55
 #, fuzzy
@@ -677,13 +734,18 @@ msgid ""
 "which pulls in the Python API (you can add a comment describing the purpose "
 "of the module and a copyright notice if you like)."
 msgstr ""
+"qui récupère l'API Python (vous pouvez ajouter un commentaire décrivant le "
+"but du module et un avis de droit d'auteur si vous le souhaitez)."
 
 #: extending/extending.rst:64
 msgid ""
 "Since Python may define some pre-processor definitions which affect the "
 "standard headers on some systems, you *must* include :file:`Python.h` before "
 "any standard headers are included."
 msgstr ""
+"Python pouvant définir certaines définitions pré-processeur qui affectent "
+"les têtes standard sur certains systèmes, vous *devez* inclure :file:`Python."
+"h` avant les en-têtes standards."
 
 #: extending/extending.rst:68
 msgid ""
@@ -695,13 +757,24 @@ msgid ""
 "on your system, it declares the functions :c:func:`malloc`, :c:func:`free` "
 "and :c:func:`realloc` directly."
 msgstr ""
+"Tous les symboles exposés par:file:`Python.h` sont préfixés de ``Py`` ou "
+"``PY``, sauf ceux qui sont définis dans les en-têtes standard. Pour le "
+"confort, et comme ils sont largement utilisés par l'interpréteur Python, ``"
+"\"Python.h\"`` inclu lui même quelques d'en-têtes standard : ``<stdio.h>``, "
+"``<string.h>``, ``<errno.h>`` et ``<stdlib.h>``. Si ce dernier n'existe pas "
+"sur votre système, il déclare les fonctions :c:func:`malloc`, :c:func:`free` "
+"et :c:func:`realloc` directement."
 
 #: extending/extending.rst:76
 msgid ""
 "The next thing we add to our module file is the C function that will be "
 "called when the Python expression ``spam.system(string)`` is evaluated "
 "(we'll see shortly how it ends up being called)::"
 msgstr ""
+"La prochaine chose que nous ajoutons à notre fichier de module est la "
+"fonction C qui sera appelée lorsque l'expression Python ``spam."
+"system(chaîne)`` sera évaluée (nous verrons bientôt comment elle finit par "
+"être appelée) ::"
 
 #: extending/extending.rst:92
 msgid ""
@@ -710,6 +783,10 @@ msgid ""
 "C function.  The C function always has two arguments, conventionally named "
 "*self* and *args*."
 msgstr ""
+"Il ya une correspondance directe de la liste des arguments en Python (par "
+"exemple, l'expression ``\"ls -l\"``) aux arguments passés à la fonction C. "
+"La fonction C a toujours deux arguments, appelés par convention *self* et "
+"*args*."
 
 #: extending/extending.rst:97
 msgid ""
@@ -729,6 +806,15 @@ msgid ""
 "determine the required types of the arguments as well as the types of the C "
 "variables into which to store the converted values.  More about this later."
 msgstr ""
+"L'argument *args* sera un pointeur vers un *tuple* Python contenant les "
+"arguments. Chaque élément du *tuple* correspond à un argument dans la liste "
+"des arguments de l'appel. Les arguments sont des objets Python --- afin d'en "
+"faire quelque chose dans notre fonction C, nous devons les convertir en "
+"valeurs C. La fonction :c:func:`PyArg_ParseTuple` de l'API Python vérifie "
+"les types des arguments et les convertit en valeurs C. Elle utilise un "
+"modèle sous forme de chaîne pour déterminer les types requis des arguments "
+"ainsi que les types de variables C dans lequel stocker les valeurs "
+"converties. Nous en verront plus, plus tard."
 
 #: extending/extending.rst:110
 msgid ""
@@ -739,10 +825,16 @@ msgid ""
 "the calling function can return *NULL* immediately (as we saw in the "
 "example)."
 msgstr ""
+":c:func:`PyArg_ParseTuple` renvoie vrai (pas zéro) si tous les arguments ont "
+"le bon type et que ses composants ont été stockés dans les variables dont "
+"les adresses données. Il retourne faux (zéro) si une liste d'arguments "
+"invalide a été passée. Dans ce dernier cas, elle soulève également une "
+"exception appropriée de sorte que la fonction d'appel puisse retourner "
+"*NULL* immédiatement (comme nous l'avons vu dans l'exemple)."
 
 #: extending/extending.rst:120
 msgid "Intermezzo: Errors and Exceptions"
-msgstr ""
+msgstr "Intermezzo: Les Erreurs et Exceptions"
 
 #: extending/extending.rst:122
 msgid ""
@@ -764,6 +856,8 @@ msgid ""
 "The Python API defines a number of functions to set various types of "
 "exceptions."
 msgstr ""
+"L'API Python définit un certain nombre de fonctions pour créer différents "
+"types d'exceptions."
 
 #: extending/extending.rst:136
 msgid ""
@@ -773,6 +867,11 @@ msgid ""
 "indicates the cause of the error and is converted to a Python string object "
 "and stored as the \"associated value\" of the exception."
 msgstr ""
+"La plus courante est :c:func:`PyErr_SetString`. Ses arguments sont un objet "
+"exception et une chaîne C. L'objet exception est généralement un objet "
+"prédéfini comme :c:data:`PyExc_ZeroDivisionError`. La chaîne C indique la "
+"cause de l'erreur et est convertie en une chaîne Python puis stockée en tant "
+"que \"valeur associée\" à l'exception."
 
 #: extending/extending.rst:142
 msgid ""
@@ -783,6 +882,11 @@ msgid ""
 "associated value.  You don't need to :c:func:`Py_INCREF` the objects passed "
 "to any of these functions."
 msgstr ""
+"Une autre fonction utile est :c:func:`PyErr_SetFromErrno`, qui construit une "
+"exception à partir de la valeur de la variable globale :c:data:`errno`. La "
+"fonction la plus générale est :c:func: `PyErr_SetObject`, qui prend deux "
+"arguments: l'exception et sa valeur associée. Vous ne devez pas appliquer :c:"
+"func:`Py_INCREF` aux objets transmis à ces fonctions."
 
 #: extending/extending.rst:149
 msgid ""
@@ -792,6 +896,12 @@ msgid ""
 "`PyErr_Occurred` to see whether an error occurred in a function call, since "
 "you should be able to tell from the return value."
 msgstr ""
+"Vous pouvez tester de manière non destructive si une exception a été levée "
+"avec :c:func:`PyErr_Occurred`. Cela renvoie l'objet exception actuel, ou "
+"*NULL* si aucune exception n'a eu lieu. Cependant, vous ne devriez pas avoir "
+"besoin d'appeler :c:func:`PyErr_Occurred` pour voir si une erreur est "
+"survenue durant l'appel d'une fonction, puisque vous devriez être en mesure "
+"de le déterminer à partir de la valeur de retour."
 
 #: extending/extending.rst:155
 msgid ""
@@ -806,6 +916,17 @@ msgid ""
 "code and tries to find an exception handler specified by the Python "
 "programmer."
 msgstr ""
+"lorsqu'une fonction *f* ayant appelé une autre fonction *g* détecte que "
+"cette dernière a échoué, *f* devrait donner une valeur d'erreur à son tour "
+"(habituellement *NULL* ou ``-1``). *f* ne devrait *pas* appeler l'une des "
+"fonctions :c:func:`PyErr_\\*`, l'une d'elles ayant déjà été appelée par *g*. "
+"La fonction appelant *f* est alors censée retourner aussi un code d'erreur à "
+"celle qui la appelée, toujours sans utiliser :c:func:`PyErr_\\*`, et ainsi "
+"de suite. La cause la plus détaillée de l'erreur a déjà été signalée par la "
+"fonction l'ayant détectée en premier. Une fois l'erreur remontée à la boucle "
+"principale de l'interpréteur Python, il interrompt le code en cours "
+"d'exécution et essaie de trouver un gestionnaire d'exception spécifié par le "
+"développeur Python."
 
 #: extending/extending.rst:165
 msgid ""
@@ -815,6 +936,12 @@ msgid ""
 "can cause information about the cause of the error to be lost: most "
 "operations can fail for a variety of reasons.)"
 msgstr ""
+"(Il ya des situations où un module peut effectivement donner un message "
+"d'erreur plus détaillé en appelant une autre fonction :c:func:`PyErr_\\*`, "
+"dans de tels cas, c'est tout à fait possible de le faire. Cependant, ce "
+"n'est généralement pas nécessaire, et peut amener à perdre des informations "
+"sur la cause de l'erreur: la plupart des opérations peuvent échouer pour "
+"tout un tas de raisons)."
 
 #: extending/extending.rst:171
 msgid ""
@@ -824,6 +951,12 @@ msgid ""
 "pass the error on to the interpreter but wants to handle it completely by "
 "itself (possibly by trying something else, or pretending nothing went wrong)."
 msgstr ""
+"Pour ignorer une exception qui aurait été émise lors d'un un appel de "
+"fonction qui aurait échoué, l'exception doit être retirée explicitement en "
+"appelant :c:func:`PyErr_Clear`. Le seul cas pour lequel du code C devrait "
+"appeler :c:func:`PyErr_Clear` est lorsqu'il ne veut pas passer l'erreur à "
+"l'interpréteur, mais souhaite la gérer lui-même (peut-être en essayant "
+"quelque chose d'autre, ou de prétendre rien a mal tourné)."
 
 #: extending/extending.rst:177
 msgid ""
@@ -841,13 +974,20 @@ msgid ""
 "positive value or zero for success and ``-1`` for failure, like Unix system "
 "calls."
 msgstr ""
+"Notez également que, à l'exception notable de :c:func:`PyArg_ParseTuple` et "
+"compagnie, les fonctions qui renvoient leur statut sous forme d'entier "
+"donnent généralement une valeur positive ou zéro en cas de succès et ``-1`` "
+"en cas d'échec, comme les appels système Unix."
 
 #: extending/extending.rst:187
 msgid ""
 "Finally, be careful to clean up garbage (by making :c:func:`Py_XDECREF` or :"
 "c:func:`Py_DECREF` calls for objects you have already created) when you "
 "return an error indicator!"
 msgstr ""
+"Enfin, lorsque vous renvoyez un code d'erreur, n'oubliez pas faire un brin "
+"de nettoyage (en appelant :c:func:`Py_XDECREF` ou :c: func:` Py_DECREF` avec "
+"les objets que vous auriez déjà créé)  !"
 
 #: extending/extending.rst:191
 msgid ""
@@ -861,12 +1001,25 @@ msgid ""
 "you have an argument whose value must be in a particular range or must "
 "satisfy other conditions, :c:data:`PyExc_ValueError` is appropriate."
 msgstr ""
+"Le choix de l'exception à lever vous incombe. Il existe des objets C "
+"correspondant à chaque exception Python, tel que :c:data:"
+"`PyExc_ZeroDivisionError`, que vous pouvez utiliser directement. Choisissez "
+"judicieusement vos exceptions, typiquement n'utilisez pas :c:data:"
+"`PyExc_TypeError` pour indiquer qu'un fichier n'a pas pu être ouvert (qui "
+"devrait probablement être :c:data:`PyExc_IOError`). Si quelque chose ne va "
+"pas avec la liste d'arguments, la fonction :c:func:`PyArg_ParseTuple` "
+"soulève habituellement une exception :c:data:`PyExc_TypeError`. Mais si vous "
+"avez un argument dont la valeur doit être dans une intervalle particulière "
+"ou qui doit satisfaire d'autres conditions, :c:data:`PyExc_ValueError` sera "
+"plus appropriée."
 
 #: extending/extending.rst:201
 msgid ""
 "You can also define a new exception that is unique to your module. For this, "
 "you usually declare a static object variable at the beginning of your file::"
 msgstr ""
+"Vous pouvez également créer une exception spécifique à votre module. Pour "
+"cela, déclarez simplement une variable statique au début de votre fichier ::"
 
 #: extending/extending.rst:206
 msgid ""
@@ -882,6 +1035,10 @@ msgid ""
 "class being :exc:`Exception` (unless another class is passed in instead of "
 "*NULL*), described in :ref:`bltin-exceptions`."
 msgstr ""
+"Notez que le nom de exception, côté Python, est :exc:`spam.error`. La "
+"fonction :c:func:`PyErr_NewException` peut créer une classe héritant de :exc:"
+"`Exception` (à moins qu'une autre classe ne lui soit fournie à la place de "
+"*NULL*), voir :ref:`bltin-exceptions`."
 
 #: extending/extending.rst:228
 msgid ""