16.14. "platform" — Accès aux données sous-jacentes de la plateforme
********************************************************************

**Code source :** Lib/platform.py

======================================================================

Note:

  Les spécificités des plateformes sont regroupées dans des sections
  triées par ordre alphabétique. Linux est inclus dans la section
  Unix.


16.14.1. Multi-plateforme
=========================

platform.architecture(executable=sys.executable, bits='', linkage='')

   Interroge l'exécutable fourni (par défaut l'interpréteur Python)
   sur les informations de l'architecture.

   Renvoie un *n*-uplet de "(bits, linkage)" qui contient de
   l'information sur l'architecture binaire et le format de lien. Les
   deux valeurs sont des chaînes de caractères.

   Lorsqu'une valeur ne peut être déterminée, la valeur passée en
   paramètre est utilisée. Si la valeur passée à *bits* est "''", la
   valeur de "sizeof(pointer)" (ou "sizeof(long)" sur les versions
   Python antérieures à 1.5.2) est utilisée comme indicateur de la
   taille de pointeur prise en charge.

   La fonction dépend de la commande "file" du système pour accomplir
   la tâche. *file* est disponible sur quasiment toutes les
   plateformes Unix ainsi que sur certaines plateformes hors de la
   famille Unix et l'exécutable doit pointer vers l'interpréteur
   Python. Des valeurs par défaut raisonnables sont utilisées lorsque
   les conditions précédentes ne sont pas atteintes.

   Note:

     Sur Mac OS X (ainsi que d'autres plateformes), les fichiers
     exécutables peuvent être universels et contenir plusieurs
     architectures.Afin de déterminer si l'interpréteur courant est
     64-bit, une méthode plus fiable est d'interroger l'attribut
     "sys.maxsize" :

        is_64bits = sys.maxsize > 2**32

platform.machine()

   Renvoie le type de machine. Par exemple, "'i386'". Une chaîne de
   caractères vide est renvoyée si la valeur ne peut être déterminée.

platform.node()

   Renvoie le nom de l'ordinateur sur le réseau (pas forcément
   pleinement qualifié). Une chaîne de caractères vide est renvoyée
   s'il ne peut pas être déterminé.

platform.platform(aliased=0, terse=0)

   Renvoie une chaîne de caractère identifiant la plateforme avec le
   plus d'informations possible.

   La valeur renvoyée est destinée à la *lecture humaine* plutôt que
   l'interprétation machine. Il est possible qu'elle soit différente
   selon la plateforme et c'est voulu.

   Si *aliased* est vrai, la fonction utilisera des alias pour
   certaines plateformes qui utilisent des noms de système qui
   diffèrent de leurs noms communs. Par exemple, SunOS sera reconnu
   comme Solaris. La fonction "system_alias()" est utilisée pour
   l'implémentation.

   Si *terse* est vrai, la fonction ne renverra que l'information
   nécessaire à l'identification de la plateforme.

platform.processor()

   Renvoie le (vrai) nom du processeur. Par exemple : "'amdk6'".

   Une chaîne de caractères vide est renvoyée si la valeur ne peut
   être déterminée. Prenez note que plusieurs plateformes ne
   fournissent pas cette information ou renvoient la même valeur que
   la fonction "machine()". NetBSD agit ainsi.

platform.python_build()

   Renvoie une paire "(buildno, builddate)" de chaîne de caractères
   identifiant la version et la date de compilation de Python.

platform.python_compiler()

   Renvoie une chaîne de caractères identifiant le compilateur utilisé
   pour compiler Python.

platform.python_branch()

   Renvoie la chaîne de caractères identifiant la branche du
   gestionnaire de versions de l'implémentation Python.

platform.python_implementation()

   Renvoie une chaîne de caractères identifiant l'implémentation de
   Python. Des valeurs possibles sont : "CPython", "IronPython",
   "Jython", "Pypy".

platform.python_revision()

   Renvoie la chaîne de caractères identifiant la révision du
   gestionnaire de versions de l'implémentation Python.

platform.python_version()

   Renvoie la version de Python comme une chaîne de caractères
   "'major.minor.patchlevel'".

   Prenez note que la valeur renvoyée inclut toujours le *patchlevel*
   (valeur par défaut de 0) à la différence de "sys.version".

platform.python_version_tuple()

   Renvoie la version de Python comme un triplet de chaînes de
   caractères "(major, minor, patchlevel)".

   Prenez note que la valeur renvoyée inclut toujours le *patchlevel*
   (valeur par défaut de "'0'") à la différence de "sys.version".

platform.release()

   Renvoie la version de déploiement du système, par exemple,
   "'2.2.0'" ou "'NT'". Une chaîne de caractères vide signifie
   qu'aucune valeur ne peut être déterminée.

platform.system()

   Returns the system/OS name, e.g. "'Linux'", "'Windows'", or
   "'Java'". An empty string is returned if the value cannot be
   determined.

platform.system_alias(system, release, version)

   Renvoie "(system, release, version)" avec des alias pour les noms
   communs de certains systèmes. Modifie aussi l'ordre de
   l'information pour éviter la confusion.

