overture-serverless 0.0.0__py3-none-any.whl

overture_serverless/job.py

@@ -0,0 +1,42 @@
+"""Lightweight base class for a portable "serverless job" contract.
+
+Subclass and implement ``execute_job()``; a runner (container, script, cron
+job, whatever) instantiates the subclass and calls ``run()``.
+
+Plain Python by design — no cloud SDKs, no framework dependencies. The same
+subclass runs identically on any backend or on a developer laptop for local
+iteration.
+"""
+
+import json
+from abc import ABC, abstractmethod
+
+
+class ServerlessPythonJob(ABC):
+    def __init__(self) -> None:
+        self._params: dict = {}
+
+    def run(self, params: "str | dict" = "{}") -> None:
+        print(f"Starting job {self.__class__.__name__}")
+        self._params = json.loads(params) if isinstance(params, str) else params
+        if not isinstance(self._params, dict):
+            raise TypeError(
+                f"params must decode to a JSON object/dict, got {type(self._params).__name__}"
+            )
+        print(f"Received params: {sorted(self._params.keys())}")
+        self.execute_job()
+        print(f"Job {self.__class__.__name__} completed successfully")
+
+    def get_param(self, name: str, default=None, is_required: bool = True):
+        value = self._params.get(name, default)
+        if isinstance(value, str):
+            value = value.strip() or None
+        if is_required and value is None:
+            raise ValueError(f"Missing required parameter: {name}")
+        return default if value is None else value
+
+    def log(self, msg: str) -> None:
+        print(msg)
+
+    @abstractmethod
+    def execute_job(self) -> None: ...

overture_serverless-0.0.0.dist-info/METADATA

@@ -0,0 +1,65 @@
+Metadata-Version: 2.4
+Name: overture-serverless
+Version: 0.0.0
+Summary: Base classes for portable, framework-agnostic serverless Python jobs.
+Author: Overture Maps Foundation
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/OvertureMaps/overture-core
+Project-URL: Source, https://github.com/OvertureMaps/overture-core/tree/main/packages/overture_serverless
+Project-URL: Issues, https://github.com/OvertureMaps/overture-core/issues
+Keywords: overture,overturemaps,serverless,jobs
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: dev
+Requires-Dist: pytest>=9.1.1; extra == "dev"
+Requires-Dist: pytest-cov>=7.0.0; extra == "dev"
+Dynamic: license-file
+
+# overture-serverless
+
+[![PyPI](https://img.shields.io/pypi/v/overture-serverless.svg)](https://pypi.org/project/overture-serverless/)
+[![Python versions](https://img.shields.io/pypi/pyversions/overture-serverless.svg)](https://pypi.org/project/overture-serverless/)
+
+Base class for portable, framework-agnostic "job" classes. A published package that gets installed at run time wherever a job actually executes, and provides the contract your job subclasses.
+
+It contains:
+- `ServerlessPythonJob` — abstract base class your jobs subclass (`execute_job()`), with parameter parsing (`get_param()`) and logging (`log()`). Plain Python, no cloud dependencies — runs identically on any backend or on your laptop.
+
+## Writing a job
+
+```python
+from overture_serverless.job import ServerlessPythonJob
+
+
+class CollectionJob(ServerlessPythonJob):
+    def execute_job(self) -> None:
+        path = self.get_param("input_path")
+        self.log(f"Processing {path}")
+        # ... your logic
+```
+
+## Testing locally
+
+```bash
+cd packages/overture_serverless
+uv run python -c "
+from overture_serverless.job import ServerlessPythonJob
+
+class ExampleJob(ServerlessPythonJob):
+    def execute_job(self) -> None:
+        self.log(self.get_param('input_path'))
+
+ExampleJob().run('{\"input_path\": \"s3://...\"}')
+"
+```
+
+## Publishing
+
+See [`PACKAGE_VERSIONING.md`](../PACKAGE_VERSIONING.md) for how a version bump here turns into a PyPI release.

overture_serverless-0.0.0.dist-info/RECORD

@@ -0,0 +1,7 @@
+overture_serverless/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+overture_serverless/job.py,sha256=TzgJ-soiMNIHGGcHH7JbXBggwU6wljOE2C7khN4ThEg,1547
+overture_serverless-0.0.0.dist-info/licenses/LICENSE,sha256=24ta8OgpjROjE-HE1FWF9T3w46CiGzvcFzxjuEOFIUI,1070
+overture_serverless-0.0.0.dist-info/METADATA,sha256=sFi_Pj8G6E3p8Z4411cfgNChQBAJR0yJccDrpa30H4U,2435
+overture_serverless-0.0.0.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+overture_serverless-0.0.0.dist-info/top_level.txt,sha256=UlY7jr7QD9r-mrw3G3cvlkb2OVmiFwWC-i6_p91Rbpo,20
+overture_serverless-0.0.0.dist-info/RECORD,,

overture_serverless-0.0.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

overture_serverless-0.0.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Overture Maps
+
+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.

overture_serverless-0.0.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+overture_serverless