orca-lab 25.9.0__tar.gz

orca_lab-25.9.0/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/MANIFEST.in

@@ -0,0 +1,38 @@
+# Include package data files
+include README.md
+include LICENSE
+include pyproject.toml
+
+# Include proto files
+recursive-include orcalab/protos *.proto
+
+# Include asset files
+recursive-include orcalab/assets *.qrc
+recursive-include orcalab/assets *.svg
+recursive-include orcalab/assets *.png
+recursive-include orcalab/assets *.jpg
+recursive-include orcalab/assets *.jpeg
+
+# Include configuration files
+recursive-include orcalab *.toml
+recursive-include orcalab *.yaml
+recursive-include orcalab *.yml
+
+# Include type hints
+recursive-include orcalab *.pyi
+
+# Exclude test files
+recursive-exclude test *
+recursive-exclude tests *
+recursive-exclude examples *
+recursive-exclude doc *
+recursive-exclude docs *
+
+# Exclude build artifacts
+exclude Makefile
+recursive-exclude scripts *
+recursive-exclude .git *
+recursive-exclude __pycache__ *
+recursive-exclude *.pyc
+recursive-exclude *.pyo
+recursive-exclude *.egg-info *

orca_lab-25.9.0/PKG-INFO

@@ -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/README.md

@@ -0,0 +1,141 @@
+# 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/orca_lab.egg-info/SOURCES.txt

@@ -0,0 +1,71 @@
+LICENSE
+MANIFEST.in
+README.md
+pyproject.toml
+orcalab/__init__.py
+orcalab/actor.py
+orcalab/application_bus.py
+orcalab/asset_service.py
+orcalab/asset_service_bus.py
+orcalab/asset_sync_service.py
+orcalab/asset_sync_ui.py
+orcalab/auth_service.py
+orcalab/config_service.py
+orcalab/event_bus.py
+orcalab/local_scene.py
+orcalab/math.py
+orcalab/path.py
+orcalab/project_util.py
+orcalab/pyside_util.py
+orcalab/remote_scene.py
+orcalab/scene_edit_bus.py
+orcalab/scene_edit_service.py
+orcalab/sim_process.py
+orcalab/token_storage.py
+orcalab/assets/assets.qrc
+orcalab/assets/gen.py
+orcalab/assets/rc_assets.py
+orcalab/assets/icons/ic_fluent_add_20_filled.svg
+orcalab/assets/icons/ic_fluent_eye_20_regular.svg
+orcalab/assets/icons/ic_fluent_eye_off_20_regular.svg
+orcalab/assets/icons/ic_fluent_filter_20_filled.svg
+orcalab/assets/icons/ic_fluent_lock_closed_20_regular.svg
+orcalab/assets/icons/ic_fluent_lock_open_20_regular.svg
+orcalab/assets/icons/ic_fluent_pause_20_filled.svg
+orcalab/assets/icons/ic_fluent_play_20_filled_green.svg
+orcalab/assets/icons/ic_fluent_stop_20_filled_red.svg
+orcalab/copilot/__init__.py
+orcalab/copilot/service.py
+orcalab/protos/__init__.py
+orcalab/protos/edit_service.proto
+orcalab/protos/edit_service_pb2.py
+orcalab/protos/edit_service_pb2_grpc.py
+orcalab/protos/generate_proto.py
+orcalab/protos/url_service.proto
+orcalab/protos/url_service_pb2.py
+orcalab/protos/url_service_pb2_grpc.py
+orcalab/ui/__init__.py
+orcalab/ui/actor_editor.py
+orcalab/ui/actor_outline.py
+orcalab/ui/actor_outline_model.py
+orcalab/ui/asset_browser.py
+orcalab/ui/auth_window.py
+orcalab/ui/copilot.py
+orcalab/ui/float_edit.py
+orcalab/ui/launch_dialog.py
+orcalab/ui/main_window.py
+orcalab/ui/rename_dialog.py
+orcalab/ui/sync_progress_window.py
+orcalab/ui/terminal_widget.py
+orcalab/ui/tool_bar.py
+orcalab/ui/transform_edit.py
+orcalab/ui/viewport.py
+orcalab/undo_service/command.py
+orcalab/undo_service/undo_service.py
+orcalab/undo_service/undo_service_bus.py
+orcalab/url_service/__init__.py
+orcalab/url_service/url_handler.py
+orcalab/url_service/url_service.py
+orcalab/url_service/url_util.py
+orcalab/url_service/url_util_linux.py
+orcalab/url_service/url_util_windows.py

orca_lab-25.9.0/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

orca_lab-25.9.0/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)

orca_lab-25.9.0/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)

orca_lab-25.9.0/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)