Add bidirectional Apache Ossie <-> Cube converter

.github/workflows/converter-cube-ci.yml

@@ -0,0 +1,65 @@
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
+
+name: Converters Cube CI
+
+on:
+  push:
+    branches: [ "main" ]
+    paths:
+      - 'converters/cube/**'
+      - '.github/workflows/converter-cube-ci.yml'
+  pull_request:
+    branches: [ "main" ]
+    paths:
+      - 'converters/cube/**'
+      - '.github/workflows/converter-cube-ci.yml'
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.11", "3.12", "3.13", "3.14"]
+
+    steps:
+      - name: Checkout project
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97 # v7.0.0
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install uv
+        run: |
+          curl -LsSf https://astral.sh/uv/install.sh | sh
+          echo "${HOME}/.local/bin" >> "${GITHUB_PATH}"
+
+      - name: Sync dependencies
+        working-directory: converters/cube
+        run: |
+          uv sync
+
+      - name: Unit Tests
+        working-directory: converters/cube
+        # The Cube-compiles-it gate needs a built Cube checkout (OSSIE_CUBE_REPO) and
+        # skips without one, so CI runs everything else. See converters/cube/README.md.
+        run: |
+          uv run pytest

converters/README.md

@@ -76,6 +76,7 @@ The Ossie specification currently defines extensions for the following vendors:
 | `OMNI` | Omni semantic model |
 | `WISDOM` | WisdomAI domain |
 | `NVIDIA_GSF` | NVIDIA Generative Semantic Fabric standalone YAML |
+| `CUBE` | Cube data model |
 
 Each vendor may define custom extensions (via the `custom_extensions` field in the Ossie spec) to carry vendor-specific metadata that does not have an equivalent in the core specification.
 

converters/cube/pyproject.toml

@@ -0,0 +1,74 @@
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "apache-ossie-cube"
+version = "0.2.0.dev0"
+description = "Bidirectional converter between Apache Ossie semantic models and Cube data models"
+authors = [{ name = "Apache Software Foundation", email = "dev@ossie.apache.org" }]
+requires-python = ">=3.11"
+readme = "README.md"
+license = "Apache-2.0"
+keywords = [
+    "Apache Ossie",
+    "Ossie",
+    "Cube",
+]
+classifiers = [
+    "License :: OSI Approved :: Apache Software License",
+    "Programming Language :: Python :: 3",
+]
+dependencies = [
+    "PyYAML>=6.0",
+    # Expression handling: locating the aggregate calls inside a composite metric so
+    # each can become its own Cube measure. Already a runtime dependency of the dbt
+    # and NVIDIA GSF converters, which use it for the same purpose.
+    "sqlglot>=20.0",
+]
+
+[dependency-groups]
+dev = [
+    "pytest>=8.0",
+    "hypothesis>=6.0",
+    # So the core-spec schema validation in test_roundtrip.py runs rather than
+    # skipping; the converter itself needs neither.
+    "jsonschema>=4.0",
+]
+
+[project.scripts]
+ossie-cube = "ossie_cube.cli:main"
+
+[project.urls]
+homepage = "https://ossie.apache.org/"
+repository = "https://github.com/apache/ossie/"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/ossie_cube"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+pythonpath = ["src"]
+
+[tool.uv]
+required-version = ">=0.9.0"
+default-groups = [
+    "dev",
+]

converters/cube/src/ossie_cube/__init__.py

@@ -0,0 +1,40 @@
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+"""Bidirectional converter between Apache Ossie semantic models and Cube data
+models. Pure offline transforms: Ossie YAML string <-> {relative filename: YAML
+string}.
+
+    from ossie_cube import convert_cube_to_ossie, convert_ossie_to_cube
+
+    ossie_yaml, issues = convert_cube_to_ossie(files)
+    files, issues = convert_ossie_to_cube(ossie_yaml)
+"""
+
+from ._common import ConversionError
+from .converter_issues import ConverterIssue, IssueLog, IssueType
+from .cube_to_osi import convert_cube_to_ossie
+from .osi_to_cube import convert_ossie_to_cube
+
+__all__ = [
+    "ConversionError",
+    "ConverterIssue",
+    "IssueLog",
+    "IssueType",
+    "convert_cube_to_ossie",
+    "convert_ossie_to_cube",
+]