Skip to content

Je travaille sur library/typing.po  #835

Closed

Description

@Kydlaw

Première fois que je contribue à un projet open source, je vous tiens au courant.

Activity

  1. JulienPalard commented on Jul 15, 2019

    @JulienPalard
    Member

    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 écrivant mdk: 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.

  2. nshaud commented on Sep 16, 2019

    @nshaud
    Contributor

    @Kydlaw Tu travailles toujours dessus ?

  3. Kydlaw commented on Sep 16, 2019

    @Kydlaw
    ContributorAuthor

    Tu fais bien de me relancer, j'avais avancé jusqu'au départ en vacances et puis ...
    Je termine dès que possible!

  4. added
    reservationThis issue is a "lock" on a file, so only one person is working on it.
    on Nov 1, 2019
  5. changed the title [-]Je travaille sur typing.po [/-] [+]Je travaille sur library/typing.po [/+] on Nov 5, 2019
  6. deronnax commented on Nov 17, 2019

    @deronnax
    Collaborator

    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.

  7. Kydlaw commented on Nov 20, 2019

    @Kydlaw
    ContributorAuthor

    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)

  8. vpoulailleau commented on Nov 20, 2019

    @vpoulailleau
    Contributor

    Pas simple effectivement 😉

    Je pense que ça serait une bonne idée d'ensuite les ajouter au glossaire, non ?

  9. nshaud commented on Nov 20, 2019

    @nshaud
    Contributor

    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)
    

    Je ne crois pas que ce soit un problème.

    * _**Callable**_
      -> (que j'ai traduit en _Callable_ directement plutôt qu'appelable)
    

    Je suis à peu près certain qu'appelable existe déjà dans la doc française.

  10. Kydlaw commented on Nov 20, 2019

    @Kydlaw
    ContributorAuthor

    Merci pour tes propositions @nshaud !
    Si personne n'a d'objections, je fais les modifications ce soir et je soumets la PR pour review.

  11. christopheNan commented on Nov 20, 2019

    @christopheNan
    Contributor

    Ellipsis : il s'agit des points de suspension (« … »). Voir le Glossaire de la documentation
    duck-typing : wikipedia traduit effectivement par « typage canard »

  12. deronnax commented on Nov 21, 2019

    @deronnax
    Collaborator

    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.

  13. Kydlaw commented on Nov 21, 2019

    @Kydlaw
    ContributorAuthor

    @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

  14. JulienPalard commented on Nov 22, 2019

    @JulienPalard
    Member

    Vraiment navré pour l'attente...

    On a pas de deadlines ici, no stress :)

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    reservationThis issue is a "lock" on a file, so only one person is working on it.

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions