Python 3 - Lernen und professionell anwenden

Anhang D

Ein Python-Modul veröffentlichen: PyPI

954

D.2.4 Die Datei __init__.py

Jedes Paketverzeichnis muss eine Datei namens __init__.py enthalten. Darin können Ini-

tialisierungsroutinen definiert sein. Sie kann aber auch einfach leer bleiben.

D.3 Das Paket auf PyPI veröffentlichen

Bevor Sie Ihr Projekt hochladen können, müssen Sie es bei PyPI registrieren. Öffnen Sie ein

Konsolenfenster (z.B. bei der Windows-Eingabeaufforderung). Wechseln Sie mit

cd in das

Projekt-Verzeichnis. In Ihrem Home-Verzeichnis sollte eine

.pypirc-Datei mit den Anmel-

dedaten gespeichert sein (siehe Abschnitt D.1).

Geben Sie das folgende Kommando ein (

> ist der Prompt):

Wenn alles gut geht, wird Ihr Projekt auf PyPI registriert und Metadaten werden hochgela-

den. Der Server meldet dann ein OK.

Falls Sie keine

.pypirc-Datei verwenden, gibt es einen Dialog mit dem Server, in dem Sie

Benutzername und Passwort »von Hand« eingeben.

Wenn Ihr Projekt auf einem anderen Repository registriert werden soll, verwenden Sie die

Option

--repository oder –r. Vielleicht möchten Sie ja zuerst Dinge ausprobieren und Ihr

Projekt deshalb auf

PyPItest speichern. Achten Sie darauf, für das Repository den Namen

zu nehmen, den Sie auch in der

.pypirc-Datei verwendet haben.

Formatierungszeichen Erklärung

=====

Titel

=====

Die Titelzeile wird oben und unten mit einer Folge von Gleichheits-

zeichen bedeckt. Diese Folge muss mindestens so lang sein wie die

Titelzeile. Auf der Projektseite von PyPI wird der Titel nicht darge-

stellt.

Absatzüberschrift

-----------------

Eine Absatzüberschrift wird mit Minuszeichen unterstrichen. Sie

erscheint dann im PyPI blau und groß gesetzt.

*kursiv*

Mit einfachen Sternen * eingerahmte Bereiche werden kursiv

gesetzt und damit schwach hervorgehoben.

**fett**

Mit doppelten Sternen ** eingerahmte Bereiche werden fett

gesetzt und damit stark hervorgehoben.

::

Zeile 1

Zeile 2

Hinter einem doppelten Doppelpunkt erscheint ein Absatz mit

einem Listing. Die Zeilen des Listings sind um vier Stellen einge-

rückt.

-

-

Zeilen, die mit einem Strich – beginnen, werden als Gliederungs-

punkte gesetzt.

Tabelle D.1: Die wichtigsten Formatierungstechniken von reStructuredText (reST)

> python setup.py register

> python setup.py register –r pypitest