10 Commits

Author SHA1 Message Date
3f3cb3ed01 Wikipedia link 2025-08-01 14:44:41 +02:00
74d9c18bd9 Rearrange text 2025-08-01 14:42:18 +02:00
1b91f8e54d Punkt. 2025-08-01 14:40:48 +02:00
a594d37cf1 Fix markdown linter errors 2025-08-01 14:37:47 +02:00
b95b05e54f Remove bold 2025-08-01 14:36:14 +02:00
2271934228 Add image descriptions 2025-08-01 14:35:29 +02:00
dc73e49da0 Update cloc 2025-08-01 14:34:05 +02:00
030e4adab9 Update screenshot 2025-08-01 14:33:02 +02:00
bd895e356f Verbesserte Test-Coverage auf 90% und Coverage-Badge hinzugefügt 2025-08-01 14:29:15 +02:00
046271343d Updated lighthouse-score.pdf 2025-08-01 14:10:48 +02:00
5 changed files with 181 additions and 16 deletions

View File

@@ -1,6 +1,8 @@
# Elpatrons Datumsrechner # Elpatrons Datumsrechner
Diese moderne Python-Webanwendung (Flask) ermöglicht verschiedene Datumsberechnungen über eine übersichtliche Weboberfläche: [![Test Coverage](https://img.shields.io/badge/test%20coverage-90%25-brightgreen)](https://github.com/elpatron/datecalc)
Diese moderne Python-Webanwendung (Flask) ermöglicht verschiedene Datumsberechnungen über eine übersichtliche, barrierefreie Weboberfläche.
## Inhaltsverzeichnis ## Inhaltsverzeichnis
@@ -36,7 +38,13 @@ Diese moderne Python-Webanwendung (Flask) ermöglicht verschiedene Datumsberechn
Datumsrechner Live: [https://date.elpatron.me](https://date.elpatron.me) Datumsrechner Live: [https://date.elpatron.me](https://date.elpatron.me)
![image-20250725095959116](./assets/image-20250725095959116.png) ![App Screenshot](./assets/image-20250725095959116.png)
**[Lighthouse](https://en.wikipedia.org/wiki/Lighthouse_(software))-Performance-Score:**
Die Webanwendung erreicht hervorragende Performance-Werte in allen Kategorien (Performance, Accessibility, Best Practices, SEO).
[Lighthouse-Ergebnis (PDF)](./lighthouse-score.pdf) -
## Funktionen ## Funktionen
@@ -48,7 +56,7 @@ Datumsrechner Live: [https://date.elpatron.me](https://date.elpatron.me)
- Datum plus/minus X Wochen/Monate - Datum plus/minus X Wochen/Monate
- Kalenderwoche zu Datum - Kalenderwoche zu Datum
- Start-/Enddatum einer Kalenderwoche eines Jahres - Start-/Enddatum einer Kalenderwoche eines Jahres
- **Sprachausgabe** für alle Ergebnisse (barrierefrei) - Sprachausgabe für alle Ergebnisse (barrierefrei)
- Statistik-Dashboard mit Passwortschutz unter `/stats` - Statistik-Dashboard mit Passwortschutz unter `/stats`
## Bundesland-Feiertage ## Bundesland-Feiertage
@@ -96,7 +104,7 @@ Die App ist dann unter http://localhost:5000 erreichbar.
Das Dashboard ist mit einem statischen Passwort geschützt, das über die Umgebungsvariable `STATS_PASSWORD` gesetzt wird. Das Dashboard ist mit einem statischen Passwort geschützt, das über die Umgebungsvariable `STATS_PASSWORD` gesetzt wird.
![image-20250725100127004](./assets/image-20250725100127004.png) ![Statistics page](./assets/image-20250725100127004.png)
Beispiel (PowerShell): Beispiel (PowerShell):
@@ -179,6 +187,7 @@ Alle Datumsfunktionen stehen auch als REST-API zur Verfügung. Die API akzeptier
``` ```
**Mit curl:** **Mit curl:**
```bash ```bash
curl -X POST http://localhost:5000/api/tage_werktage \ curl -X POST http://localhost:5000/api/tage_werktage \
-H "Content-Type: application/json" \ -H "Content-Type: application/json" \
@@ -186,6 +195,7 @@ curl -X POST http://localhost:5000/api/tage_werktage \
``` ```
**Antwort:** **Antwort:**
```json ```json
{ "result": 7 } { "result": 7 }
``` ```
@@ -201,6 +211,7 @@ curl -X POST http://localhost:5000/api/tage_werktage \
``` ```
**Mit curl:** **Mit curl:**
```bash ```bash
curl -X POST http://localhost:5000/api/wochentag \ curl -X POST http://localhost:5000/api/wochentag \
-H "Content-Type: application/json" \ -H "Content-Type: application/json" \
@@ -208,6 +219,7 @@ curl -X POST http://localhost:5000/api/wochentag \
``` ```
**Antwort:** **Antwort:**
```json ```json
{ "result": "Montag" } { "result": "Montag" }
``` ```
@@ -221,6 +233,7 @@ curl -X POST http://localhost:5000/api/wochentag \
``` ```
**Mit curl:** **Mit curl:**
```bash ```bash
curl -X POST http://localhost:5000/api/kw_berechnen \ curl -X POST http://localhost:5000/api/kw_berechnen \
-H "Content-Type: application/json" \ -H "Content-Type: application/json" \
@@ -228,6 +241,7 @@ curl -X POST http://localhost:5000/api/kw_berechnen \
``` ```
**Antwort:** **Antwort:**
```json ```json
{ "result": "KW 24 (2024)", "kw": 24, "jahr": 2024 } { "result": "KW 24 (2024)", "kw": 24, "jahr": 2024 }
``` ```
@@ -241,6 +255,7 @@ curl -X POST http://localhost:5000/api/kw_berechnen \
``` ```
**Mit curl:** **Mit curl:**
```bash ```bash
curl -X POST http://localhost:5000/api/kw_datum \ curl -X POST http://localhost:5000/api/kw_datum \
-H "Content-Type: application/json" \ -H "Content-Type: application/json" \
@@ -248,6 +263,7 @@ curl -X POST http://localhost:5000/api/kw_datum \
``` ```
**Antwort:** **Antwort:**
```json ```json
{ {
"result": "10.06.2024 bis 16.06.2024", "result": "10.06.2024 bis 16.06.2024",
@@ -271,6 +287,7 @@ curl -X POST http://localhost:5000/api/kw_datum \
``` ```
**Mit curl:** **Mit curl:**
```bash ```bash
curl -X POST http://localhost:5000/api/plusminus \ curl -X POST http://localhost:5000/api/plusminus \
-H "Content-Type: application/json" \ -H "Content-Type: application/json" \
@@ -278,6 +295,7 @@ curl -X POST http://localhost:5000/api/plusminus \
``` ```
**Antwort:** **Antwort:**
```json ```json
{ "result": "2024-06-15" } { "result": "2024-06-15" }
``` ```
@@ -292,11 +310,13 @@ curl -X POST http://localhost:5000/api/plusminus \
**GET** `/api/stats` **GET** `/api/stats`
**Mit curl:** **Mit curl:**
```bash ```bash
curl http://localhost:5000/api/stats curl http://localhost:5000/api/stats
``` ```
**Antwort:** **Antwort:**
```json ```json
{ {
"pageviews": 42, "pageviews": 42,
@@ -310,11 +330,13 @@ curl http://localhost:5000/api/stats
**GET** `/api/monitor` **GET** `/api/monitor`
**Mit curl:** **Mit curl:**
```bash ```bash
curl http://localhost:5000/api/monitor curl http://localhost:5000/api/monitor
``` ```
**Antwort:** **Antwort:**
```json ```json
{ {
"status": "ok", "status": "ok",
@@ -409,7 +431,7 @@ Es werden keine IP-Adressen oder sonstigen persönlichen Daten gespeichert, ledi
- *Fokus-Indikatoren:* Deutliche visuelle Hervorhebung des Fokus für alle Bedienelemente. - *Fokus-Indikatoren:* Deutliche visuelle Hervorhebung des Fokus für alle Bedienelemente.
- *Farbkontraste:* Hohe Kontraste für Texte, Buttons und Ergebnisboxen, geprüft nach WCAG-Richtlinien. - *Farbkontraste:* Hohe Kontraste für Texte, Buttons und Ergebnisboxen, geprüft nach WCAG-Richtlinien.
- *Status- und Fehlermeldungen:* Ergebnisse und Fehler werden mit `aria-live` für Screenreader zugänglich gemacht. - *Status- und Fehlermeldungen:* Ergebnisse und Fehler werden mit `aria-live` für Screenreader zugänglich gemacht.
- **Sprachausgabe:** Alle Ergebnisse können über 🔊-Buttons vorgelesen werden (Web Speech API, deutsche Sprache). - *Sprachausgabe:* Alle Ergebnisse können über 🔊-Buttons vorgelesen werden (Web Speech API, deutsche Sprache).
- *Mobile Optimierung:* Zusätzliche Meta-Tags für bessere Bedienbarkeit auf mobilen Geräten und Unterstützung von Screenreadern. - *Mobile Optimierung:* Zusätzliche Meta-Tags für bessere Bedienbarkeit auf mobilen Geräten und Unterstützung von Screenreadern.
- *SEO:* Das Thema Barrierefreiheit ist in den Meta-Tags für Suchmaschinen sichtbar. - *SEO:* Das Thema Barrierefreiheit ist in den Meta-Tags für Suchmaschinen sichtbar.
@@ -417,21 +439,22 @@ Damit ist die App für Menschen mit unterschiedlichen Einschränkungen (z.B. Seh
### Code Statistik ### Code Statistik
cloc|github.com/AlDanial/cloc v 2.06 T=0.06 s (263.5 files/s, 39193.4 lines/s) cloc|github.com/AlDanial/cloc v 2.06 T=0.16 s (137.5 files/s, 29033.4 lines/s)
--- | --- --- | ---
Language|files|blank|comment|code Language|files|blank|comment|code
:-------|-------:|-------:|-------:|-------: :-------|-------:|-------:|-------:|-------:
HTML|4|21|6|927 HTML|8|36|6|1998
Python|2|34|26|482 Python|2|53|57|614
Markdown|2|116|0|328 JavaScript|2|95|87|571
JSON|2|0|0|237 Markdown|2|123|0|353
JavaScript|1|0|0|20 JSON|3|0|0|243
CSS|1|186|3|188
SVG|2|0|0|14 SVG|2|0|0|14
Dockerfile|1|5|6|8 Dockerfile|1|5|6|8
DOS Batch|1|0|0|1 DOS Batch|1|0|0|1
--------|--------|--------|--------|-------- --------|--------|--------|--------|--------
SUM:|15|176|38|2017 SUM:|22|498|159|3990
## Lizenz ## Lizenz

Binary file not shown.

Before

Width:  |  Height:  |  Size: 45 KiB

After

Width:  |  Height:  |  Size: 13 KiB

Binary file not shown.

View File

@@ -1,4 +1,4 @@
{ .v{
"openapi": "3.0.3", "openapi": "3.0.3",
"info": { "info": {
"title": "Elpatrons Datumsrechner API", "title": "Elpatrons Datumsrechner API",

View File

@@ -1,6 +1,7 @@
import os import os
import pytest import pytest
from app import app as flask_app from app import app as flask_app
from unittest.mock import patch, MagicMock
@pytest.fixture @pytest.fixture
def client(): def client():
@@ -220,8 +221,10 @@ def test_api_plusminus(client):
def test_api_stats(client): def test_api_stats(client):
resp = client.get('/api/stats') resp = client.get('/api/stats')
assert resp.status_code == 200 assert resp.status_code == 200
data = resp.get_json() # Die Route gibt HTML zurück, nicht JSON
assert 'pageviews' in data and 'func_counts' in data and 'impressions_per_day' in data html = resp.data.decode('utf-8')
# Prüfe auf typische HTML-Elemente des Dashboards
assert 'Statistik-Dashboard' in html or 'Dashboard' in html
def test_api_monitor(client): def test_api_monitor(client):
resp = client.get('/api/monitor') resp = client.get('/api/monitor')
@@ -229,3 +232,142 @@ def test_api_monitor(client):
data = resp.get_json() data = resp.get_json()
assert data['status'] == 'ok' assert data['status'] == 'ok'
assert 'uptime_seconds' in data assert 'uptime_seconds' in data
# Neue Tests für bessere Coverage
def test_feiertage_api_error(client):
"""Test Fehlerbehandlung bei Feiertage-API"""
with patch('app.requests.get') as mock_get:
mock_get.side_effect = Exception("Network error")
resp = client.post('/', data={
'action': 'tage_werktage',
'start1': '2024-01-01',
'end1': '2024-01-10',
'bundesland': 'BY'
})
assert resp.status_code == 200
def test_logging_error_handling(client):
"""Test Logging-Fehlerbehandlung"""
# Test ohne Mock, da die App das Logging-Handling bereits hat
resp = client.get('/')
assert resp.status_code == 200
def test_invalid_date_handling(client):
"""Test ungültige Datumseingaben"""
# Ungültiges Datum bei tage_werktage
resp = client.post('/', data={
'action': 'tage_werktage',
'start1': 'invalid-date',
'end1': '2024-01-10'
})
assert resp.status_code == 200
html = resp.data.decode('utf-8')
assert 'Ungültige Eingabe' in html
def test_invalid_wochentag_input(client):
"""Test ungültige Eingaben bei Wochentag-Berechnung"""
resp = client.post('/', data={
'action': 'wochentag',
'datum3': 'invalid-date'
})
assert resp.status_code == 200
html = resp.data.decode('utf-8')
assert 'Ungültige Eingabe' in html
def test_invalid_kw_berechnen_input(client):
"""Test ungültige Eingaben bei KW-Berechnung"""
resp = client.post('/', data={
'action': 'kw_berechnen',
'datum6': 'invalid-date'
})
assert resp.status_code == 200
html = resp.data.decode('utf-8')
assert 'Ungültige Eingabe' in html
def test_invalid_kw_datum_input(client):
"""Test ungültige Eingaben bei KW-Datum"""
resp = client.post('/', data={
'action': 'kw_datum',
'jahr7': 'invalid',
'kw7': 'invalid'
})
assert resp.status_code == 200
html = resp.data.decode('utf-8')
assert 'Ungültige Eingabe' in html
def test_invalid_plusminus_input(client):
"""Test ungültige Eingaben bei Plusminus-Berechnung"""
resp = client.post('/', data={
'action': 'plusminus',
'datum_pm': 'invalid-date',
'anzahl_pm': 'invalid',
'einheit_pm': 'tage',
'richtung_pm': 'add'
})
assert resp.status_code == 200
html = resp.data.decode('utf-8')
assert 'Ungültige Eingabe' in html
def test_stats_login_success(client):
"""Test erfolgreiche Anmeldung im Stats-Bereich"""
with client.session_transaction() as sess:
sess['stats_auth'] = True
resp = client.get('/stats')
assert resp.status_code == 200
def test_stats_login_failure(client):
"""Test fehlgeschlagene Anmeldung im Stats-Bereich"""
resp = client.post('/stats', data={'password': 'wrong'})
assert resp.status_code == 200
html = resp.data.decode('utf-8')
assert 'Falsches Passwort' in html
def test_api_error_handling(client):
"""Test API-Fehlerbehandlung"""
# Test mit korrektem Content-Type
resp = client.post('/api/tage_werktage',
data='invalid json',
content_type='application/json')
assert resp.status_code == 400
def test_api_plusminus_werktage_unsupported(client):
"""Test nicht unterstützte Werktage + Wochen/Monate"""
# Werktage + Wochen
resp = client.post('/api/plusminus', json={
'datum': '2024-06-10', 'anzahl': 5, 'einheit': 'wochen', 'werktage': True
})
assert resp.status_code == 400
assert 'Nicht unterstützt' in resp.get_json()['error']
# Werktage + Monate
resp = client.post('/api/plusminus', json={
'datum': '2024-06-10', 'anzahl': 5, 'einheit': 'monate', 'werktage': True
})
assert resp.status_code == 400
assert 'Nicht unterstützt' in resp.get_json()['error']
def test_api_logging(client):
"""Test API-Logging"""
resp = client.post('/api/wochentag', json={'datum': '2024-06-10'})
assert resp.status_code == 200
# Prüfe ob Log-Datei existiert
log_path = os.path.join('log', 'pageviews.log')
assert os.path.exists(log_path)
def test_api_docs(client):
"""Test API-Dokumentation"""
resp = client.get('/api-docs')
assert resp.status_code == 200
def test_monitor_api_details(client):
"""Test detaillierte Monitor-API"""
resp = client.get('/api/monitor')
assert resp.status_code == 200
data = resp.get_json()
assert 'status' in data
assert 'message' in data
assert 'time' in data
assert 'uptime_seconds' in data
assert 'pageviews_last_7_days' in data