feat(bindings/c): support presign

Author: yuchanns

.github/workflows/test_behavior_binding_c.yml

@@ -54,7 +54,7 @@ jobs:
       - name: Install build tools
         run: |
           sudo apt-get update
-          sudo apt-get install -y build-essential pkg-config uuid-dev
+          sudo apt-get install -y build-essential pkg-config uuid-dev libcurl4-gnutls-dev
 
       - name: Build OpenDAL C library
         working-directory: "bindings/c"

bindings/c/include/opendal.h

@@ -87,6 +87,8 @@ typedef enum opendal_code {
   OPENDAL_RANGE_NOT_SATISFIED,
 } opendal_code;
 
+typedef struct opendal_presigned_request_inner opendal_presigned_request_inner;
+
 /**
  * \brief opendal_bytes carries raw-bytes with its length
  *
@@ -577,12 +579,52 @@ typedef struct opendal_capability {
    * If operator supports presign write.
    */
   bool presign_write;
+  /**
+   * If operator supports presign delete.
+   */
+  bool presign_delete;
   /**
    * If operator supports shared.
    */
   bool shared;
 } opendal_capability;
 
+/**
+ * \brief The underlying presigned request, which contains the HTTP method, URI, and headers.
+ * This is an opaque struct, please use the accessor functions to get the fields.
+ */
+typedef struct opendal_presigned_request {
+  struct opendal_presigned_request_inner *inner;
+} opendal_presigned_request;
+
+/**
+ * @brief The result of a presign operation.
+ */
+typedef struct opendal_result_presign {
+  /**
+   * The presigned request.
+   */
+  struct opendal_presigned_request *req;
+  /**
+   * The error.
+   */
+  struct opendal_error *error;
+} opendal_result_presign;
+
+/**
+ * \brief The key-value pair for the headers of the presigned request.
+ */
+typedef struct opendal_http_header_pair {
+  /**
+   * The key of the header.
+   */
+  const char *key;
+  /**
+   * The value of the header.
+   */
+  const char *value;
+} opendal_http_header_pair;
+
 /**
  * \brief The is the result type returned by opendal_reader_read().
  * The result type contains a size field, which is the size of the data read,
@@ -1376,6 +1418,59 @@ struct opendal_capability opendal_operator_info_get_full_capability(const struct
  */
 struct opendal_capability opendal_operator_info_get_native_capability(const struct opendal_operator_info *self);
 
+/**
+ * \brief Presign a read operation.
+ */
+struct opendal_result_presign opendal_operator_presign_read(const struct opendal_operator *op,
+                                                            const char *path,
+                                                            uint64_t expire_secs);
+
+/**
+ * \brief Presign a write operation.
+ */
+struct opendal_result_presign opendal_operator_presign_write(const struct opendal_operator *op,
+                                                             const char *path,
+                                                             uint64_t expire_secs);
+
+/**
+ * \brief Presign a delete operation.
+ */
+struct opendal_result_presign opendal_operator_presign_delete(const struct opendal_operator *op,
+                                                              const char *path,
+                                                              uint64_t expire_secs);
+
+/**
+ * \brief Presign a stat operation.
+ */
+struct opendal_result_presign opendal_operator_presign_stat(const struct opendal_operator *op,
+                                                            const char *path,
+                                                            uint64_t expire_secs);
+
+/**
+ * Get the method of the presigned request.
+ */
+const char *opendal_presigned_request_method(const struct opendal_presigned_request *req);
+
+/**
+ * Get the URI of the presigned request.
+ */
+const char *opendal_presigned_request_uri(const struct opendal_presigned_request *req);
+
+/**
+ * Get the headers of the presigned request.
+ */
+const struct opendal_http_header_pair *opendal_presigned_request_headers(const struct opendal_presigned_request *req);
+
+/**
+ * Get the length of the headers of the presigned request.
+ */
+uintptr_t opendal_presigned_request_headers_len(const struct opendal_presigned_request *req);
+
+/**
+ * \brief Free the presigned request.
+ */
+void opendal_presigned_request_free(struct opendal_presigned_request *req);
+
 /**
  * \brief Frees the heap memory used by the opendal_bytes
  */

bindings/c/src/lib.rs

@@ -47,6 +47,11 @@ pub use operator::opendal_operator;
 
 mod operator_info;
 
+mod presign;
+pub use presign::opendal_http_header_pair;
+pub use presign::opendal_presigned_request;
+pub use presign::opendal_result_presign;
+
 mod result;
 pub use result::opendal_result_exists;
 pub use result::opendal_result_is_exist;

bindings/c/src/operator_info.rs

@@ -125,6 +125,8 @@ pub struct opendal_capability {
     pub presign_stat: bool,
     /// If operator supports presign write.
     pub presign_write: bool,
+    /// If operator supports presign delete.
+    pub presign_delete: bool,
 
     /// If operator supports shared.
     pub shared: bool,
@@ -253,6 +255,7 @@ impl From<core::Capability> for opendal_capability {
             presign_read: value.presign_read,
             presign_stat: value.presign_stat,
             presign_write: value.presign_write,
+            presign_delete: value.presign_delete,
             shared: value.shared,
         }
     }