qcloud_ruby 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 5e915b09303dd0d98a6e458390648e58926933cf
+  data.tar.gz: bd881c7c31a9e75d775125cce700a72659c59d4b
+SHA512:
+  metadata.gz: 475d18739db7712ee554e5bc6567069d366e0aad16c3dd23c019775291799a736636a5714ed522b29cd6ac0a7b13b060d81797a3deb5ee0eab3761d3d8a08f3a
+  data.tar.gz: 6ef8a00d4ea1551d6e6ae7a79381b664ab2163023c7caa1bd3d1b3318fb1b88fc9fc8ecaf73b1a58c7fad9aae63915f9a191b307522c8b3def33e9f1e74b6794

data/.gitignore

@@ -0,0 +1,9 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/

data/.travis.yml

@@ -0,0 +1,5 @@
+sudo: false
+language: ruby
+rvm:
+  - 2.4.0
+before_install: gem install bundler -v 1.14.6

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in qcloud_ruby.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2017 aiasfina
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,47 @@
+An unofficial Tencent Qcloud API SDK for Ruby
+==================================
+
+安装
+----
+
+```bash
+gem install qcloud_ruby
+```
+
+使用
+----
+
+1.	使用之前请在腾讯云的[云 API 控制台](https://console.qcloud.com/capi)中创建自己的安全凭证(SecretId 和 SecretKey). SecretKey 要严格保管, 避免泄露.
+2.	安装并引入本 SDK.
+
+示例
+----
+
+```ruby
+::QcloudRuby.configure do |config|
+  config.secret_id = 'Secret id'
+  config.secret_key = 'Secret key'
+end
+
+resp = ::QcloudRuby.post(
+  service_type: ::QcloudRuby::ServiceType::ACCOUNT,
+  region: 'gz',
+  action: 'DescribeProject'
+)
+
+resp = ::QcloudRuby.get(
+  service_type: ::QcloudRuby::ServiceType::CVM,
+  region: 'gz',
+  action: 'DescribeInstances'
+)
+```
+
+SDK API
+-------
+
+请访问 [api.md](./api.md)
+
+资源
+----
+
+-	[API 列表](https://www.qcloud.com/doc/api)

data/Rakefile

@@ -0,0 +1,10 @@
+require "bundler/gem_tasks"
+require "rake/testtask"
+
+Rake::TestTask.new(:test) do |t|
+  t.libs << "test"
+  t.libs << "lib"
+  t.test_files = FileList['test/**/*_test.rb']
+end
+
+task :default => :test

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "qcloud_ruby"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require "irb"
+IRB.start(__FILE__)

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/lib/qcloud_ruby.rb

@@ -0,0 +1,31 @@
+module QcloudRuby
+  class << self
+    attr_accessor :configuration
+  end
+
+  def self.configure
+    @configuration ||= ::QcloudRuby::Configuration.new
+    yield @configuration
+  end
+
+  def self.get(service_type: nil, **params)
+    client = ::QcloudRuby::Client.new do |c|
+      c.service_type = service_type
+    end
+
+    client.request(method: 'GET', **params)
+  end
+
+  def self.post(service_type: nil, **params)
+    client = ::QcloudRuby::Client.new do |c|
+      c.service_type = service_type
+    end
+    
+    client.request(method: 'POST', **params)
+  end
+end
+
+require "qcloud_ruby/service_type"
+require "qcloud_ruby/configuration"
+require "qcloud_ruby/client"
+require "qcloud_ruby/version"

data/lib/qcloud_ruby/client.rb

@@ -0,0 +1,89 @@
+require 'forwardable'
+require 'uri'
+require 'openssl'
+require 'base64'
+require 'net/http'
+
+module QcloudRuby
+  class Client
+    extend Forwardable
+
+    attr_accessor :service_type
+
+    def initialize(&block)
+      self.instance_eval(&block)
+    end
+
+    def default_params(region, action)
+      {
+        Region: region,
+        Action: action,
+        SecretId: secret_id,
+        Timestamp: timestamp,
+        Nonce: nonce,
+        RequestClient: identity
+      }
+    end
+
+    def gen_data(method, region, action, other_params)
+      params = default_params(region, action)
+                .merge!(other_params)
+                .sort
+                .to_h
+
+      query_str = URI.encode_www_form(params)
+
+      params.merge!(Signature: sign(method, query_str))
+    end
+
+    def request(method: 'POST', region: nil, action: nil, **other_params)
+      data = gen_data(method, region, action, other_params)
+      uri = URI(url_with_protocol)
+
+      resp = if method == 'GET'
+              uri.query = URI.encode_www_form(data)
+              Net::HTTP.get_response(uri)
+            else
+              Net::HTTP.post_form(uri, data)
+            end
+
+      resp
+    end
+
+    def timestamp
+      Time.now.to_i
+    end
+
+    def nonce
+      (rand() * 65535).round
+    end
+
+    def identity
+      "SDK_RUBY_#{::QcloudRuby::VERSION}"
+    end
+
+    def host
+      "#{service_type}.#{base_host}"
+    end
+
+    def url
+      "#{host}#{path}"
+    end
+
+    def url_with_protocol
+      "#{protocol}://#{url}"
+    end
+
+    def sign(method, query)
+      source = method + url + '?' + query
+
+      Base64.encode64(OpenSSL::HMAC.digest(
+        OpenSSL::Digest.new('sha1'),
+        secret_key, source))
+      .strip
+    end
+
+    def_delegators :'QcloudRuby.configuration',
+      :protocol, :secret_id, :secret_key, :base_host, :path
+  end
+end

data/lib/qcloud_ruby/configuration.rb

@@ -0,0 +1,20 @@
+require 'digest/sha1'
+require 'base64'
+
+module QcloudRuby
+  class Configuration
+    attr_accessor :base_host, :ssl, :path, :secret_id, :secret_key
+
+    def initialize
+      @base_host = 'api.qcloud.com'
+      @path      = '/v2/index.php'
+      @ssl       = true
+    end
+
+    def protocol
+      ssl? ? 'https' : 'http'
+    end
+
+    alias_method :ssl?, :ssl
+  end
+end

data/lib/qcloud_ruby/service_type.rb

@@ -0,0 +1,9 @@
+module QcloudRuby
+  module ServiceType
+    CVM     = 'cvm'.freeze
+    VPC     = 'vpc'.freeze
+    DFW     = 'dfw'.freeze
+    LB      = 'lb'.freeze
+    ACCOUNT = 'account'.freeze
+  end
+end

data/lib/qcloud_ruby/version.rb

@@ -0,0 +1,3 @@
+module QcloudRuby
+  VERSION = "0.1.0"
+end

data/qcloud_ruby.gemspec

@@ -0,0 +1,24 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'qcloud_ruby/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "qcloud_ruby"
+  spec.version       = QcloudRuby::VERSION
+  spec.authors       = ["aiasfina"]
+  spec.email         = ["aiasfina@gmail.com"]
+
+  spec.summary       = %q{An unofficial Tencent Qcloud API SDK for Ruby.}
+  spec.description   = %q{An unofficial Tencent Qcloud API SDK for Ruby.}
+  spec.homepage      = "https://github.com/aiasfina/qcloud_ruby"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files`.split($/)
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.14"
+  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency "minitest", "~> 5.0"
+end

data/test/qcloud_ruby_test.rb

@@ -0,0 +1,59 @@
+require 'test_helper'
+require 'json'
+
+class QcloudRubyTest < Minitest::Test
+  def setup
+    ::QcloudRuby.configure do |config|
+      config.secret_id = 'Secret id'
+      config.secret_key = 'Secret key'
+    end
+  end
+
+  def test_url
+    client = ::QcloudRuby::Client.new do |c|
+      c.service_type = ::QcloudRuby::ServiceType::CVM
+    end
+
+    assert_equal 'cvm.api.qcloud.com/v2/index.php', client.url
+  end
+
+  def test_post_should_be_work
+    resp = ::QcloudRuby.post(
+      service_type: ::QcloudRuby::ServiceType::ACCOUNT,
+      region: 'gz',
+      action: 'DescribeProject'
+    )
+
+    assert_equal 0, JSON.parse(resp.body).fetch('code')
+  end
+
+  def test_get_should_be_work
+    resp = ::QcloudRuby.get(
+      service_type: ::QcloudRuby::ServiceType::CVM,
+      region: 'gz',
+      action: 'DescribeInstances'
+    )
+
+    assert_equal 0, JSON.parse(resp.body).fetch('code')
+  end
+
+  def test_with_unknow_region
+    resp = ::QcloudRuby.post(
+      service_type: ::QcloudRuby::ServiceType::CVM,
+      region: 'unknow',
+      action: 'DescribeInstances'
+    )
+
+    refute_equal 0, JSON.parse(resp.body).fetch('code')
+  end
+
+  def test_with_unknow_service_type
+    resp = ::QcloudRuby.post(
+      service_type: ::QcloudRuby::ServiceType::LB,
+      region: 'gz',
+      action: 'DescribeInstances'
+    )
+
+    refute_equal 0, JSON.parse(resp.body).fetch('code')
+  end
+end

data/test/test_helper.rb

@@ -0,0 +1,4 @@
+$LOAD_PATH.unshift File.expand_path('../../lib', __FILE__)
+require 'qcloud_ruby'
+
+require 'minitest/autorun'

metadata

@@ -0,0 +1,102 @@
+--- !ruby/object:Gem::Specification
+name: qcloud_ruby
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- aiasfina
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2017-05-01 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.14'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.14'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+description: An unofficial Tencent Qcloud API SDK for Ruby.
+email:
+- aiasfina@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".travis.yml"
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/console
+- bin/setup
+- lib/qcloud_ruby.rb
+- lib/qcloud_ruby/client.rb
+- lib/qcloud_ruby/configuration.rb
+- lib/qcloud_ruby/service_type.rb
+- lib/qcloud_ruby/version.rb
+- qcloud_ruby.gemspec
+- test/qcloud_ruby_test.rb
+- test/test_helper.rb
+homepage: https://github.com/aiasfina/qcloud_ruby
+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: []
+rubyforge_project: 
+rubygems_version: 2.6.11
+signing_key: 
+specification_version: 4
+summary: An unofficial Tencent Qcloud API SDK for Ruby.
+test_files: []