/home/bakera/wiki

Diese Seite ist nicht editierbar. Sie können den Quelltext sehen, jedoch nicht verändern. Kontaktieren Sie den Administrator, wenn Sie glauben, dass hier ein Fehler vorliegt.
====== Python Pakete veröffentlichen ======

Der [[https://pypi.python.org/pypi|Python Package Index (PyPI)]] ist eine Quelle für viele freie Projekte. Die Standardinstallation von Python bringt bereits zahlreiche Werkzeuge mit, um neue Softwarepakete zu erstellen und bei PyPI zu veröffentlichen. Dazu sind folgende Schritte nötig:

  - Die Datei ''setup.py'' anlegen (s. unten).
  - Ein Konto bei PyPI anlegen.
  - Mit ''python3 setup.py sdist'' eine Source-Distribution bauen.
  - Die Datei ''PGK-INFO'' in dem Ordner ''egg-info'' kann über das Webinterface von PyPI hochgeladen werden. Damit wird das Projekt angelegt.
  - Die Datei ''~/.pypirc'' im Home-Verzeichnis anlegen. Hier werden die Zugangsdaten für PyPI hinterlegt. (s. unten).
  - Mit ''python3 setup.py sdist upload'' das Paket bauen und bei PyPI hochladen.
  - Nun kann das Paket mit ''pip3 install paketname'' auf einem anderen Rechner installiert werden.

Eine [[https://packaging.python.org/distributing/|ausführliche Anleitung]] befindet sich in der Dokumentation von Python und in dem Buch //Expert Python Programming// in Kapitel 5.

Als Grundlage für eigene Versuche bietet sich das Beispielprojekt [[https://github.com/pypa/sampleproject|sampleproject]] an, das viele sinnvolle Standardeinstellungen enthält.

===== setup.py =====

Die Datei ''setup.py'' enthält Informationen über das Softwarepaket -- Versionsnummer, Author etc. In der Datei muss nicht viel enthalten sein:

<code python>
import setuptools

setuptools.setup(
    name="mein_programm",
    version="0.1.0",
    description="Ein Beispielprogramm",
    author="Marco Bakera",
    author_email="bakera@tbs1.de",
    packages=setuptools.find_packages())
</code>

===== .pypirc =====

Die Datei ''~/.pypirc'' enthält Informationen über das Benutzerkonto bei PyPI. Sie liegt im Homeverzeichnis und hat den folgenden einfachen Aufbau.

<code ini>

[distutils]
index-servers=pypi

[pypi]
repository = https://upload.pypi.io/legacy/
username = mein_username
password = mein_passwort
</code>