OVH Cloud OVH Cloud

[traduction] Je prend library: 3.34 __future__

4 réponses
Avatar
Alexandre Richer
Bonjour.

Je m'apelle Alexandre Richer, et je suis un =E9tudiant au baccalaur=E9at
en traduction (anglais vers le fran=E7ais) =E0 l'Universit=E9 Concordia,
=E0 Montr=E9al. J'ai aussi un formation en informatique. Je veux
participer =E0 la traduction de la documentation de Python -- si vous le
voulez bien, je vais commencer par traduire la doc du module
__future__.

Alexandre Richer

4 réponses

Avatar
Alexandre Richer
Allô.

Voici ma première version, non-LaTeXisée. deux questions:

future statement, import statement => instructions.. l'équivalence est
bonne?
fonctionnalité pour feature? Des suggestions?

Le titre est mauvais en ce moment. Il faut trouver mieux.

Quelle license utiliser? Le droit d'auteur français ne s'applique
probablement pas à moi étant donné que je vis au Canada. Finalement,
est-ce qu'on a contacté ? Un groupe d'usager interessé
à la traduction de la doc de python (toutes langues confondues) me
semble une bonne idée.

Alexandre Richer.

**traduction d'Alexandre Richer réalisée le 21 décembre 2005
suit..**

3.34 __future__ -- Définition des instructions _future_


__future__ est réellement un module. Il a trois raisons d'êtres:


Éviter de confondre les outils qui analise les instructions import et
s'attendent à trouver les modules importés quelque part.


S'assurer que les versions de Python antérieure à la version 2.1 vont
au moins lever une exception lorsqu'elle vont rencontrer une
instruction *future* (l'importation de __future__ va rater, puisqu'il
n'existait pas de module de ce nom avant 2.1)


Documenter l'introduction de changements incompatibles et le moment
auquel ils vont être -- ou ont été -- rendus obligatoires. Ceci est
une forme de documentation exécutable et on peut l'utiliser dans un
programme en important __future__ et en en examinant le contenu.



Chaque instruction de __future__.py a la forme:

FeatureName = "_Feature(" OptionalRelease "," MandatoryRelease ","
CompilerFlag ")"



où, normalement, OptionalRelease (version optionnelle) est moins
élevée que MandatoryRelease (version obligatoire). Ells sont notés
en utilisant un 5-tuplet de la même forme que sys.version_info:

(PY_MAJOR_VERSION, # le 2 dans 2.1.0a3; un int
PY_MINOR_VERSION, # le 1; un int
PY_MICRO_VERSION, # le 0; un int
PY_RELEASE_LEVEL, # "alpha", "beta", "candidate" ou "final";
string
PY_RELEASE_SERIAL # le 3; un int
)

OptionalRelease dénote la première version dans laquelle la
fonctionalité a été acceptée.

Quand une MandatoryRelease n'est pas encore arrivée, elle prédit dans
quelle version la fonctionalité entrera dans le langage à part
entière. Dans le cas contraire, elle rappelle quand ce changement est
arrivé. Dans les versions subséquentes, il n'est plus nécessaire
d'utiliser une instruction future pour utiliser la fonctionalité, mais
on peut continuer à le faire.

MandatoryRelease peut-aussi avoir la valeur None, ce qui veut dire
qu'une fonctionalité planifiée a été abandonnée.

Les instances de la classe _Feature ont deux méthodes correspondantes:
getOptionalRelease() et getMandatoryRelease()

CompilerFlag est le drapeau (sous forme de champs de bit) qui doit
être passé à la fonction intégrée compile() pour pouvoir utiliser
la fonctionalité dans du code compilé dynamiquement. Ce drapeau est
stocké dans l'attribut compiler_flag des instances de _Future.

Aucune description de fonctionnalité ne sera jamais effacée de
__future__
Avatar
F. Petitjean
Allô.

Voici ma première version, non-LaTeXisée. deux questions:
Tout d'abord merci, Alexandre de prendre le taureay par les cornes et de

proposer quelque chose.

future statement, import statement => instructions.. l'équivalence est
bonne?
Pas mal

fonctionnalité pour feature? Des suggestions?
ok


Le titre est mauvais en ce moment. Il faut trouver mieux.
En fait c'est de la spécification du « module » __future__ qu'il s'agit.


Quelle license utiliser? Le droit d'auteur français ne s'applique
probablement pas à moi étant donné que je vis au Canada. Finalement,
est-ce qu'on a contacté ? Un groupe d'usager interessé
à la traduction de la doc de python (toutes langues confondues) me
semble une bonne idée.
C'est marrant ce « groupe d'usager » :-) Enfin, j'écrirais plutôt groupe des

traducteurs de la documentation ...

Alexandre Richer.

**traduction d'Alexandre Richer réalisée le 21 décembre 2005
suit..**
Je me permets d'insérer mes remarqies. (avec les fautes d'orthographe/de

grammaire de rigueur)

3.34 __future__ -- Définition des instructions _future_


__future__ est réellement un module. Il a trois raisons d'êtres:
trois raisons d'être :



