Merge branch 'release/v0.3.0'

.github/workflows/ci.yml

@@ -0,0 +1,87 @@
+on: [push, pull_request]
+
+name: Continuous integration
+
+jobs:
+  check:
+    name: Check
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout sources
+        uses: actions/checkout@v1
+
+      - name: Install stable toolchain
+        uses: actions-rs/toolchain@v1
+        with:
+          toolchain: stable
+          override: true
+
+      - name: Run cargo check
+        uses: actions-rs/cargo@v1
+        with:
+          command: check
+
+  test:
+    name: Test Suite
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout sources
+        uses: actions/checkout@v1
+
+      - name: Install stable toolchain
+        uses: actions-rs/toolchain@v1
+        with:
+          toolchain: stable
+          override: true
+
+      - name: Run cargo test
+        uses: actions-rs/cargo@v1
+        env:
+          ACCESS_KEY_ID: ${{ secrets.ACCESS_KEY_ID }}
+          ACCESS_KEY_SECRET: ${{ secrets.ACCESS_KEY_SECRET }}
+        with:
+          command: test
+
+  fmt:
+    name: Rustfmt
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout sources
+        uses: actions/checkout@v1
+
+      - name: Install stable toolchain
+        uses: actions-rs/toolchain@v1
+        with:
+          toolchain: stable
+          override: true
+
+      - name: Install rustfmt
+        run: rustup component add rustfmt
+
+      - name: Run cargo fmt
+        uses: actions-rs/cargo@v1
+        with:
+          command: fmt
+          args: --all -- --check
+
+  clippy:
+    name: Clippy
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout sources
+        uses: actions/checkout@v1
+
+      - name: Install stable toolchain
+        uses: actions-rs/toolchain@v1
+        with:
+          toolchain: stable
+          override: true
+
+      - name: Install clippy
+        run: rustup component add clippy
+
+      - name: Run cargo clippy
+        uses: actions-rs/cargo@v1
+        with:
+          command: clippy
+          args: -- -D warnings

CHANGELOG.md

@@ -9,6 +9,14 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ### Added
 - ROA style client.
 
+## [0.3.0] - 2019-09-21
+
+### Added
+- New function(`get`, `query`, `send`) for RPC style client.
+
+### Deprecated
+- `request` function is deprecated, please use the `get` function instead.
+
 ## [0.2.0] - 2019-09-01
 
 ### Changed

Cargo.toml

@@ -1,7 +1,7 @@
 [package]
 name = "aliyun-openapi-core-rust-sdk"
 description = "Aliyun OpenAPI POP core SDK for Rust"
-version = "0.2.0"
+version = "0.3.0"
 keywords = ["aliyun", "openapi", "api", "sdk"]
 categories = ["api-bindings"]
 authors = ["mc404 <[email protected]>"]

README.md

@@ -1,17 +1,11 @@
 # aliyun-openapi-core-rust-sdk
 
