aliyunsdkcore 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: e2aa2eda4b1227ed6df56755568a56581b32687d09ffafd7a5d409ae97693f9c
+  data.tar.gz: ac4f65d9277dbd14c0aa8cce81031b7a5235b12263d0c29bf39e381ab76d3a36
+SHA512:
+  metadata.gz: a0a9cc6e88a2aad8345da1e3091d319339b9c82f1d3f933bb66a42e0567260d79c2dd54ab908637b097131e3dfe03252c1b163b7398eaef90b12e86e4e05ed20
+  data.tar.gz: 715239a7c720126240e85aa19cba49a5ccd7d78dbc0c6e4048e1f7b079ae2f0b8c259a92b59204b167c4fb94176973558c996946fbad9c456bf974a34cf754f1

data/README.md

@@ -0,0 +1,10 @@
+# Alibaba Cloud Ruby Software Development Kit(Working in progress)
+
+[![Build Status](https://travis-ci.org/aliyun/openapi-core-ruby-sdk.svg?branch=master)](https://travis-ci.org/aliyun/openapi-core-ruby-sdk)
+[![codecov](https://codecov.io/gh/aliyun/openapi-core-ruby-sdk/branch/master/graph/badge.svg)](https://codecov.io/gh/aliyun/openapi-core-ruby-sdk)
+
+The Alibaba Cloud Ruby Software Development Kit (SDK) allows you to access Alibaba Cloud services such as Elastic Compute Service (ECS), Server Load Balancer (SLB), and CloudMonitor. You can access Alibaba Cloud services without the need to handle API related tasks, such as signing and constructing your requests.
+
+This document introduces how to install and use Alibaba Cloud Ruby SDK.
+
+If you have any problem while using Ruby SDK, please submit an issue.

data/lib/roa_client.rb

@@ -0,0 +1,150 @@
+require 'faraday'
+require 'securerandom'
+require 'active_support/all'
+
+class ROAClient
+
+  attr_accessor :endpoint, :api_version, :access_key_id, :access_key_secret, :security_token, :hostname, :opts
+
+  def initialize(config)
+
+    validate config
+
+    self.endpoint          = config[:endpoint]
+    self.api_version       = config[:api_version]
+    self.access_key_id     = config[:access_key_id]
+    self.access_key_secret = config[:access_key_secret]
+    self.security_token    = config[:security_token]
+
+  end
+
+  def request(method:, uri:, params: {}, body: {}, headers: {}, options: {})
+
+    mix_headers = default_headers.merge(headers)
+
+    response = connection.send(method.downcase) do |request|
+      request.url uri, params
+      if body.present?
+        request_body                  = body.to_json
+        request.body                  = request_body
+        mix_headers['content-md5']    = Digest::MD5.base64digest request_body
+        mix_headers['content-length'] = request_body.length.to_s
+      end
+      string_to_sign = string_to_sign(method, uri, mix_headers, params)
+      mix_headers.merge!(authorization: authorization(string_to_sign))
+      mix_headers.each { |key, value| request.headers[key] = value }
+    end
+
+    return response if options.has_key? :raw_body
+
+    response_content_type = response.headers['Content-Type'] || ''
+    if response_content_type.start_with?('application/json')
+      if response.status >= 400
+        result = JSON.parse(response.body)
+        raise StandardError, "code: #{response.status}, #{result['Message']} requestid: #{result['RequestId']}"
+      end
+    end
+
+    if response_content_type.start_with?('text/xml')
+      result = Hash.from_xml(response.body)
+      raise ACSError, result['Error'] if result['Error']
+    end
+
+    response
+  end
+
+  def connection(adapter = Faraday.default_adapter)
+    Faraday.new(:url => self.endpoint) { |faraday| faraday.adapter adapter }
+  end
+
+  def get(uri: '', headers: {}, params: {}, options: {})
+    request(method: :get, uri: uri, params: params, body: {}, headers: headers, options: options)
+  end
+
+  def post(uri: '', headers: {}, params: {}, body: {}, options: {})
+    request(method: :get, uri: uri, params: params, body: body, headers: headers, options: options)
+  end
+
+  def put(uri: '', headers: {}, params: {}, body: {}, options: {})
+    request(method: :get, uri: uri, params: params, body: body, headers: headers, options: options)
+  end
+
+  def delete(uri: '', headers: {}, params: {}, options: {})
+    request(method: :get, uri: uri, params: params, body: {}, headers: headers, options: options)
+  end
+
+  def default_headers
+    default_headers = {
+      'accept':                  'application/json',
+      'date':                    Time.now.httpdate,
+      'host':                    URI(self.endpoint).host,
+      'x-acs-signature-nonce':   SecureRandom.hex(16),
+      'x-acs-signature-method':  'HMAC-SHA1',
+      'x-acs-signature-version': '1.0',
+      'x-acs-version':           self.api_version,
+      'x-sdk-client':            "RUBY(#{RUBY_VERSION})" # FIXME: 如何获取Gem的名称和版本号
+    }
+    if self.security_token
+      default_headers.merge!('x-acs-accesskey-id': self.access_key_id, 'x-acs-security-token': self.security_token)
+    end
+    default_headers
+  end
+
+  private
+
+  def string_to_sign(method, uri, headers, query = {})
+    headers.stringify_keys!
+    header_string = [
+      method,
+      headers['accept'],
+      headers['content-md5'] || '',
+      headers['content-type'] || '',
+      headers['date'],
+    ].join("\n")
+    "#{header_string}\n#{canonicalized_headers(headers)}#{canonicalized_resource(uri, query)}"
+  end
+
+  def canonicalized_headers(headers)
+    headers.keys.select { |key| key.to_s.start_with? 'x-acs-' }
+      .sort.map { |key| "#{key}:#{headers[key].strip}\n" }.join
+  end
+
+  def canonicalized_resource(uri, query_hash = {})
+    query_string = query_hash.map { |key, value| "#{key}=#{value}" }.join('&')
+    query_string.empty? ? uri : "#{uri}?#{query_string}"
+  end
+
+  def authorization(string_to_sign)
+    "acs #{self.access_key_id}:#{signature(string_to_sign)}"
+  end
+
+  def signature(string_to_sign)
+    Base64.encode64(OpenSSL::HMAC.digest('sha1', self.access_key_secret, string_to_sign)).strip
+  end
+
+  def validate(config)
+    raise ArgumentError, 'must pass "config"' unless config
+    raise ArgumentError, 'must pass "config[:endpoint]"' unless config[:endpoint]
+    unless config[:endpoint].start_with?('http://') || config[:endpoint].start_with?('https://')
+      raise ArgumentError, '"config.endpoint" must starts with \'https://\' or \'http://\'.'
+    end
+    raise ArgumentError, 'must pass "config[:api_version]"' unless config[:api_version]
+    raise ArgumentError, 'must pass "config[:access_key_id]"' unless config[:access_key_id]
+    raise ArgumentError, 'must pass "config[:access_key_secret]"' unless config[:access_key_secret]
+  end
+
+  class ACSError < StandardError
+
+    attr_accessor :code
+
+    def initialize(error)
+      self.code  = error['Code']
+      message    = error['Message']
+      host_id    = error['HostId']
+      request_id = error['RequestId']
+      super("#{message} host_id: #{host_id}, request_id: #{request_id}")
+    end
+
+  end
+
+end

data/lib/rpc_client.rb

@@ -0,0 +1,126 @@
+require 'set'
+require 'faraday'
+require 'active_support/all'
+
+class RPCClient
+
+  attr_accessor :endpoint, :api_version, :access_key_id, :access_key_secret, :security_token, :codes, :opts, :verbose
+
+  def initialize(config, verbose = false)
+
+    validate config
+
+    self.endpoint          = config[:endpoint]
+    self.api_version       = config[:api_version]
+    self.access_key_id     = config[:access_key_id]
+    self.access_key_secret = config[:access_key_secret]
+    self.security_token    = config[:security_token]
+    self.opts              = config[:opts] || {}
+    self.verbose           = verbose.instance_of?(TrueClass) && verbose
+    self.codes             = Set.new [200, '200', 'OK', 'Success']
+    self.codes.merge config[:codes] if config[:codes]
+  end
+
+  def request(action:, params: {}, opts: {})
+    opts           = self.opts.merge(opts)
+    action         = action.upcase_first if opts[:format_action]
+    params         = format_params(params) unless opts[:format_params]
+    defaults       = default_params
+    params         = { Action: action }.merge(defaults).merge(params)
+    method         = (opts[:method] || 'GET').upcase
+    normalized     = normalize(params)
+    canonicalized  = canonicalize(normalized)
+    string_to_sign = "#{method}&#{encode('/')}&#{encode(canonicalized)}"
+    key            = self.access_key_secret + '&'
+    signature      = Base64.encode64(OpenSSL::HMAC.digest('sha1', key, string_to_sign)).strip
+    normalized.push(['Signature', encode(signature)])
+
+    uri           = opts[:method] == 'POST' ? '/' : "/?#{canonicalize(normalized)}"
+    response      = connection.send(method.downcase, uri) do |request|
+      if opts[:method] == 'POST'
+        request.headers['Content-Type'] = 'application/x-www-form-urlencoded'
+        request.body                    = canonicalize(normalized)
+      end
+    end
+    response_body = JSON.parse(response.body)
+    if response_body['Code'] && !self.codes.include?(response_body['Code'])
+      raise StandardError, "#{response_body['Message']}, URL: #{uri}"
+    end
+    response
+  end
+
+  private
+
+  def connection(adapter = Faraday.default_adapter)
+    Faraday.new(:url => self.endpoint) { |faraday| faraday.adapter adapter }
+  end
+
+  def default_params
+    default_params = {
+      :Format           => 'JSON',
+      :SignatureMethod  => 'HMAC-SHA1',
+      :SignatureNonce   => SecureRandom.hex(16),
+      :SignatureVersion => '1.0',
+      :Timestamp        => Time.now.utc.strftime('%Y-%m-%dT%H:%M:%SZ'),
+      :AccessKeyId      => self.access_key_id,
+      :Version          => self.api_version,
+    }
+    default_params.merge!(SecurityToken: self.security_token) if self.security_token
+    default_params
+  end
+
+  def encode(string)
+    CGI.escape string
+  end
+
+  def format_params(param_hash)
+    param_hash.keys.each { |key| param_hash[key.to_s.upcase_first.to_sym] = param_hash.delete key }
+    param_hash
+  end
+
+  def replace_repeat_list(target, key, repeat)
+    repeat.each_with_index do |item, index|
+      if item && item.instance_of?(Hash)
+        item.each_key { |k| target["#{key}.#{index.next}.#{k}"] = item[k] }
+      else
+        target["#{key}.#{index.next}"] = item
+      end
+    end
+    target
+  end
+
+  def flat_params(params)
+    target = {}
+    params.each do |key, value|
+      if value.instance_of?(Array)
+        replace_repeat_list(target, key, value)
+      else
+        target[key] = value
+      end
+    end
+    target
+  end
+
+  def normalize(params)
+    flat_params(params)
+      .stringify_keys
+      .sort
+      .to_h
+      .map { |key, value| [encode(key), encode(value)] }
+  end
+
+  def canonicalize(normalized)
+    normalized.map { |element| "#{element.first}=#{element.last}" }.join('&')
+  end
+
+  def validate(config)
+    raise ArgumentError, 'must pass "config"' unless config
+    raise ArgumentError, 'must pass "config[:endpoint]"' unless config[:endpoint]
+    unless config[:endpoint].start_with?('http://') || config[:endpoint].start_with?('https://')
+      raise ArgumentError, '"config.endpoint" must starts with \'https://\' or \'http://\'.'
+    end
+    raise ArgumentError, 'must pass "config[:api_version]"' unless config[:api_version]
+    raise ArgumentError, 'must pass "config[:access_key_id]"' unless config[:access_key_id]
+    raise ArgumentError, 'must pass "config[:access_key_secret]"' unless config[:access_key_secret]
+  end
+end

data/spec/roa_cilent_integration_spec.rb

@@ -0,0 +1,34 @@
+require 'rspec'
+require 'roa_client'
+require 'webmock/rspec'
+
+describe 'roa request' do
+
+  WebMock.disable_net_connect!(allow: %r{ros.aliyuncs.com/regions})
+
+  let(:roa_client) do
+    ROAClient.new(
+      endpoint:          'http://ros.aliyuncs.com',
+      api_version:       '2015-09-01',
+      access_key_id:     ENV['ACCESS_KEY_ID'],
+      access_key_secret: ENV['ACCESS_KEY_SECRET'],
+      )
+  end
+
+  it 'request' do
+    response = roa_client.request(method: 'GET', uri: '/regions', options: { timeout: 15000 })
+    expect(JSON.parse(response.body).keys.include?('Regions')).to be true
+  end
+
+  it 'get should ok' do
+    response = roa_client.request(method: 'GET', uri: '/regions', options: { timeout: 10000 })
+    expect(JSON.parse(response.body).keys.include?('Regions')).to be true
+  end
+
+  it 'get raw body should ok' do
+    options  = { raw_body: true, timeout: 10000 }
+    response = roa_client.request(method: 'GET', uri: '/regions', options: options)
+    expect(response.body.instance_of? String).to be true
+  end
+
+end

data/spec/roa_client_spec.rb

@@ -0,0 +1,285 @@
+require 'rspec'
+require 'roa_client'
+require 'webmock/rspec'
+
+describe 'roa core' do
+
+  it 'should pass into "config"' do
+    expect {
+      ROAClient.new(nil)
+    }.to raise_error(ArgumentError, 'must pass "config"')
+  end
+
+  it 'should pass into "config[:endpoint]"' do
+    expect {
+      ROAClient.new({})
+    }.to raise_error(ArgumentError, 'must pass "config[:endpoint]"')
+  end
+
+  it 'should pass into valid "config[:endpoint]"' do
+    expect {
+      ROAClient.new(endpoint: 'ecs.aliyuncs.com/')
+    }.to raise_error(ArgumentError, '"config.endpoint" must starts with \'https://\' or \'http://\'.')
+  end
+
+  it 'should pass into "config[:api_version]"' do
+    expect {
+      ROAClient.new(endpoint: 'http://ecs.aliyuncs.com/')
+    }.to raise_error(ArgumentError, 'must pass "config[:api_version]"')
+  end
+
+  it 'should pass into "config[:access_key_id]"' do
+    expect {
+      ROAClient.new(endpoint: 'http://ecs.aliyuncs.com/', api_version: '1.0')
+    }.to raise_error(ArgumentError, 'must pass "config[:access_key_id]"')
+  end
+
+  it 'should pass into "config[:access_key_secret]"' do
+    expect {
+      ROAClient.new(endpoint: 'http://ecs.aliyuncs.com/', api_version: '1.0', access_key_id: 'access_key_id')
+    }.to raise_error(ArgumentError, 'must pass "config[:access_key_secret]"')
+  end
+
+  it 'should ok with http protocol' do
+    roa_client = ROAClient.new(
+      endpoint:          'http://ecs.aliyuncs.com/',
+      api_version:       '1.0',
+      access_key_id:     'access_key_id',
+      access_key_secret: 'access_key_secret'
+    )
+    expect(roa_client.endpoint).to eq('http://ecs.aliyuncs.com/')
+  end
+
+  it 'should ok with https protocol' do
+    roa_client = ROAClient.new(
+      endpoint:          'https://ecs.aliyuncs.com/',
+      api_version:       '1.0',
+      access_key_id:     'access_key_id',
+      access_key_secret: 'access_key_secret'
+    )
+    expect(roa_client.endpoint).to eq('https://ecs.aliyuncs.com/')
+  end
+
+  let(:roa_client) do
+    ROAClient.new(
+      endpoint:          'https://ecs.aliyuncs.com/',
+      api_version:       '1.0',
+      access_key_id:     'access_key_id',
+      access_key_secret: 'access_key_secret'
+    )
+  end
+
+  let(:default_header_keys) do
+    %w(accept date host
+        x-acs-signature-nonce
+        x-acs-signature-method
+        x-acs-signature-version
+        x-acs-version
+        x-sdk-client).map(&:to_sym)
+  end
+
+  it 'default headers should ok' do
+    expect(roa_client.default_headers.keys).to match_array(default_header_keys)
+    expect(roa_client.default_headers[:accept]).to eq('application/json')
+    expect(roa_client.default_headers[:date]).to match(/[A-Z][a-z]{2}, \d{2} [A-Z][a-z]{2} \d{4} \d{2}:\d{2}:\d{2} GMT/)
+    expect(roa_client.default_headers[:host]).to eq('ecs.aliyuncs.com')
+  end
+
+  it 'default_headers should ok with security_token' do
+
+    roa_client = ROAClient.new(
+      endpoint:          'https://ecs.aliyuncs.com/',
+      api_version:       '1.0',
+      access_key_id:     'access_key_id',
+      access_key_secret: 'access_key_secret',
+      security_token:    'security_token'
+    )
+
+    default_header_keys = %w(
+      accept
+      date
+      host
+      x-acs-signature-nonce
+      x-acs-signature-method
+      x-acs-signature-version
+      x-acs-version
+      x-sdk-client
+      x-acs-accesskey-id
+      x-acs-security-token
+    ).map(&:to_sym)
+
+    expect(roa_client.default_headers[:accept]).to eq('application/json')
+    expect(roa_client.default_headers.keys).to match_array(default_header_keys)
+    expect(roa_client.default_headers[:date]).to match(/[A-Z][a-z]{2}, \d{2} [A-Z][a-z]{2} \d{4} \d{2}:\d{2}:\d{2} GMT/)
+    expect(roa_client.default_headers[:accept]).to eq('application/json')
+  end
+
+  it 'request with raw body should ok' do
+    stub_request(:get, "https://ecs.aliyuncs.com/").to_return(body: 'raw body')
+    response = roa_client.request(method: 'GET', uri: '/', options: { raw_body: true })
+    expect(response.body).to eq('raw body')
+  end
+
+  it 'get request with raw body should ok' do
+    stub_request(:get, "https://ecs.aliyuncs.com/").to_return(body: 'raw body')
+    response = roa_client.get(uri: '/', options: { raw_body: true })
+    expect(response.body).to eq('raw body')
+  end
+
+  describe 'request with json response should ok' do
+    it 'json response should ok' do
+      stub_request(:get, "https://ecs.aliyuncs.com/")
+        .to_return(status: 200, headers: { 'Content-Type': 'application/json' }, body: { ok: true }.to_json)
+      response = roa_client.get(uri: '/')
+      expect(response.body).to eq({ ok: true }.to_json)
+    end
+  end
+
+  describe 'request(204) with json response should ok' do
+    it 'json response should ok' do
+      stub_request(:get, "https://ecs.aliyuncs.com/")
+        .to_return(status: 204, headers: { 'Content-Type': 'application/json' }, body: '')
+      response = roa_client.get(uri: '/')
+      expect(response.body).to eq('')
+    end
+  end
+
+  describe 'request(400) with json response should ok' do
+    let(:status) { 400 }
+    let(:headers) { { 'Content-Type': 'application/json' } }
+    let(:body) { { 'Message': 'error message', 'RequestId': 'requestid', 'Code': 'errorcode' }.to_json }
+    it 'json response should ok' do
+      stub_request(:get, "https://ecs.aliyuncs.com/")
+        .to_return(status: status, headers: headers, body: body)
+      expect {
+        roa_client.get(uri: '/')
+      }.to raise_error(StandardError, 'code: 400, error message requestid: requestid')
+    end
+  end
+
+  describe 'request with xml response should ok' do
+    let(:status) { 200 }
+    let(:headers) { { 'Content-Type': 'text/xml' } }
+    let(:body) do
+      <<-XML
+        <note>
+          <to>George</to>
+          <from>John</from>
+          <heading>Reminder</heading>
+          <body>Don't forget the meeting!</body>
+        </note>
+      XML
+    end
+    it 'xml response should ok' do
+      stub_request(:get, "https://ecs.aliyuncs.com/")
+        .to_return(status: status, headers: headers, body: body)
+      response = roa_client.get(uri: '/')
+      expect(response.body).to eq(body)
+    end
+  end
+
+  describe 'request(400) with xml response should ok' do
+    let(:status) { 400 }
+    let(:headers) { { 'Content-Type': 'text/xml' } }
+    let(:body) do
+      <<-XML
+        <Error>
+          <Message>error message</Message>
+          <RequestId>requestid</RequestId>
+          <HostId>hostid</HostId>
+          <Code>errorcode</Code>
+        </Error>
+      XML
+    end
+    it 'xml response should ok' do
+      stub_request(:get, "https://ecs.aliyuncs.com/")
+        .to_return(status: status, headers: headers, body: body)
+      expect {
+        roa_client.get(uri: '/')
+      }.to raise_error(ROAClient::ACSError, 'error message host_id: hostid, request_id: requestid')
+    end
+  end
+
+  describe 'request(200) with plain response should ok' do
+    it 'plain response should ok' do
+      stub_request(:get, "https://ecs.aliyuncs.com/").to_return(status: 200, body: 'plain text')
+      response = roa_client.get(uri: '/')
+      expect(response.body).to eq('plain text')
+    end
+  end
+
+  describe 'post should ok' do
+    it 'should ok' do
+      stub_request(:get, "https://ecs.aliyuncs.com/")
+        .to_return(status: 200, headers: { 'content-type': 'application/json' }, body: { ok: true }.to_json)
+      response = roa_client.post(uri: '/', body: 'text')
+      expect(response.body).to eq('{"ok":true}')
+    end
+    it 'should ok with query' do
+      stub_request(:get, "https://ecs.aliyuncs.com/?k=v")
+        .to_return(status: 200, headers: { 'content-type': 'application/json' }, body: { ok: true }.to_json)
+      response = roa_client.post(uri: '/', params: { k: 'v' }, body: 'text')
+      expect(response.body).to eq('{"ok":true}')
+    end
+  end
+
+  describe 'put should ok' do
+    it 'should ok' do
+      stub_request(:get, "https://ecs.aliyuncs.com/")
+        .to_return(status: 200, headers: { 'content-type': 'application/json' }, body: { ok: true }.to_json)
+      response = roa_client.put(uri: '/', body: 'text')
+      expect(response.body).to eq('{"ok":true}')
+    end
+  end
+
+  describe 'delete should ok' do
+    it 'should ok' do
+      stub_request(:get, "https://ecs.aliyuncs.com/")
+        .to_return(status: 200, headers: { 'content-type': 'application/json' }, body: { ok: true }.to_json)
+      response = roa_client.delete(uri: '/')
+      expect(response.body).to eq('{"ok":true}')
+    end
+  end
+
+  it 'signature should ok' do
+    expect(roa_client.send(:signature, '123456')).to eq('BeAYlq/e5iWAoTNmzf8jbcBxdq0=')
+  end
+
+  it 'authorization should ok' do
+    expect(roa_client.send(:authorization, '123456')).to eq('acs access_key_id:BeAYlq/e5iWAoTNmzf8jbcBxdq0=')
+  end
+
+  it 'canonicalized_headers should ok' do
+    expect(roa_client.send(:canonicalized_headers, {})).to be_empty
+    expect(roa_client.send(:canonicalized_headers, { key: 'value' })).to be_empty
+    expect(roa_client.send(:canonicalized_headers, { 'x-acs-key': 'value' })).to eq("x-acs-key:value\n")
+  end
+
+  it 'canonicalized_resource should ok' do
+    expect(roa_client.send(:canonicalized_resource, '/')).to eq('/')
+    expect(roa_client.send(:canonicalized_resource, '/', { key: 'value' })).to eq('/?key=value')
+    expect(roa_client.send(:canonicalized_resource, '/', { key: 'value', 'key1': 'value2' })).to eq('/?key=value&key1=value2')
+  end
+
+  it 'string_to_sign should ok ' do
+    expect(
+      roa_client.send(:string_to_sign, 'GET', '/', { accept: 'application/json' })
+    ).to eq("GET\napplication/json\n\n\n\n/")
+  end
+
+  describe 'ROAClient::ACSError class' do
+    it 'ACSError should ok' do
+      expect {
+        error_info = {
+          Message:   'error message',
+          Code:      'errorcode',
+          HostId:    'hostid',
+          RequestId: 'requestid',
+        }
+        raise ROAClient::ACSError, error_info.stringify_keys!
+      }.to raise_error(ROAClient::ACSError, 'error message host_id: hostid, request_id: requestid')
+    end
+  end
+
+
+end

data/spec/rpc_cilent_integration_spec.rb

@@ -0,0 +1,35 @@
+require 'rspec'
+require 'rpc_client'
+require 'webmock/rspec'
+
+describe 'rpc request' do
+
+  WebMock.disable_net_connect!(allow: %r{ecs.aliyuncs.com})
+
+  let(:rpc_client) do
+    RPCClient.new(
+      endpoint:          'https://ecs.aliyuncs.com',
+      api_version:       '2014-05-26',
+      access_key_id:     ENV['ACCESS_KEY_ID'],
+      access_key_secret: ENV['ACCESS_KEY_SECRET'],
+    )
+  end
+
+  it 'should ok' do
+    params         = { key: (1..11).to_a.map(&:to_s) }
+    request_option = { method: 'POST', timeout: 15000 }
+    response       = rpc_client.request(action: 'DescribeRegions', params: params, opts: request_option)
+    response_body  = JSON.parse(response.body)
+    expect(response_body.keys.include?('Regions')).to be true
+    expect(response_body.keys.include?('RequestId')).to be true
+  end
+
+  it 'should ok with repeat list less 10 item' do
+    params         = { key: (1..9).to_a.map(&:to_s) }
+    request_option = { method: 'POST', timeout: 15000 }
+    response       = rpc_client.request(action: 'DescribeRegions', params: params, opts: request_option)
+    response_body  = JSON.parse(response.body)
+    expect(response_body.keys.include?('Regions')).to be true
+    expect(response_body.keys.include?('RequestId')).to be true
+  end
+end

data/spec/rpc_client_spec.rb

@@ -0,0 +1,234 @@
+require 'rspec'
+require 'rpc_client'
+require 'webmock/rspec'
+
+describe 'rpc core' do
+
+  describe 'RPCClient' do
+    it 'should pass into "config"' do
+      expect {
+        RPCClient.new(nil)
+      }.to raise_error(ArgumentError, 'must pass "config"')
+    end
+
+    it 'should pass into "config[:endpoint]"' do
+      expect {
+        RPCClient.new({})
+      }.to raise_error(ArgumentError, 'must pass "config[:endpoint]"')
+    end
+
+    it 'should pass into valid "config[:endpoint]"' do
+      expect {
+        RPCClient.new(endpoint: 'ecs.aliyuncs.com/')
+      }.to raise_error(ArgumentError, '"config.endpoint" must starts with \'https://\' or \'http://\'.')
+    end
+
+    it 'should pass into "config[:api_version]"' do
+      expect {
+        RPCClient.new(endpoint: 'http://ecs.aliyuncs.com/')
+      }.to raise_error(ArgumentError, 'must pass "config[:api_version]"')
+    end
+
+    it 'should pass into "config[:access_key_id]"' do
+      expect {
+        RPCClient.new(endpoint: 'http://ecs.aliyuncs.com/', api_version: '1.0')
+      }.to raise_error(ArgumentError, 'must pass "config[:access_key_id]"')
+    end
+
+    it 'should pass into "config[:access_key_secret]"' do
+      expect {
+        RPCClient.new(endpoint: 'http://ecs.aliyuncs.com/', api_version: '1.0', access_key_id: 'access_key_id')
+      }.to raise_error(ArgumentError, 'must pass "config[:access_key_secret]"')
+    end
+
+    it 'should ok with http protocol' do
+      rpc_client = RPCClient.new(
+        endpoint:          'http://ecs.aliyuncs.com/',
+        api_version:       '1.0',
+        access_key_id:     'access_key_id',
+        access_key_secret: 'access_key_secret'
+      )
+      expect(rpc_client.endpoint).to eq('http://ecs.aliyuncs.com/')
+    end
+
+    it 'should ok with https protocol' do
+      rpc_client = RPCClient.new(
+        endpoint:          'https://ecs.aliyuncs.com/',
+        api_version:       '1.0',
+        access_key_id:     'access_key_id',
+        access_key_secret: 'access_key_secret'
+      )
+      expect(rpc_client.endpoint).to eq('https://ecs.aliyuncs.com/')
+    end
+
+    it 'should ok with codes' do
+      rpc_client = RPCClient.new(
+        endpoint:          'https://ecs.aliyuncs.com/',
+        api_version:       '1.0',
+        access_key_id:     'access_key_id',
+        access_key_secret: 'access_key_secret',
+        codes:             ['True']
+      )
+      expect(rpc_client.codes.include? 'True').to be true
+    end
+  end
+
+  describe 'default params' do
+
+    it 'should ok' do
+      rpc_client          = RPCClient.new(
+        endpoint:          'https://ecs.aliyuncs.com/',
+        api_version:       '1.0',
+        access_key_id:     'access_key_id',
+        access_key_secret: 'access_key_secret',
+      )
+      default_params_keys = %w(Format SignatureMethod SignatureNonce SignatureVersion Timestamp AccessKeyId Version)
+      expect(rpc_client.send(:default_params).stringify_keys.keys).to match_array default_params_keys
+    end
+  end
+
+  it 'should ok with securityToken' do
+    rpc_client          = RPCClient.new(
+      endpoint:          'https://ecs.aliyuncs.com/',
+      api_version:       '1.0',
+      access_key_id:     'access_key_id',
+      access_key_secret: 'access_key_secret',
+      security_token:    'security_token'
+    )
+    default_params_keys = %w(Format SignatureMethod SignatureNonce SignatureVersion Timestamp AccessKeyId Version SecurityToken)
+    expect(rpc_client.send(:default_params).stringify_keys.keys).to match_array default_params_keys
+  end
+
+  describe 'request' do
+    it 'get with raw body should ok' do
+      rpc_client = RPCClient.new(
+        endpoint:          'https://ecs.aliyuncs.com/',
+        api_version:       '1.0',
+        access_key_id:     'access_key_id',
+        access_key_secret: 'access_key_secret',
+      )
+      stub_request(:get, /https:\/\/ecs.aliyuncs.com/).to_return(status: 200, body: {}.to_json)
+      expect(rpc_client.request(action: 'action').body).to eq({}.to_json)
+    end
+  end
+
+  describe 'request with post' do
+
+    let(:rpc_client) do
+      RPCClient.new(
+        endpoint:          'https://ecs.aliyuncs.com/',
+        api_version:       '1.0',
+        access_key_id:     'access_key_id',
+        access_key_secret: 'access_key_secret',
+        security_token:    'security_token'
+      )
+    end
+
+    it 'should ok' do
+      stub_request(:get, /https:\/\/ecs.aliyuncs.com/).to_return(status: 200, body: {}.to_json)
+      expect(rpc_client.request(action: 'action').body).to eq({}.to_json)
+    end
+
+    it 'should ok with format_action' do
+      stub_request(:get, /https:\/\/ecs.aliyuncs.com/).to_return(status: 200, body: {}.to_json)
+      response = rpc_client.request(action: 'action', opts: { format_action: false })
+      expect(response.body).to eq({}.to_json)
+    end
+
+    it 'should ok with format_params' do
+      stub_request(:get, /https:\/\/ecs.aliyuncs.com/).to_return(status: 200, body: {}.to_json)
+      response = rpc_client.request(action: 'action', opts: { format_params: false })
+      expect(response.body).to eq({}.to_json)
+    end
+
+    it 'get with raw body should ok' do
+      stub_request(:post, "https://ecs.aliyuncs.com").to_return(status: 200, body: {}.to_json)
+      response = rpc_client.request(action: 'action', opts: { method: 'POST' })
+      expect(response.body).to eq({}.to_json)
+    end
+
+    it 'get with verbose should ok' do
+      stub_request(:get, /https:\/\/ecs.aliyuncs.com/).to_return(status: 200, body: {}.to_json)
+      response = rpc_client.request(action: 'action')
+      expect(response.status).to eq 200
+      expect(response.success?).to be true
+      expect(response.body).to eq({}.to_json)
+    end
+  end
+
+  describe 'request with error' do
+
+    let(:rpc_client) do
+      RPCClient.new(
+        endpoint:          'https://ecs.aliyuncs.com/',
+        api_version:       '1.0',
+        access_key_id:     'access_key_id',
+        access_key_secret: 'access_key_secret',
+      )
+    end
+
+    it 'request with 400 should ok' do
+      mock_response = { Code: 400, Message: 'error message' }.to_json
+      stub_request(:get, /https:\/\/ecs.aliyuncs.com/).to_return(status: 400, body: mock_response)
+      expect {
+        rpc_client.request(action: 'action')
+      }.to raise_error(StandardError, /error message, URL:/)
+    end
+  end
+
+  describe 'RPC private methods' do
+
+    let(:rpc_client) do
+      RPCClient.new(
+        endpoint:          'https://ecs.aliyuncs.com/',
+        api_version:       '1.0',
+        access_key_id:     'access_key_id',
+        access_key_secret: 'access_key_secret',
+        security_token:    'security_token'
+      )
+    end
+
+    it 'formatParams should ok' do
+      expect(rpc_client.send(:format_params, { foo: 1, bar: 2 })).to eq(Foo: 1, Bar: 2)
+    end
+
+    it 'encode should ok' do
+      expect(rpc_client.send(:encode, 'str')).to eq 'str'
+      expect(rpc_client.send(:encode, 'str\'str')).to eq 'str%27str'
+      expect(rpc_client.send(:encode, 'str(str')).to eq 'str%28str'
+      expect(rpc_client.send(:encode, 'str)str')).to eq 'str%29str'
+      expect(rpc_client.send(:encode, 'str*str')).to eq 'str%2Astr'
+    end
+
+    it 'replace_repeat_list should ok' do
+      expect(rpc_client.send(:replace_repeat_list, {}, 'key', [])).to eq({})
+      expect(rpc_client.send(:replace_repeat_list, {}, 'key', ['value'])).to eq({ 'key.1' => 'value' })
+      expect(rpc_client.send(:replace_repeat_list, {}, 'key', [{ :Domain => '1.com' }])).to eq({ 'key.1.Domain' => '1.com' })
+    end
+
+    it 'flat_params should ok' do
+      expect(rpc_client.send(:flat_params, {})).to eq({})
+      expect(rpc_client.send(:flat_params, { key: ['value'] })).to eq({ 'key.1' => 'value' })
+      expect(rpc_client.send(:flat_params, { key: 'value' })).to eq({ key: 'value' })
+      expect(rpc_client.send(:flat_params, { key: [{ Domain: '1.com' }] })).to eq({ 'key.1.Domain' => '1.com' })
+    end
+
+    it 'normalize should ok' do
+      expect(rpc_client.send(:normalize, {})).to be_empty
+      expect(rpc_client.send(:normalize, { key: ['value'] })).to match_array [%w(key.1 value)]
+      expect(rpc_client.send(:normalize, { key: 'value' })).to match_array [%w(key value)]
+      expect(rpc_client.send(:normalize, { key: [{ Domain: '1.com' }] })).to match_array [%w(key.1.Domain 1.com)]
+      expect(rpc_client.send(:normalize, { a: 'value', c: 'value', b: 'value' }))
+        .to match_array [%w(a value), %w(b value), %w(c value)]
+    end
+
+    it 'canonicalize should ok' do
+      expect(rpc_client.send(:canonicalize, [])).to be_empty
+      expect(rpc_client.send(:canonicalize, { foo: 1 })).to eq 'foo=1'
+      expect(rpc_client.send(:canonicalize, [['foo', 1]])).to eq 'foo=1'
+      expect(rpc_client.send(:canonicalize, { foo: 1, bar: 2 })).to eq 'foo=1&bar=2'
+      expect(rpc_client.send(:canonicalize, [['foo', 1], ['bar', 2]])).to eq 'foo=1&bar=2'
+    end
+  end
+
+end

data/spec/spec_helper.rb

@@ -0,0 +1,110 @@
+require 'simplecov'
+SimpleCov.start do
+  add_filter "/spec/"
+end
+
+if ENV['CI'] == 'true'
+  require 'codecov'
+  SimpleCov.formatter = SimpleCov::Formatter::Codecov
+end
+
+# This file was generated by the `rspec --init` command. Conventionally, all
+# specs live under a `spec` directory, which RSpec adds to the `$LOAD_PATH`.
+# The generated `.rspec` file contains `--require spec_helper` which will cause
+# this file to always be loaded, without a need to explicitly require it in any
+# files.
+#
+# Given that it is always loaded, you are encouraged to keep this file as
+# light-weight as possible. Requiring heavyweight dependencies from this file
+# will add to the boot time of your test suite on EVERY test run, even for an
+# individual file that may not need all of that loaded. Instead, consider making
+# a separate helper file that requires the additional dependencies and performs
+# the additional setup, and require it from the spec files that actually need
+# it.
+#
+# See http://rubydoc.info/gems/rspec-core/RSpec/Core/Configuration
+RSpec.configure do |config|
+  # rspec-expectations config goes here. You can use an alternate
+  # assertion/expectation library such as wrong or the stdlib/minitest
+  # assertions if you prefer.
+  config.expect_with :rspec do |expectations|
+    # This option will default to `true` in RSpec 4. It makes the `description`
+    # and `failure_message` of custom matchers include text for helper methods
+    # defined using `chain`, e.g.:
+    #     be_bigger_than(2).and_smaller_than(4).description
+    #     # => "be bigger than 2 and smaller than 4"
+    # ...rather than:
+    #     # => "be bigger than 2"
+    expectations.include_chain_clauses_in_custom_matcher_descriptions = true
+  end
+
+  # rspec-mocks config goes here. You can use an alternate test double
+  # library (such as bogus or mocha) by changing the `mock_with` option here.
+  config.mock_with :rspec do |mocks|
+    # Prevents you from mocking or stubbing a method that does not exist on
+    # a real object. This is generally recommended, and will default to
+    # `true` in RSpec 4.
+    mocks.verify_partial_doubles = true
+  end
+
+  # This option will default to `:apply_to_host_groups` in RSpec 4 (and will
+  # have no way to turn it off -- the option exists only for backwards
+  # compatibility in RSpec 3). It causes shared context metadata to be
+  # inherited by the metadata hash of host groups and examples, rather than
+  # triggering implicit auto-inclusion in groups with matching metadata.
+  config.shared_context_metadata_behavior = :apply_to_host_groups
+
+# The settings below are suggested to provide a good initial experience
+# with RSpec, but feel free to customize to your heart's content.
+=begin
+  # This allows you to limit a spec run to individual examples or groups
+  # you care about by tagging them with `:focus` metadata. When nothing
+  # is tagged with `:focus`, all examples get run. RSpec also provides
+  # aliases for `it`, `describe`, and `context` that include `:focus`
+  # metadata: `fit`, `fdescribe` and `fcontext`, respectively.
+  config.filter_run_when_matching :focus
+
+  # Allows RSpec to persist some state between runs in order to support
+  # the `--only-failures` and `--next-failure` CLI options. We recommend
+  # you configure your source control system to ignore this file.
+  config.example_status_persistence_file_path = "spec/examples.txt"
+
+  # Limits the available syntax to the non-monkey patched syntax that is
+  # recommended. For more details, see:
+  #   - http://rspec.info/blog/2012/06/rspecs-new-expectation-syntax/
+  #   - http://www.teaisaweso.me/blog/2013/05/27/rspecs-new-message-expectation-syntax/
+  #   - http://rspec.info/blog/2014/05/notable-changes-in-rspec-3/#zero-monkey-patching-mode
+  config.disable_monkey_patching!
+
+  # This setting enables warnings. It's recommended, but in some cases may
+  # be too noisy due to issues in dependencies.
+  config.warnings = true
+
+  # Many RSpec users commonly either run the entire suite or an individual
+  # file, and it's useful to allow more verbose output when running an
+  # individual spec file.
+  if config.files_to_run.one?
+    # Use the documentation formatter for detailed output,
+    # unless a formatter has already been configured
+    # (e.g. via a command-line flag).
+    config.default_formatter = "doc"
+  end
+
+  # Print the 10 slowest examples and example groups at the
+  # end of the spec run, to help surface which specs are running
+  # particularly slow.
+  config.profile_examples = 10
+
+  # Run specs in random order to surface order dependencies. If you find an
+  # order dependency and want to debug it, you can fix the order by providing
+  # the seed, which is printed after each run.
+  #     --seed 1234
+  config.order = :random
+
+  # Seed global randomization in this process using the `--seed` CLI option.
+  # Setting this allows you to use `--seed` to deterministically reproduce
+  # test failures related to randomization by passing the same `--seed` value
+  # as the one that triggered the failure.
+  Kernel.srand config.seed
+=end
+end

metadata

@@ -0,0 +1,98 @@
+--- !ruby/object:Gem::Specification
+name: aliyunsdkcore
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Alibaba Cloud SDK
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2019-03-13 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: codecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.1.10
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.1.10
+description: Alibaba Cloud Ruby Core SDK
+email:
+- sdk-team@alibabacloud.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- lib/roa_client.rb
+- lib/rpc_client.rb
+- spec/roa_cilent_integration_spec.rb
+- spec/roa_client_spec.rb
+- spec/rpc_cilent_integration_spec.rb
+- spec/rpc_client_spec.rb
+- spec/spec_helper.rb
+homepage: http://www.alibabacloud.com/
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.0.2
+signing_key: 
+specification_version: 4
+summary: Alibaba Cloud Ruby Core SDK
+test_files:
+- spec/roa_cilent_integration_spec.rb
+- spec/roa_client_spec.rb
+- spec/rpc_cilent_integration_spec.rb
+- spec/rpc_client_spec.rb
+- spec/spec_helper.rb