Translate Library/shelve #236

p13773 · 2018-07-12T19:03:34Z

JulienPalard · 2018-07-12T19:41:04Z

library/shelve.po

@@ -62,31 +79,52 @@ msgid ""
 "determine which accessed entries are mutable, nor which ones were actually "
 "mutated)."
 msgstr ""
+"À cause de la sémantique Python, une \"shelf\" ne peut pas savoir lorsqu'une "
+"entrée mutable de dictionnaire-persistant est modifiée. Par défaut les "


s/mutable/muable ou simplement modifiable.

JulienPalard · 2018-07-12T19:41:27Z

library/shelve.po

@@ -62,31 +79,52 @@ msgid ""
 "determine which accessed entries are mutable, nor which ones were actually "
 "mutated)."
 msgstr ""
+"À cause de la sémantique Python, une \"shelf\" ne peut pas savoir lorsqu'une "
+"entrée mutable de dictionnaire-persistant est modifiée. Par défaut les "


quoi un trait d'union entre dictionnaire et persistant ?

JulienPalard · 2018-07-12T19:41:50Z

library/shelve.po

+"entrée mutable de dictionnaire-persistant est modifiée. Par défaut les "
+"objets modifiés sont écris *seulement* lorsqu'ils sont assignés à une \"shelf"
+"\" (voir :ref:`shelve-example`). Si le paramètre optionnel *writeback* est "
+"mis à ``True``, toutes les entrées déjà accédées sont aussi misent en cache "


JulienPalard · 2018-07-12T19:42:09Z

library/shelve.po

+"objets modifiés sont écris *seulement* lorsqu'ils sont assignés à une \"shelf"
+"\" (voir :ref:`shelve-example`). Si le paramètre optionnel *writeback* est "
+"mis à ``True``, toutes les entrées déjà accédées sont aussi misent en cache "
+"en mémoire, et ré-écrite sur :meth:`~Shelf.sync` et :meth:`~Shelf.close`; "


Il manque un espace insécable avant le ;.

JulienPalard · 2018-07-12T19:42:36Z

library/shelve.po

+"\" (voir :ref:`shelve-example`). Si le paramètre optionnel *writeback* est "
+"mis à ``True``, toutes les entrées déjà accédées sont aussi misent en cache "
+"en mémoire, et ré-écrite sur :meth:`~Shelf.sync` et :meth:`~Shelf.close`; "
+"cela peut faciliter la mutation des entrées mutables dans le dictionnaire "


s/mutation/modification/ ?
s/mutables/modifiables ?

JulienPalard · 2018-07-12T20:00:22Z

library/shelve.po

+"Si le paramètre *writeback* est ``True``, l'objet va garder en cache toutes "
+"les entrées accédées et les écrire dans le *dict* aux moments de "
+"synchronisation et de fermeture. Cela permet des opérations naturelles sur "
+"les entrées mutables, mais peut consommer beaucoup plus de mémoire et rendre "


muables / modifiables

JulienPalard · 2018-07-12T20:00:44Z

library/shelve.po


 #: ../Doc/library/shelve.rst:120
 msgid ""
 "The *keyencoding* parameter is the encoding used to encode keys before they "
 "are used with the underlying dict."
 msgstr ""
+"Le paramètre *keyencoding* est l'encodage utilisé pour encoder les clés "
+"avant qu'elles soient utilisées avec le dictionnaire sous-jasent."


JulienPalard · 2018-07-12T20:01:06Z

library/shelve.po


 #: ../Doc/library/shelve.rst:123
 msgid ""
 "A :class:`Shelf` object can also be used as a context manager, in which case "
 "it will be automatically closed when the :keyword:`with` block ends."
 msgstr ""
+"Un objet :class:`Shelf` peut également être utilisé comme un manager de "


