chefkoch-cli 0.1.1__tar.gz

chefkoch_cli-0.1.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 smlfg
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

chefkoch_cli-0.1.1/PKG-INFO

@@ -0,0 +1,136 @@
+Metadata-Version: 2.4
+Name: chefkoch-cli
+Version: 0.1.1
+Summary: Chefkoch.de-Rezepte im Terminal: Suche, Rezeptdetails, Einkaufsliste und Watch
+Author-email: smlfg <186922365+smlfg@users.noreply.github.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/smlfg/chefkoch-cli
+Project-URL: Repository, https://github.com/smlfg/chefkoch-cli
+Keywords: chefkoch,recipes,cli,terminal
+Classifier: Environment :: Console
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: httpx>=0.24
+Dynamic: license-file
+
+# chefkoch-cli
+
+Chefkoch.de-Rezepte im Terminal: Suche mit Filtern, Rezeptdetails mit auf
+Portionen skalierten Zutaten, Einkaufsliste aus mehreren Rezepten und Watch auf
+neue Rezepte. Ausschließlich lesend, ohne Login.
+
+## Schnellstart
+
+Voraussetzung: Python 3.10+ und `pipx`.
+
+```bash
+pipx install git+https://github.com/smlfg/chefkoch-cli
+chefkoch suche lasagne --limit 5
+chefkoch rezept "vegane lasagne" --portionen 4
+chefkoch einkaufsliste "die ultimative vegane lasagne" "vegetarische spinat gemüse lasagne" --portionen 4
+```
+
+Die Suche nimmt den Begriff positional. `chefkoch rezept` und
+`chefkoch einkaufsliste` akzeptieren Namen, IDs oder Chefkoch-URLs; bei
+mehreren Treffern erscheint im Terminal eine nummerierte Auswahl.
+
+## Befehle und Beispiele
+
+### Suchen
+
+```bash
+chefkoch suche lasagne --limit 5
+chefkoch suche chili --vegetarisch --max-zeit 30 --min-bewertung 4.5
+chefkoch suche suppe --vegan --sort zeit
+chefkoch suche kuchen --sort neu --limit 10 --seite 2
+```
+
+Filter: `--vegetarisch`, `--vegan`, `--max-zeit N`, `--min-bewertung X`,
+`--schwierigkeit simpel|normal|pfiffig`, `--sort bewertung|zeit|neu`,
+`--limit N`, `--seite N`.
+
+### Rezept anzeigen
+
+```bash
+chefkoch rezept "vegane lasagne" --portionen 4
+chefkoch rezept 745721177147257
+chefkoch rezept https://www.chefkoch.de/rezepte/745721177147257/Lasagne.html --portionen 8
+```
+
+Ein Name sucht und zeigt bei mehreren Treffern eine nummerierte Auswahl. Eine
+ID oder URL lädt das Rezept direkt. `--portionen` skaliert die Zutaten.
+
+### Einkaufsliste
+
+```bash
+chefkoch einkaufsliste "die ultimative vegane lasagne" "vegetarische spinat gemüse lasagne" --portionen 4
+```
+
+Mehrere Namen, IDs oder URLs ergeben eine zusammengefasste Liste. Gleiche
+Zutaten mit gleicher Einheit werden summiert, unterschiedliche Einheiten
+bleiben getrennt.
+
+### Watch
+
+```bash
+chefkoch watch "vegane lasagne" --min-bewertung 4.5
+```
+
+Watch merkt sich die zuletzt gesehenen IDs pro Suchbegriff und Filter und zeigt
+beim nächsten Lauf nur neue Treffer.
+
+## Ausgabe und JSON
+
+Im Terminal ist die Ausgabe lesbar (Trefferliste, Rezept, Einkaufsliste). JSON
+erscheint nur mit `--json` oder wenn stdout kein Terminal ist. Im JSON-Modus
+steht genau ein Objekt auf stdout, auch bei Fehlern:
+
+```bash
+chefkoch suche lasagne --limit 5 --json
+chefkoch rezept "vegane lasagne" --json
+```
+
+## Konfiguration
+
+| Variable | Default | Bedeutung |
+|---|---|---|
+| `CHEFKOCH_BASE_URL` | `https://api.chefkoch.de` | API-Basis (Test/Fake-Server) |
+| `CHEFKOCH_MIN_INTERVAL` | `1` | Mindestabstand zwischen Requests in Sekunden; `0` nur für Tests |
+| `XDG_STATE_HOME` | `~/.local/state` | Basis für den Watch-State |
+
+Der Watch-State liegt unter
+`$XDG_STATE_HOME/chefkoch-cli/watch.json` (Fallback
+`~/.local/state/chefkoch-cli/watch.json`) und enthält nur IDs, Suchschlüssel
+und Zeitstempel. Weitere Config-Dateien gibt es nicht.
+
+## Exit-Codes
+
+| Exit | Bedeutung |
+|---|---|
+| 0 | Erfolg, inklusive `--help` und `--version` |
+| 1 | Allgemeiner Fehler (z. B. kaputter Watch-State) |
+| 2 | Usage: fehlende/ungültige Argumente, mehrdeutiger Name ohne TTY |
+| 3 | Netz/Quelle: Timeout, HTTP-Fehler, Rezept-404, keine Treffer |
+| 4 | Login erforderlich (nicht verwendet) bzw. Daten-/Parse-Fehler |
+
+## Datenquelle und Grenzen
+
+`chefkoch` nutzt die inoffizielle API `https://api.chefkoch.de` über
+`GET /v2/recipes` und `GET /v2/recipes/<id>`. Die Website
+`www.chefkoch.de/rezepte/*?*` und `/v2/search/suggestions` werden nicht
+abgerufen. Das Tool sendet keine Cookies, speichert keine Zugangsdaten und
+führt keine schreibenden Web-Aktionen aus.
+
+Die API ist nicht offiziell dokumentiert und kann sich jederzeit ändern.
+Details und Befehlsvertrag stehen in `ANFORDERUNGEN.md`, `INTERFACE.md` und
+`docs/UX.md`.
+
+## Lizenz
+
+MIT, Copyright smlfg. Siehe `LICENSE`.

