Merge branch 'main' into better-docs

.github/actions/fuzz_test/action.yaml

@@ -16,7 +16,7 @@
 # under the License.
 
 name: Fuzz Test
-description: 'Fuzz test given setup and service'
+description: "Fuzz test given setup and service"
 inputs:
   setup:
     description: "The setup action for test"
@@ -41,7 +41,7 @@ runs:
           - name: Run Fuzz Test
             shell: bash
             working-directory: core/fuzz
-            run: cargo +nightly fuzz run ${{ inputs.target }} --features services-${{ inputs.service }} -- -max_total_time=120
+            run: cargo +nightly-2024-11-22 fuzz run ${{ inputs.target }} --features services-${{ inputs.service }} -- -max_total_time=120
             env:
               OPENDAL_TEST: ${{ inputs.service }}
         EOF

.github/scripts/test_behavior/plan.py

@@ -139,6 +139,7 @@ def calculate_hint(changed_files: list[str]) -> Hint:
             and not p.startswith("core/edge/")
             and not p.startswith("core/fuzz/")
             and not p.startswith("core/src/services/")
+            and not p.startswith("core/src/docs/")
         ):
             hint.core = True
             hint.binding_java = True

.github/services/webhdfs/webhdfs_with_user_name/action.yml

@@ -0,0 +1,37 @@
+# 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: webhdfs
+description: "Behavior test for webhdfs with user name specified"
+
+runs:
+  using: "composite"
+  steps:
+    - name: Setup webhdfs
+      shell: bash
+      working-directory: fixtures/webhdfs
+      run: |
+        docker compose -f docker-compose-webhdfs.yml up -d --wait
+    - name: Setup
+      shell: bash
+      run: |
+        cat << EOF >> $GITHUB_ENV
+        OPENDAL_WEBHDFS_ROOT=/
+        OPENDAL_WEBHDFS_ENDPOINT=http://127.0.0.1:9870
+        OPENDAL_WEBHDFS_ATOMIC_WRITE_DIR=.opendal_tmp/
+        OPENDAL_WEBHDFS_USER_NAME=root
+        EOF

.github/workflows/ci_core.yml

@@ -108,7 +108,7 @@ jobs:
           github-token: ${{ secrets.GITHUB_TOKEN }}
       - name: Build
         working-directory: core
-        run: cargo build
+        run: cargo build --locked
 
   build_all_features:
     runs-on: ubuntu-latest
@@ -133,7 +133,7 @@ jobs:
 
       - name: Build
         working-directory: core
-        run: cargo build --all-features
+        run: cargo build --all-features --locked
 
   build_all_platforms:
     runs-on: ${{ matrix.os }}
@@ -213,7 +213,7 @@ jobs:
             services-webdav
             services-webhdfs
           )
-          cargo build --features "${FEATURES[*]}"
+          cargo build --features "${FEATURES[*]}" --locked
 
   # We only support some services(see `available_services` below) for now.
   build_under_wasm:
@@ -233,7 +233,7 @@ jobs:
             services-s3
           )
           rustup target add wasm32-unknown-unknown
-          cargo build --target wasm32-unknown-unknown --no-default-features --features="${FEATURES[*]}"
+          cargo build --target wasm32-unknown-unknown --no-default-features --features="${FEATURES[*]}" --locked
 
   unit:
     runs-on: ubuntu-latest

.github/workflows/test_fuzz.yml

@@ -40,7 +40,7 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        target: [ "fuzz_reader", "fuzz_writer" ]
+        target: ["fuzz_reader", "fuzz_writer"]
         cases:
           - { service: "memory", setup: "memory" }
           - { service: "fs", setup: "local_fs" }
@@ -54,8 +54,8 @@ jobs:
         shell: bash
         run: |
           sudo apt-get install -y libfuzzer-14-dev
-          rustup install nightly
-          cargo +nightly install cargo-fuzz
+          rustup install nightly-2024-11-22
+          cargo +nightly-2024-11-22 install cargo-fuzz
       - name: Fuzz
         uses: ./.github/actions/fuzz_test
         env:

.vscode/settings.json

@@ -6,6 +6,9 @@
     "${workspaceFolder}/bindings/python/Cargo.toml",
     "${workspaceFolder}/bindings/java/Cargo.toml",
     "${workspaceFolder}/bindings/nodejs/Cargo.toml",
+    "${workspaceFolder}/bin/oli/Cargo.toml",
+    "${workspaceFolder}/bin/oay/Cargo.toml",
+    "${workspaceFolder}/bin/ofs/Cargo.toml"
   ],
   "java.compile.nullAnalysis.mode": "automatic"
 }

README.md

@@ -3,7 +3,7 @@
 [![](https://img.shields.io/github/discussions/apache/opendal)](https://github.com/apache/opendal/discussions)
 [![](https://img.shields.io/discord/1081052318650339399?logo=discord&label=discord)](https://opendal.apache.org/discord)
 
-OpenDAL is an Open Data Access Layer that enables seamless interaction with diverse storage services.
+OpenDAL (`/ˈoʊ.pən.dæl/`, pronounced "OH-puhn-dal") is an Open Data Access Layer that enables seamless interaction with diverse storage services.
 
 OpenDAL's development is guided by its vision of **One Layer, All Storage** and its core principles: **Open Community**, **Solid Foundation**, **Fast Access**, **Object Storage First**, and **Extensible Architecture**. Read the explained vision at [OpenDAL Vision](https://opendal.apache.org/vision).