s/manager/gestionnaire/ (ou manager en italique, c'est un mot anglais).

JulienPalard · 2018-07-12T20:02:29Z

library/shelve.po

@@ -199,6 +288,13 @@ msgid ""
 "open` function.  The optional *protocol* and *writeback* parameters have the "
 "same interpretation as for the :class:`Shelf` class."
 msgstr ""
+"Une sous-classe de :class:`Shelf` qui accète un *filename* au lieu d'un "


il manque un p à accepte, et il y a un accent de trop.

JulienPalard · 2018-07-12T20:03:21Z

library/shelve.po

@@ -209,19 +305,21 @@ msgid ""
 "To summarize the interface (``key`` is a string, ``data`` is an arbitrary "
 "object)::"
 msgstr ""
+"Pour résumer l'interface (``key`` est une chaîne de caractère, ``data`` est "
+"un objet arbitraire)::"


le :: → : :: ou <espace insécable><deux points><deux points>.

christopheNan

Merci pour cette contribution.

christopheNan · 2018-07-13T15:49:39Z

library/shelve.po

 msgstr ""
+"Un *shelf* est un objet persistant, dictionnaire-compatible. La différence avec "
+"les bases de données \"dbm\" est que les valeurs (et non la clés !) dans un "


s/et non la clés/pas les clés/ ?

christopheNan · 2018-07-13T15:51:10Z

library/shelve.po

 msgstr ""
+"Un *shelf* est un objet persistant, dictionnaire-compatible. La différence avec "
+"les bases de données \"dbm\" est que les valeurs (et non la clés !) dans un "
+"*shelf* peuvent être des objets Python, essentiellement arbitraires --- "


"peuvent être des objets Python arbitraires" ? le "essentiellement" étant "par essence".

christopheNan · 2018-07-13T15:51:35Z

library/shelve.po

+"Un *shelf* est un objet persistant, dictionnaire-compatible. La différence avec "
+"les bases de données \"dbm\" est que les valeurs (et non la clés !) dans un "
+"*shelf* peuvent être des objets Python, essentiellement arbitraires --- "
+"n'importe quoi que le module :mod:`pickle` peut gérer. Cela inclus la plupart "


s/inclus/inclut/

christopheNan · 2018-07-13T15:53:11Z

library/shelve.po

 msgstr ""
+"Ouvre un dictionnaire persistant. Le nom de fichier spécifié est le nom de "
+"fichier de base pour la base de données sous-jacente. Comme effet de bord, une "


"basename" est le nom de fichier sans (son) extension. Par exemple, pour "fichier.txt", basename est "fichier".

christopheNan · 2018-07-13T15:54:47Z

library/shelve.po

 msgstr ""
+"À cause de la sémantique Python, un *shelf* ne peut pas savoir lorsqu'une entrée "
+"modifiable de dictionnaire persistant est modifiée. Par défaut les objets "
+"modifiés sont écris *seulement* lorsqu'ils sont assignés à une \"shelf\" (voir :"


s/ecris/écrits/

christopheNan · 2018-07-13T16:13:44Z

library/shelve.po

 msgstr ""
+"Un objet :class:`Shelf` peut également être utilisé comme un gestionnaire de "
+"contexte, auquel cas il sera automatiquement fermé lorsque le block :keyword:"


je remplacerais "auquel cas" par un point-virgule.

christopheNan · 2018-07-13T16:14:50Z

library/shelve.po

 msgstr ""
+"Une sous-classe de :class:`Shelf` qui propose :meth:`first`, :meth:`!next`, :"


Dans la documentation, nous ne mettons généralement pas d'article indéfini dans ce cas (remarque générale). Ici :
"Sous-classe de ..."

christopheNan · 2018-07-13T16:15:23Z

library/shelve.po

+"le module tiers :mod:`bsddb` de `pybsddb <https://www.jcea.es/programacion/"
+"pybsddb.htm>`_ mais non dans les autres modules de base de données. L'objet "
+"*dict* passé au constructeur ne doit pas supporter ces méthodes. Cela est "
+"généralement fait en appeleant une des fonctions suivantes : :func:`bsddb."


s/appeleant/appelant/

christopheNan · 2018-07-13T16:16:12Z

library/shelve.po

 msgstr ""
+"Une sous-classe de :class:`Shelf` qui accepte un *filename* au lieu d'un objet "
+"dictionnaire-compatible. Le fichier sous-jacent va être ouvert avec :func:`dbm."


s/va être/est/
et je mettrais le reste de la phrase aussi au présent.

christopheNan · 2018-07-13T16:17:31Z

library/shelve.po

+"open`. Par défaut le fichier va être créé en lecture et en écriture. Le "
+"paramètre optionnel *flag* peut être interprété de la même manière que pour la "
+"fonction :func:`.open`. Les paramètres optionnels *protocol* et *writeback* "
+"s'interprète de la même manière que pour la classe :class:`Shelf`."


s/interprète/interprètent/ (les paramètres).

christopheNan

J'ai fait encore quelques remarques.

christopheNan · 2018-07-14T20:52:51Z

library/shelve.po

-"dictionnaire persistant sur le disque, si faisable. Cela est appelé "
-"automatiquement quand le *shelf* est fermé avec :meth:`close`."
+"Réécrit toutes les entrées dans le cache si le *shelf* a été ouvert avec *writeback* passé "
+"à :const:`True`. Vide le cache et synchroniser le dictionnaire persistant sur le disque, si "


s/synchroniser/synchronise/

christopheNan · 2018-07-14T20:54:01Z

library/shelve.po

+"dépend de l'interface disponible. Donc c'est risqué d'ouvrir la base de données directement "
+"en utilisant :mod:`dbm`. La base de données est également (malheureusement) sujette à des "
+"limitations de :mod:`dbm`, si c'est utilisé --- cela signifie que (la représentation "
+"*pickled* de) l'objet stocké dans la base de données doit être assez petit, et dans de rare "


doit être assez petit et, dans de rares cas, des collisions ...

christopheNan · 2018-07-14T20:56:55Z

library/shelve.po

-"nécessite des connaissances à propos de l'implémentation de la base de données "
-"utilisée."
+"Le module :mod:`shelve` ne gère pas l'accès *concurrent* en lecture/écriture sur les objets "
+"stockés (les accès multiples simultanés sont sûrs). Lorsqu'un programme a un *shelf* ouvert "


les accès simultanés en lecture sont sûrs.

christopheNan · 2018-07-14T20:57:58Z

library/shelve.po

-"mais peut consommer beaucoup plus de mémoire et rendre les temps de "
-"synchronisation et de fermeture très long."
+"Si le paramètre *writeback* est ``True``, l'objet garde en cache toutes les entrées "
+"accédées et les écrire dans le *dict* aux moments de synchronisation et de fermeture. Cela "


s/les écrire/les écrit/

christopheNan · 2018-07-14T20:59:22Z

library/shelve.po

-"contexte, auquel cas il sera automatiquement fermé lorsque le block :keyword:"
-"`with` sera terminé."
+"Un objet :class:`Shelf` peut également être utilisé comme un gestionnaire de contexte ; il "
+"sera automatiquement fermé lorsque le block :keyword:`with` sera terminé."


On peut mettre cette phrase au présent.

christopheNan · 2018-07-14T20:59:47Z

library/shelve.po

 msgstr ""
-"Ajout du paramètre *keyencoding* ; précédemment, les clés étaient toujours "
-"encodés en UTF-8."
+"Ajout du paramètre *keyencoding* ; précédemment, les clés étaient toujours encodés en UTF-8."


s/encodés/encodées/ (les clés)

christopheNan · 2018-07-14T21:00:20Z

library/shelve.po

-"optionnels *protocol*, *writeback*, et *keyencoding* ont la même signification "
-"que pour la classe :class:`Shelf`."
+"Sous-classe de :class:`Shelf` qui propose :meth:`first`, :meth:`!next`, :meth:`previous`, :"
+"meth:`last` and :meth:`set_location` qui sont disponible dans le module tiers :mod:`bsddb` "


s/and/et/
s/disponible/disponibles/ (les méthodes)

christopheNan · 2018-07-14T21:02:11Z

library/shelve.po

+"Sous-classe de :class:`Shelf` qui propose :meth:`first`, :meth:`!next`, :meth:`previous`, :"
+"meth:`last` and :meth:`set_location` qui sont disponible dans le module tiers :mod:`bsddb` "
+"de `pybsddb <https://www.jcea.es/programacion/pybsddb.htm>`_ mais non dans les autres "
+"modules de base de données. L'objet *dict* passé au constructeur ne doit pas supporter ces "


Nous traduisons "to support" par "gérer".
Il me semble que la phrase originale dit l'inverse : l'objet doit (savoir) gérer ces méthodes.

p13773 added 2 commits July 12, 2018 21:15

start translate

a28e056

translate

76969f9

p13773 force-pushed the library/shelve branch from 0d1b74b to 76969f9 Compare July 12, 2018 19:16

JulienPalard requested changes Jul 12, 2018

View reviewed changes

changes after Julien Palard review

2087c47

christopheNan suggested changes Jul 13, 2018

View reviewed changes

changes after christopheNan review

15552cd

christopheNan suggested changes Jul 14, 2018

View reviewed changes

update after second review of christopheNan

b6e04fa

hotshot92 approved these changes Jul 16, 2018

View reviewed changes

christopheNan approved these changes Jul 16, 2018

View reviewed changes

JulienPalard merged commit c625a52 into python:3.7 Jul 19, 2018

		msgstr ""
		"Une sous-classe de :class:`Shelf` qui propose :meth:`first`, :meth:`!next`, :"

Translate Library/shelve #236

Translate Library/shelve #236

Uh oh!

Conversation

p13773 commented Jul 12, 2018

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

christopheNan left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

christopheNan left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!