pytekukko 0.16.0__tar.gz → 0.17.0__tar.gz

{pytekukko-0.16.0 → pytekukko-0.17.0}/CHANGELOG.md

@@ -1,5 +1,26 @@
 # Changelog
 
+## [0.17.0](https://github.com/scop/pytekukko/compare/v0.16.0...v0.17.0) (2025-10-12)
+
+
+### Features
+
+* **examples:** facilitate shtab generated completions ([0b89ac6](https://github.com/scop/pytekukko/commit/0b89ac6b9d5c33e003f1a5e1bfa131e74625f5a1))
+* remove Google calendar updater example ([c2f4c5c](https://github.com/scop/pytekukko/commit/c2f4c5c34824bcc3c91a2b7f82f57b971df98fe3))
+
+
+### Performance Improvements
+
+* quote typing.cast type expressions ([76b5c56](https://github.com/scop/pytekukko/commit/76b5c566f49a2f385e89bbfaffaa3eb5dff1153e))
+
+
+### Documentation
+
+* add OpenSSF Scorecard badge ([a2b1fa8](https://github.com/scop/pytekukko/commit/a2b1fa800e8493e999afbb13b0834848bfd75ce2))
+* add OpenSSF Scorecard badge, misc tweaks ([5b70504](https://github.com/scop/pytekukko/commit/5b70504b5ffca34158cda3cbf96f36f0ed70d82c))
+* note Python in top level description ([adc916d](https://github.com/scop/pytekukko/commit/adc916d65a7a781071baa047e9478e87860acbff))
+* **README:** update CI badge URLs ([084fc4b](https://github.com/scop/pytekukko/commit/084fc4bdc2c94d8c70655e44dbe3fd314d77f26a))
+
 ## [0.16.0](https://github.com/scop/pytekukko/compare/v0.15.0...v0.16.0) (2024-01-23)
 
 

{pytekukko-0.16.0/src/pytekukko.egg-info → pytekukko-0.17.0}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.4
 Name: pytekukko
-Version: 0.16.0
+Version: 0.17.0
 Summary: Jätekukko Omakukko API client
 Author-email: Ville Skyttä <ville.skytta@iki.fi>
 License: 
@@ -222,16 +222,17 @@ License-File: LICENSE
 Requires-Dist: aiohttp~=3.4
 Provides-Extra: examples
 Requires-Dist: python-dotenv<2,>=0.10; extra == "examples"
-Requires-Dist: google-api-python-client>=2.0.2,~=2.0; extra == "examples"
-Requires-Dist: icalendar~=5.0; extra == "examples"
+Requires-Dist: icalendar<7,>=5; extra == "examples"
+Dynamic: license-file
 
 # pytekukko -- Jätekukko Omakukko API client
 
 [![Python versions](https://img.shields.io/pypi/pyversions/pytekukko.svg)](https://pypi.org/project/pytekukko/)
 [![PyPI version](https://badge.fury.io/py/pytekukko.svg)](https://badge.fury.io/py/pytekukko)
-[![CI status](https://github.com/scop/pytekukko/workflows/check/badge.svg)](https://github.com/scop/pytekukko/actions?query=workflow%3Acheck)
+[![CI status](https://github.com/scop/pytekukko/actions/workflows/test.yaml/badge.svg)](https://github.com/scop/pytekukko/actions/workflows/test.yaml)
+[![OpenSSF Scorecard](https://api.scorecard.dev/projects/github.com/scop/pytekukko/badge)](https://scorecard.dev/viewer/?uri=github.com%2Fscop%2Fpytekukko)
 
-Simple asyncio client for the [Jätekukko](https://www.jatekukko.fi)
+Simple Python asyncio client for the [Jätekukko](https://www.jatekukko.fi)
 [Omakukko](https://tilasto.jatekukko.fi/indexservice2.jsp) API.
 
 The API of this package is modeled closely after the Omakukko
@@ -254,6 +255,8 @@ detected. If the detection is successful, there is no need to
 separately track session expiration or use the `login` method in the
 first place.
 
+## Command line examples
+
 For usage examples, see utilities in the `pytekukko.examples`
 package. Executables and dependencies for these are installed when the
 package is installed with the `examples` extra, invoke them with
@@ -262,8 +265,28 @@ package is installed with the `examples` extra, invoke them with
 - `pytekukko-collection-schedules`: output collection schedules in JSON
 - `pytekukko-invoice-headers`: output basic info on invoices in JSON
 - `pytekukko-next-collections`: output next collection dates in JSON
-- `pytekukko-update-google-calendar`: update Google Calendar with
-  events for next collections
+
+Shell completions for the examples can be generated with
+[shtab's CLI usage mode](https://docs.iterative.ai/shtab/use/#cli-usage).
+
+<details>
+
+```shell
+shtab \
+  --prog pytekukko-collection-schedules \
+  --prefix pytekukko_collection_schedules \
+  pytekukko.examples.print_collection_schedules.argparser
+shtab \
+  --prog pytekukko-invoice-headers \
+  --prefix pytekukko_invoice_headers \
+  pytekukko.examples.print_invoice_headers.argparser
+shtab \
+  --prog pytekukko-next-collections \
+  --prefix pytekukko_next_collections \
+  pytekukko.examples.print_next_collections.argparser
+```
+
+</details>
 
 ## Disclaimer
 

{pytekukko-0.16.0 → pytekukko-0.17.0}/README.md

@@ -2,9 +2,10 @@
 
 [![Python versions](https://img.shields.io/pypi/pyversions/pytekukko.svg)](https://pypi.org/project/pytekukko/)
 [![PyPI version](https://badge.fury.io/py/pytekukko.svg)](https://badge.fury.io/py/pytekukko)
-[![CI status](https://github.com/scop/pytekukko/workflows/check/badge.svg)](https://github.com/scop/pytekukko/actions?query=workflow%3Acheck)
+[![CI status](https://github.com/scop/pytekukko/actions/workflows/test.yaml/badge.svg)](https://github.com/scop/pytekukko/actions/workflows/test.yaml)
+[![OpenSSF Scorecard](https://api.scorecard.dev/projects/github.com/scop/pytekukko/badge)](https://scorecard.dev/viewer/?uri=github.com%2Fscop%2Fpytekukko)
 
-Simple asyncio client for the [Jätekukko](https://www.jatekukko.fi)
+Simple Python asyncio client for the [Jätekukko](https://www.jatekukko.fi)
 [Omakukko](https://tilasto.jatekukko.fi/indexservice2.jsp) API.
 
 The API of this package is modeled closely after the Omakukko
@@ -27,6 +28,8 @@ detected. If the detection is successful, there is no need to
 separately track session expiration or use the `login` method in the
 first place.
 
+## Command line examples
+
 For usage examples, see utilities in the `pytekukko.examples`
 package. Executables and dependencies for these are installed when the
 package is installed with the `examples` extra, invoke them with
@@ -35,8 +38,28 @@ package is installed with the `examples` extra, invoke them with
 - `pytekukko-collection-schedules`: output collection schedules in JSON
 - `pytekukko-invoice-headers`: output basic info on invoices in JSON
 - `pytekukko-next-collections`: output next collection dates in JSON
-- `pytekukko-update-google-calendar`: update Google Calendar with
-  events for next collections
+
+Shell completions for the examples can be generated with
+[shtab's CLI usage mode](https://docs.iterative.ai/shtab/use/#cli-usage).
+
+<details>
+
+```shell
+shtab \
+  --prog pytekukko-collection-schedules \
+  --prefix pytekukko_collection_schedules \
+  pytekukko.examples.print_collection_schedules.argparser
+shtab \
+  --prog pytekukko-invoice-headers \
+  --prefix pytekukko_invoice_headers \
+  pytekukko.examples.print_invoice_headers.argparser
+shtab \
+  --prog pytekukko-next-collections \
+  --prefix pytekukko_next_collections \
+  pytekukko.examples.print_next_collections.argparser
+```
+
+</details>
 
 ## Disclaimer
 

{pytekukko-0.16.0 → pytekukko-0.17.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "pytekukko"
-version = "0.16.0"
+version = "0.17.0"
 description = "Jätekukko Omakukko API client"
 readme = "README.md"
 requires-python = ">=3.10"
@@ -23,27 +23,31 @@ classifiers = [
 dependencies = ["aiohttp~=3.4"]
 
 [project.optional-dependencies]
-examples = ["python-dotenv>=0.10,<2", "google-api-python-client~=2.0,>=2.0.2", "icalendar~=5.0"]
+examples = ["python-dotenv>=0.10,<2", "icalendar>=5,<7"]
 
 [project.scripts]
 pytekukko-collection-schedules = "pytekukko.examples.print_collection_schedules:main [examples]"
 pytekukko-invoice-headers = "pytekukko.examples.print_invoice_headers:main [examples]"
 pytekukko-next-collections = "pytekukko.examples.print_next_collections:main [examples]"
-pytekukko-update-google-calendar = "pytekukko.examples.update_google_calendar:main [examples]"
 
 [project.urls]
 Homepage = "https://github.com/scop/pytekukko"
 Changelog = "https://github.com/scop/pytekukko/blob/main/CHANGELOG.md"
 
 [tool.ruff]
+fix = true
+src = ["src", "tests"]
+
+[tool.ruff.lint]
 select = ["ALL"]
 ignore = [
   "ANN", # Maybe sometime
   "D203", # Ping/pong with D211
   "D213", # Ping/pong with D212
-  "TCH003", # Maybe sometime
+  "TC003", # Maybe sometime
   # https://docs.astral.sh/ruff/formatter/#conflicting-lint-rules
   # (keep order of ignores here same as ^there for maintainability)
+  # https://github.com/astral-sh/ruff/issues/8175
   "W191",
   "E111",
   "E114",
@@ -59,17 +63,16 @@ ignore = [
   "ISC001",
   "ISC002",
 ]
-fix = true
 unfixable = ["T20"]
-src = ["src", "tests"]
 
-[tool.ruff.per-file-ignores]
+[tool.ruff.lint.per-file-ignores]
 "tests/*.py" = ["S101"]
 
 [tool.mypy]
 python_version = "3.10"
 mypy_path = "$MYPY_CONFIG_FILE_DIR/src"
-enable_error_code = "ignore-without-code,redundant-self,truthy-iterable"
+# covered by ruff: unimported-reveal (F821), unused-awaitable (RUF006)
+enable_error_code = "deprecated,exhaustive-match,explicit-override,ignore-without-code,possibly-undefined,redundant-expr,redundant-self,truthy-bool,truthy-iterable"
 strict = true
 warn_unreachable = true
 exclude = "^build/"
@@ -80,8 +83,3 @@ ignore_missing_imports = true
 
 [tool.pytest.ini_options]
 asyncio_mode = "auto"
-filterwarnings = [
-  "error",
-  # https://github.com/pytest-dev/pytest/issues/10977
-  "default:(ast\\.(NameConstant|Str)|Attribute s) is deprecated:DeprecationWarning:_pytest.assertion.rewrite",
-]

{pytekukko-0.16.0 → pytekukko-0.17.0}/requirements/dev-requirements.txt

@@ -1,6 +1,5 @@
 -e .[examples]
 -r test-requirements.txt
 
-mypy==1.8.0
-nox
-ruff==0.1.14
+mypy==1.18.2
+nox[uv]

pytekukko-0.17.0/requirements/test-requirements.txt

@@ -0,0 +1,6 @@
+pytest>=6
+  pytest-asyncio>=0.25
+  pytest-recording
+  vcrpy==7.0.0
+python-dotenv>=0.10,<2
+shtab

{pytekukko-0.16.0 → pytekukko-0.17.0}/src/pytekukko/__init__.py

@@ -13,7 +13,7 @@ from aiohttp import ClientResponse, ClientResponseError, ClientSession
 from .exceptions import UnexpectedResponseStructureError
 from .models import CustomerData, InvoiceHeader, Service
 
-__version__ = "0.16.0"
+__version__ = "0.17.0"
 DEFAULT_BASE_URL = "https://tilasto.jatekukko.fi/jatekukko/"
 
 SERVICE_TIMEZONE = ZoneInfo("Europe/Helsinki")
@@ -77,7 +77,7 @@ class Pytekukko:
             params=params,
         )
 
-        return cast(list[date], _unmarshal(response_data))
+        return cast("list[date]", _unmarshal(response_data))
 
     async def get_invoice_headers(self) -> list[InvoiceHeader]:
         """Get headers of available invoices."""
@@ -114,7 +114,7 @@ class Pytekukko:
             raise_for_status=True,
         ) as response:
             # NOTE(scop): could check that we got {"response":"OK"}
-            return cast(dict[str, str], await response.json())
+            return cast("dict[str, str]", await response.json())
 
     async def logout(self) -> None:
         """Log out the current session."""

{pytekukko-0.16.0 → pytekukko-0.17.0}/src/pytekukko/examples/print_collection_schedules.py

@@ -2,6 +2,7 @@
 
 """Print collection schedules."""
 
+import argparse
 import asyncio
 import json
 import sys
@@ -13,13 +14,21 @@ import pytekukko
 from pytekukko.examples import example_argparser, example_client
 
 
-async def run_example() -> None:
-    """Run the example."""
+def argparser() -> argparse.ArgumentParser:
+    """Return an argument parser for the example.
+
+    This is a separate function to facilitate shtab generated completions.
+    """
     argparser = example_argparser(__doc__)
     argparser.add_argument(
         "-i", "--icalendar", action="store_true", help="output iCalendar"
     )
-    args = argparser.parse_args()
+    return argparser
+
+
+async def run_example() -> None:
+    """Run the example."""
+    args = argparser().parse_args()
 
     client, cookie_jar, cookie_jar_path = example_client(args)
 

{pytekukko-0.16.0 → pytekukko-0.17.0}/src/pytekukko/examples/print_invoice_headers.py

@@ -2,17 +2,24 @@
 
 """Print basic info on invoices."""
 
+import argparse
 import asyncio
 import json
 
 from pytekukko.examples import example_argparser, example_client
 
 
+def argparser() -> argparse.ArgumentParser:
+    """Return an argument parser for the example.
+
+    This is a separate function to facilitate shtab generated completions.
+    """
+    return example_argparser(__doc__)
+
+
 async def run_example() -> None:
     """Run the example."""
-    client, cookie_jar, cookie_jar_path = example_client(
-        example_argparser(__doc__).parse_args(),
-    )
+    client, cookie_jar, cookie_jar_path = example_client(argparser().parse_args())
 
     async with client.session:
         data = [

{pytekukko-0.16.0 → pytekukko-0.17.0}/src/pytekukko/examples/print_next_collections.py

@@ -2,17 +2,24 @@
 
 """Print next collection dates."""
 
+import argparse
 import asyncio
 import json
 
 from pytekukko.examples import example_argparser, example_client
 
 
+def argparser() -> argparse.ArgumentParser:
+    """Return an argument parser for the example.
+
+    This is a separate function to facilitate shtab generated completions.
+    """
+    return example_argparser(__doc__)
+
+
 async def run_example() -> None:
     """Run the example."""
-    client, cookie_jar, cookie_jar_path = example_client(
-        example_argparser(__doc__).parse_args(),
-    )
+    client, cookie_jar, cookie_jar_path = example_client(argparser().parse_args())
 
     async with client.session:
         data = [

{pytekukko-0.16.0 → pytekukko-0.17.0}/src/pytekukko/models.py

@@ -21,12 +21,12 @@ class Service:
     @property
     def name(self) -> str:
         """Get service name."""
-        return cast(str, self.raw_data["ASTNimi"])
+        return cast("str", self.raw_data["ASTNimi"])
 
     @property
     def pos(self) -> int:
         """Get "pos" value."""
-        return cast(int, self.raw_data["ASTPos"])
+        return cast("int", self.raw_data["ASTPos"])
 
     @property
     def next_collection(self) -> date | None:
@@ -50,12 +50,12 @@ class CustomerData:
     @property
     def customer_number(self) -> str:
         """Get customer number."""
-        return cast(str, self.raw_data["asiakasnro"])
+        return cast("str", self.raw_data["asiakasnro"])
 
     @property
     def name(self) -> str:
         """Get customer name."""
-        return cast(str, self.raw_data["nimi"])
+        return cast("str", self.raw_data["nimi"])
 
 
 @dataclass
@@ -71,14 +71,14 @@ class InvoiceHeader:
     @property
     def name(self) -> str:
         """Get customer number."""
-        return cast(str, self.raw_data["name"])
+        return cast("str", self.raw_data["name"])
 
     @property
     def due_date(self) -> date:
         """Get due date."""
-        return cast(date, self.raw_data["dueDate"])
+        return cast("date", self.raw_data["dueDate"])
 
     @property
     def total(self) -> float:
         """Get total amount."""
-        return cast(float, self.raw_data["total"])
+        return cast("float", self.raw_data["total"])

{pytekukko-0.16.0 → pytekukko-0.17.0/src/pytekukko.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.4
 Name: pytekukko
-Version: 0.16.0
+Version: 0.17.0
 Summary: Jätekukko Omakukko API client
 Author-email: Ville Skyttä <ville.skytta@iki.fi>
 License: 
@@ -222,16 +222,17 @@ License-File: LICENSE
 Requires-Dist: aiohttp~=3.4
 Provides-Extra: examples
 Requires-Dist: python-dotenv<2,>=0.10; extra == "examples"
-Requires-Dist: google-api-python-client>=2.0.2,~=2.0; extra == "examples"
-Requires-Dist: icalendar~=5.0; extra == "examples"
+Requires-Dist: icalendar<7,>=5; extra == "examples"
+Dynamic: license-file
 
 # pytekukko -- Jätekukko Omakukko API client
 
 [![Python versions](https://img.shields.io/pypi/pyversions/pytekukko.svg)](https://pypi.org/project/pytekukko/)
 [![PyPI version](https://badge.fury.io/py/pytekukko.svg)](https://badge.fury.io/py/pytekukko)
-[![CI status](https://github.com/scop/pytekukko/workflows/check/badge.svg)](https://github.com/scop/pytekukko/actions?query=workflow%3Acheck)
+[![CI status](https://github.com/scop/pytekukko/actions/workflows/test.yaml/badge.svg)](https://github.com/scop/pytekukko/actions/workflows/test.yaml)
+[![OpenSSF Scorecard](https://api.scorecard.dev/projects/github.com/scop/pytekukko/badge)](https://scorecard.dev/viewer/?uri=github.com%2Fscop%2Fpytekukko)
 
-Simple asyncio client for the [Jätekukko](https://www.jatekukko.fi)
+Simple Python asyncio client for the [Jätekukko](https://www.jatekukko.fi)
 [Omakukko](https://tilasto.jatekukko.fi/indexservice2.jsp) API.
 
 The API of this package is modeled closely after the Omakukko
@@ -254,6 +255,8 @@ detected. If the detection is successful, there is no need to
 separately track session expiration or use the `login` method in the
 first place.
 
+## Command line examples
+
 For usage examples, see utilities in the `pytekukko.examples`
 package. Executables and dependencies for these are installed when the
 package is installed with the `examples` extra, invoke them with
@@ -262,8 +265,28 @@ package is installed with the `examples` extra, invoke them with
 - `pytekukko-collection-schedules`: output collection schedules in JSON
 - `pytekukko-invoice-headers`: output basic info on invoices in JSON
 - `pytekukko-next-collections`: output next collection dates in JSON
-- `pytekukko-update-google-calendar`: update Google Calendar with
-  events for next collections
+
+Shell completions for the examples can be generated with
+[shtab's CLI usage mode](https://docs.iterative.ai/shtab/use/#cli-usage).
+
+<details>
+
+```shell
+shtab \
+  --prog pytekukko-collection-schedules \
+  --prefix pytekukko_collection_schedules \
+  pytekukko.examples.print_collection_schedules.argparser
+shtab \
+  --prog pytekukko-invoice-headers \
+  --prefix pytekukko_invoice_headers \
+  pytekukko.examples.print_invoice_headers.argparser
+shtab \
+  --prog pytekukko-next-collections \
+  --prefix pytekukko_next_collections \
+  pytekukko.examples.print_next_collections.argparser
+```
+
+</details>
 
 ## Disclaimer
 

{pytekukko-0.16.0 → pytekukko-0.17.0}/src/pytekukko.egg-info/SOURCES.txt

@@ -19,10 +19,9 @@ src/pytekukko/examples/__init__.py
 src/pytekukko/examples/print_collection_schedules.py
 src/pytekukko/examples/print_invoice_headers.py
 src/pytekukko/examples/print_next_collections.py
-src/pytekukko/examples/update_google_calendar.py
 tests/__init__.py
 tests/test_pytekukko.py
-tests/cassettes/test_get_collection_schedule.yaml
-tests/cassettes/test_get_invoice_headers.yaml
-tests/cassettes/test_login_logout.yaml
-tests/cassettes/test_logout.yaml
+tests/cassettes/test_pytekukko/test_get_collection_schedule.yaml
+tests/cassettes/test_pytekukko/test_get_invoice_headers.yaml
+tests/cassettes/test_pytekukko/test_login_logout.yaml
+tests/cassettes/test_pytekukko/test_logout.yaml

{pytekukko-0.16.0 → pytekukko-0.17.0}/src/pytekukko.egg-info/entry_points.txt

@@ -2,4 +2,3 @@
 pytekukko-collection-schedules = pytekukko.examples.print_collection_schedules:main [examples]
 pytekukko-invoice-headers = pytekukko.examples.print_invoice_headers:main [examples]
 pytekukko-next-collections = pytekukko.examples.print_next_collections:main [examples]
-pytekukko-update-google-calendar = pytekukko.examples.update_google_calendar:main [examples]

pytekukko-0.17.0/src/pytekukko.egg-info/requires.txt

@@ -0,0 +1,5 @@
+aiohttp~=3.4
+
+[examples]
+python-dotenv<2,>=0.10
+icalendar<7,>=5

{pytekukko-0.16.0 → pytekukko-0.17.0}/tests/test_pytekukko.py

@@ -69,7 +69,7 @@ async def fixture_client() -> Pytekukko:
     )
 
 
-@pytest.mark.vcr()
+@pytest.mark.vcr
 async def test_login_logout(client: Pytekukko) -> None:
     """Test login followed by logout."""
     async with client.session:
@@ -77,14 +77,14 @@ async def test_login_logout(client: Pytekukko) -> None:
         await client.logout()  # No exception counts as success here
 
 
-@pytest.mark.vcr()
+@pytest.mark.vcr
 async def test_logout(client: Pytekukko) -> None:
     """Test bare logout."""
     async with client.session:
         await client.logout()  # No exception counts as success here
 
 
-@pytest.mark.vcr()
+@pytest.mark.vcr
 async def test_get_collection_schedule(client: Pytekukko) -> None:
     """Test getting collection schedule."""
     async with client.session:
@@ -95,7 +95,7 @@ async def test_get_collection_schedule(client: Pytekukko) -> None:
     assert all(isinstance(date, datetime.date) for date in dates)
 
 
-@pytest.mark.vcr()
+@pytest.mark.vcr
 async def test_get_invoice_headers(client: Pytekukko) -> None:
     """Test getting invoice headers."""
     async with client.session:

pytekukko-0.16.0/requirements/test-requirements.txt

@@ -1,5 +0,0 @@
-pytest>=6
-  pytest-asyncio>=0.17
-  pytest-vcr
-  vcrpy==6.0.0
-python-dotenv>=0.10,<2

pytekukko-0.16.0/src/pytekukko/examples/update_google_calendar.py

@@ -1,211 +0,0 @@
-#!/usr/bin/env python3
-
-"""Update Google Calendar with events for next collections.
-
-To get the required service account file, enable the Google Calendar API
-in the Google Cloud console, create service account credentials with
-access to it, and create keys of type JSON.
-
-Calendar id is typically the target Google Calendar account e-mail
-address.
-"""
-
-import asyncio
-import datetime
-import logging
-import sys
-import zoneinfo
-from collections.abc import Mapping
-from typing import Any, NamedTuple, cast
-
-from google.oauth2 import service_account  # type: ignore[import-untyped]
-from googleapiclient.discovery import build  # type: ignore[import-untyped]
-
-from pytekukko.examples import arg_environ_default, example_argparser, example_client
-
-logging.basicConfig(level=logging.INFO)
-LOGGER = logging.getLogger(__name__)
-
-
-class CalendarData(NamedTuple):
-    """Helper container for calendar data to update."""
-
-    name: str
-    date: datetime.date
-    location: str
-
-
-# https://developers.google.com/resources/api-libraries/documentation/calendar/v3/python/latest/calendar_v3.events.html
-def update_google_calendar(
-    credentials: service_account.Credentials,
-    calendar_id: str,
-    data: Mapping[str, CalendarData],
-) -> None:
-    """Update the calendar."""
-    service = build(
-        "calendar",
-        "v3",
-        credentials=credentials,
-        # https://github.com/googleapis/google-api-python-client/issues/299
-        # https://github.com/googleapis/google-api-python-client/issues/325
-        cache_discovery=False,
-    )
-
-    # Events with only date set are apparently treated as occurring at midnight,
-    # start of day in calendar's timezone.
-    calendar = service.calendars().get(calendarId=calendar_id).execute()
-    if calendar.get("timeZone"):
-        timezone: datetime.tzinfo = zoneinfo.ZoneInfo(calendar["timeZone"])
-    else:
-        timezone = datetime.timezone.utc
-    since = datetime.datetime.now(timezone).replace(hour=0) - datetime.timedelta(
-        hours=1,
-    )
-
-    events = (
-        service.events()
-        .list(
-            calendarId=calendar_id,
-            orderBy="startTime",
-            singleEvents=True,
-            timeMin=since.isoformat(),
-            privateExtendedProperty="pytekukko-managed=true",
-        )
-        .execute()
-    )
-
-    pos_events: dict[str, dict[str, Any]] = {}
-    for event in events["items"]:
-        # Store first event for each pos for update, delete rest
-        pos = event["extendedProperties"]["private"].get("pytekukko-pos")
-        if pos and pos in data and not pos_events.get(pos):
-            pos_events[pos] = event
-        else:
-            service.events().delete(
-                calendarId=calendar_id,
-                eventId=event["id"],
-            ).execute()
-
-    for pos, pos_event_data in data.items():
-        date = pos_event_data.date.isoformat()
-        name = pos_event_data.name or ""
-        description = f"{name} [pos={pos}]".strip()
-        event_data = {
-            "summary": "Jätekukko collection",
-            "description": description,
-            "location": pos_event_data.location or None,
-            "start": {"date": date},
-            "end": {"date": date},
-            # Reminders are "for the authenticated user" per docs.
-            # So for the service account, not the calendar owner :(
-            # No way to set this for the "actual" calendar user from here,
-            # at least while using a service account.
-            "reminders": {"useDefault": False},
-            "transparency": "transparent",
-            "extendedProperties": {
-                "private": {"pytekukko-managed": "true", "pytekukko-pos": pos},
-            },
-            "source": {
-                "url": "https://tilasto.jatekukko.fi/indexservice2.jsp",
-                "title": "Omakukko",
-            },
-            "creator": {
-                "displayName": "Pytekukko",
-            },
-        }
-
-        event = pos_events.get(pos)
-
-        method = None
-        log_level = logging.INFO
-        if event:
-            for key, value in event_data.items():
-                if event.get(key) != value:
-                    action = "updated"
-                    method = service.events().patch(
-                        calendarId=calendar_id,
-                        eventId=event["id"],
-                        body=event_data,
-                    )
-                    break
-            else:
-                action = "unchanged"
-                log_level = logging.DEBUG
-        else:
-            action = "created"
-            method = service.events().insert(
-                calendarId=calendar_id,
-                body=event_data,
-            )
-        if method:
-            event = method.execute()
-        LOGGER.log(log_level, "Event %s: %s", action, event.get("htmlLink"))
-
-
-async def run_example() -> None:
-    """Run the example."""
-    argparser = example_argparser(__doc__)
-    argparser.add_argument(
-        "--google-calendar-id",
-        type=str,
-        **arg_environ_default("PYTEKUKKO_GOOGLE_CALENDAR_ID"),  # type: ignore[arg-type]
-    )
-    argparser.add_argument(
-        "--google-service-account-file",
-        type=str,
-        **arg_environ_default(  # type: ignore[arg-type]
-            "PYTEKUKKO_GOOGLE_SERVICE_ACCOUNT_FILE",
-            fallback="service_account.json",
-        ),
-    )
-    args = argparser.parse_args()
-
-    if not args.google_calendar_id:
-        print("Google calendar id required", file=sys.stderr)  # noqa: T201
-        sys.exit(2)
-
-    client, cookie_jar, cookie_jar_path = example_client(args)
-
-    credentials = service_account.Credentials.from_service_account_file(
-        args.google_service_account_file,
-    )
-
-    async with client.session:
-        services = await client.get_services()
-        if not cookie_jar_path:
-            await client.logout()
-
-    if cookie_jar_path:
-        cookie_jar.save(cookie_jar_path)
-
-    data = {}
-    for service in (x for x in services if x.next_collection):
-        data[str(service.pos)] = CalendarData(
-            name=service.name,
-            date=cast(datetime.date, service.next_collection),
-            location=", ".join(
-                x
-                for x in (
-                    service.raw_data.get("owner", {}).get("katu"),
-                    service.raw_data.get("owner", {}).get("posti"),
-                )
-                if x
-            ),
-        )
-
-    await asyncio.get_event_loop().run_in_executor(
-        None,
-        update_google_calendar,
-        credentials,
-        args.google_calendar_id,
-        data,
-    )
-
-
-def main() -> None:
-    """Run example in event loop."""
-    asyncio.run(run_example())
-
-
-if __name__ == "__main__":
-    main()

pytekukko-0.16.0/src/pytekukko.egg-info/requires.txt

@@ -1,6 +0,0 @@
-aiohttp~=3.4
-
-[examples]
-python-dotenv<2,>=0.10
-google-api-python-client>=2.0.2,~=2.0
-icalendar~=5.0