eetlijst-python 0.0.1__tar.gz

eetlijst_python-0.0.1/PKG-INFO

@@ -0,0 +1,80 @@
+Metadata-Version: 2.4
+Name: eetlijst-python
+Version: 0.0.1
+Summary: Python rewrite of the Eetlijst GraphQL client
+Requires-Python: <3.15,>=3.14
+Description-Content-Type: text/markdown
+Requires-Dist: httpx>=0.28
+Requires-Dist: pydantic>=2.0.0
+Provides-Extra: dev
+Requires-Dist: ariadne-codegen>=0.18; extra == "dev"
+Requires-Dist: mypy>=1.8.0; extra == "dev"
+Requires-Dist: black>=24.0; extra == "dev"
+Requires-Dist: isort>=5.13; extra == "dev"
+Requires-Dist: pylint>=3.0; extra == "dev"
+
+# eetlijst-python
+
+A simple Python API client for Eetlijst.
+
+> [!NOTE]
+> This project is made for use in a student house, and will probably not be maintained.
+> Most of this Python port was converted from the TypeScript version (https://github.com/DJ1TJOO/eetlijst-api-ts) using Google Gemini.
+
+## Usage
+
+Create a virtual environment and install the package:
+
+    python -m venv .venv
+    # Activate virtual environment (.venv\Scripts\Activate.ps1 on Windows or source .venv/bin/activate on Linux/macOS)
+    python -m pip install -e .
+
+The API key can be retrieved from the account page, under Developer API key (BETA), at https://v5.eetlijst.nl/account
+
+```python
+import asyncio
+from eetlijst import Eetlijst
+
+eetlijst = Eetlijst("<API_KEY>")
+
+async def main():
+    app_status = await eetlijst.app.status()
+    print(app_status)
+
+if __name__ == "__main__":
+    asyncio.run(main())
+```
+
+See Examples (./examples/) for more.
+
+## What is Included
+
+- Service classes for app, events, expenses, groups, users, groups.users, groups.list, events.attendance, and expenses.settlements.
+- A complete GraphQL operation manifest at src/eetlijst/operations.graphql for ariadne-codegen.
+- Example scripts matching the TS examples.
+
+## Development & Codegen
+
+This project uses ariadne-codegen (https://github.com/mirumee/ariadne-codegen) for GraphQL code generation.
+
+Run code generation:
+
+```
+ariadne-codegen
+```
+
+The configuration in pyproject.toml points to the GraphQL schema and outputs generated code into src/generated/.
+
+### Building
+
+To build the package locally, install the build tool first:
+
+```
+python -m pip install build
+```
+
+Build the package:
+
+```
+python -m build
+```

eetlijst_python-0.0.1/README.md

@@ -0,0 +1,65 @@
+# eetlijst-python
+
+A simple Python API client for Eetlijst.
+
+> [!NOTE]
+> This project is made for use in a student house, and will probably not be maintained.
+> Most of this Python port was converted from the TypeScript version (https://github.com/DJ1TJOO/eetlijst-api-ts) using Google Gemini.
+
+## Usage
+
+Create a virtual environment and install the package:
+
+    python -m venv .venv
+    # Activate virtual environment (.venv\Scripts\Activate.ps1 on Windows or source .venv/bin/activate on Linux/macOS)
+    python -m pip install -e .
+
+The API key can be retrieved from the account page, under Developer API key (BETA), at https://v5.eetlijst.nl/account
+
+```python
+import asyncio
+from eetlijst import Eetlijst
+
+eetlijst = Eetlijst("<API_KEY>")
+
+async def main():
+    app_status = await eetlijst.app.status()
+    print(app_status)
+
+if __name__ == "__main__":
+    asyncio.run(main())
+```
+
+See Examples (./examples/) for more.
+
+## What is Included
+
+- Service classes for app, events, expenses, groups, users, groups.users, groups.list, events.attendance, and expenses.settlements.
+- A complete GraphQL operation manifest at src/eetlijst/operations.graphql for ariadne-codegen.
+- Example scripts matching the TS examples.
+
+## Development & Codegen
+
+This project uses ariadne-codegen (https://github.com/mirumee/ariadne-codegen) for GraphQL code generation.
+
+Run code generation:
+
+```
+ariadne-codegen
+```
+
+The configuration in pyproject.toml points to the GraphQL schema and outputs generated code into src/generated/.
+
+### Building
+
+To build the package locally, install the build tool first:
+
+```
+python -m pip install build
+```
+
+Build the package:
+
+```
+python -m build
+```

eetlijst_python-0.0.1/pyproject.toml

@@ -0,0 +1,94 @@
+[project]
+name = "eetlijst-python"
+version = "0.0.1"
+description = "Python rewrite of the Eetlijst GraphQL client"
+readme = "README.md"
+requires-python = ">=3.14,<3.15"
+dependencies = [
+  "httpx>=0.28",
+  "pydantic>=2.0.0",
+]
+
+[project.optional-dependencies]
+dev = [
+  "ariadne-codegen>=0.18",
+  "mypy>=1.8.0",
+  "black>=24.0",
+  "isort>=5.13",
+  "pylint>=3.0",
+]
+
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[tool.ariadne-codegen]
+schema_path = "schema.graphql"
+queries_path = "src/eetlijst/services"
+target_package_name = "generated"
+target_package_path = "src/eetlijst"
+include_comments = "none"
+client_name = "GraphQlClient"
+
+[tool.ariadne-codegen.scalars.uuid]
+type = "str"
+
+[tool.ariadne-codegen.scalars.timestamptz]
+type = "datetime.datetime"
+deserialize = "iso8601.parse_date"
+
+[tool.pylint.main]
+ignore-paths = [
+    "src/eetlijst/generated"
+]
+
+[tool.pylint.messages_control]
+disable = [
+    "duplicate-code",
+    "too-many-arguments",
+    "too-many-positional-arguments",
+    "line-too-long",
+    "missing-module-docstring",
+    "missing-class-docstring",
+    "missing-function-docstring",
+    "bare-except",
+    "too-many-branches",
+    "too-many-locals",
+    "too-few-public-methods",
+    "too-many-public-methods",
+    "fixme"
+]
+
+[tool.pylint.BASIC]
+typevar-rgx = "^_?[A-Z][a-zA-Z0-9_]*$"
+
+[tool.black]
+exclude = "src/eetlijst/generated"
+
+[tool.isort]
+profile = "black"
+skip = [
+    "src/eetlijst/generated"
+]
+sections = [
+    "FUTURE",
+    "STDLIB",
+    "THIRDPARTY",
+    "GENERATED",
+    "SRC",
+    "SERVICES",
+    "UTILS",
+    "FIRSTPARTY",
+    "LOCALFOLDER"
+]
+known_generated = ["eetlijst.generated"]
+known_src = ["eetlijst"]
+known_services = ["eetlijst.services"]
+known_utils = ["eetlijst.utils"]
+
+[tool.mypy]
+exclude = "src/eetlijst/generated"
+check_untyped_defs = true
+warn_redundant_casts = true
+disallow_any_generics = true
+disallow_any_unimported = true

eetlijst_python-0.0.1/setup.cfg

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

eetlijst_python-0.0.1/src/eetlijst/__init__.py

@@ -0,0 +1,3 @@
+from .eetlijst import Eetlijst
+
+__all__ = ["Eetlijst"]

eetlijst_python-0.0.1/src/eetlijst/eetlijst.py

@@ -0,0 +1,37 @@
+from typing import Optional
+
+from eetlijst.generated import GraphQlClient
+
+from eetlijst.services import (
+    App,
+    EventAttendance,
+    Events,
+    Expenses,
+    GroupList,
+    Groups,
+    GroupUsers,
+    Settlements,
+    Users,
+)
+
+
+class Eetlijst:
+    def __init__(self, api_key: str, url: Optional[str] = None):
+        self._client = GraphQlClient(
+            url or "https://api.eetlijst.nl/v1/graphql",
+            {"Authorization": f"Bearer {api_key}"},
+        )
+
+        self.app = App(self._client)
+
+        event_attendance = EventAttendance(self._client)
+        self.events = Events(self._client, event_attendance)
+
+        group_users = GroupUsers(self._client)
+        group_list = GroupList(self._client)
+        self.groups = Groups(self._client, group_users, group_list)
+
+        settlements = Settlements(self._client)
+        self.expenses = Expenses(self._client, settlements)
+
+        self.users = Users(self._client)

eetlijst_python-0.0.1/src/eetlijst/exceptions.py

@@ -0,0 +1,2 @@
+class EetlijstException(Exception):
+    pass