Skip to content

feat: provide send-wrapper to contidionally implement Send for operators #6173

feat: provide send-wrapper to contidionally implement Send for operators

feat: provide send-wrapper to contidionally implement Send for operators #6173

Workflow file for this run

# 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: Docs
on:
push:
branches:
- main
pull_request:
branches:
- main
paths:
- "core/**"
- "bindings/**"
- "integrations/**"
- ".github/workflows/docs.yml"
concurrency:
group: ${{ github.workflow }}-${{ github.ref }}-${{ github.event_name }}
cancel-in-progress: true
jobs:
build-rust-doc:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- name: Setup Rust toolchain
uses: ./.github/actions/setup
with:
need-rocksdb: true
need-protoc: true
github-token: ${{ secrets.GITHUB_TOKEN }}
# Revert to nightly after https://github.com/apache/opendal/issues/4161 addressed
- name: Setup Rust Nightly
run: |
rustup toolchain install nightly-2024-01-01
- uses: actions/setup-java@v4
with:
distribution: temurin
java-version: '17'
- name: Build OpenDAL doc
working-directory: core
run: cargo +nightly-2024-01-01 doc --lib --no-deps --all-features
env:
LD_LIBRARY_PATH: ${{ env.JAVA_HOME }}/lib/server:${{ env.LD_LIBRARY_PATH }}
# Enable cfg docs to make sure docs are built.
RUSTDOCFLAGS: "--cfg docs"
- name: Upload docs
uses: actions/upload-artifact@v3
with:
name: rust-docs
path: ./core/target/doc
build-java-doc:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- uses: actions/setup-java@v4
with:
distribution: temurin
java-version: '17'
- name: Build and test
working-directory: bindings/java
run: mvn javadoc:javadoc
- name: Upload docs
uses: actions/upload-artifact@v3
with:
name: java-docs
path: ./bindings/java/target/site/apidocs
build-nodejs-doc:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- uses: pnpm/action-setup@v3
with:
version: 8
- uses: actions/setup-node@v4
with:
node-version: '18'
cache: pnpm
cache-dependency-path: "bindings/nodejs/pnpm-lock.yaml"
- name: Corepack
working-directory: bindings/nodejs
run: corepack enable
- name: Install dependencies
working-directory: bindings/nodejs
run: pnpm install --frozen-lockfile
- name: Build docs theme
working-directory: bindings/nodejs
run: pnpm run build:theme
- name: Build bindings/nodejs Docs
working-directory: bindings/nodejs
run: pnpm run docs
- name: Upload docs
uses: actions/upload-artifact@v3
with:
name: nodejs-docs
path: ./bindings/nodejs/docs
build-python-doc:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- uses: actions/setup-python@v5
with:
python-version: '3.11'
- name: Setup Rust toolchain
uses: ./.github/actions/setup
- name: Build and install dependencies
working-directory: bindings/python
run: |
python -m pip install -e .[docs]
- name: Build Docs
working-directory: bindings/python
run: pdoc -t ./template --output-dir ./docs opendal
- name: Upload docs
uses: actions/upload-artifact@v3
with:
name: python-docs
path: ./bindings/python/docs
build-c-doc:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- name: Setup Rust toolchain
uses: ./.github/actions/setup
with:
github-token: ${{ secrets.GITHUB_TOKEN }}
- name: Setup doxygen
run: sudo apt-get install doxygen
- name: Build Docs
working-directory: bindings/c
run: make doc
- name: Upload docs
uses: actions/upload-artifact@v3
with:
name: C-docs
path: ./bindings/c/docs/doxygen/html
build-lua-doc:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- name: Setup lua-ldoc
run: sudo apt-get install lua-ldoc
- name: Build Docs
working-directory: "bindings/lua"
run: ldoc ./src
- name: Upload docs
uses: actions/upload-artifact@v3
with:
name: lua-docs
path: ./bindings/lua/doc/
build-haskell-doc:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- name: Setup Haskell toolchain (ghc-9.2.8)
run: |
curl --proto '=https' --tlsv1.2 -sSf https://get-ghcup.haskell.org | sh
ghcup install ghc 9.2.8 --set
ghcup install cabal --set
cabal update
- name: Setup Rust toolchain
uses: ./.github/actions/setup
- name: Restore haskell cache
uses: actions/cache/restore@v4
with:
key: ${{ runner.os }}-haskell-${{ hashFiles('**/*.cabal', '**/Setup.hs') }}
path: |
~/.cabal/store
bindings/haskell/dist-newstyle
restore-keys: ${{ runner.os }}-haskell-
- name: Build Docs
working-directory: "bindings/haskell"
run: |
cabal haddock --haddock-html --haddock-quickjump --haddock-hyperlink-source
find dist-newstyle -path '**/build/**/doc' -exec cp -r {}/html/opendal/ doc \;
- name: Upload docs
uses: actions/upload-artifact@v3
with:
name: haskell-docs
path: ./bindings/haskell/doc/
build-cpp-doc:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- name: Setup Rust toolchain
uses: ./.github/actions/setup
with:
github-token: ${{ secrets.GITHUB_TOKEN }}
- name: Install dependencies
run: |
sudo apt-get install doxygen graphviz ninja-build
- name: Build Cpp docs
working-directory: "bindings/cpp"
run: |
mkdir build
cd build
cmake -GNinja -DOPENDAL_DOCS_ONLY=ON ..
ninja docs
- name: Upload docs
uses: actions/upload-artifact@v3
with:
name: cpp-docs
path: ./bindings/cpp/build/docs_doxygen/html
build-ocaml-doc:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- name: Setup Rust toolchain
uses: ./.github/actions/setup
with:
github-token: ${{ secrets.GITHUB_TOKEN }}
- name: Setup OCaml toolchain
uses: ./.github/actions/setup-ocaml
- name: Build OCaml docs
working-directory: "bindings/ocaml"
run: |
opam install -y dune odoc
eval $(opam env)
dune build @doc
- name: Upload docs
uses: actions/upload-artifact@v3
with:
name: ocaml-docs
path: ./bindings/ocaml/_build/default/_doc/_html
build-object-store-opendal-doc:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- name: Setup Rust toolchain
uses: ./.github/actions/setup
# Revert to nightly after https://github.com/apache/opendal/issues/4161 addressed
- name: Setup Rust Nightly
run: |
rustup toolchain install nightly-2024-01-01
- name: Build object-store-opendal doc
working-directory: "integrations/object_store"
run: cargo +nightly-2024-01-01 doc --lib --no-deps --all-features
env:
# Enable cfg docs to make sure docs are built.
RUSTDOCFLAGS: "--cfg docs"
- name: Upload docs
uses: actions/upload-artifact@v3
with:
name: object-store-opendal-docs
path: ./integrations/object_store/target/doc
build-dav-server-opendalfs-doc:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- name: Setup Rust toolchain
uses: ./.github/actions/setup
# Revert to nightly after https://github.com/apache/opendal/issues/4161 addressed
- name: Setup Rust Nightly
run: |
rustup toolchain install nightly-2024-01-01
- name: Build dav-server-opendalfs doc
working-directory: "integrations/dav-server"
run: cargo +nightly-2024-01-01 doc --lib --no-deps --all-features
env:
# Enable cfg docs to make sure docs are built.
RUSTDOCFLAGS: "--cfg docs"
- name: Upload docs
uses: actions/upload-artifact@v3
with:
name: dav-server-opendalfs-docs
path: ./integrations/dav-server/target/doc
build-website:
runs-on: ubuntu-latest
needs:
- build-rust-doc
- build-java-doc
- build-nodejs-doc
- build-python-doc
- build-c-doc
- build-lua-doc
- build-haskell-doc
- build-cpp-doc
- build-ocaml-doc
- build-object-store-opendal-doc
- build-dav-server-opendalfs-doc
steps:
- uses: actions/checkout@v4
- uses: pnpm/action-setup@v3
with:
version: 8
- uses: actions/setup-node@v4
with:
node-version: '18'
cache: pnpm
cache-dependency-path: "website/pnpm-lock.yaml"
- name: Corepack
working-directory: website
run: corepack enable
- name: Download rust docs
uses: actions/download-artifact@v3
with:
name: rust-docs
path: ./website/static/docs/rust
- name: Download nodejs docs
uses: actions/download-artifact@v3
with:
name: nodejs-docs
path: ./website/static/docs/nodejs
- name: Download python docs
uses: actions/download-artifact@v3
with:
name: python-docs
path: ./website/static/docs/python
- name: Download java docs
uses: actions/download-artifact@v3
with:
name: java-docs
path: ./website/static/docs/java
- name: Download C docs
uses: actions/download-artifact@v3
with:
name: C-docs
path: ./website/static/docs/c
- name: Download lua docs
uses: actions/download-artifact@v3
with:
name: lua-docs
path: ./website/static/docs/lua
- name: Download haskell docs
uses: actions/download-artifact@v3
with:
name: haskell-docs
path: ./website/static/docs/haskell
- name: Download cpp docs
uses: actions/download-artifact@v3
with:
name: cpp-docs
path: ./website/static/docs/cpp
- name: Download ocaml docs
uses: actions/download-artifact@v3
with:
name: ocaml-docs
path: ./website/static/docs/ocaml
- name: Download object-store-opendal docs
uses: actions/download-artifact@v3
with:
name: object-store-opendal-docs
path: ./website/static/docs/object-store-opendal
- name: Download dav-server-opendalfs docs
uses: actions/download-artifact@v3
with:
name: dav-server-opendalfs-docs
path: ./website/static/docs/dav-server-opendalfs
- name: Install Dependencies
working-directory: website
run: pnpm install --frozen-lockfile
- name: Build
working-directory: website
run: pnpm build
- name: Copy asf file
run: cp .asf.yaml ./website/build/.asf.yaml
- name: Deploy to gh-pages
uses: peaceiris/actions-gh-pages@v3.9.2
if: github.event_name == 'push' && github.ref_name == 'main'
with:
github_token: ${{ secrets.GITHUB_TOKEN }}
publish_dir: website/build
publish_branch: gh-pages
- name: Clear build
run: rm -rf ./website/build
- name: Build for nightlies with tagged version
working-directory: website
run: pnpm build
env:
# Keep this same with the remote_path below
OPENDAL_WEBSITE_BASE_URL: /opendal/opendal-docs-release-${{ github.ref_name }}/
OPENDAL_WEBSITE_NOT_LATEST: true
- name: Deploy to nightlies for tagged version
uses: burnett01/rsync-deployments@5.2
if: "startsWith(github.ref, 'refs/tags/')"
with:
switches: -avzr
path: website/build/
remote_path: ${{ secrets.NIGHTLIES_RSYNC_PATH }}/opendal/opendal-docs-release-${{ github.ref_name }}/
remote_host: ${{ secrets.NIGHTLIES_RSYNC_HOST }}
remote_port: ${{ secrets.NIGHTLIES_RSYNC_PORT }}
remote_user: ${{ secrets.NIGHTLIES_RSYNC_USER }}
remote_key: ${{ secrets.NIGHTLIES_RSYNC_KEY }}
- name: Clear build
run: rm -rf ./website/build
- name: Build for nightlies with stable version
working-directory: website
run: pnpm build
env:
OPENDAL_WEBSITE_BASE_URL: /opendal/opendal-docs-stable/
- name: Deploy to nightlies for stable version
uses: burnett01/rsync-deployments@5.2
if: "startsWith(github.ref, 'refs/tags/')"
with:
switches: -avzr --delete
path: website/build/
remote_path: ${{ secrets.NIGHTLIES_RSYNC_PATH }}/opendal/opendal-docs-stable/
remote_host: ${{ secrets.NIGHTLIES_RSYNC_HOST }}
remote_port: ${{ secrets.NIGHTLIES_RSYNC_PORT }}
remote_user: ${{ secrets.NIGHTLIES_RSYNC_USER }}
remote_key: ${{ secrets.NIGHTLIES_RSYNC_KEY }}