Workon newtypes tut

Author: JulienPalard

extending/newtypes_tutorial.po

@@ -6,7 +6,7 @@ msgstr ""
 "Project-Id-Version: Python 3\n"
 "Report-Msgid-Bugs-To: \n"
 "POT-Creation-Date: 2020-08-24 09:01+0200\n"
-"PO-Revision-Date: 2021-04-27 18:38+0200\n"
+"PO-Revision-Date: 2021-06-07 18:39+0200\n"
 "Last-Translator: Julien Palard <julien@palard.fr>\n"
 "Language-Team: FRENCH <traductions@lists.afpy.org>\n"
 "Language: fr\n"
@@ -27,9 +27,10 @@ msgid ""
 "can get started.  This document is a gentle introduction to the topic."
 msgstr ""
 "Python permet à l'auteur d'un module d'extension C de définir de nouveaux "
-"types qui peuvent être manipulés depuis du code Python, tel que les types "
-"natifs :class:`str` et :class:`list`. Un gabarit permet de coder ces types, "
-"mais quelques subtilités doivent être abordées avant de commencer."
+"types qui peuvent être manipulés depuis du code Python, à la manière des "
+"types natifs :class:`str` et :class:`list`. Les implémentations de tous les "
+"types d'extension ont des similarités, mais quelques subtilités doivent être "
+"abordées avant de commencer."
 
 #: extending/newtypes_tutorial.rst:24
 msgid "The Basics"
@@ -47,13 +48,14 @@ msgid ""
 "functions are called \"type methods\"."
 msgstr ""
 ":term:`CPython` considère que tous les objets Python sont des variables de "
-"type :c:type:`PyObject\\\\*`, qui sert de type de base pour tous les objets "
+"type :c:type:`PyObject\\*`, qui sert de type de base pour tous les objets "
 "Python. La structure de :c:type:`PyObject` ne contient que le :term:"
-"`compteur de références <reference count>` et un pointeur vers un objet de type « type de "
-"l'objet ». C'est ici que tout se joue : l'objet type détermine quelle fonction "
-"(C) doit être appelée par l'interpréteur quand, par exemple, un attribut est "
-"recherché sur un objet, quand une méthode est appelée, ou quand l'objet est multiplié "
-"par un autre objet. Ces fonctions C sont appelées des « méthodes de type »."
+"`compteur de références <reference count>` et un pointeur vers un objet de "
+"type « type de l'objet ». C'est ici que tout se joue : l'objet type "
+"détermine quelle fonction C doit être appelée par l'interpréteur quand, par "
+"exemple, un attribut est recherché sur un objet, quand une méthode est "
+"appelée, ou quand l'objet est multiplié par un autre objet. Ces fonctions C "
+"sont appelées des « méthodes de type »."
 
 #: extending/newtypes_tutorial.rst:35
 msgid ""
@@ -80,7 +82,7 @@ msgid ""
 "allows defining heap-allocated extension types using the :c:func:"
 "`PyType_FromSpec` function, which isn't covered in this tutorial."
 msgstr ""
-"Ce qui est montré ici, c'est la manière traditionnelle de définir des types "
+"Ce qui est montré ici est la manière traditionnelle de définir des types "
 "d'extension *statiques*, et cela convient dans la majorité des cas. L'API C "
 "permet aussi de définir des types alloués sur le tas, via la fonction :c:"
 "func:`PyType_FromSpec`, mais ce n'est pas couvert par ce tutoriel."
@@ -136,10 +138,10 @@ msgstr ""
 "C'est ce qu'un objet ``Cusom`` contient. ``PyObject_HEAD`` est "
 "obligatoirement au début de chaque structure d'objet et définit un champ "
 "appelé ``ob_base`` de type :c:type:`PyObject`, contenant un pointeur vers un "
