orca-lab 25.9.0__py3-none-any.whl

orca_lab-25.9.0.dist-info/METADATA

@@ -0,0 +1,181 @@
+Metadata-Version: 2.4
+Name: orca-lab
+Version: 25.9.0
+Summary: OrcaLab - Cloud-native robotics simulation platform with advanced UI and asset management
+Author-email: 松应科技 <huangwei@orca3d.cn>
+License: MIT
+Project-URL: Homepage, https://github.com/openverse-orca/OrcaLab
+Project-URL: Documentation, https://github.com/openverse-orca/OrcaLab
+Project-URL: Repository, https://github.com/openverse-orca/OrcaLab
+Project-URL: Bug Tracker, https://github.com/openverse-orca/OrcaLab/issues
+Keywords: robotics,simulation,ui,asset-management,orca,pyside
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Software Development :: User Interfaces
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: orca-gym
+Requires-Dist: numpy>=2.0.0
+Requires-Dist: scipy
+Requires-Dist: scipy-stubs
+Requires-Dist: grpcio==1.66.1
+Requires-Dist: grpcio-tools==1.66.1
+Requires-Dist: pyside6==6.9.2
+Requires-Dist: aiohttp
+Requires-Dist: aiofiles
+Requires-Dist: qasync
+Requires-Dist: psutil
+Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: pytest-cov; extra == "dev"
+Requires-Dist: flake8; extra == "dev"
+Requires-Dist: black; extra == "dev"
+Requires-Dist: mypy; extra == "dev"
+Dynamic: license-file
+
+# OrcaLab
+
+OrcaLab is a front-end of OrcaGym. It provides a user-interface for scene assembling and simulation.
+
+## Features
+
+- TODO
+
+## Requirements
+
+- Python 3.12 or higher
+- [OrcaGym](https://github.com/your-org/OrcaGym) (required dependency)
+- Other dependencies listed in `pyproject.toml`
+
+## Development Requirements
+
+For building and releasing packages, the following pip packages are required:
+
+### Core Build Tools
+```bash
+pip install build twine wheel setuptools
+```
+
+### Development Tools (Optional)
+```bash
+pip install pytest pytest-cov flake8 black mypy
+```
+
+### Make Commands and Required Packages
+
+The project includes a `Makefile` with various commands. Here are the required packages for each command:
+
+| Make Command | Required pip packages | Description |
+|-------------|----------------------|-------------|
+| `make build` | `build`, `setuptools`, `wheel` | Build distribution packages |
+| `make check` | `twine` | Check package quality |
+| `make test-install` | `build`, `setuptools`, `wheel` | Test local installation |
+| `make test-install-testpypi` | `build`, `setuptools`, `wheel` | Test TestPyPI installation |
+| `make test-install-pypi` | `build`, `setuptools`, `wheel` | Test PyPI installation |
+| `make release-test` | `build`, `twine`, `setuptools`, `wheel` | Release to TestPyPI |
+| `make release-prod` | `build`, `twine`, `setuptools`, `wheel` | Release to PyPI |
+| `make bump-version` | None (uses sed) | Bump version number |
+| `make setup-pypirc` | None | Setup PyPI configuration file |
+| `make check-pypirc` | None | Check PyPI configuration |
+| `make clean` | None | Clean build artifacts |
+| `make test` | `pytest`, `pytest-cov` | Run tests |
+| `make format` | `black` | Format code |
+| `make lint` | `flake8`, `mypy` | Lint code |
+
+### Quick Setup for Development
+```bash
+# Install development dependencies
+pip install build twine wheel setuptools pytest pytest-cov flake8 black mypy
+
+# Or install from the project's optional dependencies
+pip install -e ".[dev]"
+```
+
+## Release Process
+
+### Quick Release
+```bash
+# Setup PyPI configuration (first time only)
+make setup-pypirc
+
+# Release to TestPyPI
+./scripts/release/release.sh test
+
+# Release to PyPI
+./scripts/release/release.sh prod
+```
+
+### Step-by-step Release
+```bash
+# Clean, build, check, and upload
+./scripts/release/clean.sh
+./scripts/release/build.sh
+./scripts/release/check.sh
+./scripts/release/upload_test.sh  # or upload_prod.sh
+```
+
+## Installation
+
+1. Install OrcaGym (required):
+	```bash
+	# Please follow the OrcaGym installation instructions
+	```
+2. Clone this repository and install OrcaLab in editable mode:
+	```bash
+	# required by pyside
+	sudo apt install libxcb-cursor0
+
+	git clone https://github.com/openverse-orca/OrcaLab.git
+	cd OrcaLab
+	pip install -e .
+	```
+
+
+## Usage
+
+To start OrcaLab, run:
+
+```bash
+python run.py
+```
+
+
+## Notice
+
+- Blocking function (like QDialog.exec()) should not be called in async function directly. It will stop the async loop in a strange way. There are two ways to work around:
+	- wrap in `qasync.asyncWrap`
+	- invoke by a qt signal.
+
+``` python
+# wrap in `qasync.asyncWrap`
+
+async def foo():
+	def bloc_task():
+		return dialog.exec()
+
+	await asyncWrap(bloc_task)	
+
+# invoke by a qt signal
+
+def bloc_task():
+	return dialog.exec()
+
+some_signal.connect(bloc_task)
+
+```
+
+## 常见问题
+
+### Linux上出现 version `GLIBCXX_3.4.30' not found
+    conda update -c conda-forge libstdcxx-ng
+
+
+
+## License
+
+This project is licensed under the terms of the [LICENSE](LICENSE) file.

orca_lab-25.9.0.dist-info/RECORD

@@ -0,0 +1,72 @@
+orca_lab-25.9.0.dist-info/licenses/LICENSE,sha256=IAibJRQUWEGQheOOblT8gFgk22tipq6IcpFXADQGCP4,1095
+orcalab/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+orcalab/actor.py,sha256=dUUyiVgweVtN1gXYi4ZuE2p-sOP3gluGOKAzkMXexxk,4347
+orcalab/application_bus.py,sha256=Rm3xTI2u2bY4gMiDgj80DEZdQY1cv8YbfdOrw4t_4z4,349
+orcalab/asset_service.py,sha256=njGQxHot9sj14AZlTQ9xjFGTM6Rq3_mBfM7OUeseffU,1653
+orcalab/asset_service_bus.py,sha256=-dJuTuFg9eFfxkdtTxmEGiheC83d4BMLLFZjon_WYXk,488
+orcalab/asset_sync_service.py,sha256=abmGbXi0KsLm2pwNECDZZxzfAD0vNwKYSYXo9P5pPb8,14141
+orcalab/asset_sync_ui.py,sha256=-MF5v81oDnM31tbIf4IEX5K7fUqB9r_eMRs_zSlkk9g,7149
+orcalab/auth_service.py,sha256=MD-x6wmaaw-2ZM_lIAFXu12BSALPcQqBjYe3XDs06sg,8002
+orcalab/config_service.py,sha256=JZC7OJTti6gEkof-mjiK8Eaqfi5-Qv8jEAj4WEHVcwM,5570
+orcalab/event_bus.py,sha256=-5JAY3Pt6Rsnw4hNN4TYhilXKE6e0YDj2LzvGmnxXWc,3453
+orcalab/local_scene.py,sha256=SU6YkTmc7G97qL2Yu61wri-lEy0GJUZ5Lk8ICRLQ59w,7425
+orcalab/math.py,sha256=MUcHwXaK8yQvsgtJuUkFbUuoycpq_Js5uM-5zwYw9sk,10607
+orcalab/path.py,sha256=NLA0CxS5uVVQOdtXrBJSfxufPYzDexjBbJ_y_O-tCII,2499
+orcalab/project_util.py,sha256=_LjYWIctTjx9K_cmku68_XOqLK8bC2SE4PkrMYpFygs,4946
+orcalab/pyside_util.py,sha256=O1WVAmKZWaeuOXeZerJIHLXqW1afBt3F-Q_AWPNBwpg,872
+orcalab/remote_scene.py,sha256=2cVgwSdeQbbzLt688tjzuPIdUvOJudje0maiR5ID350,25418
+orcalab/scene_edit_bus.py,sha256=DK6tN7spaQdDPcYcwQcHKVRSKncJDHb4fSt8kEQ72JA,5183
+orcalab/scene_edit_service.py,sha256=nOrRNqTs7UMplFarjU2IwQ-ER3biFCj-McjKL4pUzTs,7544
+orcalab/sim_process.py,sha256=m3HsJEnHlqGMED0twe88LFkeqWCcKZc81JFx8Mf-Wq0,533
+orcalab/token_storage.py,sha256=LAIyGXf2wfzMsSotaad-EAUykzH2k0xcnXM3W089RoA,2868
+orcalab/assets/assets.qrc,sha256=W1ZSv-Id2d3bayr-hUlpWdP5_mMIwG_DjfBXu5KY544,591
+orcalab/assets/gen.py,sha256=zb2GxCzIXDdEGNLfBOKM9wucdo9HNhYGm0eDryfAqNg,234
+orcalab/assets/rc_assets.py,sha256=Dr33d4V3UJBtzNri7lLowoItczRgpEN3YkqknYDUhyM,6120
+orcalab/assets/icons/ic_fluent_add_20_filled.svg,sha256=2XD9hGlOYjONyj85jLLvdasl7CIJ-hGUXBWObgKnJ6c,454
+orcalab/assets/icons/ic_fluent_eye_20_regular.svg,sha256=P-2yEb29XUfJ0eKoIP5z_9AGfr9VXtj-Q1AzoJ0NLR0,730
+orcalab/assets/icons/ic_fluent_eye_off_20_regular.svg,sha256=gZsYAz7O3B-d7IMLqBGSXOUnaTjH11SkmJzdYx8G2H0,1183
+orcalab/assets/icons/ic_fluent_filter_20_filled.svg,sha256=fEbpnY-joccvO70waqMWe8UOmuSPP5fFWbKJJLvukps,570
+orcalab/assets/icons/ic_fluent_lock_closed_20_regular.svg,sha256=YrCk_Eym-U9C13EAGzgb3AujYCgQU5AWGWJSXrGbOiI,606
+orcalab/assets/icons/ic_fluent_lock_open_20_regular.svg,sha256=NmQP-udujk7-5DghXAuwmI-tyO6Yu_1HSS8LdI9uH8g,660
+orcalab/assets/icons/ic_fluent_pause_20_filled.svg,sha256=JIScWws61Angezb23XZWGeJbmuGJ76RpR3yU5KOpu6I,370
+orcalab/assets/icons/ic_fluent_play_20_filled_green.svg,sha256=w26YqTsHV7mGn-6Z9MDtWBTMnfxkMGnrTv0d3jngXXw,313
+orcalab/assets/icons/ic_fluent_stop_20_filled_red.svg,sha256=wMppuX_umpq1NkWetuQqAQ5vTW9yjz2k4Fw-Rh2yLw0,268
+orcalab/copilot/__init__.py,sha256=D7Vm5tkfex3RDoVtF9Hb8zUOdkjkBMkSKf7KCtG8bG8,255
+orcalab/copilot/service.py,sha256=2tJhqQ-4eeEkYcXuqxC3UTgwP1kD6z8zRiPC1VB4voU,17710
+orcalab/protos/__init__.py,sha256=BEWEkM6Hq2h2h_cY8T50uG5cQuAZkT2491c3BCTGneM,83
+orcalab/protos/edit_service.proto,sha256=RXHwR8NAIEtkAadlMSL0hd4Ht0w6UfaMy2WBChexsYI,6660
+orcalab/protos/edit_service_pb2.py,sha256=Kna69jEUytZNmxaD5ExdENo9qvUz6U77YIrDtmP6Ljg,15791
+orcalab/protos/edit_service_pb2_grpc.py,sha256=_4dHzhO7WIH2N6y-O42arCBG8PJPFoedAyNm95PF3pM,42988
+orcalab/protos/generate_proto.py,sha256=B439HHYO7jkidKmBZDET8SwfA8EGapsMlpSOsVHlASs,759
+orcalab/protos/url_service.proto,sha256=XIGYjW64xjfq-n4tHr7Nu5hbYi4cUs5ASaxF4s4lMks,328
+orcalab/protos/url_service_pb2.py,sha256=jGexEzzw1wKcKholMO3OLuI3fssJRqV8yOqPcMQXDRs,1916
+orcalab/protos/url_service_pb2_grpc.py,sha256=lUQNDNqRiEygAjvNBz4ce6gau0Nt3EjfwlqDDo3d0CA,3473
+orcalab/ui/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+orcalab/ui/actor_editor.py,sha256=UsNhScxjGFhOwwGU7i-0Fw2yWIvGA1Q2xx5TNP9FBQo,5969
+orcalab/ui/actor_outline.py,sha256=Jl62T3een6WJGEmjIkZOVQFo8yy32sGyiRZ-EcB8yBU,10859
+orcalab/ui/actor_outline_model.py,sha256=9iJVIXZuWlMO0xFdJ9CTqe0kX1SfuMxtO-dVkwA_Hbc,11815
+orcalab/ui/asset_browser.py,sha256=jE7Wnsc3dcBbCmhQteD1lGDgJkBLgIPhB3v1gOEsspI,8414
+orcalab/ui/auth_window.py,sha256=CXJp0Q7nDvTytTPNKmxJlIJ6xi9TastLVidS1KZ1LOU,5959
+orcalab/ui/copilot.py,sha256=8D_p76dm2LO5nLbBbc6BM-4uuzhnNzsv9fILbLe_fVY,25211
+orcalab/ui/float_edit.py,sha256=3VU1afvcAQ3bzJh_BxKQR5EVMLGHUZ1AZbSd6OOPm08,4859
+orcalab/ui/launch_dialog.py,sha256=9PGw2Yz9c5rv0sDcbYergT_F3ZC0Ga7F7RvKvW8F_aM,10164
+orcalab/ui/main_window.py,sha256=0th-nAy8jsJgeQtrTCp4VtLMq37M6aKyIQclVEtfP5A,33791
+orcalab/ui/rename_dialog.py,sha256=Sctwo4KKp3xP5bkwNVkuf4mjmUpPRmUKJFIO2XL4E4U,2348
+orcalab/ui/sync_progress_window.py,sha256=dvmkLB_S1IA3lqqXr3DNbTvZkYQzzGXwhE_6wNFM48o,13985
+orcalab/ui/terminal_widget.py,sha256=MtT_0gQQuInrsuyZY-Grs1Qa0u5WaYk24kfYgn_zdfA,10499
+orcalab/ui/tool_bar.py,sha256=bM_fXUPC5BDJ3sekCiN_zzWANWwaP68bWbCy_6r1wA4,1323
+orcalab/ui/transform_edit.py,sha256=lNiynsMXPCtJfVMrKNZbCgjBReQ3CLz-BRXQE2YGgwc,3610
+orcalab/ui/viewport.py,sha256=W_rztkzoSka_4eVJFEPINoQjMfH6tCKw-7wx2y7NvNw,1952
+orcalab/undo_service/command.py,sha256=RcfIaJE97s-e8C9ZnsZi9eGKyo2A1N-C4yLPaQ1d1q8,2323
+orcalab/undo_service/undo_service.py,sha256=EeGnyGort_YputzwCAXsYflDUEUpuvdjPEPYR9fqoWE,6443
+orcalab/undo_service/undo_service_bus.py,sha256=OS60-dGac3X4PIv-AlPjrzzZTxZIyzbvDxv-VCVTWaY,836
+orcalab/url_service/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+orcalab/url_service/url_handler.py,sha256=vTOHVl35PVQy4rj-rOVXVTXoDvh9k5qCJRLKwqdPAyg,1319
+orcalab/url_service/url_service.py,sha256=qas4qvz6LYlrLTMDGXNo77r52n9X2pfwglTUlGjt-Qc,1705
+orcalab/url_service/url_util.py,sha256=jXlFGPlzPAHfgAcEGC9BbifulB7TyajOYg1CNbhqpNw,1587
+orcalab/url_service/url_util_linux.py,sha256=x5-STEZZPE9IlRNkz6T9g-o3KGItHB9li2H9_YE61GU,1664
+orcalab/url_service/url_util_windows.py,sha256=FsG3hHlbIdbS7vlFaiwmkDOQLBhbKlkUe6k6kKliQU4,2137
+orca_lab-25.9.0.dist-info/METADATA,sha256=4-wIZ5pke5kL264ZG-myvl4V93VbjoXj7KScf4P43Co,5050
+orca_lab-25.9.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+orca_lab-25.9.0.dist-info/top_level.txt,sha256=drzov7E-eqRe5ydwax4hioudYNpxUzqkyHFPuF_3fZs,8
+orca_lab-25.9.0.dist-info/RECORD,,

orca_lab-25.9.0.dist-info/WHEEL

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

orca_lab-25.9.0.dist-info/licenses/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2025 Shanghai Songying Technology Co.,Ltd.
+
+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.
+

orca_lab-25.9.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+orcalab

orcalab/actor.py

@@ -0,0 +1,146 @@
+from typing import List, override
+
+from orcalab.path import Path
+from orcalab.math import Transform
+
+import copy
+
+type ParentActor = GroupActor | None
+
+
+class BaseActor:
+    def __init__(self, name: str, parent: ParentActor):
+        self._name = ""
+        self._parent = None
+        self._transform = Transform()
+        self._world_transform = None
+        self.name = name
+        self.parent = parent
+
+    def __repr__(self):
+        return f"BaseActor(name={self._name})"
+
+    @property
+    def name(self):
+        return self._name
+
+    @name.setter
+    def name(self, value):
+        if not isinstance(value, str) or not Path.is_valid_name(value):
+            raise ValueError(f"Invalid name: {value}")
+        self._name = value
+
+    @property
+    def parent(self) -> ParentActor:
+        return self._parent
+
+    @parent.setter
+    def parent(self, parent_actor):
+        if parent_actor is not None and not isinstance(parent_actor, GroupActor):
+            raise TypeError("parent must be an instance of GroupActor or None.")
+
+        if parent_actor == self._parent:
+            return
+
+        if self._parent is not None:
+            self._parent._children.remove(self)
+
+        if parent_actor is not None:
+            parent_actor._children.append(self)
+
+        self._parent = parent_actor
+        self._world_transform = None  # Invalidate world transform cache
+
+    @property
+    def transform(self):
+        return copy.deepcopy(self._transform)
+
+    @transform.setter
+    def transform(self, value):
+        if not isinstance(value, Transform):
+            raise TypeError("transform must be an instance of Transform.")
+        self._transform = copy.deepcopy(value)
+
+        self._world_transform = None  # Invalidate world transform cache
+
+    @property
+    def world_transform(self) -> Transform:
+        if self._world_transform is not None:
+            return self._world_transform
+
+        if self.parent is None:
+            self._world_transform = self.transform
+        else:
+            self._world_transform = self.parent.world_transform * self.transform
+
+        return self._world_transform
+
+    @world_transform.setter
+    def world_transform(self, value: Transform):
+        if not isinstance(value, Transform):
+            raise TypeError("world_transform must be an instance of Transform.")
+
+        if self.parent is None:
+            self.transform = value
+        else:
+            self.transform = self.parent.world_transform.inverse() * value
+
+        self._world_transform = value
+
+
+class GroupActor(BaseActor):
+    def __init__(self, name: str, parent: ParentActor = None):
+        self._children: List[BaseActor] = []
+        super().__init__(name, parent)
+
+    def __repr__(self):
+        return f"GroupActor(name={self.name}, children_count={len(self._children)})"
+
+    @property
+    def children(self):
+        return self._children.copy()
+
+    def insert_child(self, index: int, child: BaseActor):
+        if not isinstance(child, BaseActor):
+            raise TypeError("Child must be an instance of GroupActor or AssetActor.")
+
+        if child in self._children:
+            raise ValueError(f"{child.name} is already a child of {self.name}")
+
+        if child.parent is not None:
+            child.parent.remove_child(child)
+
+        if index < 0 or index > len(self._children):
+            self._children.append(child)
+        else:
+            self._children.insert(index, child)
+
+        child._parent = self
+
+    def add_child(self, child: BaseActor):
+        self.insert_child(-1, child)
+
+    def remove_child(self, child: BaseActor):
+        if child in self._children:
+            self._children.remove(child)
+            child._parent = None
+        # Don't raise error if child is not in the list - this can happen during cleanup
+
+
+class AssetActor(BaseActor):
+    def __init__(self, name: str, asset_path: str, parent: GroupActor = None):
+        super().__init__(name, parent)
+        self._asset_path = asset_path
+
+    def __repr__(self):
+        return f"AssetActor(name={self.name})"
+
+    @property
+    def asset_path(self):
+        return self._asset_path
+
+    @asset_path.setter
+    def asset_path(self, value):
+        if not isinstance(value, str) or len(value) == 0:
+            raise ValueError("asset_path name must be non-empty string")
+        self._asset_path = value

orcalab/application_bus.py

@@ -0,0 +1,17 @@
+from orcalab.event_bus import create_event_bus
+from typing import List
+
+class ApplicationRequest:
+
+    def get_cache_folder(self, output: List[str]) -> None:
+        pass
+
+
+ApplicationRequestBus = create_event_bus(ApplicationRequest)
+
+
+class ApplicationNotification:
+    pass
+
+
+ApplicationNotificationBus = create_event_bus(ApplicationNotification)

orcalab/asset_service.py

@@ -0,0 +1,50 @@
+from datetime import datetime
+from orcalab.asset_service_bus import AssetServiceRequest, AssetServiceRequestBus, AssetServiceNotificationBus
+from orcalab.application_bus import ApplicationRequestBus
+
+import aiohttp
+import aiofiles
+
+from typing import override
+
+
+class AssetService(AssetServiceRequest):
+
+    def __init__(self):
+        super().__init__()
+        AssetServiceRequestBus.connect(self)
+
+    def destroy(self):
+        AssetServiceRequestBus.disconnect(self)
+
+    @override
+    async def download_asset_to_file(self, url: str, file: str) -> None:
+        async with aiofiles.open(file, "wb") as f:
+            async with aiohttp.ClientSession() as session:
+                async with session.get(url) as response:
+                    if response.status != 200:
+                        raise Exception(
+                            f"Failed to download asset. Status code: {response.status}"
+                        )
+                    data = await response.read()
+                    await f.write(data)
+
+    @override
+    async def download_asset_to_cache(self, url: str) -> None:
+        cache_folder = []
+        ApplicationRequestBus().get_cache_folder(cache_folder)
+
+        if len(cache_folder) == 0:
+            raise Exception("Cache folder is not set.")
+
+        cache_folder: str = cache_folder[0]
+
+        # name file with time and date.
+        timestamp = datetime.now().strftime("%Y%m%d_%H%M%S")
+        filename = f"asset_{timestamp}.pak"
+
+        file_path = cache_folder + "/" + filename
+
+        await self.download_asset_to_file(url, file_path)
+
+        await AssetServiceNotificationBus().on_asset_downloaded(file_path)

orcalab/asset_service_bus.py

@@ -0,0 +1,22 @@
+from orcalab.event_bus import create_event_bus
+
+
+class AssetServiceRequest:
+
+    async def download_asset_to_file(self, url: str, file: str) -> None:
+        pass
+
+    async def download_asset_to_cache(self, url: str) -> None:
+        pass
+
+
+AssetServiceRequestBus = create_event_bus(AssetServiceRequest)
+
+
+class AssetServiceNotification:
+
+    async def on_asset_downloaded(self, file: str) -> None:
+        pass
+
+
+AssetServiceNotificationBus = create_event_bus(AssetServiceNotification)