crowdio-sdk 0.3.0__tar.gz

crowdio_sdk-0.3.0/LICENSE

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

crowdio_sdk-0.3.0/PKG-INFO

@@ -0,0 +1,73 @@
+Metadata-Version: 2.4
+Name: crowdio-sdk
+Version: 0.3.0
+Summary: CROWDio SDK for distributed Python task execution
+Author: CROWDio Team
+License-Expression: MIT
+Project-URL: Homepage, https://crowdio-21.github.io/Docs/docs/
+Project-URL: Repository, https://github.com/Crowdio-21
+Project-URL: Issues, https://github.com/your-org/CROWDio/issues
+Keywords: distributed-computing,sdk,websocket,checkpointing,mobile-crowd-computing,python,volunteer-computing,edge-computing,task-scheduling,resource-management,data-processing,machine-learning,ai,iot,mobile-devices,cloud-computing,serverless-computing,parallel-computing,high-performance-computing
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: websockets>=12.0
+Provides-Extra: image
+Requires-Dist: Pillow>=10.0.0; extra == "image"
+Dynamic: license-file
+
+# CROWDio SDK
+
+CROWDio SDK provides client-side tools for submitting distributed Python workloads to a CROWDio foreman.
+
+## Included Packages
+
+- `developer_sdk`: public client APIs, decorators, and image utility helpers.
+- `common`: shared protocol and serialization utilities used by the SDK runtime.
+
+## Install
+
+```bash
+pip install crowdio-sdk
+```
+
+Install optional image processing dependencies:
+
+```bash
+pip install "crowdio-sdk[image]"
+```
+
+## Quick Start
+
+```python
+import asyncio
+from developer_sdk import crowdio_connect, crowdio_map, crowdio_disconnect
+
+
+def square(x):
+    return x * x
+
+
+async def main():
+    await crowdio_connect("localhost", 9000)
+    results = await crowdio_map(square, [1, 2, 3, 4])
+    print(results)
+    await crowdio_disconnect()
+
+
+asyncio.run(main())
+```
+
+## Notes
+
+- The package requires a reachable CROWDio foreman endpoint.
+- Image utilities under `developer_sdk.image_utils` require Pillow (install with `[image]` extra).

crowdio_sdk-0.3.0/README.md

@@ -0,0 +1,46 @@
+# CROWDio SDK
+
+CROWDio SDK provides client-side tools for submitting distributed Python workloads to a CROWDio foreman.
+
+## Included Packages
+
+- `developer_sdk`: public client APIs, decorators, and image utility helpers.
+- `common`: shared protocol and serialization utilities used by the SDK runtime.
+
+## Install
+
+```bash
+pip install crowdio-sdk
+```
+
+Install optional image processing dependencies:
+
+```bash
+pip install "crowdio-sdk[image]"
+```
+
+## Quick Start
+
+```python
+import asyncio
+from developer_sdk import crowdio_connect, crowdio_map, crowdio_disconnect
+
+
+def square(x):
+    return x * x
+
+
+async def main():
+    await crowdio_connect("localhost", 9000)
+    results = await crowdio_map(square, [1, 2, 3, 4])
+    print(results)
+    await crowdio_disconnect()
+
+
+asyncio.run(main())
+```
+
+## Notes
+
+- The package requires a reachable CROWDio foreman endpoint.
+- Image utilities under `developer_sdk.image_utils` require Pillow (install with `[image]` extra).

crowdio_sdk-0.3.0/common/__init__.py

@@ -0,0 +1,68 @@
+"""
+Common utilities for CrowdCompute
+
+Exports:
+- Protocol messages and types
+- Serialization utilities
+- Worker type detection and code instrumentation for mobile
+"""
+
+# Protocol exports
+from .protocol import (
+    Message,
+    MessageType,
+    CheckpointType,
+    RecoveryStatus,
+    create_worker_ready_message,
+    create_submit_job_message,
+    create_assign_task_message,
+    create_assign_task_message_with_metadata,
+    create_resume_task_message,
+    create_resume_task_message_with_metadata,
+    create_task_result_message,
+)
+
+# Code instrumentation exports for mobile workers
+from .code_instrumenter import (
+    WorkerType,
+    detect_worker_capabilities,
+    instrument_for_mobile,
+    prepare_code_for_mobile_resume,
+    generate_mobile_checkpoint_wrapper,
+    CheckpointInstrumenter,
+    ResumeInstrumenter,
+)
+
+# Serialization exports
+from .serializer import (
+    serialize_function,
+    deserialize_function_for_PC,
+    get_runtime_info,
+)
+
+__all__ = [
+    # Protocol
+    "Message",
+    "MessageType",
+    "CheckpointType",
+    "RecoveryStatus",
+    "create_worker_ready_message",
+    "create_submit_job_message",
+    "create_assign_task_message",
+    "create_assign_task_message_with_metadata",
+    "create_resume_task_message",
+    "create_resume_task_message_with_metadata",
+    "create_task_result_message",
+    # Code instrumentation
+    "WorkerType",
+    "detect_worker_capabilities",
+    "instrument_for_mobile",
+    "prepare_code_for_mobile_resume",
+    "generate_mobile_checkpoint_wrapper",
+    "CheckpointInstrumenter",
+    "ResumeInstrumenter",
+    # Serialization
+    "serialize_function",
+    "deserialize_function_for_PC",
+    "get_runtime_info",
+]