notebooks/seminar03extra.ipynb → notebooks/seminar_regex.ipynb

 %% Cell type:markdown id: tags:
 
 # Seminar Problemorientierte Programmierung
 
 ## 3 Extra: Reguläre Ausdrücke
 
 Dieses Kapitel taucht nicht im englischen Python-Kurs auf und wird separat gepflegt.
 
 In der Praxis können wir reguläre Ausdrücke nutzen, um in Texten zu suchen und Muster zu entdecken. Python bietet uns im `re`-Modul (re = Regular Expression = Regulärer Ausdruck) viele Funktionen an, um mit regulären Ausdrücken zu arbeiten.
 
 Es gibt dabei zwei "Dimensionen" an denen wir uns "entlanghangeln" müssen: die Funktionen, die vom `re`-Modul bereitgestellt werden und die regulären Ausdrücke selber, die komplex werden können. Wir beginnen zunächst mit nur einer Funktion und werden Stück für Stück komplexere Ausdrücke kennenlernen. Danach schauen wir uns weitere Funktionen an.
 
 ### Ihre Lernziele
 
 Beschreiben Sie in 2-3 Stichpunkten kurz was Sie im Seminar heute lernen wollen. Klicken Sie dazu doppelt auf diesen Text und bearbeiten Sie dann den Text:
 
 -
 -
 -
 
 
 ### Exkurs: Was mir an Python gefällt