-"objet type et un compteur de références (on peut y accéder en "
-"utilisant les macros :c:macro:`Py_REFCNT` et :c:macro:`Py_TYPE`, "
-"respectivement). La raison d'être de ces macros est d'abstraire l'agencement "
-"de la structure, et ainsi de permettre l'ajout de champs en mode débogage."
+"objet type et un compteur de références (on peut y accéder en utilisant les "
+"macros :c:macro:`Py_REFCNT` et :c:macro:`Py_TYPE`, respectivement). La "
+"raison d'être de ces macros est d'abstraire l'agencement de la structure, et "
+"ainsi de permettre l'ajout de champs en mode débogage."
 
 #: extending/newtypes_tutorial.rst:75
 msgid ""
@@ -170,6 +172,10 @@ msgid ""
 "listing all the :c:type:`PyTypeObject` fields that you don't care about and "
 "also to avoid caring about the fields' declaration order."
 msgstr ""
+"Nous recommandons d'utiliser la syntaxe d'initialisation nommée (C99) pour "
+"remplir la structure, comme ci-dessus, afin d'éviter d'avoir à nommer les "
+"champs de :c:type:`PyTypeObject` dont vous n'avez pas besoin, et de ne pas "
+"vous soucier de leur ordre."
 
 #: extending/newtypes_tutorial.rst:104
 msgid ""
@@ -178,22 +184,31 @@ msgid ""
 "fields will be filled with zeros by the C compiler, and it's common practice "
 "to not specify them explicitly unless you need them."
 msgstr ""
+"La définition de :c:type:`PyTypeObject` dans :file:`object.h` contient en "
+"fait bien plus de :ref:`champs <type-structs>` que la définition ci-dessus. "
+"Les champs restants sont mis à zéro par le compilateur C, et c'est une "
+"pratique répandue de ne pas spécifier les champs dont vous n'avez pas besoin."
 
 #: extending/newtypes_tutorial.rst:109
 msgid "We're going to pick it apart, one field at a time::"
-msgstr ""
+msgstr "Regardons les champs de cette structures, un par un ::"
 
 #: extending/newtypes_tutorial.rst:113
 msgid ""
 "This line is mandatory boilerplate to initialize the ``ob_base`` field "
 "mentioned above. ::"
 msgstr ""
+"Cette ligne, obligatoire, initialise le champ ``ob_base`` mentionné "
+"précédemment."
 
 #: extending/newtypes_tutorial.rst:118
 msgid ""
 "The name of our type.  This will appear in the default textual "
 "representation of our objects and in some error messages, for example:"
 msgstr ""
+"C'est le nom de notre type. Il apparaît dans la représentation textuelle par "
+"défaut de nos objets, ainsi que dans quelques messages d'erreur, par "
+"exemple :"
 
 #: extending/newtypes_tutorial.rst:128
 msgid ""
@@ -203,13 +218,22 @@ msgid ""
 "`custom.Custom`. Using the real dotted import path is important to make your "
 "type compatible with the :mod:`pydoc` and :mod:`pickle` modules. ::"
 msgstr ""
+"Notez que le nom comporte un point : il inclut le nom du module et le nom du "
+"type. Dans ce cas le module  est :mod:`custom`, et le type est :class:"
+"`Custom`, donc nous donnons comme nom :class:`custom.Custom`. Nommer "
+"correctement son type, avec le point, est important pour le rendre "
+"compatible avec :mod:`pydoc` et :mod:`pickle`. ::"
 
 #: extending/newtypes_tutorial.rst:137
 msgid ""
 "This is so that Python knows how much memory to allocate when creating new :"
 "class:`Custom` instances.  :c:member:`~PyTypeObject.tp_itemsize` is only "
 "used for variable-sized objects and should otherwise be zero."
 msgstr ""
+"C'est pour que Python sache combien de mémoire allouer à la création d'une "
+"nouvelle instance de :class:`Custom`. :c:member:`~PyTypeObject.tp_itemsize` "
+"n'est utilisé que pour les objets de taille variable, sinon il doit rester à "
+"zéro."
 
 #: extending/newtypes_tutorial.rst:143
 msgid ""
@@ -224,22 +248,40 @@ msgid ""
 "type will be :class:`object`, or else you will be adding data members to "
 "your base type, and therefore increasing its size."
 msgstr ""