-Aliyun OpenAPI POP core SDK for Rust.
-
-## Installation
-
-Write into Cargo.toml dependencies:
+[![Crates Status](http://meritbadge.herokuapp.com/aliyun-openapi-core-rust-sdk)](https://crates.io/crates/aliyun-openapi-core-rust-sdk)
+[![Actions Status](https://github.com/r4ntix/aliyun-openapi-core-rust-sdk/workflows/ci.yml/badge.svg)](https://github.com/r4ntix/aliyun-openapi-core-rust-sdk/actions)
 
-```toml
-[dependencies]
-aliyun-openapi-core-rust-sdk = "0.2.0"
-```
+Aliyun OpenAPI POP core SDK for Rust.
 
-### Notes
+## Notes
 
 You must know your `AK`(`accessKeyId/accessKeySecret`), and the aliyun product's `endpoint` and `apiVersion`.
 
@@ -36,9 +30,15 @@ fn main() -> Result<(), Box<dyn Error>> {
         String::from("<version>"),
     );
 
+    // call `DescribeRegions` with empty queries.
+    let response = aliyun_openapi_client.get("DescribeRegions").send()?;
+    println!("DescribeRegions response: {}", response);
+
     // call `DescribeInstances` with queries.
-    let response =
-        aliyun_openapi_client.request("DescribeInstances", &[("RegionId", "cn-hangzhou")])?;
+    let response = aliyun_openapi_client
+        .get("DescribeInstances")
+        .query(&[("RegionId", "cn-hangzhou")])
+        .send()?;
     println!("DescribeInstances response: {}", response);
 
     Ok(())

examples/ecs.rs

@@ -12,12 +12,14 @@ fn main() -> Result<(), Box<dyn Error>> {
     );
 
     // call `DescribeRegions` with empty queries.
-    let response = aliyun_openapi_client.request("DescribeRegions", &[])?;
+    let response = aliyun_openapi_client.get("DescribeRegions").send()?;
     println!("DescribeRegions response: {}", response);
 
     // call `DescribeInstances` with queries.
-    let response =
-        aliyun_openapi_client.request("DescribeInstances", &[("RegionId", "cn-hangzhou")])?;
+    let response = aliyun_openapi_client
+        .get("DescribeInstances")
+        .query(&[("RegionId", "cn-hangzhou")])
+        .send()?;
     println!("DescribeInstances response: {}", response);
 
     Ok(())

examples/rds.rs

@@ -12,12 +12,14 @@ fn main() -> Result<(), Box<dyn Error>> {
     );
 
     // call `DescribeRegions` with empty queries.
-    let response = aliyun_openapi_client.request("DescribeRegions", &[])?;
+    let response = aliyun_openapi_client.get("DescribeRegions").send()?;
     println!("DescribeRegions response: {}", response);
 
     // call `DescribeDBInstances` with queries.
-    let response =
-        aliyun_openapi_client.request("DescribeDBInstances", &[("RegionId", "cn-hangzhou")])?;
+    let response = aliyun_openapi_client
+        .get("DescribeDBInstances")
+        .query(&[("RegionId", "cn-hangzhou")])
+        .send()?;
     println!("DescribeDBInstances response: {}", response);
 
     Ok(())

examples/slb.rs

@@ -12,12 +12,14 @@ fn main() -> Result<(), Box<dyn Error>> {
     );
 
     // call `DescribeRegions` with empty queries.
-    let response = aliyun_openapi_client.request("DescribeRegions", &[])?;
+    let response = aliyun_openapi_client.get("DescribeRegions").send()?;
     println!("DescribeRegions response: {}", response);
 
     // call `DescribeLoadBalancers` with queries.
-    let response =
-        aliyun_openapi_client.request("DescribeLoadBalancers", &[("RegionId", "cn-hangzhou")])?;
+    let response = aliyun_openapi_client
+        .get("DescribeLoadBalancers")
+        .query(&[("RegionId", "cn-hangzhou")])
+        .send()?;
     println!("DescribeLoadBalancers response: {}", response);
 
     Ok(())

examples/vpc.rs

@@ -12,11 +12,14 @@ fn main() -> Result<(), Box<dyn Error>> {
     );
 
     // call `DescribeRegions` with empty queries.
-    let response = aliyun_openapi_client.request("DescribeRegions", &[])?;
+    let response = aliyun_openapi_client.get("DescribeRegions").send()?;
     println!("DescribeRegions response: {}", response);
 
     // call `DescribeVpcs` with queries.
-    let response = aliyun_openapi_client.request("DescribeVpcs", &[("RegionId", "cn-hangzhou")])?;
+    let response = aliyun_openapi_client
+        .get("DescribeVpcs")
+        .query(&[("RegionId", "cn-hangzhou")])
+        .send()?;
     println!("DescribeVpcs response: {}", response);
 
     Ok(())

src/lib.rs

@@ -12,7 +12,7 @@
 //!
 //! The RPC style client:
 //!
-//! ```rust
+//! ```no_run
 //! use aliyun_openapi_core_rust_sdk::RPClient;
 //! use std::error::Error;
 //!
@@ -25,18 +25,24 @@
 //!         String::from("<version>"),
 //!     );
 //!
+//!     // call `DescribeRegions` with empty queries.
+//!     let response = aliyun_openapi_client.get("DescribeRegions").send()?;
+//!     println!("DescribeRegions response: {}", response);
+//!
 //!     // call `DescribeInstances` with queries.
-//!     let response =
-//!             aliyun_openapi_client.request("DescribeInstances", &[("RegionId", "cn-hangzhou")])?;
-//!         println!("DescribeInstances response: {}", response);
+//!     let response = aliyun_openapi_client
+//!         .get("DescribeInstances")
+//!         .query(&[("RegionId", "cn-hangzhou")])
+//!         .send()?;
+//!     println!("DescribeInstances response: {}", response);
 //!
 //!     Ok(())
 //! }
 //! ```
 //!
 //! The ROA style client:
 //!
-//! ```rust
+//! ```no_run
 //! unimplemented!();
 //! ```
 //! # Examples