Merge branch 'main' into chore/format-and-style

Author: thirdgerb

.github/linters/.isort.cfg

@@ -0,0 +1,2 @@
+[settings]
+line_length=120

.github/linters/.yaml-lint.yml

@@ -0,0 +1,9 @@
+extends: default
+
+rules:
+  brackets:
+    max-spaces-inside: 1
+  comments-indentation: disable
+  document-start: disable
+  line-length: disable
+  truthy: disable

.github/workflows/check-style.yml

@@ -0,0 +1,48 @@
+name: Style Check
+
+on:
+  workflow_call:
+
+concurrency:
+  group: style-${{ github.head_ref || github.run_id }}
+  cancel-in-progress: true
+
+permissions:
+  checks: write
+  statuses: write
+  contents: read
+
+jobs:
+  python-style:
+    name: Python Style
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v6
+        with:
+          persist-credentials: false
+
+      - name: Check changed files
+        id: changed-files
+        uses: tj-actions/changed-files@v47
+        with:
+          files: |
+            *
+            .github/workflows/style.yml
+
+      - name: Setup UV and Python
+        if: steps.changed-files.outputs.any_changed == 'true'
+        uses: astral-sh/setup-uv@v7
+        with:
+          enable-cache: false
+          python-version: "3.10"
+          cache-dependency-glob: uv.lock
+
+      - name: Install dependencies
+        if: steps.changed-files.outputs.any_changed == 'true'
+        run: uv sync --dev --frozen
+
+      - name: Run Ruff Checks
+        if: steps.changed-files.outputs.any_changed == 'true'
+        run: uv run --dev ruff check

.github/workflows/main-ci.yml

@@ -0,0 +1,47 @@
+name: Main CI Pipeline
+
+on:
+  pull_request:
+    branches: ["main"]
+  push:
+    branches: ["main"]
+
+permissions:
+  contents: write
+  pull-requests: write
+  checks: write
+  statuses: write
+
+concurrency:
+  group: main-ci-${{ github.head_ref || github.run_id }}
+  cancel-in-progress: true
+
+jobs:
+  check-changes:
+    runs-on: ubuntu-latest
+    outputs:
+      code_changes: ${{ steps.changes.outputs.code_changes }}
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+        with:
+          persist-credentials: false
+          fetch-depth: 0
+      - name: Check for file changes
+        uses: dorny/paths-filter@v3
+        id: changes
+        with:
+          base: ${{ github.base_ref || github.ref_name }}
+          filters: |
+            code_changes:
+              - '*'
+              - '**/*'
+  # run-tests:
+  #   name: Run Tests
+  #   needs: check-changes
+  #   if: needs.check-changes.outputs.code_changes == 'true'
+  #   uses: ./.github/workflows/run-tests.yml
+
+  check-style:
+    name: Style Check
+    uses: ./.github/workflows/check-style.yml

.github/workflows/run-tests.yml

@@ -0,0 +1,50 @@
+name: Run Tests
+
+on:
+  workflow_call:
+
+concurrency:
+  group: api-tests-${{ github.head_ref || github.run_id }}
+  cancel-in-progress: true
+
+jobs:
+  pytest:
+    name: Run All python tests
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        shell: bash
+    strategy:
+      matrix:
+        python-version:
+          - "3.10"
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v6
+        with:
+          persist-credentials: false
+
+      - name: Install system dependencies
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y cmake portaudio19-dev python3-pyaudio libgl1-mesa-dev libglu1-mesa-dev
+
+      - name: Setup UV and Python
+        uses: astral-sh/setup-uv@v7
+        with:
+          enable-cache: true
+          python-version: ${{ matrix.python-version }}
+          cache-dependency-glob: uv.lock
+
+      - name: Check UV lockfile
+        run: uv lock --check
+
+      - name: Install dependencies
+        run: uv sync --dev --all-extras --frozen
+
+      - name: Run Tests
+        env:
+          DEBUG: true
+        run: |
+          uv run --dev pytest

examples/moss_agent.py

@@ -72,12 +72,10 @@ def run_moss_agent(container: Container):
                     description="你的视觉通道, 通过这个通道你可以使用摄像头看见",
                     address="tcp://localhost:5557",
                 ),
-                # todo: 暂时未实装, 预计实装它.
-                # "no_ppt": ZMQProxyConfig(
-                #     script="no_ppt_channel.py",
-                #     description="",
-                #     address="tcp://localhost:5558",
-                # )
+                "slide": ZMQProxyConfig(
+                    script="slide_app.py",
+                    description="可以打开你的slide studio gui，通过这个通道你可以呈现并讲述一个slide主题",
+                ),
             },
         ),
         logger=logger,

examples/moss_zmq_channels/.gitignore

@@ -0,0 +1 @@
+*.sock

examples/moss_zmq_channels/slide_app.py

@@ -0,0 +1,29 @@
+import sys
+from os.path import join, dirname
+
+from PyQt6.QtWidgets import QApplication
+from ghoshell_common.contracts import Workspace
+
+from ghoshell_moss.transports.zmq_channel import ZMQChannelProvider
+from ghoshell_moss_contrib.channels.slide_studio import SlideStudio, SlideAssets
+from ghoshell_moss_contrib.example_ws import workspace_container
+
+current_dir = dirname(__file__)
+workspace_dir = join(dirname(current_dir), ".workspace")
+
+
+if __name__ == "__main__":
+    with workspace_container(workspace_dir) as _container:
+        _app = QApplication(sys.argv)
+        ws = _container.force_fetch(Workspace)
+        studio_storage = ws.assets().sub_storage("slide_studio")
+        studio = SlideStudio(SlideAssets(studio_storage), _container)
+        provider = ZMQChannelProvider(
+            address=f"ipc://{__file__}.sock",
+            container=_container,
+        )
+        # Pyqt6 will block main process, so provider must run in thread.
+        provider.run_in_thread(studio.as_channel())
+        # Default show player viewer window.(will not be default soon)
+        studio.player.viewer.show()
+        sys.exit(_app.exec())

examples/scripts/__init__.py

@@ -0,0 +1,20 @@
+import sys
+
+from PyQt6.QtWidgets import QApplication
+
+from ghoshell_moss_contrib.gui.slide_studio_creator import PPTXConverterWindow
+from ghoshell_moss_contrib.example_ws import workspace_container
+from ghoshell_common.contracts import Workspace
+
+
+if __name__ == "__main__":
+    import pathlib
+    CURRENT_DIR = pathlib.Path(__file__).parent
+    WORKSPACE_DIR = CURRENT_DIR.parent.joinpath(".workspace").absolute()
+    with workspace_container(WORKSPACE_DIR) as _container:
+        ws = _container.force_fetch(Workspace)
+        storage = ws.assets().sub_storage("slide_studio")
+        app = QApplication(sys.argv)
+        window = PPTXConverterWindow(storage)
+        window.show()
+        sys.exit(app.exec())