Éviter de confondre les outils qui analise les instructions import et
éviter que les outils qui analysent les instructions « import » et qui

s'attendent à trouver les modules importés quelque part.
s'attendent à retrouver les modules importés, ne soient perdus/ne

perdent le fil/ [roll your own expression :-)]


S'assurer que les versions de Python antérieure à la version 2.1 vont
antérieures

au moins lever une exception lorsqu'elle vont rencontrer une
instruction *future* (l'importation de __future__ va rater, puisqu'il
instruction « future » (l'importation de __future__ va échouer, puisqu'il

n'existait pas de module de ce nom avant 2.1)


Documenter l'introduction de changements incompatibles et le moment
auquel ils vont être -- ou ont été -- rendus obligatoires. Ceci est
où ils vont être -- ou ont été -- rendus obligatoires. Ceci est

une forme de documentation exécutable et on peut l'utiliser dans un
une forme de documentation dynamique et on peut l'utiliser dans un

programme en important __future__ et en en examinant le contenu.



Chaque instruction de __future__.py a la forme:
forme :


FeatureName = "_Feature(" OptionalRelease "," MandatoryRelease ","
CompilerFlag ")"



où, normalement, OptionalRelease (version optionnelle) est moins
où, normalement, « OptionalRelease » (version optionnelle) est moins

élevée que MandatoryRelease (version obligatoire). Ells sont notés
élevée que « MandatoryRelease » (version obligatoire). Ells sont notés

en utilisant un 5-tuplet de la même forme que sys.version_info:

(PY_MAJOR_VERSION, # le 2 dans 2.1.0a3; un int
(PY_MAJOR_VERSION, # le « 2 » dans « 2.1.0a3 », un entier

PY_MINOR_VERSION, # le 1; un int
PY_MINOR_VERSION, # le « 1 », un entier

PY_MICRO_VERSION, # le 0; un int
PY_MICRO_VERSION, # le « 0 », un entier

PY_RELEASE_LEVEL, # "alpha", "beta", "candidate" ou "final";
string
PY_RELEASE_LEVEL, # « alpha », « beta », « candidate », ou « final »:

une chaîne de caractères.
PY_RELEASE_SERIAL # le 3; un int
PY_RELEASE_SERIAL # le « 3 », un entier

)

OptionalRelease dénote la première version dans laquelle la
« OptionalRelease » dénote la première version dans laquelle la

fonctionalité a été acceptée.

Quand une MandatoryRelease n'est pas encore arrivée, elle prédit dans
Quand une « MandatoryRelease » n'est pas encore officialisée, elle

indique à aprtir de
quelle version la fonctionalité entrera dans le langage à part
quelle version la fonctionalité fera partie du langage.

entière. Dans le cas contraire, elle rappelle quand ce changement est
Dans le cas contraire, elle rappelle quand ce changement est arrivé.

arrivé. Dans les versions subséquentes, il n'est plus nécessaire
Dans les versions suivantes, il n'est plus nécessaire

d'utiliser une instruction future pour utiliser la fonctionalité, mais
on peut continuer à le faire.

MandatoryRelease peut-aussi avoir la valeur None, ce qui veut dire
« MandatoryRelease » peut aussi avoir la valeur « None », ce qui signifie

qu'une fonctionalité planifiée a été abandonnée.

Les instances de la classe _Feature ont deux méthodes correspondantes:
Les instances de la classe « _Feature » ont deux méthodes correspondantes :

getOptionalRelease() et getMandatoryRelease()
« getOptionalRelease() » et « getMandatoryRelease() »


CompilerFlag est le drapeau (sous forme de champs de bit) qui doit
« CompilerFlag » est le drapeau (sous forme de champ de bits) qui doit

être passé à la fonction intégrée compile() pour pouvoir utiliser
la fonctionalité dans du code compilé dynamiquement. Ce drapeau est
stocké dans l'attribut compiler_flag des instances de _Future.
stocké dans l'attribut « compiler_flag » des instances de « _Future ».


Aucune description de fonctionnalité ne sera jamais effacée de
__future__



--
dur, dur d'être traducteur
dur, dur d'être relecteur.

Avatar
Alexandre Richer
Je suis d'accord avec tes modifications, mais il me reste quelques
questions:

1) Mettre les noms de variables entre guillemets systématiquement?
Dans la version LaTeX, j'imagine qu'on utilisera une convention
typographique (police à empattement fixe) pour les distinguer du reste
du texte.

2) Est-ce que documentation dynamique rend bien le fait que c'est de la
doc disponible au moment de l'exécution? Le mot dynamique a tellement
de sens..

3) entier ou int? J'avais gardé le int parce que c'est une référence
directe à un type de Python. Je n'ai pas encore regardé ce que les
traducteurs de 2.0.1 avait décidé, mais si on décide d'utiliser des
termes français pour désigner les types de Python, il faut s'assurer
d'une certaine uniformité (entier c'est simple, mais string, float ou
dict, ce l'est moins).

Alexandre
Avatar
Alexandre Richer
Oh, et merci pour la relecture.