Metadata-Version

Version des Dateiformats; derzeit sind „1.0“ und „1.1“ die einzigen erlaubten Werte.

Beispiel

Metadata-Version: 1.1

Name

Der Name des Pakets.

Beispiel

Name: BeagleVote

Version

Ein String, der die Versionsnummer des Pakets enthält. Dieses Feld sollte von einer der Version-Klassen (StrictVersion oder LooseVersion) im distutils.version Modul geparst werden können.

Beispiel

Version: 1.0a2

Platform (mehrfache Verwendung)

Eine durch Kommas getrennte Liste von Plattformspezifikationen, die die vom Paket unterstützten Betriebssysteme zusammenfasst, die nicht in den „Operating System“-Trove-Klassifikatoren aufgeführt sind. Siehe „Classifier“ unten.

Beispiel

Platform: ObscureUnix, RareDOS

Supported-Platform (mehrfach verwendbar)

Binäre Distributionen, die eine PKG-INFO-Datei enthalten, verwenden das Supported-Platform-Feld in ihren Metadaten, um das Betriebssystem und die CPU anzugeben, für die das Binärpaket kompiliert wurde. Die Semantik des Supported-Platform-Feldes ist in dieser PEP nicht spezifiziert.

Beispiel

Supported-Platform: RedHat 7.2
Supported-Platform: i386-win32-2791

Zusammenfassung

Eine einzeilige Zusammenfassung, was das Paket tut.

Beispiel

Summary: A module for collecting votes from beagles.

Description (optional)

Eine längere Beschreibung des Pakets, die mehrere Absätze umfassen kann. Software, die mit Metadaten arbeitet, sollte keine maximale Größe für dieses Feld annehmen, obwohl Leute ihr Handbuch nicht als Beschreibung einfügen sollten.

Der Inhalt dieses Feldes kann mit reStructuredText-Markup geschrieben werden [1]. Für Programme, die mit den Metadaten arbeiten, ist die Unterstützung von Markup optional; Programme können den Inhalt des Feldes auch unverändert anzeigen. Dies bedeutet, dass Autoren bei der Verwendung von Markup konservativ sein sollten.

Beispiel

Description: This module collects votes from beagles
             in order to determine their electoral wishes.
             Do *not* try to use this module with basset hounds;
             it makes them grumpy.

Keywords (optional)

Eine Liste zusätzlicher Schlüsselwörter, die zur Suche nach dem Paket in einem größeren Katalog verwendet werden.

Beispiel

Keywords: dog puppy voting election

Home-page (optional)

Ein String, der die URL der Homepage des Pakets enthält.

Beispiel

Home-page: http://www.example.com/~cschultz/bvote/

Download-URL

Ein String, der die URL enthält, von der diese Version des Pakets heruntergeladen werden kann. (Das bedeutet, dass die URL nicht etwas wie „…/package-latest.tgz“ sein kann, sondern stattdessen „../package-0.45.tgz“ sein muss.)

Author (optional)

Ein String, der mindestens den Namen des Autors enthält; zusätzliche Kontaktinformationen können angegeben werden.

Beispiel

Author: C. Schultz, Universal Features Syndicate,
        Los Angeles, CA <cschultz@peanuts.example.com>

Author-email

Ein String, der die E-Mail-Adresse des Autors enthält. Er kann einen Namen und eine E-Mail-Adresse in den rechtlichen Formen eines RFC 822 ‘From:’-Headers enthalten. Er ist nicht optional, da Katalogsysteme den E-Mail-Teil dieses Feldes als eindeutigen Schlüssel zur Darstellung des Autors verwenden können. Ein Katalog könnte Autoren die Möglichkeit bieten, ihren GPG-Schlüssel, ihre persönliche Homepage und andere zusätzliche Metadaten *über den Autor* zu speichern, und optional die Möglichkeit, mehrere E-Mail-Adressen derselben Person zuzuordnen. Autorbezogene Metadatenfelder werden von dieser PEP nicht abgedeckt.

Beispiel

Author-email: "C. Schultz" <cschultz@example.com>

Lizenz

Text, der die Lizenz angibt, unter der das Paket steht, wenn die Lizenz keine Auswahl aus den „License“-Trove-Klassifikatoren ist. Siehe „Classifier“ unten.

Beispiel

License: This software may only be obtained by sending the
         author a postcard, and then the user promises not
         to redistribute it.

Classifier (mehrfach verwendbar)

Jeder Eintrag ist ein String, der einen einzelnen Klassifizierungswert für das Paket angibt. Klassifikatoren werden in PEP 301 beschrieben.

Beispiele

Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console (Text Based)

Requires (mehrfach verwendbar)

Jeder Eintrag enthält einen String, der ein anderes Modul oder Paket beschreibt, das von diesem Paket benötigt wird.

Das Format eines Anforderungsstrings ist identisch mit dem eines Modul- oder Paketnamens, der mit der ‚import‘-Anweisung verwendet werden kann, optional gefolgt von einer Versionsangabe in Klammern.

Eine Versionsangabe ist eine Reihe von bedingten Operatoren und Versionsnummern, getrennt durch Kommas. Bedingte Operatoren müssen einer der folgenden sein: „<“, „>“, „<=“, „>=“, „==“ und „!=“. Versionsnummern müssen im von der distutils.version.StrictVersion Klasse akzeptierten Format sein: zwei oder drei durch Punkte getrennte numerische Komponenten, mit einem optionalen „Pre-Release“-Tag am Ende, bestehend aus dem Buchstaben ‚a‘ oder ‚b‘ gefolgt von einer Zahl. Beispiel-Versionsnummern sind „1.0“, „2.3a2“, „1.3.99“.

Eine beliebige Anzahl von bedingten Operatoren kann angegeben werden, z.B. der String „>1.0, !=1.3.4, <2.0“ ist eine gültige Versionsangabe.

Alle folgenden sind mögliche Anforderungsstrings: „rfc822“, „zlib (>=1.1.4)“, „zope“.

Es gibt keine kanonische Liste, welche Strings verwendet werden sollen; die Python-Community kann eigene Standards wählen.

Beispiel

Requires: re
Requires: sys
Requires: zlib
Requires: xml.parsers.expat (>1.0)
Requires: psycopg

Provides (mehrfach verwendbar)

Jeder Eintrag enthält einen String, der ein Paket oder Modul beschreibt, das von diesem Paket bereitgestellt wird, sobald es installiert ist. Diese Strings sollten mit denen übereinstimmen, die in den Requirements-Feldern verwendet werden. Eine Versionsangabe kann angegeben werden (ohne Vergleichsoperator); die Versionsnummer des Pakets wird impliziert, wenn keine angegeben ist.

Beispiel

Provides: xml
Provides: xml.utils
Provides: xml.utils.iso8601
Provides: xml.dom
Provides: xmltools (1.3)

Obsoletes (mehrfach verwendbar)

Jeder Eintrag enthält einen String, der ein Paket oder Modul beschreibt, das dieses Paket veraltet macht, was bedeutet, dass die beiden Pakete nicht gleichzeitig installiert werden sollten. Versionsangaben können angegeben werden.

Die häufigste Verwendung dieses Feldes wird sein, wenn sich ein Paketname ändert, z.B. Gorgon 2.3 wird in Torqued Python 1.0 aufgenommen. Wenn Sie Torqued Python installieren, sollte das Gorgon-Paket entfernt werden.

Beispiel

Obsoletes: Gorgon