ArmandS/python-docs-fr
Fork 0
forked from AFPy/python-docs-fr
Code Pull requests Activity

Merge pull request #263 from tburette/abc.po

Browse source 
Working on abc
This commit is contained in:
Julien Palard 2018-07-27 09:27:37 +02:00 • committed by GitHub
commit a6910ac9e4
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
1 changed files with 142 additions and 5 deletions
Download patch file Download diff file Expand all files Collapse all files

147
library/abc.po
View file

@ -6,13 +6,14 @@ msgstr ""
"Project-Id-Version: Python 3.6\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2018-03-23 09:03+0100\n"
"PO-Revision-Date: 2018-05-08 17:13+0200\n"
"PO-Revision-Date: 2018-07-25 16:29+0200\n"
"Last-Translator: Julien Palard <julien@palard.fr>\n"
"Language-Team: FRENCH <traductions@lists.afpy.org>\n"
"Language: fr\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"X-Generator: Poedit 2.0.9\n"
#: ../Doc/library/abc.rst:2
msgid ":mod:`abc` --- Abstract Base Classes"
@ -29,6 +30,14 @@ msgid ""
"see the PEP for why this was added to Python. (See also :pep:`3141` and the :"
"mod:`numbers` module regarding a type hierarchy for numbers based on ABCs.)"
msgstr ""
"Le module fournit l'infrastructure pour définir les :term:`classes de bases "
"abstraites <abstract base class>` ( *Abstract Base Class* ou *ABC* en "
"anglais ) en Python, tel qu'indiqué dans la :pep:`3119`; voir la PEP pour la "
"raison de son ajout à Python. (Voir également la :pep:`3141` et le module :"
"mod:`numbers` pour ce qui concerne la hiérarchie de types pour les nombres "
"basés sur les classes de base abstraites).\n"
"Par la suite nous utiliserons l'abréviation ABC ( *Abstract Base Class*) "
"pour désigner une classe de base abstraite."
#: ../Doc/library/abc.rst:20
msgid ""
@ -38,12 +47,21 @@ msgid ""
"class or instance provides a particular interface, for example, is it "
"hashable or a mapping."
msgstr ""
"Le module :mod:`collections` possède certains classes concrètes qui dérivent "
"d'ABC. Celles-ci peuvent, bien sur, être elles-mêmes dérivées. De plus; le "
"sous-module :mod:`collections.abc` possède des ABC qui peuvent être "
"utilisées pour tester si une classe ou une instance fournit une interface "
"spécifique. Par exemple, est-elle hachable ou un tableau associatif "
"( *mapping* ) ?"
#: ../Doc/library/abc.rst:27
msgid ""
"This module provides the metaclass :class:`ABCMeta` for defining ABCs and a "
"helper class :class:`ABC` to alternatively define ABCs through inheritance:"
msgstr ""
"Ce module fournit la métaclasse :class:`ABCMeta` pour définir les ABC ainsi "
"que la classe d'aide :class:`ABC`, cette dernière permettant de définir des "
"ABC en utilisant l'héritage :"
#: ../Doc/library/abc.rst:32
msgid ""
@ -51,6 +69,10 @@ msgid ""
"an abstract base class can be created by simply deriving from :class:`ABC` "
"avoiding sometimes confusing metaclass usage, for example::"
msgstr ""
"Une classe d'aide qui a :class:`ABCMeta` pour métaclasse. Avec cette classe, "
"une ABC peut être créée simplement en héritant de :class:`ABC` , ce qui "
"permet d'éviter l'utilisation parfois déroutante de métaclasse, par "
"exemple : ::"
#: ../Doc/library/abc.rst:41
msgid ""
@ -60,10 +82,16 @@ msgid ""
"One may also define an abstract base class by passing the metaclass keyword "
"and using :class:`ABCMeta` directly, for example::"
msgstr ""
"Il est à noter que le type de :class:`ABC` reste :class:`ABCMeta`. En "
"conséquence, hériter de :class:`ABC` nécessite les précautions habituelles "
"concernant l'utilisation de métaclasses: l'utilisation d'héritage multiple "
"peut entrainer des conflits de métaclasses. Il est également possible de "
"définir une ABC en passant l'argument nommé metaclass et en utilisant :class:"
"`ABCMeta` directement, par exemple : ::"
#: ../Doc/library/abc.rst:57
msgid "Metaclass for defining Abstract Base Classes (ABCs)."
msgstr ""
msgstr "Métaclasse pour définir des classes de base abstraites (ABC)."
#: ../Doc/library/abc.rst:59
msgid ""
@ -76,31 +104,50 @@ msgid ""
"will method implementations defined by the registering ABC be callable (not "
"even via :func:`super`). [#]_"
msgstr ""
"Utilisez cette métaclasse pour créer une ABC. Il est possible d'hériter "
"d'une ABC directement, cette classe de base abstraite fonctionne alors comme "
"une classe mixin. Vous pouvez également enregistrer une classe concrète sans "
"lien (même une classe native) et des ABC comme \"sous-classes virtuelles\" "
"-- celles-ci et leur descendantes seront considérées comme des sous-classes "
"de la classe de base abstraite par la fonction native :func:`issubclass`, "
"mais les ABC enregistrées n'apparaitront pas dans leur ordre de résolution "
"des méthodes (*MRO* pour *Method Resolution Order* en anglais). Les "
"implémentations de méthodes définies par l'ABC ne seront pas appelable (pas "
"même via :func:`super`). [#]_"
#: ../Doc/library/abc.rst:68
msgid ""
"Classes created with a metaclass of :class:`ABCMeta` have the following "
"method:"
msgstr ""
"Les classes créées avec comme métaclasse :class:`ABCMeta` possèdent les "
"méthodes suivantes :"
#: ../Doc/library/abc.rst:72
msgid ""
"Register *subclass* as a \"virtual subclass\" of this ABC. For example::"
msgstr ""
"Enregistrer *subclass* en tant que sous-classe virtuelle de cette ABC. Par "
"exemple : ::"
#: ../Doc/library/abc.rst:85
msgid "Returns the registered subclass, to allow usage as a class decorator."
msgstr ""
"Renvoie la sous-classe enregistrée pour permettre l'utilisation en tant que "
"décorateur de classe."
#: ../Doc/library/abc.rst:88
msgid ""
"To detect calls to :meth:`register`, you can use the :func:`get_cache_token` "
"function."
msgstr ""
"Pour détecter les appels à :meth:`register`, vous pouvez utiliser la "
"fonction :func:`get_cache_token`."
#: ../Doc/library/abc.rst:92
msgid "You can also override this method in an abstract base class:"
msgstr ""
"Vous pouvez également redéfinir (*override*) cette méthode dans une ABC :"
#: ../Doc/library/abc.rst:96
msgid "(Must be defined as a class method.)"
@ -114,6 +161,12 @@ msgid ""
"of the ABC. (This class method is called from the :meth:`__subclasscheck__` "
"method of the ABC.)"
msgstr ""
"Vérifie si *subclass* est considérée comme une sous-classe de cette ABC. "
"Cela signifie que vous pouvez personnaliser le comportement de "
"``issubclass`` sans nécessiter d'appeler :meth:`register` pour chacune des "
"classes que vous souhaitez considérer comme sous-classe de l'ABC. (Cette "
"méthode de classe est appelée par la méthode :meth:`__subclasscheck__` de la "
"classe de base abstraite)."
#: ../Doc/library/abc.rst:104
msgid ""
@ -123,11 +176,19 @@ msgid ""
"even if it would normally be one. If it returns ``NotImplemented``, the "
"subclass check is continued with the usual mechanism."
msgstr ""
"Cette méthode devrait renvoyer ``True``, ``False`` ou ``NotImplemented``. Si "
"elle renvoie ``True``, *subclass* est considérée comme sous-classe de cette "
"ABC. Si elle renvoie ``False``, la *subclass* n'est pas considérée une sous-"
"clase de cette ABC même si elle l'aurait été en temps normal. Si elle "
"renvoie ``NotImplemented``, la vérification d'appartenance à la sous-classe "
"continue via le mécanisme habituel."
#: ../Doc/library/abc.rst:114
msgid ""
"For a demonstration of these concepts, look at this example ABC definition::"
msgstr ""
"Pour une démonstration de ces concepts, voir cet exemple de définition de "
"ABC : ::"
#: ../Doc/library/abc.rst:143
msgid ""
@ -137,6 +198,11 @@ msgid ""
"also part of the ``MyIterable`` abstract base class, but it does not have to "
"be overridden in non-abstract derived classes."
msgstr ""
"L'ABC ``MyIterable`` définit la méthode d'itération :meth:`~iterator."
"__iter__` comme méthode abstraite. L'implémentation qui lui est donnée ici "
"peut être appelée depuis les sous-classes. La méthode :meth:`get_iterator` "
"fait également partie de la classe de base abstraite ``MyIterable``, mais "
"elle n'a pas à être redéfinie dans les classes dérivées non-abstraites."
#: ../Doc/library/abc.rst:149
msgid ""
@ -145,6 +211,11 @@ msgid ""
"__dict__` (or in that of one of its base classes, accessed via the :attr:"
"`~class.__mro__` list) is considered a ``MyIterable`` too."
msgstr ""
"La méthode de classe :meth:`__subclasshook__` définie ici dit que toute "
"classe qui possède la méthode :meth:`~iterator.__iter__` dans son :attr:"
"`~object.__dict__` (ou dans une de ses classes de base, accédée via la "
"liste :attr:`~class.__mro__`) est considérée également comme un "
"``MyIterable``."
#: ../Doc/library/abc.rst:154
msgid ""
@ -154,6 +225,12 @@ msgid ""
"meth:`__getitem__`). Note that this will not make ``get_iterator`` "
"available as a method of ``Foo``, so it is provided separately."
msgstr ""
"Enfin, la dernière ligne fait de ``Foo`` une sous-classe virtuelle de "
"``MyIterable``, même si cette classe ne définit pas de méthode :meth:"
"`~iterator.__iter__` (elle utilise l'ancien protocol d'itération qui se "
"définit en termes de :meth:`__len__` et :meth:`__getitem__`). A noter que "
"cela ne rendra pas le ``get_iterator`` de ``MyIterable`` disponible comme "
"une méthode de ``Foo``, ``get_iterator`` est donc implémenté séparément."
#: ../Doc/library/abc.rst:163
msgid "The :mod:`abc` module also provides the following decorator:"
@ -161,7 +238,7 @@ msgstr "Le module :mod:`abc` fournit aussi le décorateur :"
#: ../Doc/library/abc.rst:167
msgid "A decorator indicating abstract methods."
msgstr "Un décorateur marquant les méthodes abstraites."
msgstr "Un décorateur marquant les méthodes comme abstraites."
#: ../Doc/library/abc.rst:169
msgid ""
@ -172,6 +249,13 @@ msgid ""
"the normal 'super' call mechanisms. :func:`abstractmethod` may be used to "
"declare abstract methods for properties and descriptors."
msgstr ""
"Utiliser ce décorateur nécessite que la métaclasse de la classe soit :class:"
"`ABCMeta` ou soit dérivé de celle-ci. Une classe qui possède une méta-classe "
"dérivée de :class:`ABCMeta` ne peut pas être instanciée à moins que toutes "
"ses méthodes et propriétés abstraites soient redéfinies. Les méthodes "
"abstraites peuvent être appelées en utilisant n'importe quel des mécanismes "
"d'appel à 'super'. :func:`abstractmethod` peut être utilisé pour déclarer "
"des méthodes abstraites pour les propriétés et descripteurs."
#: ../Doc/library/abc.rst:176
msgid ""
@ -181,6 +265,12 @@ msgid ""
"regular inheritance; \"virtual subclasses\" registered with the ABC's :meth:"
"`register` method are not affected."
msgstr ""
"Ajouter dynamiquement des méthodes abstraites à une classe ou essayer de "
"modifier le statut d'abstraction d'une méthode ou d'une classe une fois "
"celle-ci créée n'est pas géré. :func:`abstractmethod` n'affecte que les sous-"
"classes dérivées utilisant l'héritage classique. Les \"sous-classes "
"virtuelles\" enregistrées avec la méthode :meth:`register` de l'ABC ne sont "
"pas affectées."
#: ../Doc/library/abc.rst:182
msgid ""
@ -188,6 +278,9 @@ msgid ""
"descriptors, it should be applied as the innermost decorator, as shown in "
"the following usage examples::"
msgstr ""
"Quand le décorateur :func:`abstractmethod` est utilisé en même temps que "
"d'autres descripteurs de méthodes, il devrait être appliqué en tant que "
"décorateur le plus interne. Voir les exemples d'utilisation suivants : ::"
#: ../Doc/library/abc.rst:216
msgid ""
@ -197,6 +290,11 @@ msgid ""
"of the methods used to compose the descriptor are abstract. For example, "
"Python's built-in property does the equivalent of::"
msgstr ""
"Afin d'interagir correctement avec le mécanisme de classe de base abstraite, "
"un descripteur doit s'identifier comme abstrait en utilisant :attr:"
"`__isabstractmethod__`. En général, cet attribut devrait être ``True`` si au "
"moins une des méthodes faisant partie du descripteur est abstraite. Par "
"exemple, la propriété native de python fait l'équivalent de : ::"
#: ../Doc/library/abc.rst:231
msgid ""
@ -206,46 +304,66 @@ msgid ""
"point for a super-call in a framework that uses cooperative multiple-"
"inheritance."
msgstr ""
"Contrairement aux méthodes abstraites Java, ces méthodes abstraites peuvent "
"posséder une implémentation. Cette implémentation peut être appelée via le "
"mécanisme :func:`super` depuis la classe qui la redéfinie."
#: ../Doc/library/abc.rst:239
msgid "The :mod:`abc` module also supports the following legacy decorators:"
msgstr ""
"Le module :mod:`abc` gère également les décorateurs historiques suivants :"
#: ../Doc/library/abc.rst:244
msgid ""
"It is now possible to use :class:`classmethod` with :func:`abstractmethod`, "
"making this decorator redundant."
msgstr ""
"Il est désormais possible d'utiliser :class:`classmethod` avec :func:"
"`abstractmethod`, cela rend ce décorateur redondant."
#: ../Doc/library/abc.rst:248
msgid ""
"A subclass of the built-in :func:`classmethod`, indicating an abstract "
"classmethod. Otherwise it is similar to :func:`abstractmethod`."
msgstr ""
"Une sous-classe du décorateur natif :func:`classmethod` qui indique une "
"méthode de classe ( ``classmethod`` ) abstraite. En dehors de cela, est "
"similaire à :func:`abstractmethod`."
#: ../Doc/library/abc.rst:251
msgid ""
"This special case is deprecated, as the :func:`classmethod` decorator is now "
"correctly identified as abstract when applied to an abstract method::"
msgstr ""
"Ce cas spécial est obsolète car le décorateur :func:`classmethod` est "
"désormais correctement identifié comme abstrait quand appliqué à une méthode "
"abstraite : ::"
#: ../Doc/library/abc.rst:265
msgid ""
"It is now possible to use :class:`staticmethod` with :func:`abstractmethod`, "
"making this decorator redundant."
msgstr ""
"Il est désormais possible d'utiliser :class:`staticmethod` avec :func:"
"`abstractmethod`, cela rend ce décorateur redondant."
#: ../Doc/library/abc.rst:269
msgid ""
"A subclass of the built-in :func:`staticmethod`, indicating an abstract "
"staticmethod. Otherwise it is similar to :func:`abstractmethod`."
msgstr ""
"Une sous-classe du décorateur natif :func:`classmethod` qui indique une "
"méthode statique ( ``staticmethod`` ) abstraite. En dehors de cela, est "
"similaire à :func:`abstractmethod`."
#: ../Doc/library/abc.rst:272
msgid ""
"This special case is deprecated, as the :func:`staticmethod` decorator is "
"now correctly identified as abstract when applied to an abstract method::"
msgstr ""
"Ce cas spécial est obsolète car le décorateur :func:`staticmethod` est "
"désormais correctement identifié comme abstrait quand appliqué à une méthode "
"abstraite : ::"
#: ../Doc/library/abc.rst:285
msgid ""
@ -253,17 +371,24 @@ msgid ""
"`property.setter` and :meth:`property.deleter` with :func:`abstractmethod`, "
"making this decorator redundant."
msgstr ""
"Il est désormais possible d'utiliser :class:`property`, :meth:`property."
"getter`, :meth:`property.setter` et :meth:`property.deleter` avec :func:"
"`abstractmethod`, ce qui rend ce décorateur redondant."
#: ../Doc/library/abc.rst:290
msgid ""
"A subclass of the built-in :func:`property`, indicating an abstract property."
msgstr ""
"Une sous-classe de :func:`property`, qui indique une propriété abstraite."
#: ../Doc/library/abc.rst:293
msgid ""
"This special case is deprecated, as the :func:`property` decorator is now "
"correctly identified as abstract when applied to an abstract method::"
msgstr ""
"Ce cas spécial est obsolète car le décorateur :func:`property` est désormais "
"correctement identifié comme abstrait quand appliqué à une méthode "
"abstraite : ::"
#: ../Doc/library/abc.rst:303
msgid ""
@ -271,20 +396,26 @@ msgid ""
"write abstract property by appropriately marking one or more of the "
"underlying methods as abstract::"
msgstr ""
"L'exemple ci-dessus définit une propriété en lecture seule. Vous pouvez "
"également définir une propriété en lecture-écriture abstraite en indiquant "
"une ou plusieurs des méthodes sous-jacentes comme abstraite : ::"
#: ../Doc/library/abc.rst:317
msgid ""
"If only some components are abstract, only those components need to be "
"updated to create a concrete property in a subclass::"
msgstr ""
"Si seuls certains composants sont abstraits, seuls ces composants abstraits "
"nécessitent d'être mis à jour pour créer une propriété concrète dans une "
"sous-classe : ::"
#: ../Doc/library/abc.rst:326
msgid "The :mod:`abc` module also provides the following functions:"
msgstr ""
msgstr "Le module :mod:`abc` fournit également la fonction suivante :"
#: ../Doc/library/abc.rst:330
msgid "Returns the current abstract base class cache token."
msgstr ""
msgstr "Renvoie le jeton de cache ( *cache token*) de l'ABC."
#: ../Doc/library/abc.rst:332
msgid ""
@ -292,6 +423,10 @@ msgid ""
"the current version of the abstract base class cache for virtual subclasses. "
"The token changes with every call to :meth:`ABCMeta.register` on any ABC."
msgstr ""
"Le jeton est un objet opaque (qui implémente le test d'égalité) qui "
"identifie la version actuelle du cache de l'ABC pour les sous-classes "
"virtuelles. Le jeton change avec chaque appel à :meth:`ABCMeta.register` sur "
"n'importe quelle ABC."
#: ../Doc/library/abc.rst:340
msgid "Footnotes"
@ -302,3 +437,5 @@ msgid ""
"C++ programmers should note that Python's virtual base class concept is not "
"the same as C++'s."
msgstr ""
"Les développeurs C++ noteront que le concept Python de classe de base "
"virtuelle ( *virtual base class* ) n'est pas le même que celui de C++."