chefkoch_cli-0.1.1/README.md

@@ -0,0 +1,115 @@
+# chefkoch-cli
+
+Chefkoch.de-Rezepte im Terminal: Suche mit Filtern, Rezeptdetails mit auf
+Portionen skalierten Zutaten, Einkaufsliste aus mehreren Rezepten und Watch auf
+neue Rezepte. Ausschließlich lesend, ohne Login.
+
+## Schnellstart
+
+Voraussetzung: Python 3.10+ und `pipx`.
+
+```bash
+pipx install git+https://github.com/smlfg/chefkoch-cli
+chefkoch suche lasagne --limit 5
+chefkoch rezept "vegane lasagne" --portionen 4
+chefkoch einkaufsliste "die ultimative vegane lasagne" "vegetarische spinat gemüse lasagne" --portionen 4
+```
+
+Die Suche nimmt den Begriff positional. `chefkoch rezept` und
+`chefkoch einkaufsliste` akzeptieren Namen, IDs oder Chefkoch-URLs; bei
+mehreren Treffern erscheint im Terminal eine nummerierte Auswahl.
+
+## Befehle und Beispiele
+
+### Suchen
+
+```bash
+chefkoch suche lasagne --limit 5
+chefkoch suche chili --vegetarisch --max-zeit 30 --min-bewertung 4.5
+chefkoch suche suppe --vegan --sort zeit
+chefkoch suche kuchen --sort neu --limit 10 --seite 2
+```
+
+Filter: `--vegetarisch`, `--vegan`, `--max-zeit N`, `--min-bewertung X`,
+`--schwierigkeit simpel|normal|pfiffig`, `--sort bewertung|zeit|neu`,
+`--limit N`, `--seite N`.
+
+### Rezept anzeigen
+
+```bash
+chefkoch rezept "vegane lasagne" --portionen 4
+chefkoch rezept 745721177147257
+chefkoch rezept https://www.chefkoch.de/rezepte/745721177147257/Lasagne.html --portionen 8
+```
+
+Ein Name sucht und zeigt bei mehreren Treffern eine nummerierte Auswahl. Eine
+ID oder URL lädt das Rezept direkt. `--portionen` skaliert die Zutaten.
+
+### Einkaufsliste
+
+```bash
+chefkoch einkaufsliste "die ultimative vegane lasagne" "vegetarische spinat gemüse lasagne" --portionen 4
+```
+
+Mehrere Namen, IDs oder URLs ergeben eine zusammengefasste Liste. Gleiche
+Zutaten mit gleicher Einheit werden summiert, unterschiedliche Einheiten
+bleiben getrennt.
+
+### Watch
+
+```bash
+chefkoch watch "vegane lasagne" --min-bewertung 4.5
+```
+
+Watch merkt sich die zuletzt gesehenen IDs pro Suchbegriff und Filter und zeigt
+beim nächsten Lauf nur neue Treffer.
+
+## Ausgabe und JSON
+
+Im Terminal ist die Ausgabe lesbar (Trefferliste, Rezept, Einkaufsliste). JSON
+erscheint nur mit `--json` oder wenn stdout kein Terminal ist. Im JSON-Modus
+steht genau ein Objekt auf stdout, auch bei Fehlern:
+
+```bash
+chefkoch suche lasagne --limit 5 --json
+chefkoch rezept "vegane lasagne" --json
+```
+
+## Konfiguration
+
+| Variable | Default | Bedeutung |
+|---|---|---|
+| `CHEFKOCH_BASE_URL` | `https://api.chefkoch.de` | API-Basis (Test/Fake-Server) |
+| `CHEFKOCH_MIN_INTERVAL` | `1` | Mindestabstand zwischen Requests in Sekunden; `0` nur für Tests |
+| `XDG_STATE_HOME` | `~/.local/state` | Basis für den Watch-State |
+
+Der Watch-State liegt unter
+`$XDG_STATE_HOME/chefkoch-cli/watch.json` (Fallback
+`~/.local/state/chefkoch-cli/watch.json`) und enthält nur IDs, Suchschlüssel
+und Zeitstempel. Weitere Config-Dateien gibt es nicht.
+
+## Exit-Codes
+
+| Exit | Bedeutung |
+|---|---|
+| 0 | Erfolg, inklusive `--help` und `--version` |
+| 1 | Allgemeiner Fehler (z. B. kaputter Watch-State) |
+| 2 | Usage: fehlende/ungültige Argumente, mehrdeutiger Name ohne TTY |
+| 3 | Netz/Quelle: Timeout, HTTP-Fehler, Rezept-404, keine Treffer |
+| 4 | Login erforderlich (nicht verwendet) bzw. Daten-/Parse-Fehler |
+
+## Datenquelle und Grenzen
+
+`chefkoch` nutzt die inoffizielle API `https://api.chefkoch.de` über
+`GET /v2/recipes` und `GET /v2/recipes/<id>`. Die Website
+`www.chefkoch.de/rezepte/*?*` und `/v2/search/suggestions` werden nicht
+abgerufen. Das Tool sendet keine Cookies, speichert keine Zugangsdaten und
+führt keine schreibenden Web-Aktionen aus.
+
+Die API ist nicht offiziell dokumentiert und kann sich jederzeit ändern.
+Details und Befehlsvertrag stehen in `ANFORDERUNGEN.md`, `INTERFACE.md` und
+`docs/UX.md`.
+
+## Lizenz
+
+MIT, Copyright smlfg. Siehe `LICENSE`.