platform.version()

   Renvoie la version de déploiement du système. Par exemple, "'#3 on
   degas'". Une chaîne de caractères vide est renvoyée si aucune
   valeur ne peut être déterminée.

platform.uname()

   Interface de *uname* relativement portable. Renvoie un
   "namedtuple()" contenant six attributs : "system", "node",
   "release", "version", "machine" et "processor".

   Prenez note qu'il y a un attribut supplémentaire ("processor") par
   rapport à la valeur de retour de "os.uname()". De plus, les deux
   premiers attributs changent de nom ; ils s'appellent "sysname" et
   "nodename" pour la fonction "os.uname()".

   Les entrées qui ne peuvent pas être identifiées ont la valeur "''".

   Modifié dans la version 3.3: Le type renvoyé passe d'un *tuple* à
   un *namedtuple*.


16.14.2. Plateforme Java
========================

platform.java_ver(release='', vendor='', vminfo=('', '', ''), osinfo=('', '', ''))

   Version de l'interface pour Jython.

   Renvoie un *n*-uplet "(release, vendor, vminfo, osinfo)". *vminfo*
   est un triplet de valeur "(vm_name, vm_release, vm_vendor)" et
   *osinfo* est un triplet de valeur "(os_name, os_version, os_arch)".
   Les valeurs indéterminables ont la valeur des paramètres par défaut
   (valeur de "''" par défaut).


16.14.3. Plateforme Windows
===========================

platform.win32_ver(release='', version='', csd='', ptype='')

   Interroge le registre Windows pour de l'information supplémentaire
   et renvoie un triplet de "(release, version, csd, ptype)" faisant
   référence au  numéro de version du SE, le numéro de version, le
   niveau de CSD (Service Pack) et le type de SE (monoprocesseur ou
   multiprocesseur).

   Astuce : *ptype* est "'Uniprocessor Free'" sur des machines NT
   ayant qu'un seul processeur et "'Multiprocessor Free'" sur des
   machines ayant plusieurs processeurs. La composante *'Free'* fait
   référence à l'absence de code de débogage dans le SE. Au contraire,
   *'Checked'* indique que le SE utilise du code de débogage pour
   valider les paramètres, etc.

   Note:

     This function works best with Mark Hammond's "win32all" package
     installed, but also on Python 2.3 and later (support for this was
     added in Python 2.6). It obviously only runs on Win32 compatible
     platforms.


16.14.3.1. Win95/98 specific
----------------------------

platform.popen(cmd, mode='r', bufsize=-1)

   Portable "popen()" interface.  Find a working popen implementation
   preferring "win32pipe.popen()".  On Windows NT, "win32pipe.popen()"
   should work; on Windows 9x it hangs due to bugs in the MS C
   library.

   Obsolète depuis la version 3.3: This function is obsolete.  Use the
   "subprocess" module.  Check especially the Remplacer les fonctions
   plus anciennes par le module subprocess section.


16.14.4. Plateforme Mac OS
==========================

platform.mac_ver(release='', versioninfo=('', '', ''), machine='')

   Renvoie les informations de version de Mac OS avec un triplet de
   "(release, versioninfo, machine)". *versioninfo* est un triplet de
   "(version, dev_stage, non_release_version)".

   Les entrées qui ne peuvent pas être identifiées auront la valeur
   "''". Les membres du *n*-uplet sont tous des chaînes de caractères.


16.14.5. Plateformes Unix
=========================

platform.dist(distname='', version='', id='', supported_dists=('SuSE', 'debian', 'redhat', 'mandrake', ...))

   This is another name for "linux_distribution()".

   Deprecated since version 3.5, will be removed in version 3.8: See
   alternative like the distro package.

platform.linux_distribution(distname='', version='', id='', supported_dists=('SuSE', 'debian', 'redhat', 'mandrake', ...), full_distribution_name=1)

   Tries to determine the name of the Linux OS distribution name.

   "supported_dists" may be given to define the set of Linux
   distributions to look for. It defaults to a list of currently
   supported Linux distributions identified by their release file
   name.

   If "full_distribution_name" is true (default), the full
   distribution read from the OS is returned. Otherwise the short name
   taken from "supported_dists" is used.

   Returns a tuple "(distname,version,id)" which defaults to the args
   given as parameters.  "id" is the item in parentheses after the
   version number.  It is usually the version codename.

   Deprecated since version 3.5, will be removed in version 3.8: See
   alternative like the distro package.

platform.libc_ver(executable=sys.executable, lib='', version='', chunksize=16384)

   Tente d'identifier la version de la bibliothèque standard C à
   laquelle le fichier exécutable (par défaut l'interpréteur Python)
   est lié. Renvoie une paire de chaînes de caractères "(lib,
   version)". Les valeurs passées en paramètre seront retournées si la
   recherche échoue.

   Prenez note que cette fonction a une connaissance profonde des
   méthodes utilisées par les versions de la bibliothèque standard C
   pour ajouter des symboles au fichier exécutable. Elle n'est
   probablement utilisable qu'avec des exécutables compilés avec
   **gcc**.

   Le fichier est lu en blocs de *chunksize* octets.
