ray-doris 1.0__tar.gz

ray_doris-1.0/.dockerignore

@@ -0,0 +1,10 @@
+**
+!pyproject.toml
+!README.md
+!LICENSE
+!NOTICE
+!src/
+!src/**
+!tests/
+!tests/slow_integration/
+!tests/slow_integration/**

ray_doris-1.0/.github/workflows/ci.yml

@@ -0,0 +1,163 @@
+name: CI
+
+on:
+  workflow_call:
+    inputs:
+      candidate_sha:
+        description: Immutable release candidate commit to test
+        required: false
+        type: string
+  pull_request:
+  push:
+    branches: [master]
+  schedule:
+    - cron: "17 3 * * 1"
+
+concurrency:
+  group: ci-${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  unit:
+    name: Python ${{ matrix.python }} / Ray ${{ matrix.ray }}
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - python: "3.9"
+            ray: "2.49.2"
+          - python: "3.10"
+            ray: "2.55.1"
+          - python: "3.12"
+            ray: "2.56.1"
+    steps:
+      - uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262 # v4.4.0
+        with:
+          persist-credentials: false
+          ref: ${{ inputs.candidate_sha || github.sha }}
+      - uses: astral-sh/setup-uv@d0cc045d04ccac9d8b7881df0226f9e82c39688e # v6.8.0
+        with:
+          python-version: ${{ matrix.python }}
+      - run: uv venv --python ${{ matrix.python }}
+      - run: uv pip install -e ".[test]" "ray[data]==${{ matrix.ray }}"
+      - run: .venv/bin/python -m pytest tests/unit tests/contract --cov=ray_doris --cov-report=term-missing
+
+  quality:
+    name: Static quality
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    steps:
+      - uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262 # v4.4.0
+        with:
+          persist-credentials: false
+          ref: ${{ inputs.candidate_sha || github.sha }}
+      - uses: astral-sh/setup-uv@d0cc045d04ccac9d8b7881df0226f9e82c39688e # v6.8.0
+        with:
+          python-version: "3.12"
+      - run: uv venv --python 3.12
+      - run: uv pip install -e ".[dev,flight]" "ray[data]==2.56.1"
+      - run: .venv/bin/ruff format --check .
+      - run: .venv/bin/ruff check .
+      - run: .venv/bin/mypy
+      - run: .venv/bin/pre-commit run --all-files
+      - run: >-
+          .venv/bin/python tools/check_workflow_pins.py
+          .github/workflows/ci.yml
+          .github/workflows/release.yml
+          .github/workflows/slow-integration.yml
+      - run: >-
+          .venv/bin/python tools/check_release_workflow.py
+          .github/workflows/ci.yml .github/workflows/release.yml
+
+  docs:
+    name: Documentation
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+    steps:
+      - uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262 # v4.4.0
+        with:
+          persist-credentials: false
+          ref: ${{ inputs.candidate_sha || github.sha }}
+      - uses: astral-sh/setup-uv@d0cc045d04ccac9d8b7881df0226f9e82c39688e # v6.8.0
+        with:
+          python-version: "3.12"
+      - name: Install spelling system dependency
+        run: |
+          sudo apt-get update
+          sudo apt-get install --yes enchant-2
+      - name: Install documentation environment
+        run: |
+          uv venv .docs-venv --python 3.12
+          uv pip install \
+            --python .docs-venv/bin/python \
+            --requirement doc/requirements-doc.lock.txt
+          uv pip install \
+            --python .docs-venv/bin/python \
+            --no-build-isolation \
+            --no-deps \
+            --editable .
+      - name: Check documentation contracts
+        run: .docs-venv/bin/python tools/check_docs.py
+      - name: Build strict documentation
+        run: make -C doc strict SPHINXBUILD=../.docs-venv/bin/sphinx-build
+      - name: Check documentation spelling
+        run: make -C doc spelling SPHINXBUILD=../.docs-venv/bin/sphinx-build
+      - uses: lycheeverse/lychee-action@e7477775783ea5526144ba13e8db5eec57747ce8 # v2.4.1
+        with:
+          args: >-
+            --no-progress
+            --max-retries 3
+            README.md CONTRIBUTING.md SECURITY.md CHANGELOG.md doc/source
+
+  integration:
+    name: Doris 4.0.6 integration
+    runs-on: ubuntu-latest
+    timeout-minutes: 25
+    steps:
+      - uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262 # v4.4.0
+        with:
+          persist-credentials: false
+          ref: ${{ inputs.candidate_sha || github.sha }}
+      - uses: astral-sh/setup-uv@d0cc045d04ccac9d8b7881df0226f9e82c39688e # v6.8.0
+        with:
+          python-version: "3.12"
+      - run: uv venv --python 3.12
+      - run: uv pip install -e ".[test,flight]" "ray[data]==2.56.1"
+      - run: docker compose -f tests/integration/docker-compose.yml up -d --build
+      - run: .venv/bin/python -m pytest tests/integration -v
+      - name: Capture Doris logs
+        if: always()
+        run: docker compose -f tests/integration/docker-compose.yml logs --no-color > doris-it.log
+      - uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02 # v4.6.2
+        if: always()
+        with:
+          name: doris-it-log
+          path: doris-it.log
+      - name: Stop Doris
+        if: always()
+        run: docker compose -f tests/integration/docker-compose.yml down -v --rmi local
+
+  package:
+    name: Package
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+    steps:
+      - uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262 # v4.4.0
+        with:
+          persist-credentials: false
+          ref: ${{ inputs.candidate_sha || github.sha }}
+      - uses: astral-sh/setup-uv@d0cc045d04ccac9d8b7881df0226f9e82c39688e # v6.8.0
+        with:
+          python-version: "3.12"
+      - run: uv venv --python 3.12
+      - run: uv pip install build twine
+      - run: .venv/bin/python -m build
+      - run: .venv/bin/twine check dist/*
+      - run: uv venv --python 3.12 .venv-package
+      - run: uv pip install --python .venv-package/bin/python dist/*.whl
+      - run: .venv-package/bin/python -c "import ray_doris; print(ray_doris.__version__)"
+      - run: uv venv --python 3.12 .venv-sdist
+      - run: uv pip install --python .venv-sdist/bin/python dist/*.tar.gz
+      - run: .venv-sdist/bin/python -c "import ray_doris; print(ray_doris.__version__)"

ray_doris-1.0/.github/workflows/release.yml

@@ -0,0 +1,333 @@
+name: Release
+
+on:
+  push:
+    tags: ["v*"]
+  workflow_dispatch:
+    inputs:
+      candidate_sha:
+        description: Full master-reachable commit SHA to validate without publishing
+        required: true
+        type: string
+      expected_version:
+        description: Exact package version expected at the candidate commit
+        required: true
+        type: string
+
+permissions:
+  contents: read
+  actions: read
+
+concurrency:
+  group: release-${{ github.event_name == 'push' && github.ref || inputs.candidate_sha }}
+  cancel-in-progress: false
+
+jobs:
+  candidate:
+    name: Validate release candidate
+    runs-on: ubuntu-latest
+    outputs:
+      mode: ${{ steps.candidate.outputs.mode }}
+      sha: ${{ steps.candidate.outputs.sha }}
+      version: ${{ steps.candidate.outputs.version }}
+      tag: ${{ steps.candidate.outputs.tag }}
+      master_sha: ${{ steps.candidate.outputs.master_sha }}
+    steps:
+      - uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262 # v4.4.0
+        with:
+          fetch-depth: 0
+          persist-credentials: false
+          ref: master
+      - uses: actions/setup-python@a26af69be951a213d495a4c3e4e4022e16d87065 # v5.6.0
+        with:
+          python-version: "3.12"
+      - name: Fetch protected master and tag identities
+        run: >-
+          git fetch --force origin
+          +refs/heads/master:refs/remotes/origin/master
+          +refs/tags/*:refs/tags/*
+      - name: Resolve immutable candidate
+        id: candidate
+        env:
+          CANDIDATE_REF: ${{ github.event_name == 'workflow_dispatch' && inputs.candidate_sha || github.ref }}
+          EXPECTED_VERSION: ${{ github.event_name == 'workflow_dispatch' && inputs.expected_version || '' }}
+          MODE: ${{ github.event_name == 'workflow_dispatch' && 'dry-run' || 'tag' }}
+          RELEASE_TAG: ${{ github.event_name == 'push' && github.ref_name || '' }}
+          EVENT_SHA: ${{ github.event_name == 'push' && github.event.after || '' }}
+          EVENT_CREATED: ${{ github.event_name == 'push' && github.event.created || false }}
+          EVENT_DELETED: ${{ github.event_name == 'push' && github.event.deleted || false }}
+          EVENT_FORCED: ${{ github.event_name == 'push' && github.event.forced || false }}
+        run: >-
+          python tools/check_release.py
+          --mode "${MODE}"
+          --candidate-ref "${CANDIDATE_REF}"
+          --expected-version "${EXPECTED_VERSION}"
+          --tag "${RELEASE_TAG}"
+          --master-ref origin/master
+          --event-sha "${EVENT_SHA}"
+          --event-created "${EVENT_CREATED}"
+          --event-deleted "${EVENT_DELETED}"
+          --event-forced "${EVENT_FORCED}"
+          --github-output "${GITHUB_OUTPUT}"
+
+  verify:
+    name: Candidate CI gates
+    needs: candidate
+    uses: ./.github/workflows/ci.yml
+    with:
+      candidate_sha: ${{ needs.candidate.outputs.sha }}
+
+  build:
+    name: Build and verify distributions
+    needs: [candidate, verify]
+    runs-on: ubuntu-latest
+    outputs:
+      distributions_artifact_id: ${{ steps.upload.outputs.artifact-id }}
+    steps:
+      - uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262 # v4.4.0
+        with:
+          persist-credentials: false
+          ref: ${{ needs.candidate.outputs.sha }}
+      - uses: astral-sh/setup-uv@d0cc045d04ccac9d8b7881df0226f9e82c39688e # v6.8.0
+        with:
+          enable-cache: true
+          python-version: "3.12"
+      - run: uv venv --python 3.12
+      - run: uv pip install --python .venv/bin/python "build==1.3.0" "twine==6.2.0"
+      - run: .venv/bin/python -m build --outdir release-artifacts/packages
+      - run: .venv/bin/twine check release-artifacts/packages/*
+      - run: >-
+          .venv/bin/python tools/verify_release_artifacts.py release-artifacts/packages
+          --name ray-doris
+          --version "${{ needs.candidate.outputs.version }}"
+          --manifest release-artifacts/SHA256SUMS
+          --prepare
+      - name: Upload immutable distributions
+        id: upload
+        uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02 # v4.6.2
+        with:
+          name: distributions
+          path: release-artifacts/
+          if-no-files-found: error
+
+  install-smoke:
+    name: Install ${{ matrix.distribution }} ${{ matrix.profile }}
+    needs: [candidate, verify, build]
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - profile: base
+            extra: ""
+            distribution: wheel
+          - profile: flight
+            extra: "[flight]"
+            distribution: wheel
+          - profile: base
+            extra: ""
+            distribution: sdist
+          - profile: flight
+            extra: "[flight]"
+            distribution: sdist
+    steps:
+      - uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262 # v4.4.0
+        with:
+          persist-credentials: false
+          ref: ${{ needs.candidate.outputs.sha }}
+      - uses: actions/setup-python@a26af69be951a213d495a4c3e4e4022e16d87065 # v5.6.0
+        with:
+          python-version: "3.12"
+      - uses: actions/download-artifact@d3f86a106a0bac45b974a628896c90dbdf5c8093 # v4.3.0
+        with:
+          artifact-ids: ${{ needs.build.outputs.distributions_artifact_id }}
+          path: release/
+          merge-multiple: true
+      - run: >-
+          python tools/verify_release_artifacts.py release/packages
+          --name ray-doris
+          --version "${{ needs.candidate.outputs.version }}"
+          --manifest release/SHA256SUMS
+      - name: Install built distribution
+        env:
+          EXTRA: ${{ matrix.extra }}
+          DISTRIBUTION: ${{ matrix.distribution }}
+        run: |
+          if [ "$DISTRIBUTION" = "wheel" ]; then
+            package="$(find release/packages -maxdepth 1 -type f -name '*.whl')"
+          else
+            package="$(find release/packages -maxdepth 1 -type f -name '*.tar.gz')"
+          fi
+          test -n "$package"
+          python -m pip install "ray-doris${EXTRA} @ file://${GITHUB_WORKSPACE}/${package}"
+      - run: python -c "import ray_doris; print(ray_doris.__version__)"
+
+  testpypi-publish:
+    name: Publish formal artifact to TestPyPI
+    if: >-
+      always() &&
+      github.event_name == 'push' &&
+      startsWith(github.ref, 'refs/tags/v') &&
+      needs.candidate.result == 'success' &&
+      needs.verify.result == 'success' &&
+      needs.build.result == 'success' &&
+      needs.install-smoke.result == 'success' &&
+      needs.candidate.outputs.mode == 'tag'
+    needs: [candidate, verify, build, install-smoke]
+    runs-on: ubuntu-latest
+    environment: testpypi
+    permissions:
+      contents: read
+      id-token: write
+    steps:
+      - uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262 # v4.4.0
+        with:
+          persist-credentials: false
+          ref: ${{ needs.candidate.outputs.sha }}
+      - uses: actions/setup-python@a26af69be951a213d495a4c3e4e4022e16d87065 # v5.6.0
+        with:
+          python-version: "3.12"
+      - uses: actions/download-artifact@d3f86a106a0bac45b974a628896c90dbdf5c8093 # v4.3.0
+        with:
+          artifact-ids: ${{ needs.build.outputs.distributions_artifact_id }}
+          path: release/
+          merge-multiple: true
+      - run: >-
+          python tools/verify_release_tag.py
+          --tag "${{ needs.candidate.outputs.tag }}"
+          --expected-sha "${{ needs.candidate.outputs.sha }}"
+      - run: >-
+          python tools/verify_release_artifacts.py release/packages
+          --name ray-doris
+          --version "${{ needs.candidate.outputs.version }}"
+          --manifest release/SHA256SUMS
+      - uses: pypa/gh-action-pypi-publish@dc37677b2e1c63e2034f94d8a5b11f265b73ba33 # v1.14.2
+        with:
+          packages-dir: release/packages/
+          repository-url: https://test.pypi.org/legacy/
+
+  testpypi-smoke:
+    name: TestPyPI smoke (${{ matrix.profile }})
+    if: >-
+      always() &&
+      github.event_name == 'push' &&
+      startsWith(github.ref, 'refs/tags/v') &&
+      needs.candidate.result == 'success' &&
+      needs.testpypi-publish.result == 'success' &&
+      needs.candidate.outputs.mode == 'tag'
+    needs: [candidate, testpypi-publish]
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - profile: base
+            extra: ""
+          - profile: flight
+            extra: "[flight]"
+    steps:
+      - uses: actions/setup-python@a26af69be951a213d495a4c3e4e4022e16d87065 # v5.6.0
+        with:
+          python-version: "3.12"
+      - name: Install from TestPyPI with PyPI dependency fallback
+        env:
+          EXTRA: ${{ matrix.extra }}
+          VERSION: ${{ needs.candidate.outputs.version }}
+        run: >-
+          python -m pip install
+          --index-url https://test.pypi.org/simple/
+          --extra-index-url https://pypi.org/simple/
+          "ray-doris${EXTRA}==${VERSION}"
+      - run: python -c "import ray_doris; print(ray_doris.__version__)"
+
+  publish:
+    name: Publish to PyPI
+    if: >-
+      always() &&
+      github.event_name == 'push' &&
+      startsWith(github.ref, 'refs/tags/v') &&
+      needs.candidate.result == 'success' &&
+      needs.verify.result == 'success' &&
+      needs.build.result == 'success' &&
+      needs.install-smoke.result == 'success' &&
+      needs.testpypi-publish.result == 'success' &&
+      needs.testpypi-smoke.result == 'success' &&
+      needs.candidate.outputs.mode == 'tag'
+    needs: [candidate, verify, build, install-smoke, testpypi-publish, testpypi-smoke]
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      contents: read
+      id-token: write
+    steps:
+      - uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262 # v4.4.0
+        with:
+          persist-credentials: false
+          ref: ${{ needs.candidate.outputs.sha }}
+      - uses: actions/setup-python@a26af69be951a213d495a4c3e4e4022e16d87065 # v5.6.0
+        with:
+          python-version: "3.12"
+      - uses: actions/download-artifact@d3f86a106a0bac45b974a628896c90dbdf5c8093 # v4.3.0
+        with:
+          artifact-ids: ${{ needs.build.outputs.distributions_artifact_id }}
+          path: release/
+          merge-multiple: true
+      - run: >-
+          python tools/verify_release_tag.py
+          --tag "${{ needs.candidate.outputs.tag }}"
+          --expected-sha "${{ needs.candidate.outputs.sha }}"
+      - run: >-
+          python tools/verify_release_artifacts.py release/packages
+          --name ray-doris
+          --version "${{ needs.candidate.outputs.version }}"
+          --manifest release/SHA256SUMS
+      - uses: pypa/gh-action-pypi-publish@dc37677b2e1c63e2034f94d8a5b11f265b73ba33 # v1.14.2
+        with:
+          packages-dir: release/packages/
+
+  github-release:
+    name: Create GitHub Release
+    if: >-
+      always() &&
+      github.event_name == 'push' &&
+      startsWith(github.ref, 'refs/tags/v') &&
+      needs.candidate.result == 'success' &&
+      needs.verify.result == 'success' &&
+      needs.build.result == 'success' &&
+      needs.install-smoke.result == 'success' &&
+      needs.testpypi-publish.result == 'success' &&
+      needs.testpypi-smoke.result == 'success' &&
+      needs.publish.result == 'success' &&
+      needs.candidate.outputs.mode == 'tag'
+    needs: [candidate, verify, build, install-smoke, testpypi-publish, testpypi-smoke, publish]
+    runs-on: ubuntu-latest
+    environment: github-release
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262 # v4.4.0
+        with:
+          persist-credentials: false
+          ref: ${{ needs.candidate.outputs.sha }}
+      - uses: actions/download-artifact@d3f86a106a0bac45b974a628896c90dbdf5c8093 # v4.3.0
+        with:
+          artifact-ids: ${{ needs.build.outputs.distributions_artifact_id }}
+          path: release/
+          merge-multiple: true
+      - run: >-
+          python tools/verify_release_tag.py
+          --tag "${{ needs.candidate.outputs.tag }}"
+          --expected-sha "${{ needs.candidate.outputs.sha }}"
+      - run: >-
+          python tools/verify_release_artifacts.py release/packages
+          --name ray-doris
+          --version "${{ needs.candidate.outputs.version }}"
+          --manifest release/SHA256SUMS
+      - name: Publish immutable release assets
+        env:
+          GH_TOKEN: ${{ github.token }}
+        run: >-
+          gh release create "${{ needs.candidate.outputs.tag }}"
+          release/packages/* release/SHA256SUMS
+          --title "ray-doris ${{ needs.candidate.outputs.version }}"
+          --notes-file "release-notes/v${{ needs.candidate.outputs.version }}.md"

ray_doris-1.0/.github/workflows/slow-integration.yml

@@ -0,0 +1,90 @@
+name: Slow distributed integration
+
+on:
+  workflow_call:
+    inputs:
+      profile:
+        description: Slow integration profile
+        required: false
+        default: full
+        type: string
+      row_count:
+        description: Rows loaded into each slow integration table
+        required: false
+        default: "10000"
+        type: string
+      stress_seconds:
+        description: Minimum duration of repeated Flight SQL reads
+        required: false
+        default: "5"
+        type: string
+      be_memory_limit:
+        description: Memory limit for each Doris BE container
+        required: false
+        default: 2g
+        type: string
+  workflow_dispatch:
+    inputs:
+      profile:
+        description: Slow integration profile
+        required: true
+        default: full
+        type: choice
+        options: [full, core]
+      row_count:
+        description: Rows loaded into each slow integration table
+        required: true
+        default: "10000"
+        type: string
+      stress_seconds:
+        description: Minimum duration of repeated Flight SQL reads
+        required: true
+        default: "5"
+        type: string
+      be_memory_limit:
+        description: Memory limit for each Doris BE container
+        required: true
+        default: "2g"
+        type: string
+  schedule:
+    - cron: "17 3 * * 0"
+
+permissions:
+  contents: read
+
+concurrency:
+  group: slow-integration-${{ github.ref }}
+  cancel-in-progress: false
+
+jobs:
+  distributed:
+    name: Ray and Doris distributed slow integration
+    runs-on: [self-hosted, linux, x64, ray-doris-slow-it]
+    timeout-minutes: 30
+    env:
+      RAY_DORIS_SLOW_PROFILE: ${{ inputs.profile || 'full' }}
+      RAY_DORIS_ROW_COUNT: ${{ inputs.row_count || '10000' }}
+      RAY_DORIS_STRESS_SECONDS: ${{ inputs.stress_seconds || '5' }}
+      RAY_DORIS_BE_MEMORY_LIMIT: ${{ inputs.be_memory_limit || '2g' }}
+    steps:
+      - uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262 # v4.4.0
+      - name: Run distributed cluster scenario
+        env:
+          RAY_DORIS_SLOW_LOG_DIR: ${{ runner.temp }}/ray-doris-slow-it
+        run: tests/slow_integration/run.sh
+      - uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02 # v4.6.2
+        if: always()
+        with:
+          name: ray-doris-slow-it-logs
+          path: ${{ runner.temp }}/ray-doris-slow-it/*.log
+          if-no-files-found: warn
+          overwrite: true
+          retention-days: 30
+      - uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02 # v4.6.2
+        if: ${{ success() && env.RAY_DORIS_SLOW_PROFILE == 'full' }}
+        with:
+          name: ray-doris-slow-result-${{ github.sha }}
+          path: ${{ runner.temp }}/ray-doris-slow-it/slow-result.json
+          if-no-files-found: error
+          overwrite: true
+          retention-days: 90

ray_doris-1.0/.gitignore

@@ -0,0 +1,15 @@
+.DS_Store
+.coverage
+.mypy_cache/
+.pytest_cache/
+.ruff_cache/
+.docs-venv/
+.venv*/
+uv.lock
+__pycache__/
+build/
+doc/_build/
+dist/
+htmlcov/
+*.egg-info/
+*.py[cod]

