Traduction doc de python

Version imprimable

Traduction __doc__ de python

Bonjour,

J'utilise Pyscripter et il y a une auto-complétion sur les fonctions qui donne une description des paramètres attendus en allant chercher dans la chaine __doc__ de la fonction. Je voudrais traduire cette info pour quelques fonctions de base. J'ai donc redéfini ces fonctions ainsi par exemple (Python 3.2) :

Code:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
 
def range(debut,fin='optionel',pas='optionel'):
    """
    debut, fin et pas sont des entiers.
    Les paramètres debut et pas sont optionnels.
    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
    Retourne une liste d’entiers :
      – De l’intervalle [0; deb[ si un seul paramètre est renseigné.
      – De l’intervalle [deb; fin[ si 2 paramètres sont renseignés
      – De l’intervalle [deb; fin[ mais en réalisant une suite arithmétique de raison pas si les 3 paramètres sont renseignés.
    """
    if pas=='optionel':
        if fin=='optionel':
            return builtins.range(debut)
        else :
            return builtins.range(debut,fin)
    else :
        return builtins.range(debut,fin,pas)

Mais du coup, c'est assez complexe à gérer. Voyez-vous une autre solution ?

Merci,
Vincent

11/04/2013, 16h59
wiztricks

Salut,

C'est un travail de romain mais pourquoi pas!
Pourquoi ne pas utiliser gettext (la bibilothèque standard qui permet d'associer à du texte des traductions dans n-langues).
Pour cela, il faudrait mettre à jour l'attribut __doc__ avec un appel à gettext: si __doc__ = "la documentation de l'objet", on le ré-ecrit __doc__ = _("la documentation de l'objet"). Ce qui va remplacer le __doc__ par sa traduction.
note: "_" est le raccourci généralement utilisé pour appeler gettext.

Si vous cherchez sur google avec "using gettext to translate python docstrings", vous tomberez sur cette discussion qui montre comment "patcher" remplacer le docstring) automatiquement un module en utilisant inspect.

Voilà pour la méthode, après, il faut adapter (et écrire les traductions).

- W
23/04/2013, 09h47
rambc
Bonjour.

Citation:

Envoyé par magicvinni

... la chaine __doc__ de la fonction. Je voudrais traduire cette info pour quelques fonctions de base.

Le mieux serait de procéder comme suit, cela me semble plus utile.
1. Ne taper des docstrings qu'en anglais.
2. Faire une mini-doc dans le langage que tu veux.
Intérêts de cette méthode.
1. En faisant comme suit, on ne touche jamais aux docstrings et on rend son programme "iinternational".
2. N'importe qui peut traduire la doc. dans un autre langage.
28/04/2013, 20h46
progamer2013

Connaissance

Bonsoir a tous je suis nouveau en programmation de Python je dirai même débutant je suis a l’étude de l'expression while
voila ma préoccupation
sous Python Windows je ne trouve pas le signe (plus petit et plus grand)
sous Python Shell je peux fais le copier et coller ça marche
mais lorsque je veux essayer par exemple
a,b,c=1,1,1
while c(inférieur) a 1 :
print (a),
a,b,c=b,a+1,c+1
et que je valide au lieu d'obtenir plutôt les nombres sur la même ligne
11,12,26,26,45,88(juste un aperçue)
j'obtient plutôt un truc de ce genre
11
12
26
26
45
88

j'aimerai donc savoir quel est le problème et ou puis je trouver la touche (inférieur et supérieur)
merci
28/04/2013, 21h29
magicvinni

Bonsoir,

Merci à tous de vos réponses.

@rambc : Oui, ce n'est pas terrible de modifier le docstring du module je trouve aussi. En fait nous avons déjà fait une doc AmiensPython. Mais l'EDI Pyscripter propose des infos-bulles en allant chercher dans le docstring justement, qui peut être appréciable pour les élèves dans un premier temps.

http://download.tuxfamily.org/amienspython/exemple.png

@progamer2013 : Je ne vois pas trop ce que vient faire ton message ici... Si c'est sous Python 3.x la syntaxe pour ne pas aller à la ligne est print(a,sep='') car print a, c'est pour Python 2.x

Vincent