-
-In einer Datei alle E-Mail-Adressen extrahieren geht recht einfach:
+In ihrem Verzeichnis sollte eine Datei `test.txt` liegen. Öffnen Sie diese in einem Texteditor Ihrer Wahl. Schauen Sie jetzt, wie leicht man mit dem Modul `re` in Python E-Mail-Adressen extrahieren kann:
 
 %% Cell type:code id: tags:
 
 ``` 
 import re
 
 def find_in_file(pattern, file):
     reg_pattern = re.compile(pattern)
     for line in file:
         for found in reg_pattern.findall(line):
             print(found[0])
 
 find_in_file(r"([a-zA-Z0-9-!#$%&'*+-/=?^_`{|}~]+@([A-Za-z0-9-]+\.)+[a-zA-Z]{2,})", open("test.txt", "rt"))
 ```
 
 %% Cell type:markdown id: tags:
 
 ###  3.1 Einfache Suche
 
 Wir können mit der Funktion `findall` alle Teilzeichenketten in einer Zeichenkette finden, die auf ein gegebenes Muster (in Form eines regulären Ausdrucks) passen. Die Funktion erwartet zwei Argumente: einen regulären Ausdruck und die Zeichenkette, die durchsucht werden soll:
 
 %% Cell type:code id: tags:
 
 ``` 
 import re
 re.findall(r'f[a-z]*', 'which foot or hand fell fastest')
 ```
 
 %% Cell type:markdown id: tags:
 
 
 1. In der ersten Zeile wird das `re`-Modul importiert. Das muss einmal am Anfang unseres Programms passieren. Hier im Jupyter-Notebook reicht es, wenn das Modul in einem Block importiert wird - sobald der Block ausgeführt wurde, kann es in allen folgenden Blöcken verwendet werden.
 2. In der nächsten Zeile wird - mittels der Punkt-Notation - die `findall`-Funktion im `re`-Modul aufgerufen.
 3. Der Funktion werden zwei Argumente übergeben: `r'f[a-z]*'` und `'which foot or hand fell fastest'`.
 4. Das erste Argument ist ein regulärer Ausdruck. Reguläre Ausdrücke werden in Hochkommata `''` eingeschlossen und beginnen mit einem `r`.
 5. Das heißt, der eigentliche reguläre Ausdruck lautet `f[a-z]*`. Dieser Ausdruck beschreibt Zeichenketten, die mit einem `f` beginnen und von beliebig vielen - auch 0! - (`*`) Kleinbuchstaben (`[a-z]`) gefolgt werden. Dabei beschreibt der Ausdruck `[a-z]` in eckigen Klammern ein Zeichen, welches die Werte `a` bis `z` haben darf, das `*` dahinter besagt, dass dieses Zeichen beliebig oft wiederholt werden darf.
 6. Das zweite Argument (`'which foot or hand fell fastest'`) ist die Zeichenkette, in der wir nach Teilzeichenketten suchen, die auf den übergebenen regulären Ausdruck passen.
 
 Das Ergebnis des Aufrufs von `findall` ist eine Liste der Teilzeichenketten, die auf das Muster passen - in unserem Beispiel sind das die Zeichenketten `foot`, `fell` und `fastest`.
 
 Probieren Sie es hier selber aus:
 
 %% Cell type:code id: tags:
 
 ``` 
 regaus = r'f[a-z]*'
 text = input("Geben Sie eine Zeichenkette zum Testen ein:")
 ergebnis = re.findall(regaus, text)
 if ergebnis:
     print("Es wurden folgende Teilzeichenketten erkannt:", ergebnis)
 else:
     print("Leider wurde nichts erkannt, probieren Sie es noch einmal.")
 ```
 
 %% Cell type:markdown id: tags:
 
 Ändern Sie den regulären Ausdruck im folgenden Beispiel, so dass alle Wörter, die mit einem `b` beginnen ausgegeben werden:
 
 %% Cell type:code id: tags:
 
 ``` 
 re.findall(r'b', 'Wir bauten und bohrten bis das Haus fertig war.')
 ```
 
 %% Cell type:markdown id: tags:
 
 Die Ausgabe sollte so aussehen:
 ```
 ['bauten', 'bohrten', 'bis']
 ```
 Ändern Sie den regulären Ausdruck, so dass jetzt nur Wörter ausgegeben werden, die mit einem `b` beginnen und mit einem `n` enden. Die Ausgabe sollte dann so aussehen:
 ```
 ['bauten', 'bohrten']
 ```
 
 Welche Probleme sind bei Ihren Versuchen aufgetreten?
 -
 -
 
 %% Cell type:markdown id: tags:
 
 ### 3.2 Schritt für Schritt: ein beliebiges Zeichen
 
 Der Punkt `.` steht für ein beliebiges Zeichen:
 
 %% Cell type:code id: tags:
 
 ``` 
 re.findall(r'a.', "Am Anfang aßen wir alle Manna und Kartoffeln")
 ```
 
 %% Cell type:markdown id: tags:
 
 Im Satz `Am Anfang aßen wir alle Kartoffeln.` gibt es genau sechs Vorkommen von einem kleinen `a` mit einem Zeichen dahinter. Wie wir sehen, wird auch das `a` am Ende von `Manna`, welches von einem Leerzeichen gefolgt ist, erkannt. Das liegt daran, dass der Punkt für wirklich jedes Zeichen (auch das Leerzeichen) steht. Die zwei Zeichenketten `Am` und `An` werden nicht erkannt, da sie ein großes `A` enthalten, wir aber nach einem kleinen gesucht haben.
 
 %% Cell type:markdown id: tags:
 
 ### 3.3 Und weiter
 
 Sie kennen jetzt eine Funktion, um reguläre Ausdrücke in Python anzuwenden und damit Texte zu durchsuchen. Weitere Funktionen ermöglichen die Extraktion und das Ersetzen von Teilzeichenketten in Texten. Bevor wir diese Funktionen kennenlernen, ist es praktisch, mit regulären Ausdrücken vertraut zu werden. Eine sehr gute interaktive Übungsseite dazu finden Sie [hier](https://regexone.com/lesson/introduction_abcs). Arbeiten Sie diese Seite gemeinsam Schritt für Schritt durch. Schrecken Sie nicht vor dem englischen Text zurück - ich helfe Ihnen bei Fragen gerne weiter.
 
 Es gibt noch viele andere gute Tutorials zu regulären Ausdrücken, z.B. [hier](https://ryanstutorials.net/regular-expressions-tutorial/) oder [hier](https://www.python-kurs.eu/re.php). Sie können auch eine dieser Anleitungen durcharbeiten, wenn Sie damit besser zurechtkommen.
 
 %% Cell type:markdown id: tags:
 
 ### 3.4 weitere nützliche Funktionen des `re`-Moduls
 
 Sie haben in den Tutorials einige regulären Ausdrücke kennengelernt. Nun können wir weitere Funktionen des `re`-Moduls benutzen. Im Folgenden werden mehrere Funktionen vorgestellt. Anschließend können Sie diese in Übungen testen.
 
 %% Cell type:markdown id: tags:
 
 #### 3.4.1 Suchen und Matchen
 
 Die Funktion `findall(regex,string)` haben sie schon kennengelernt:
 
 %% Cell type:code id: tags:
 
 ``` 
 import re
 re.findall(r'f[a-z]*', 'which foot or hand fell fastest')
 ```
 
 %% Cell type:markdown id: tags:
 
 Zudem gibt es eine Funktion  `search(regex,string)`. Die Argumente sind diesselben wie bei `findall`.
 Diese Funktion durchsucht eine Zeichenkette *string* nach dem Vorkommen eines Teilstrings, der auf den regulären Ausdruck *regex* passt. Der erste gefundene Teilstring wird zurückgeliefert. Die Rückgabe ist ein sogennantes *match-Objekt*.
 
 %% Cell type:code id: tags:
 
 ``` 
 import re
 object1 = re.search(r'f[a-z]*', 'which foot or hand fell fastest')
 
 object2 = re.search(r'f[a-z]*', 'The regex did not match anything.')
 
 print(object1,"\n",object2)
 
 ```
 
 %% Cell type:markdown id: tags:
 
 Ein *match-Objekt* enthält die Methoden `group()`, `span()`, `start()` und `end()`, die man im folgenden Beispiel im selbsterklärenden Einsatz sieht:
 
 %% Cell type:code id: tags:
 
 ``` 
 object1 = re.search(r'f[a-z]*', 'which foot or hand fell fastest')
 print(object1.group())
 print(object1.span())
 print(object1.start())
 print(object1.end())
 ```
 
 %% Cell type:markdown id: tags:
 
 Es gibt zuletzt noch eine dritte Funktion `match(regex,string)`. Diese Funktion checkt, ob ein Teilstring, der auf den regulären Ausdruck *regex* passt, am Anfang der Zeichenkette *string* vorkommt, Die Rückgabe ist wieder ein *match-Objekt*.
 
 %% Cell type:code id: tags:
 
 ``` 
 object1 = re.match(r'f[a-z]*', 'foot or hand fell fastest')
 object2 = re.match(r'f[a-z]*', 'which foot or hand fell fastest')
 print(object2)
 print(object1)
 print(object1.group())
 print(object1.span())
 print(object1.start())
 print(object1.end())
 ```
 
 %% Cell type:markdown id: tags:
 
 #### 3.4.1 Übung:
 
 Denken Sie sich eine Zeichenkette und einen regulären Ausdruck aus, die die Unterschiede der drei kennengelernten Funktionen wiedergibt.
 
 %% Cell type:code id: tags:
 
 ``` 
 ```
 
 %% Cell type:markdown id: tags:
 
 #### 3.4.2 Ersetzen
 
 %% Cell type:markdown id: tags:
 
 Das `re`-Modul stellt nicht nur Funktionen zum Durchsuchen von Zeichenketten zur Verfügung. Mit der Funktion `re.sub(regex, replacement, string)` kann man Teilstrings ersetzen. Jede Übereinstimmung des regulären Ausdrucks *regex* in der Zeichenkette *string* wird durch die Zeichenkette *replacement* ersetzt.
 
 %% Cell type:code id: tags:
 
 ``` 
 re.sub(r'f[a-z]*', 'beer', 'which foot or hand fell fastest')
 ```
 
 %% Cell type:markdown id: tags:
 
 #### 3.4.3 Kompilieren
 
 Wenn man bestimmte reguläre Ausdrücke mehrmals benutzen möchte, kann man die Funktion `compile(regex)` benutzen. Diese Funktion kompiliert einen regulären Ausdruck *regex* in eine regex-Objekt. Dieses kann man dann für weitere Funktionen nutzen.
 
 %% Cell type:code id: tags:
 
 ``` 
 regex_1 = re.compile(r'f[a-z]*')
 
 print(regex_1.findall('which foot or hand fell fastest'))
 
 print(regex_1.search('which foot or hand fell fastest'))
 
 print(regex_1.match('which foot or hand fell fastest'))
 
 print(regex_1.sub('beer','which foot or hand fell fastest'))
 ```
 
 %% Cell type:markdown id: tags:
 
 ### Aufgaben
 
 #### Aufgabe 1
 Schreiben Sie eine Funktion, die eine Zeichenkette als Parameter entgegennimmt und überprüft, ob die Zeichenkette nur Kleinbuchstaben und Zahlen enthält.
 Benutzen Sie reguläre Ausdrücke und die obigen Funktionen.
 
 %% Cell type:code id: tags:
 
 ``` 
 ```
 
 %% Cell type:markdown id: tags:
 
 #### Aufgabe 2
 
 Schreiben Sie eine Funktion, die eine Zeichenkette als Parameter entgegennimmt und überprüft, ob die Zeichenkette einen Teilstring enthält, der aus einem "a" und nachfolgend aus mindestens einem "b" besteht. (z.B. "abb", "abbbbb", "abbbbbbbbbbbbbbbb").
 Benutzen Sie reguläre Ausdrücke und die obigen Funktionen.
 
 %% Cell type:code id: tags:
 
 ``` 
 ```
 
 %% Cell type:markdown id: tags:
 
 #### Aufgabe 3
 
 Schreiben Sie eine Funktion, die eine Zeichenkette als Parameter entgegennimmt und alle darin enthaltenen Leerzeichen durch ein Minus ersetzt.
 Benutzen Sie reguläre Ausdrücke und die obigen Funktionen.
 
 %% Cell type:code id: tags:
 
 ``` 
 ```
 
 %% Cell type:markdown id: tags:
 
 #### Aufgabe 4
 
 Schreiben Sie eine Funktion, die eine Zeichenkette *s* und eine natürliche Zahl  *n* als Parameter entgegennimmt und alle Wörter der Länge n aus der Zeichenkette *s* entfernt.
 Benutzen Sie reguläre Ausdrücke und die obigen Funktionen.
 
 %% Cell type:code id: tags:
 
 ``` 
 ```
 
 %% Cell type:markdown id: tags:
 
 ![Speichern](https://amor.cms.hu-berlin.de/~jaeschkr/teaching/spp/floppy.png) Speichern Sie dieses Notebook so, dass Ihre Änderungen nicht verlorengehen (nicht auf einem Pool-Rechner). Klicken Sie dazu oben links auf das Disketten-Icon und nutzen Sie beispielsweise einen USB-Stick, E-Mail, Google Drive, Dropbox oder Ihre [HU-Box](https://box.hu-berlin.de/).
 
 %% Cell type:markdown id: tags:
 
 ![Smiley](https://upload.wikimedia.org/wikipedia/commons/a/a7/Emblem-fun.svg)
 
 Herzlichen Glückwunsch! Sie haben das 3. Kapitel geschafft. Weiter geht es in [4: Fallstudie: Schnittstellenentwurf](seminar04.ipynb).
+
+%% Cell type:markdown id: tags:
+
+![CC-BY-NC](https://scm.cms.hu-berlin.de/ibi/python/-/raw/master/img/cc-by-nc.png)
+
+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.

notebooks/uebung_regex.ipynb

 %% Cell type:markdown id: tags:
 
 # 12. Übungsblatt
 
 Mit diesem Python-Code können Sie Ihren regulären Ausdruck testen:
 
 %% Cell type:code id: tags:
 
 ``` 
 import re
 
 """
 Ändern Sie den folgenden regulären Ausdruck, so dass alle
 positiven Muster erkannt werden, aber kein negatives Muster.
 """
 muster = re.compile("Z")
 positive = [
     "rap them",
     "tapeth",
     "apth",
     "wrap/try",
     "sap tray",
     "87ap9th",
     "apothecary"
 ]
 
 negative = [
     "aleht",
     "happy them",
     "tarpth",
     "Apt",
     "peth",
     "tarreth",
     "ddapdg",
     "apples",
     "shape the"
 ]
 
 # testen, ob alle positiven Muster richtig erkannt werden
 positive_not_matched = [s for s in positive if not muster.findall(s)]
 if positive_not_matched:
     print("Folgende positiven Muster wurden nicht erkannt:", ", ".join(positive_not_matched))
 
 # testen, ob keine negativen Muster erkannt werden
 negative_matched = [s for s in negative if muster.findall(s)]
 if negative_matched:
     print("Folgende negativen Muster wurden erkannt:", ", ".join(negative_matched))
 
 if not positive_not_matched and not negative_matched:
     print("Herzlichen Glückwunsch, Sie haben das richtige Muster gefunden!")
 ```
 
 %% Cell type:markdown id: tags:
 
 Nachfolgend noch einige Beispiele zur Verwendung von regulären Ausdrücke mit Python:
 
 %% Cell type:code id: tags:
 
 ``` 
 # Funktionen für reguläre Ausdrücke werden im Modul "re" bereitgestellt
 import re
 
 # die Methode "findall" findet alle Teilzeichenketten in einer Zeichenkette,
 # die auf das angegebene Muster passen
 re.findall("cat|dog", "This sentence contains a dog.")
 ```
 
 %% Cell type:code id: tags:
 
 ``` 
 # die Methode "match" testet, ob die gesamte Zeichenkette auf das angegebene Muster passt
 re.match(".*dog\\.", "This sentence contains a dog.")
 ```
 
 %% Cell type:code id: tags:
 
 ``` 
 re.match(".*(cat|dog)", "This sentence contains a cat.")
 ```
 
 %% Cell type:markdown id: tags:
 
 Mit "match" können wir beispielsweise unsere Ergebnisse für Aufgabe 1 prüfen:
 
 %% Cell type:code id: tags:
 
 ``` 
 if re.match("[hc]?at", "cat"):
     print("Wort wurde erkannt")
 else:
     print("Wort wurde nicht erkannt")
 ```
 
 %% Cell type:markdown id: tags:
 
 
 %% Cell type:code id: tags:
 
 ``` 
 # Es gibt eine umfangreiche eingebaute Hilfe:
 help(re)
 ```
 
 %% Cell type:code id: tags:
 
 ``` 
 ```
+
+%% Cell type:markdown id: tags:
+
+![CC-BY-NC](https://scm.cms.hu-berlin.de/ibi/python/-/raw/master/img/cc-by-nc.png)
+
+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.

programmierspass/Develop_and_publish_modul.ipynb

+%% Cell type:markdown id:1fe95632 tags:
+
+# Ein Python-Modul entwicklen und veröffentlichen
+
+<br/>
+<br/>
+
+Dieses Notebook finden Sie hier: https://scm.cms.hu-berlin.de/ibi/python/-/blob/master/programmierspass/Develop_and_publish_modul.ipynb
+
+<br/>
+
+![CC-BY-NC](https://scm.cms.hu-berlin.de/ibi/python/-/raw/master/img/cc-by-nc.png)
+
+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.
+
+<div class="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.
+
+%% Cell type:markdown id:cbf98fba tags:
+
+## Mein erstes PyPI (Test)-Package
+
+%% Cell type:markdown id:0cbf8602 tags:
+
+### Beispiel für ein minimales Projekt
+
+```
+pypi-example/
+├── LICENSE
+├── pyproject.toml
+├── README.md
+└── pypiex/
+    ├── __init__.py
+    └── example.py
+```
+
+%% Cell type:markdown id:8b3f6ddf tags:
+
+### pyproject.toml - Konfiguration von Metadaten
+
+```toml
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "Pypiex"
+version = "0.0.1"
+authors = [
+    { name = "Frederik Arnold", email = "frederik.arnold@hu-berlin.de" }
+]
+description = "Eine kurze Beschreibung für PyPiex"
+readme = "README.md"
+requires-python = ">=3.7"
+
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "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:markdown id:68e05d16 tags:
+
+- Zuerst müssen für den Build benötigten Pakete installiert werden.
+
+```
+pip install --upgrade build
+```
+
+%% Cell type:markdown id:3cf7b4cd tags:
+
+- 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 xyz-version.tar.gz and xyz-version-py3-none-any.whl
+```
+
+- 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 den Testserver hochladen
+
+- Um Pakete hochladen zu können muss zuerst ein Account erstellt werden.
+
+<div class="alert alert-info">
+<b>Hinweis</b> Der PyPI Testserver ist unabhängig von der Produktionsumgebung und es werden jeweils eigene Accounts benötigt.
+</div>
+
+%% Cell type:markdown id:1444d33a 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.
+
+<div class="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:
+
+- Jetzt die für den Upload benötigten Packages laden und installieren:
+
+```
+pip install --upgrade twine
+```
+
+%% Cell type:markdown id:325e2694 tags:
+
+- 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.
+
+
+```
+python -m twine upload --repository testpypi dist/*
+```
+
+<div class="alert alert-info">
+<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.
+
+%% Cell type:code id:eab699f8 tags:
+
+``` 
+!pip install --index-url https://test.pypi.org/simple/ --no-deps Pypiex
+```
+
+%% Cell type:code id:2f369bf9 tags:
+
+``` 
+from pypiex import example
+example.say_hello("Frederik")
+```
+
+%% Cell type:markdown id:2a17f85c tags:
+
+## Literatur
+
+- https://packaging.python.org/en/latest/tutorials/packaging-projects/
+- https://setuptools.pypa.io/en/latest/userguide/index.html
+
+%% Cell type:code id:ee4663eb tags:
+
+``` 
+```

programmierspass/census2010.py

+allData = {}
\ No newline at end of file