chefkoch_cli-0.1.1/pyproject.toml

@@ -0,0 +1,39 @@
+[build-system]
+requires = ["setuptools>=68"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "chefkoch-cli"
+version = "0.1.1"
+description = "Chefkoch.de-Rezepte im Terminal: Suche, Rezeptdetails, Einkaufsliste und Watch"
+readme = "README.md"
+requires-python = ">=3.10"
+license = "MIT"
+authors = [
+    { name = "smlfg", email = "186922365+smlfg@users.noreply.github.com" },
+]
+keywords = ["chefkoch", "recipes", "cli", "terminal"]
+classifiers = [
+    "Environment :: Console",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+]
+dependencies = ["httpx>=0.24"]
+
+[project.urls]
+Homepage = "https://github.com/smlfg/chefkoch-cli"
+Repository = "https://github.com/smlfg/chefkoch-cli"
+
+[project.scripts]
+chefkoch = "chefkoch_cli.cli:main"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+addopts = "-ra"
+pythonpath = ["src"]

chefkoch_cli-0.1.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

chefkoch_cli-0.1.1/src/chefkoch_cli/__init__.py

@@ -0,0 +1,5 @@
+"""Chefkoch.de-Rezepte im Terminal."""
+
+__version__ = "0.1.1"
+
+__all__ = ["__version__"]

chefkoch_cli-0.1.1/src/chefkoch_cli/__main__.py

@@ -0,0 +1,8 @@
+"""Einstieg für ``python -m chefkoch_cli``."""
+
+from __future__ import annotations
+
+from .cli import main
+
+if __name__ == "__main__":
+    raise SystemExit(main())