Zum Inhalt

Über diese Site

Auf dieser Site habe ich meine Daten zum MVHS Workshop: Python für Automatisierungs- und Scripting-Aufgaben abgelegt.

Der gesamte Inhalt dieser Site ist in meinem GitHub Repository maroph/mvhs_python_automatisierung_scripting abgelegt.

Struktur des Repositories

Im Branch main des Repositories befinden sich die folgenden Dateien und Verzeichnisse:

  • .github/workflows/ci.yml
    GitHub Actions Konfigurationsdatei.
    Diese Konfigurationsdatei sorgt dafür, dass bei jedem commit im Branch main, der den Inhalt der Webseiten betrifft, die HTML Seiten neu erzeugt werden.
  • docs
    Markdown Sourcen dieser Site
  • sources
    Python Source Code
  • LICENSE
    Lizenz des Repositories (CC-BY 4.0)
  • README.md
    Readme Datei des Repositories
  • build.bash
    Linux build Skript.
    Mit diesem Skript kann man lokal die HTML Seiten auf einem Linux System erzeugen.
  • mkdocs.yml
    MkDocs Konfigurationsdatei

Änderungen/Erweiterungen committe ich zuerst im Branch develop. Abschließend merge ich das Ergebnis in den main Branch.

Webseiten

Die Markdown Dateien für die Webseiten sind unter docs abgelegt.

Die Webseiten erzeuge ich aus den Markdown Dateien mit dem
MkDocs Static Site Generator und dem darauf aufbauenden Material for MkDocs. Die erzeugten Webseiten werden im Branch gh-pages abgelegt.

Für den Aufruf der benötigten Python Module nutze ich ein Python Virtual Environment.

Auf die Webseiten kann man über die GitHub Page maroph.github.io/mvhs_python_automatisierung_scripting zugreifen.

Python

Python Dateien

Die Python Dateien sind im Verzeichnis sources des Repositories abgelegt.

Python Version und Betriebssysteme

Die Python Programme habe ich unter Debian 12 und Windows 11 getestet.

Die jeweils verwendete Python Version kann man mit dem Programm version.py ausgeben.

Debian 12.11

$ python3 version.py
Python Version : 3.11.2
---
Node           : myhost
System         : Linux
Release        : 5.15.167.4-microsoft-standard-WSL2
Version        : #1 SMP Tue Nov 5 00:21:55 UTC 2024
Machine        : x86_64
Processor      :

Windows 11 24H2

> python.exe version.py
Python Version : 3.13.2
---
Node      : myhost
System    : Windows
Release   : 11
Version   : 10.0.26100
Machine   : AMD64
Processor : AMD64 Family 25 Model 80 Stepping 0, AuthenticAMD

Python Virtual Environment

Zur Erzeugung der Webseiten verwende ich die folgenden Python Module

Für die benötigten Python Module verwende ich das folgende Virtual Environment:

python3 -m venv venv
source venv/bin/activate
python -m pip install --upgrade pip
python -m pip install --upgrade setuptools
python -m pip install --upgrade wheel
python -m pip install mkdocs-material
python -m pip install mkdocs-git-revision-date-localized-plugin
python -m pip install mkdocs-rss-plugin

Python Virtual Environment (Ergänzung: Runtime)

Für die Beispiele werden zusätzlich die folgenden Python Module benötigt:

python -m pip install beautifulsoup4
python -m pip install lxml
python -m pip install python-dateutil
python -m pip install requests

Für Testfälle benutze ich die pytest Module

python -m pip install pytest
python -m pip install pytest-order

Sollte das Modul pip und/oder venv nicht installiert sein, muss man das entsprechende Package installieren.

Auf einem Debian System geht das mit dem folgenden Kommando

sudo apt install python3-pip
sudo apt install python3-venv