ray_doris-1.0/.pre-commit-config.yaml

@@ -0,0 +1,14 @@
+repos:
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.12.8
+    hooks:
+      - id: ruff-check
+        args: [--fix]
+      - id: ruff-format
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v5.0.0
+    hooks:
+      - id: check-toml
+      - id: check-yaml
+      - id: end-of-file-fixer
+      - id: trailing-whitespace

ray_doris-1.0/.readthedocs.yaml

@@ -0,0 +1,23 @@
+version: 2
+
+build:
+  os: ubuntu-24.04
+  tools:
+    python: "3.12"
+  apt_packages:
+    - enchant-2
+  jobs:
+    install:
+      - pip install --requirement doc/requirements-doc.lock.txt
+      - pip install --no-build-isolation --no-deps --editable .
+    build:
+      html:
+        # This custom command replaces the default RTD Sphinx build. The
+        # Makefile enforces warnings-as-errors with -W and --keep-going.
+        - >-
+          make -C doc html
+          SPHINXBUILD=sphinx-build
+          HTMLDIR="$READTHEDOCS_OUTPUT/html"
+
+sphinx:
+  configuration: doc/source/conf.py

ray_doris-1.0/CHANGELOG.md

@@ -0,0 +1,28 @@
+# Changelog
+
+All notable changes to this project are documented in this file.
+
+## Unreleased
+
+- Bound Ray support to tested 2.49.2 through 2.56.x DeveloperAPI signatures.
+- Balance tablet splits, avoid draining active MySQL results on early consumer termination, and
+  align MySQL and Flight result-schema checks.
+- Reject non-serializable worker options on the driver and redact filters and server details from
+  representations, logs, and public errors.
+- Mark Python 3.9 as Alpha legacy compatibility and Flight SQL and automatic transport selection as
+  experimental.
+- Validate release ancestry against the `master` default branch.
+- Add environment-referenced credentials that resolve independently on the driver and workers
+  without serializing the resolved value.
+- Add a private-CA option and independent timeout for query-plan HTTPS, plus fixed redacted MySQL
+  TLS setup errors.
+- Move distributed worker-retry and backend-failure evidence to the minimum-privilege MySQL path.
+- Bind releases to a successful full slow-suite manifest from the exact release commit and workflow
+  run while keeping FE cluster HA as a deployment responsibility.
+
+## 0.1.0a1
+
+- Add tablet-aware Apache Doris reads through Ray Data's documented V1 Datasource extension API.
+- Add bounded MySQL streaming and optional Arrow Flight SQL transport.
+- Add explicit schema conversion, deterministic planning, and controlled fallback behavior.
+- Add Ray compatibility, real Doris integration, package, and release verification workflows.