"### pyproject.toml - Konfiguration von Metadaten\n",
"\n",
"```toml\n",
"[build-system]\n",
...
...
@@ -174,14 +174,16 @@
"\n",
"classifiers = [\n",
" \"Programming Language :: Python :: 3\",\n",
" \"License :: OSI Approved :: MIT License\",\n",
" \"License :: OSI Approved :: Apache Software License\",\n",
" \"Operating System :: OS Independent\",\n",
"]\n",
"\n",
"[project.urls]\n",
"\"Homepage\" = \"https://...\"\n",
"\"Bug Tracker\" = \"https://...\"\n",
"```"
"```\n",
"\n",
"- Weitere Informationen zu den einzelnen Angaben: https://packaging.python.org/en/latest/specifications/declaring-project-metadata/#declaring-project-metadata"
]
},
{
...
...
@@ -240,17 +242,7 @@
"source": [
"### Package für den Upload erzeugen\n",
"\n",
"- Für die Erzeugung der zum Upload benötigten Dateien, muss zuerst in den Projektordner navigiert werden, und dort die folgende Befehle ausgeführt werden:"
]
},
{
"cell_type": "code",
"execution_count": null,
"id": "0251a377",
"metadata": {},
"outputs": [],
"source": [
"!pip install --upgrade build"
"- Für die Erzeugung der zum Upload benötigten Dateien, muss zuerst in den Projektordner navigiert werden, und dort die folgende Befehle ausgeführt werden."
]
},
{
...
...
@@ -258,17 +250,11 @@
"id": "68e05d16",
"metadata": {},
"source": [
"- Jetzt sollten alle benötigten Pakete installiert sein."
]
},
{
"cell_type": "code",
"execution_count": null,
"id": "92583304",
"metadata": {},
"outputs": [],
"source": [
"!python -m build"
"- Zuerst müssen für den Build benötigten Pakete installiert werden.\n",
"\n",
"```\n",
"pip install --upgrade build\n",
"```"
]
},
{
...
...
@@ -276,7 +262,11 @@
"id": "3cf7b4cd",
"metadata": {},
"source": [
"- Dieser Befehl erstellt anhand der `pyproject.toml` alle benötigten Dateien und legt diese in den Ordner `dist` im Projektordner."
"- Dann kann anhand der `pyproject.toml` das Package erstellt werden. Dieses wird in den Ordner `dist` im Projektordner gespeichert.\n",
"\n",
"```\n",
"python -m build\n",
"```"
]
},
{
...
...
@@ -287,12 +277,12 @@
"- Wenn die Befehle korrekt ausgeführt werden konnten, dann sollte die letzte Zeile so lauten:\n",
"\n",
"```\n",
"Successfully built Pypiex-0.0.1.tar.gz and Pypiex-0.0.1-py3-none-any.whl\n",
"Successfully built xyz-version.tar.gz and xyz-version-py3-none-any.whl\n",
"```\n",
"\n",
"- Außerdem sollten zwei Dateien im Ordner `dist` erzeugt worden sein.\n",
"- Die Datei mit der Endung `.whl` ist eine Wheel-Datei.\n",
"- Die Datei mit der Endung `.tar.gz` TODO"
"- Außerdem sollten zwei Dateien im Ordner `dist` erzeugt worden sein. Es gibt verschiedene Arten von Packages.\n",
"- Die Datei mit der Endung `.tar.gz` ist eine Source Distribution.\n",
"- Die Datei mit der Endung `.whl` (Wheel-Datei) ist eine Built Distribution. Dieses Format ist neuer und hat verschiedene Vorteile. Die Details sind an dieser Stelle nicht relevant. "
]
},
{
...
...
@@ -300,9 +290,13 @@
"id": "a87cd03e",
"metadata": {},
"source": [
"### Package auf Testserver hochladen\n",
"### Package auf den Testserver hochladen\n",
"\n",
"- Um Pakete hochladen zu können muss zuerst ein Account erstellt werden. Der PyPI Testserver ist unabhängig von der Produktionsumgebung und es werden jeweils eigene Accounts benötigt."
"- Um Pakete hochladen zu können muss zuerst ein Account erstellt werden. \n",
"\n",
"<div class=\"alert alert-info\">\n",
"<b>Hinweis</b> Der PyPI Testserver ist unabhängig von der Produktionsumgebung und es werden jeweils eigene Accounts benötigt.\n",
"</div> "
]
},
{
...
...
@@ -310,17 +304,11 @@
"id": "1444d33a",
"metadata": {},
"source": [
"- Jetzt muss ein `API token` generiert werden. Dies kann man unter folgendem Link: https://test.pypi.org/manage/account/#api-tokens. In den Kontoeinstellungen im Bereich `API-Token`. Der Geltungsbereich kann auf `Gesamtes Konto` gestellt werden. Das erstellte Token muss direkt gesichert werden, da es danach nicht mehr einsehbar ist."
]
},
{
"cell_type": "code",
"execution_count": null,
"id": "e2a24a2c",
"metadata": {},
"outputs": [],
"source": [
"!pip install --upgrade twine"
"- Jetzt muss ein `API token` generiert werden. Dies geschieht in den Kontoeinstellungen im Bereich `API-Token`. Folgender Link führt automatisch dort hin: https://test.pypi.org/manage/account/#api-tokens. Auf `API-Token hinzufügen` klicken. Dort einen sinnvollen Namen vergeben und den Geltungsbereich auf `Gesamtes Konto` stellen.\n",
"\n",
"<div class=\"alert alert-info\">\n",
"<b>Hinweis</b> Ein erstelltes Token muss direkt gesichert werden, da es danach nicht mehr einsehbar ist.\n",
"</div>"
]
},
{
...
...
@@ -328,17 +316,11 @@
"id": "abf06326",
"metadata": {},
"source": [
"- Diese Zeile lädt und installiert die benötigten Packages."
"- Jetzt die für den Upload benötigten Packages laden und installieren:\n",
"\n",
"```\n",
"pip install --upgrade twine\n",
"```"
]
},
{
...
...
@@ -346,7 +328,12 @@
"id": "325e2694",
"metadata": {},
"source": [
"- Diese Zeile führt den Upload aus. Hierbei wird nach dem Username und Passwort gefragt. Für den Username muss `__token__` verwendet werden und für Passwort das gerade erstelle Token inklusive des `pypi` Prefix.\n",
"- Und dann den Upload ausführen. Hierbei wird nach dem Username und Passwort gefragt. Für den Username muss `__token__` verwendet werden und für Passwort das gerade erstelle Token inklusive des `pypi` Prefix.\n",
"<b>Hinweis</b> Soll eine neue Version für ein Paket hochgeladen werden, dann muss vor der Erzeugung des Pakets immer zuerst die Versionsnummer in der `pyproject.toml` angepasst werden. Eine Version kann immer nur ein Mal hochgeladen werden. \n",
Dieses Notebook ist als freies Werk unter der Lizenz [Creative Commons Attribution-NonCommercial 3.0 Unported](http://creativecommons.org/licenses/by-nc/3.0/) verfügbar. Sie dürfen die Inhalte kopieren, verteilen und verändern, solange Sie die Urheber nennen und sie nicht für kommerzielle Zwecke nutzen.
%% Cell type:markdown id:c7dc7204 tags:
## Was ist ein Modul?
- Ein Modul ist eine Datei, die Python-Definitionen und -Anweisungen beinhaltet. Oder anders gesagt: Jede Python-Datei ist ein Modul und der Name des Moduls ist der Dateiname ohne die Endung `.py`
- Ein Package ist eine Sammlung von Modulen. Hierfür liegen mehrere Module in einem Ordner, welcher auch eine Datei `__init__.py` enthalten muss. Dies unterscheidet ein Package von einem Ordner, der zufällig mehrere Module enthält.
%% Cell type:markdown id:21e7cd83 tags:
## Module verwenden
- Python wird mit einer Bibliothek von Standardmodulen ausgeliefert. Ein solches Modul kann mit dem Befehl `import` importiert und anschließend verwendet weden.
%% Cell type:code id:94cad5e7 tags:
```
import json
```
%% Cell type:markdown id:1129c831 tags:
- Wenn wir nun versuchen ein Modul zu installieren, welches nicht in den Standardmodulen enthalten ist, dann kommt es zu einer Fehlermeldung.
%% Cell type:code id:3aa3db5d tags:
```
import pandas
```
%% Cell type:markdown id:bdc84dcf tags:
## Module installieren
- Module, die nicht in der Bibliothek von Standardmodulen enthalten sind, müssen vor dem Import installiert werden. Hierfür wird ein Paketverwaltungsprogramm verwendet. Dies ist im Normfall `pip`. Mit dem Befehl `pip install` können Pakete installiert werden.
%% Cell type:code id:2148e19b tags:
```
!pip install pandas
```
%% Cell type:markdown id:2dce18c9 tags:
## Doch was passiert hier eigentlich?
%% Cell type:markdown id:f07907eb tags:
### Python Package Index (PyPI)
-`pip`lädt Pakete aus dem Python Package Index (PyPI).
- PyPI ist ein Sofware-Vezeichnis der Programmiersprache Python.
- PyPI umfasst knapp 420.00 Projekte (Stand: Dezember 2022)
- Jede:r kann sich auf PyPI (https://pypi.org) registrieren und ein Projekt erstellen.
<divclass="alert alert-info">
<b>Hinweis</b> Der Begriff "Package" kann etwas verwirrend sein. PyPI spricht auch von Packages. Ein PyPI-Package kann ein einzelnes Python-Modul sein oder aber auch mehrere Python-Packages umfassen.
</div>
%% Cell type:markdown id:d45b9900 tags:
### PyPI Testumgebung
- Für Testzwecke gibt es die PyPI Testumgebgung (https://test.pypi.org)
- Diese funktioniert genau wie die reale Version und sollte verwendet werden um die eigene Konfiguration zu testen.
"License :: OSI Approved :: Apache Software License",
"Operating System :: OS Independent",
]
[project.urls]
"Homepage"="https://..."
"Bug Tracker"="https://..."
```
- Weitere Informationen zu den einzelnen Angaben: https://packaging.python.org/en/latest/specifications/declaring-project-metadata/#declaring-project-metadata
%% Cell type:markdown id:927e9459 tags:
### README.md
```
# Mein Projekt
Dies ist ein Beispielprojekt.
```
%% Cell type:markdown id:4c8acd0d tags:
### LICENSE
```
Apache License
Version 2.0, January 2004
http://www.apache.org/licenses/
TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
1. Definitions.
"License" shall mean the terms and conditions for use, reproduction,
and distribution as defined by Sections 1 through 9 of this document.
"Licensor" shall mean the copyright owner or entity authorized by
the copyright owner that is granting the License.
"Legal Entity" shall mean the union of the acting entity and all
other entities that control, are controlled by, or are under common
control with that entity. For the purposes of this definition,
"control" means (i) the power, direct or indirect, to cause the
direction or management of such entity, whether by contract or
otherwise, or (ii) ownership of fifty percent (50%) or more of the
outstanding shares, or (iii) beneficial ownership of such entity.
[...]
```
%% Cell type:markdown id:d4b197a7 tags:
### Package für den Upload erzeugen
- Für die Erzeugung der zum Upload benötigten Dateien, muss zuerst in den Projektordner navigiert werden, und dort die folgende Befehle ausgeführt werden:
%% Cell type:code id:0251a377 tags:
```
!pip install --upgrade build
```
- Für die Erzeugung der zum Upload benötigten Dateien, muss zuerst in den Projektordner navigiert werden, und dort die folgende Befehle ausgeführt werden.
%% Cell type:markdown id:68e05d16 tags:
- Jetzt sollten alle benötigten Pakete installiert sein.
%% Cell type:code id:92583304 tags:
- Zuerst müssen für den Build benötigten Pakete installiert werden.
```
!python -m build
```
pip install --upgrade build
```
%% Cell type:markdown id:3cf7b4cd tags:
- Dieser Befehl erstellt anhand der `pyproject.toml` alle benötigten Dateien und legt diese in den Ordner `dist` im Projektordner.
- Dann kann anhand der `pyproject.toml` das Package erstellt werden. Dieses wird in den Ordner `dist` im Projektordner gespeichert.
```
python -m build
```
%% Cell type:markdown id:afd1c91e tags:
- Wenn die Befehle korrekt ausgeführt werden konnten, dann sollte die letzte Zeile so lauten:
```
Successfully built Pypiex-0.0.1.tar.gz and Pypiex-0.0.1-py3-none-any.whl
Successfully built xyz-version.tar.gz and xyz-version-py3-none-any.whl
```
- Außerdem sollten zwei Dateien im Ordner `dist` erzeugt worden sein.
- Die Datei mit der Endung `.whl` ist eine Wheel-Datei.
- Die Datei mit der Endung `.tar.gz` TODO
- Außerdem sollten zwei Dateien im Ordner `dist` erzeugt worden sein. Es gibt verschiedene Arten von Packages.
- Die Datei mit der Endung `.tar.gz` ist eine Source Distribution.
- Die Datei mit der Endung `.whl` (Wheel-Datei) ist eine Built Distribution. Dieses Format ist neuer und hat verschiedene Vorteile. Die Details sind an dieser Stelle nicht relevant.
%% Cell type:markdown id:a87cd03e tags:
### Package auf Testserver hochladen
### Package auf den Testserver hochladen
- Um Pakete hochladen zu können muss zuerst ein Account erstellt werden. Der PyPI Testserver ist unabhängig von der Produktionsumgebung und es werden jeweils eigene Accounts benötigt.
- Um Pakete hochladen zu können muss zuerst ein Account erstellt werden.
%% Cell type:markdown id:1444d33a tags:
<divclass="alert alert-info">
<b>Hinweis</b> Der PyPI Testserver ist unabhängig von der Produktionsumgebung und es werden jeweils eigene Accounts benötigt.
</div>
- Jetzt muss ein `API token` generiert werden. Dies kann man unter folgendem Link: https://test.pypi.org/manage/account/#api-tokens. In den Kontoeinstellungen im Bereich `API-Token`. Der Geltungsbereich kann auf `Gesamtes Konto` gestellt werden. Das erstellte Token muss direkt gesichert werden, da es danach nicht mehr einsehbar ist.
%% Cell type:markdown id:1444d33a tags:
%% Cell type:code id:e2a24a2c tags:
- Jetzt muss ein `API token` generiert werden. Dies geschieht in den Kontoeinstellungen im Bereich `API-Token`. Folgender Link führt automatisch dort hin: https://test.pypi.org/manage/account/#api-tokens. Auf `API-Token hinzufügen` klicken. Dort einen sinnvollen Namen vergeben und den Geltungsbereich auf `Gesamtes Konto` stellen.
```
!pip install --upgrade twine
```
<divclass="alert alert-info">
<b>Hinweis</b> Ein erstelltes Token muss direkt gesichert werden, da es danach nicht mehr einsehbar ist.
</div>
%% Cell type:markdown id:abf06326 tags:
- Diese Zeile lädt und installiert die benötigten Packages.
%% Cell type:code id:545fac45 tags:
- Jetzt die für den Upload benötigten Packages laden und installieren:
- Diese Zeile führt den Upload aus. Hierbei wird nach dem Username und Passwort gefragt. Für den Username muss `__token__` verwendet werden und für Passwort das gerade erstelle Token inklusive des `pypi` Prefix.
- Und dann den Upload ausführen. Hierbei wird nach dem Username und Passwort gefragt. Für den Username muss `__token__` verwendet werden und für Passwort das gerade erstelle Token inklusive des `pypi` Prefix.
<b>Hinweis</b> Soll eine neue Version für ein Paket hochgeladen werden, dann muss vor der Erzeugung des Pakets immer zuerst die Versionsnummer in der `pyproject.toml` angepasst werden. Eine Version kann immer nur ein Mal hochgeladen werden.
</div>
%% Cell type:markdown id:a55a2eb7 tags:
## Package installieren und verwenden
- Das Paket kann jetzt mit `pip` installiert werden. Hierzu muss der Testserver angegeben werden.