+"Si vous voulez qu'une classe en Python puisse hériter de votre type, et que "
+"votre type a le même :c:member:`~PyTypeObject.tp_basicsize` que son parent, "
+"vous pourriez rencontrer des problèmes avec l'héritage multiple. Une sous-"
+"classe Python de votre type devra lister votre type en premier dans son :"
+"attr:`~class.__bases__`, sans quoi il ne sera pas capable d'appeler la "
+"méthode :meth:`__new__` de votre type sans erreur. Vous pouvez éviter ce "
+"problème en vous assurant que votre type a un :c:member:`~PyTypeObject."
+"tp_basicsize` plus grand que son parent. La plupart du temps ce sera vrai "
+"(soit son parent sera :class:`object`, soit vous ajouterez des attributs à "
+"votre type, augmentant ainsi sa taille)."
 
 #: extending/newtypes_tutorial.rst:153
 msgid "We set the class flags to :const:`Py_TPFLAGS_DEFAULT`. ::"
 msgstr ""
+"On utilise la constante :const:`Py_TPFLAGS_DEFAULT` comme seule option de "
+"type. ::"
 
 #: extending/newtypes_tutorial.rst:157
 msgid ""
 "All types should include this constant in their flags.  It enables all of "
 "the members defined until at least Python 3.3.  If you need further members, "
 "you will need to OR the corresponding flags."
 msgstr ""
+"Chaque type devrait inclure cette constante dans ses options : elle active "
+"tous les membres définis jusqu'à au moins Python 3.3. Si vous avez besoin de "
+"plus de membres, vous pouvez la combiner à d'autres constantes avec un *ou* "
+"binaire."
 
 #: extending/newtypes_tutorial.rst:161
 msgid ""
 "We provide a doc string for the type in :c:member:`~PyTypeObject.tp_doc`. ::"
 msgstr ""
+"On fournit une *docstring* pour ce type via le membre :c:member:"
+"`~PyTypeObject.tp_doc`. ::"
 
 #: extending/newtypes_tutorial.rst:165
 msgid ""
@@ -249,31 +291,45 @@ msgid ""
 "use the default implementation provided by the API function :c:func:"
 "`PyType_GenericNew`. ::"
 msgstr ""
+"Pour permettre la création d'une instance, nous devons fournir un *handler* :"
+"c:member:`~PyTypeObject.tp_new`, qui est l'équivalent de la méthode Python :"
+"meth:`__new__`, mais elle a besoin d'être spécifiée explicitement. Dans ce "
+"cas, on se contente de l'implémentation par défaut fournie par la fonction :"
+"c:func:`PyType_GenericNew` de l'API."
 
 #: extending/newtypes_tutorial.rst:172
 msgid ""
 "Everything else in the file should be familiar, except for some code in :c:"
 "func:`PyInit_custom`::"
 msgstr ""
+"Le reste du fichier doit vous être familier, en dehors du code de :c:func:"
+"`PyInit_custom` ::"
 
 #: extending/newtypes_tutorial.rst:178
 msgid ""
 "This initializes the :class:`Custom` type, filling in a number of members to "
 "the appropriate default values, including :attr:`ob_type` that we initially "
 "set to ``NULL``. ::"
 msgstr ""
+"Il initialise le type :class:`Custom`, en assignant quelques membres à leurs "
+"valeurs par défaut, tel que :attr:`ob_type` qui valait initialement "
+"``NULL``. ::"
 
 #: extending/newtypes_tutorial.rst:189
 msgid ""
 "This adds the type to the module dictionary.  This allows us to create :"
 "class:`Custom` instances by calling the :class:`Custom` class:"
 msgstr ""
+"Ici on ajoute le type au dictionnaire du module. Cela permet de créer une "
+"instance de :class:`Custom` en appelant la classe :class:`Custom` :"
 
 #: extending/newtypes_tutorial.rst:197
 msgid ""
 "That's it!  All that remains is to build it; put the above code in a file "
 "called :file:`custom.c` and:"
 msgstr ""
+"C'est tout ! Il ne reste plus qu'à compiler, placez le code ci-dessus dans "
+"un fichier :file:`custom.c` et :"
 
 #: extending/newtypes_tutorial.rst:206
 msgid "in a file called :file:`setup.py`; then typing"