You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
On est aussi joignable sur IRC, par exemple via https://kiwi.freenode.net/, channel #python-docs-fr, tu n'as pas besoin de créer de compte, pas besoin de mot de passe, juste besoin d'être patient car il est possible qu'on ne soit pas les yeux rivés sur le channel à ce moment là. Hésite pas à me mentionner d'ailleurs si tu pose une question (en écrivant mdk: avant ta question), je la verrai mieux.
Hello @Kydlaw . Toujours dessus ? Si non ce n'est pas grave, fais une PR avec ce que tu as déjà, qu'on puisse intégrer ton travail et que d'autres puissent continuer.
Vraiment navré pour l'attente... J'ai complété la traduction. Il me reste certains termes que je ne sais pas vraiment comment traduire (non rentré dans le glossaire). Je veux bien un coup de main là-dessus avant de soumettre la PR. Je les mets à la suite en gras italique:
Generics can be parameterized by using a new factory available in typing called :class:TypeVar.
It is possible to declare the return type of a callable without specifying the call signature by substituting a literal ellipsis for the list of arguments in the type hint: Callable[..., ReturnType].
-> (ellipse littérale ?)
This behavior allows :data:Any to be used as an escape hatch when you need to mix dynamically and statically typed code.
:pep:544 allows to solve this problem by allowing users to write the above code without explicit base classes in the class definition, allowing Bucket to be implicitly considered a subtype of both Sized and Iterable[int] by static type checkers. This is known as structural subtyping (or static duck-typing)::
-> (duck-typing revient très souvent dans ce module, j'osais pas partir sur "typage canard" sans demander)
This decorator is itself not available at runtime. It is mainly intended to mark classes that are defined in type stub files if an implementation returns an instance of a private class::
Note that returning instances of private classes is not recommended. It is usually preferable to make such classes public.
-> (ça me fait bizzare de traduire en "classes privées" ou "classes publiques", j'aimerais avoir votre avis)
Callable
-> (que j'ai traduit en Callable directement plutôt qu'appelable)
Vu que cette page m'intéresse, mes deux centimes (ça n'engage que moi :-)).
* Generics can be parameterized by using a new _**factory**_ available in typing called :class:`TypeVar`.
L'usage Wikipédien est de traduire par fabrique. On peut préciser « fabrique (au sens des patrons de conception) ».
* It is possible to declare the return type of a callable without specifying the call signature by substituting a _**literal ellipsis**_ for the list of arguments in the type hint: `Callable[..., ReturnType]`.
-> (ellipse littérale ?)
Une ellipse. Je pense que c'est suffisamment clair.
* This behavior allows :data:`Any` to be used as an _**escape hatch**_ when you need to mix dynamically and statically typed code.
Littéralement, une sortie de secours. Plus prosaïquement : une solution.
* :pep:`544` allows to solve this problem by allowing users to write the above code without explicit base classes in the class definition, allowing `Bucket` to be implicitly considered a subtype of both `Sized` and `Iterable[int]` by static type checkers. This is known as _structural subtyping_ (or static _**duck-typing**_)::
Je ne suis pas choqué par typage canard, ça se trouve dans quelques bouquins (même hors Python, en Ruby par exemple).
* This decorator is itself not available at runtime. It is mainly intended to mark classes that are defined in type _**stub**_ files if an implementation returns an instance of a private class::
Ok, ça c'est chaud. « définies dans des fichiers séparés spécifiques » ?
* Note that returning instances of _**private**_ classes is not recommended. It is usually preferable to make such classes _**public**_.
-> (ça me fait bizzare de traduire en "classes privées" ou "classes publiques", j'aimerais avoir votre avis)
Ellipsis : il s'agit des points de suspension (« … »). Voir le Glossaire de la documentation
duck-typing : wikipedia traduit effectivement par « typage canard »
christopheNan me coupe l'herbe sous le pied pour « typage canard » : c'est en effet utilisé par la page Wikipédia français, alors go ! Quand à « callable », je confirme que nous l'avons traduit partout par « appelables », le lecteur ne sera donc pas perdu.
Kydlaw, connais-tu pogrep ? C'est un outil fait par JulienPalard pour grep-er un terme anglais dans la traduction et voir dans quelle entrées il apparaît traduit, et donc par quoi il a déjà traduit dans la doc. C'est indispensable ! pip install pogrep puis pogrep <le mot> dans ton clone de python-docs-fr.
@deronnax Non, mais maintenant oui.
C'est effectivement indispensable et vraiment bien fichu. Kudos à JulienPalard du coup.
Il serait vraiment intéressant de le mentionner quelque part dans le README.rst
Activity
JulienPalard commentedon Jul 15, 2019
Bienvenu !
N'hésite pas à poser des questions.
On est aussi joignable sur IRC, par exemple via https://kiwi.freenode.net/, channel
#python-docs-fr, tu n'as pas besoin de créer de compte, pas besoin de mot de passe, juste besoin d'être patient car il est possible qu'on ne soit pas les yeux rivés sur le channel à ce moment là. Hésite pas à me mentionner d'ailleurs si tu pose une question (en écrivantmdk:avant ta question), je la verrai mieux.On organise aussi des ateliers sur Paris : https://www.meetup.com/fr-FR/Python-AFPY-Paris/ si tu es de la région, le prochain c'est jeudi.
nshaud commentedon Sep 16, 2019
@Kydlaw Tu travailles toujours dessus ?
Kydlaw commentedon Sep 16, 2019
Tu fais bien de me relancer, j'avais avancé jusqu'au départ en vacances et puis ...
Je termine dès que possible!
[-]Je travaille sur typing.po [/-][+]Je travaille sur library/typing.po [/+]deronnax commentedon Nov 17, 2019
Hello @Kydlaw . Toujours dessus ? Si non ce n'est pas grave, fais une PR avec ce que tu as déjà, qu'on puisse intégrer ton travail et que d'autres puissent continuer.
Kydlaw commentedon Nov 20, 2019
Vraiment navré pour l'attente... J'ai complété la traduction. Il me reste certains termes que je ne sais pas vraiment comment traduire (non rentré dans le glossaire). Je veux bien un coup de main là-dessus avant de soumettre la PR. Je les mets à la suite en gras italique:
Generics can be parameterized by using a new factory available in typing called :class:
TypeVar.It is possible to declare the return type of a callable without specifying the call signature by substituting a literal ellipsis for the list of arguments in the type hint:
Callable[..., ReturnType].-> (ellipse littérale ?)
This behavior allows :data:
Anyto be used as an escape hatch when you need to mix dynamically and statically typed code.:pep:
544allows to solve this problem by allowing users to write the above code without explicit base classes in the class definition, allowingBucketto be implicitly considered a subtype of bothSizedandIterable[int]by static type checkers. This is known as structural subtyping (or static duck-typing)::-> (duck-typing revient très souvent dans ce module, j'osais pas partir sur "typage canard" sans demander)
This decorator is itself not available at runtime. It is mainly intended to mark classes that are defined in type stub files if an implementation returns an instance of a private class::
Note that returning instances of private classes is not recommended. It is usually preferable to make such classes public.
-> (ça me fait bizzare de traduire en "classes privées" ou "classes publiques", j'aimerais avoir votre avis)
Callable
-> (que j'ai traduit en Callable directement plutôt qu'appelable)
vpoulailleau commentedon Nov 20, 2019
Pas simple effectivement 😉
Je pense que ça serait une bonne idée d'ensuite les ajouter au glossaire, non ?
nshaud commentedon Nov 20, 2019
Vu que cette page m'intéresse, mes deux centimes (ça n'engage que moi :-)).
L'usage Wikipédien est de traduire par fabrique. On peut préciser « fabrique (au sens des patrons de conception) ».
Une ellipse. Je pense que c'est suffisamment clair.
Littéralement, une sortie de secours. Plus prosaïquement : une solution.
Je ne suis pas choqué par typage canard, ça se trouve dans quelques bouquins (même hors Python, en Ruby par exemple).
Ok, ça c'est chaud. « définies dans des fichiers séparés spécifiques » ?
Je ne crois pas que ce soit un problème.
Je suis à peu près certain qu'appelable existe déjà dans la doc française.
Kydlaw commentedon Nov 20, 2019
Merci pour tes propositions @nshaud !
Si personne n'a d'objections, je fais les modifications ce soir et je soumets la PR pour review.
christopheNan commentedon Nov 20, 2019
Ellipsis : il s'agit des points de suspension (« … »). Voir le Glossaire de la documentation
duck-typing : wikipedia traduit effectivement par « typage canard »
deronnax commentedon Nov 21, 2019
christopheNan me coupe l'herbe sous le pied pour « typage canard » : c'est en effet utilisé par la page Wikipédia français, alors go ! Quand à « callable », je confirme que nous l'avons traduit partout par « appelables », le lecteur ne sera donc pas perdu.
Kydlaw, connais-tu
pogrep? C'est un outil fait par JulienPalard pour grep-er un terme anglais dans la traduction et voir dans quelle entrées il apparaît traduit, et donc par quoi il a déjà traduit dans la doc. C'est indispensable !pip install pogreppuispogrep <le mot>dans ton clone de python-docs-fr.Kydlaw commentedon Nov 21, 2019
@deronnax Non, mais maintenant oui.
C'est effectivement indispensable et vraiment bien fichu. Kudos à JulienPalard du coup.
Il serait vraiment intéressant de le mentionner quelque part dans le README.rst
JulienPalard commentedon Nov 22, 2019
On a pas de deadlines ici, no stress :)