Initial commit: classcharts-api Python library

Author: kgstorm

.gitignore

@@ -0,0 +1,10 @@
+secrets.local.json
+__pycache__/
+*.py[cod]
+*.egg-info/
+.eggs/
+dist/
+build/
+.env
+.venv/
+*.env

LICENSE

@@ -0,0 +1,15 @@
+ISC License
+
+Copyright (c) 2022 James Cook
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
+AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
+OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+PERFORMANCE OF THIS SOFTWARE.

README.md

@@ -0,0 +1,38 @@
+# classcharts-api
+
+A Python port of [classcharts-api-js](https://github.com/classchartsapi/classcharts-api-js) by James Cook.
+
+Provides an async Python client for the ClassCharts parent and student APIs.
+
+## Installation
+
+```bash
+pip install classcharts-api
+```
+
+## Usage
+
+```python
+import asyncio
+from classcharts_api import ParentClient
+
+async def main():
+    async with ParentClient("email@example.com", "password") as client:
+        await client.login()
+        pupils = client.pupils
+        homeworks = await client.get_homeworks_for_each_pupil(
+            display_date="due_date",
+            from_date="2026-01-01",
+            to_date="2026-07-01",
+        )
+        for pupil_id, resp in homeworks.items():
+            print(f"Pupil {pupil_id}: {len(resp['data'])} homework items")
+
+asyncio.run(main())
+```
+
+## License
+
+ISC License — see [LICENSE](LICENSE).
+
+This project is a Python port of [classcharts-api-js](https://github.com/classchartsapi/classcharts-api-js), copyright (c) 2022 James Cook, used under the ISC License.

pyproject.toml

@@ -0,0 +1,38 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "classcharts-api"
+version = "1.0.0"
+description = "Async Python wrapper for the ClassCharts API"
+license = { text = "ISC" }
+requires-python = ">=3.11"
+keywords = ["classcharts", "school", "api", "home-assistant"]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: ISC License (ISCL)",
+    "Framework :: AsyncIO",
+    "Intended Audience :: Developers",
+]
+dependencies = [
+    "aiohttp>=3.9.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8.0",
+    "pytest-asyncio>=0.23",
+    "aioresponses>=0.7",
+    "pytest-cov>=5.0",
+]
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"
+testpaths = ["tests"]
+
+[tool.ruff]
+line-length = 100

src/classcharts_api/__init__.py

@@ -0,0 +1,14 @@
+"""ClassCharts API Python wrapper."""
+
+from .parent_client import ParentClient
+from .student_client import StudentClient
+from .exceptions import ClassChartsAuthError, ClassChartsApiError
+from . import models
+
+__all__ = [
+    "ParentClient",
+    "StudentClient",
+    "ClassChartsAuthError",
+    "ClassChartsApiError",
+    "models",
+]