larrow-qingcloud 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 3d61865ed5e80afc2c62df279a97e2bf6953f103
+  data.tar.gz: d868ff45b35ca34d55e4abeef07cbf9babc8f9b8
+SHA512:
+  metadata.gz: f137a8bd083ceaf964f1bfb55daba5fee8e078f6ff1d696553eae4b3d4205cbc7a3b1799d91fb39aa702a235588ea099155a386ced6b795dd2923219127541f0
+  data.tar.gz: 9e150feb1132e7c6be0cf25e1f8120ccbc3530513ddc9752dd8f73f5b0fbcc91a191262ff3aade2c4473c6b4c753ce74fb148e3583a6fc51fa29e28cac9ba062

data/.gitignore

@@ -0,0 +1,21 @@
+*.gem
+*.rbc
+*.log
+**/*.swp
+.bundle
+.config
+.yardoc
+*.keys
+*.csv
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+tags

data/.rspec

@@ -0,0 +1,4 @@
+--colour
+--format documentation
+--fail-fast
+

data/.rubocop.yml

@@ -0,0 +1,60 @@
+# This configuration was generated by `rubocop --auto-gen-config`
+# on 2014-07-01 20:41:04 +0800 using RuboCop version 0.24.0.
+# The point is for the user to remove these configuration records
+# one by one as the offenses are removed from the code base.
+# Note that changes in the inspected code, or installation of new
+# versions of RuboCop, may require this file to be generated again.
+
+# Offense count: 1
+Lint/AmbiguousOperator:
+  Enabled: true
+
+# Offense count: 1
+Lint/Debugger:
+  Enabled: true
+
+# Offense count: 4
+Lint/Void:
+  Enabled: true
+
+# Offense count: 1
+Style/ClassVars:
+  Enabled: true
+
+# Offense count: 13
+Style/Documentation:
+  Enabled: false
+
+# Offense count: 1
+# Configuration parameters: EnforcedStyle, SupportedStyles.
+Style/DotPosition:
+  Enabled: true
+
+# Offense count: 4
+# Configuration parameters: EnforcedStyle, SupportedStyles.
+Style/FormatString:
+  Enabled: true
+
+# Offense count: 1
+# Configuration parameters: AllowedVariables.
+Style/GlobalVars:
+  Enabled: true
+
+# Offense count: 1
+# Configuration parameters: AllowURI.
+Style/LineLength:
+  Max: 136
+
+# Offense count: 7
+# Configuration parameters: CountComments.
+Style/MethodLength:
+  Max: 24
+
+# Offense count: 1
+# Configuration parameters: CountKeywordArgs.
+Style/ParameterLists:
+  Max: 7
+
+# Offense count: 2
+Style/RegexpLiteral:
+  MaxSlashes: 0

data/.ruby-version

@@ -0,0 +1 @@
+2.1

data/Gemfile

@@ -0,0 +1,10 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in larrow-qingcloud.gemspec
+gemspec
+group :test do
+  gem 'rspec'
+  gem 'pry'
+  gem 'pry-nav'
+  gem 'simplecov'
+end

data/Gemfile.lock

@@ -0,0 +1,69 @@
+PATH
+  remote: .
+  specs:
+    larrow-qingcloud (0.0.1)
+      promising (~> 0.3)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    activesupport (4.1.0)
+      i18n (~> 0.6, >= 0.6.9)
+      json (~> 1.7, >= 1.7.7)
+      minitest (~> 5.1)
+      thread_safe (~> 0.1)
+      tzinfo (~> 1.1)
+    coderay (1.1.0)
+    diff-lcs (1.2.5)
+    docile (1.1.3)
+    faraday (0.9.0)
+      multipart-post (>= 1.2, < 3)
+    i18n (0.6.9)
+    json (1.8.1)
+    method_source (0.8.2)
+    minitest (5.3.3)
+    multi_json (1.9.3)
+    multipart-post (2.0.0)
+    promising (0.3.1)
+    pry (0.9.12.6)
+      coderay (~> 1.0)
+      method_source (~> 0.8)
+      slop (~> 3.4)
+    pry-nav (0.2.3)
+      pry (~> 0.9.10)
+    rake (0.9.6)
+    rspec (3.0.0)
+      rspec-core (~> 3.0.0)
+      rspec-expectations (~> 3.0.0)
+      rspec-mocks (~> 3.0.0)
+    rspec-core (3.0.3)
+      rspec-support (~> 3.0.0)
+    rspec-expectations (3.0.3)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.0.0)
+    rspec-mocks (3.0.3)
+      rspec-support (~> 3.0.0)
+    rspec-support (3.0.3)
+    simplecov (0.8.2)
+      docile (~> 1.1.0)
+      multi_json
+      simplecov-html (~> 0.8.0)
+    simplecov-html (0.8.0)
+    slop (3.5.0)
+    thread_safe (0.3.3)
+    tzinfo (1.1.0)
+      thread_safe (~> 0.1)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  activesupport (~> 4.1)
+  bundler (~> 1.5)
+  faraday (~> 0)
+  larrow-qingcloud!
+  pry
+  pry-nav
+  rake (~> 0)
+  rspec
+  simplecov

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2014 lifu
+
+MIT License
+
+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,39 @@
+# Larrow::Qingcloud
+
+A simple wrapper for Qingcloud(IAAS)
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'larrow-qingcloud'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install larrow-qingcloud
+
+## Sample
+before use Qingcloud API, you should establish connection first:
+
+    Qingcloud.establish_connection <your_access_id>, <your_secret_key>
+
+* list images
+
+    images = Qingcloud::Image.describe
+
+* create and destroy instance
+
+    objs = Qingcloud::Instance.create count: 1
+    Qingcloud::Instance.destroy instance_ids: objs.map(&:instance_id)
+
+## Contributing
+
+1. Fork it ( http://github.com/<my-github-username>/larrow-qingcloud/fork )
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request

data/Rakefile

@@ -0,0 +1 @@
+require 'bundler/gem_tasks'

data/larrow-qingcloud.gemspec

@@ -0,0 +1,26 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'larrow/qingcloud/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'larrow-qingcloud'
+  spec.version       = Larrow::Qingcloud::VERSION
+  spec.authors       = ['fsword']
+  spec.email         = ['li.jianye@gmail.com']
+  spec.summary       = "qingcloud's ruby sdk, unofficial version"
+  spec.description   = 'access qingcloud with a simple way for ruby programmer'
+  spec.homepage      = 'http://github.com/fsword/larrow-qingcloud'
+  spec.license       = 'MIT'
+
+  spec.files         = `git ls-files -z`.split("\x0")
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ['lib']
+
+  spec.add_dependency 'promising', '~> 0.3'
+  spec.add_development_dependency 'bundler', '~> 1.5'
+  spec.add_development_dependency 'rake', '~> 0'
+  spec.add_development_dependency 'activesupport', '~> 4.1'
+  spec.add_development_dependency 'faraday', '~> 0'
+end

data/lib/larrow/qingcloud/base.rb

@@ -0,0 +1,139 @@
+require 'timeout'
+module Larrow
+  module Qingcloud
+    # base class for Qingcloud model
+    class Base
+      include Logger
+      attr_accessor :id, :status, :delegator
+
+      DESTROY_STATUSES = [:deleted, :ceased,:released]
+
+      def initialize(id,options={})
+        self.id = id
+        options.each_pair do |k,v|
+          self.send "#{k}=",v
+        end
+      end
+
+      # status always be symbol
+      def status= status
+        @status = status.nil? ? nil : status.to_sym
+      end
+
+      def conn
+        self.class.conn
+      end
+
+      def model_name
+        self.class.model_name
+      end
+
+      def show(params = {})
+        self.class.describe([self.id],params).first
+      end
+
+      # block method, should be delayed at caller function
+      def wait_for(status)
+        loop do
+          data = show
+          if data['status'].to_sym == status
+            info "#{model_name} status changed: #{id} - #{status}"
+            self.status = status
+            yield data if block_given?
+            break self
+          else
+            debug "#{model_name} wait for status: #{id} - #{data['status']}"
+          end
+          sleep 2
+        end
+      end
+
+      def self.conn
+        Qingcloud.connection
+      end
+
+      # just for state access, such as:
+      #   model.running?
+      # do not affect `respond_to?`
+      def method_missing(method, *args, &block)
+        if method.to_s.last == '?'
+          status == method.to_s[0..-2].to_sym
+        else
+          super
+        end
+      end
+
+      # multi names( used as param_name )
+      # KeyPair -> keypair -> keypairs
+      def self.model_name
+        name.split(/::/).last
+      end
+      def self.singular_name
+        name.split(/::/).last.downcase
+      end
+      def self.plural_name
+        name.split(/::/).last.downcase.pluralize
+      end
+
+      def param_by(*args)
+        self.class.param_by(*args)
+      end
+
+      def self.param_by(ids, init_params={})
+        ids.each_with_index.reduce(init_params) do |result, (id, index)|
+          result.update :"#{plural_name}.#{index + 1}" => id
+        end
+      end
+
+      # convert hash data to object when block given
+      def self.describe(ids, params)
+        params = param_by(ids, params)
+        datas = conn.service(
+          'get', "Describe#{model_name}s", params
+        )["#{singular_name}_set"]
+        if block_given?
+          datas.map do |data|
+            yield data
+          end
+        else
+          datas
+        end
+      end
+
+      # destroy method generator
+      #
+      # destroy can be called by end user, so it will return a future
+      def self.destroy_action(action)
+        define_method :destroy do
+          params = self.class.param_by [id]
+          future(timeout:90) do
+            loop do
+              begin
+                result = conn.get action, params
+                info "destroy #{self.class.name}: #{result}"
+                break result['ret_code'] == 0
+              rescue ServiceError => e
+                if e.message =~ /has already been deleted/
+                  break :already_deleted
+                else
+                  sleep 2
+                end
+              end
+            end
+          end
+        end
+        define_method :ensure_destroy do
+          params = self.class.param_by [id]
+          future(timeout:90) do
+            loop do
+              break true if DESTROY_STATUSES.include?(@status) 
+              conn.get action, params rescue nil
+              sleep 2
+              @status = show['status'].to_sym
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/larrow/qingcloud/connection.rb

@@ -0,0 +1,61 @@
+require 'faraday'
+require 'cgi'
+require 'openssl'
+require 'base64'
+require 'json'
+
+module Larrow
+  module Qingcloud
+    # Connection delegator for Qingcloud
+    class Connection
+      include Logger
+      URL_TEMPLATE = 'https://api.qingcloud.com/iaas/?%s&signature=%s'
+      attr_accessor :access_key, :secret_key, :zone_id
+
+      def initialize(access_key, secret_key, zone_id)
+        self.access_key = access_key
+        self.secret_key = secret_key
+        self.zone_id    = zone_id
+      end
+
+      def service(method, action, params = {})
+        # Time.new.iso8601 cannot be recognized
+        time_stamp = Time.new.utc.strftime '%Y-%m-%dT%TZ'
+        params.update(
+          zone: zone_id,
+          action: action,
+          time_stamp: time_stamp,
+          access_key_id: access_key,
+          version: 1,
+          signature_method: 'HmacSHA256',
+          signature_version: 1
+        )
+
+        request_str = params.keys.sort.map do |k|
+          "#{CGI.escape k.to_s}=#{CGI.escape params[k].to_s}"
+        end.join('&')
+
+        signed_text = format "%s\n/iaas/\n%s", method.upcase, request_str
+
+        signature = Base64.encode64(OpenSSL::HMAC.digest(
+          OpenSSL::Digest.new('sha256'), secret_key||'', signed_text
+        )).strip
+
+        url = format URL_TEMPLATE, request_str, CGI.escape(signature)
+        resp = Faraday.send(method.to_sym, url)
+        debug "API #{action} #{request_str}"
+
+        JSON.parse(resp.body).tap do |obj|
+          if obj['ret_code'] != 0
+            debug "Service Error(#{obj['ret_code']}): #{obj['message']}"
+            fail ServiceError, obj['message']
+          end
+        end
+      end
+
+      def get action, params = {}
+        service 'get', action, params
+      end
+    end
+  end
+end

data/lib/larrow/qingcloud/eip.rb

@@ -0,0 +1,41 @@
+module Larrow
+  module Qingcloud
+    # External address
+    class Eip < Base
+      attr_accessor :address
+      destroy_action 'ReleaseEips'
+
+      def self.create(bandwidth:1, count:1)
+        result = conn.service 'get', 'AllocateEips',
+                              bandwidth: bandwidth,
+                              count: count
+
+        info "EIP added: #{result['eips']}"
+        result['eips'].map do |id| 
+          promise(timeout:60){ new(id).wait_for :available }
+        end
+      end
+
+      def wait_for(status)
+        super do |data|
+          self.address = data['eip_addr']
+        end
+      end
+
+      def associate(instance_id)
+        conn.service 'get', 'AssociateEip',
+                     instance: instance_id,
+                     eip: id
+        promise(timeout:60){ wait_for :associated }
+      end
+
+      # cannot support batch dissociating
+      def dissociate(instance_id)
+        conn.service 'get', 'DissociateEips',
+                     :instance => instance_id,
+                     :'eips.1'  => id
+        promise(timeout:60){ wait_for :available }
+      end
+    end
+  end
+end

data/lib/larrow/qingcloud/errors.rb

@@ -0,0 +1,3 @@
+module Larrow::Qingcloud
+  ServiceError = Class.new(StandardError)
+end

data/lib/larrow/qingcloud/image.rb

@@ -0,0 +1,38 @@
+module Larrow
+  module Qingcloud
+    class Image < Base
+      attr_accessor :platform, :provider
+      destroy_action 'DeleteImages'
+
+      def self.list(provider=:system,ids:[])
+        describe(ids,{:provider => provider,:'status.1' => :available}) do |hash|
+          new hash['image_id'],
+            hash.slice('status','platform','provider')
+        end
+      end
+
+      def self.create instance_id
+        result = conn.get 'CaptureInstance', instance: instance_id
+        info "image created(instance: #{instance_id}): #{result}"
+        image = new result['image_id']
+        promise(timeout:90){ image.wait_for :available }
+      end
+
+      def self.create_from_snapshot snapshot_id
+        result = conn.get 'CaptureInstanceFromSnapshot', snapshot: snapshot_id
+        info "image created(snapshot: #{snapshot_id}): #{result}"
+        image = new result['image_id']
+        promise(timeout:90){ image.wait_for :available }
+      end
+      
+      def wait_for status
+        super do |data|
+          self.status = status
+          self.platform = data['platform']
+          self.provider = data['provider']
+        end
+      end
+
+    end
+  end
+end

data/lib/larrow/qingcloud/instance.rb

@@ -0,0 +1,78 @@
+module Larrow
+  module Qingcloud
+    class Instance < Base
+      attr_accessor :vxnet_id, :keypair_id
+
+      destroy_action 'TerminateInstances'
+
+      # return an array(running instance)
+      def self.create(image_id:nil,
+                      cpu:1,
+                      memory:1024,
+                      count:1, 
+                      login_mode: 'passwd',
+                      passwd:'1qaz@WSX', 
+                      keypair_id:nil, 
+                      vxnet_id:'vxnet-0')
+        err 'The default password is weak, you should change it'
+
+        image_id ||= 'trustysrvx64b'
+        
+        result = conn.service 'get', 'RunInstances',
+                              :image_id         => image_id,
+                              :cpu              => cpu,
+                              :memory           => memory,
+                              :count            => count,
+                              :login_mode       => login_mode,
+                              :login_passwd     => passwd,
+                              :'login_keypair'  => keypair_id,
+                              :'vxnets.n'       => vxnet_id
+
+        info "instance added: #{result['instances']}"
+        result['instances'].map do |id|
+          instance = new id,keypair_id: keypair_id,vxnet_id:vxnet_id
+          promise(timeout:90){ instance.wait_for :running }
+        end
+      end
+
+      def attach_keypair(keypair_id)
+        return self if self.keypair_id
+        conn.service 'get', 'AttachKeyPairs',
+                     :'instances.1' => id,
+                     :'keypairs.1'  => keypair_id
+        loop do
+          if show(verbose: 1)['keypair_ids'].count > 0
+            self.keypair_id = keypair_id
+            info "instance attach keypair: #{id}"
+            break self
+          end
+          sleep 2
+        end
+      end
+
+      def join_vxnet(vxnet_id = 'vxnet-0')
+        return self if self.vxnet_id
+        params = param_by [id], vxnet: vxnet_id
+        conn.service 'get', 'JoinVxnet', params
+        loop do
+          if show['vxnets'].size > 0
+            self.vxnet_id = vxnet_id
+            info "instance joined vxnet: #{id}"
+            break self
+          end
+          sleep 2
+        end
+      end
+
+      # return a delayed instance object
+      def stop force=nil
+        if force
+          conn.get 'StopInstances', :'instances.1' => id, :force => 1
+        else
+          conn.get 'StopInstances', :'instances.1' => id
+        end
+        promise(timeout:60){ wait_for :stopped }
+      end
+    end
+  end
+end

data/lib/larrow/qingcloud/key_pair.rb

@@ -0,0 +1,17 @@
+module Larrow
+  module Qingcloud
+    class KeyPair < Base
+      attr_accessor :id, :name
+      def self.list()
+        describe([],{}) do |hash|
+          new hash['keypair_id'],hash['keypair_name']
+        end
+      end
+
+      def initialize id,name
+        self.id = id
+        self.name = name
+      end
+    end
+  end
+end

data/lib/larrow/qingcloud/logger.rb

@@ -0,0 +1,51 @@
+require 'logger'
+module Larrow
+  module Qingcloud
+    def self.logger= logger
+      @@logger = logger
+    end
+    # Qingcloud logger
+    # default log file: $current_dir/qingcloud.log
+    module Logger
+      def self.included(base)
+        base.extend ClassMethods
+      end
+
+      module ClassMethods
+        def logger
+          @logger ||= begin
+                        if Qingcloud.class_variable_defined? '@@logger'
+                          Qingcloud.class_variable_get '@@logger'
+                        else
+                          ::Logger.new('qingcloud.log')
+                        end
+                      end
+        end
+
+        def debug(msg)
+          logger.debug msg
+        end
+
+        def info(msg)
+          logger.info msg
+        end
+
+        def err(msg)
+          logger.error msg
+        end
+      end
+
+      def debug(msg)
+        self.class.debug msg
+      end
+
+      def info(msg)
+        self.class.info msg
+      end
+
+      def err(msg)
+        self.class.err msg
+      end
+    end
+  end
+end

data/lib/larrow/qingcloud/snapshot.rb

@@ -0,0 +1,23 @@
+module Larrow
+  module Qingcloud
+    class Snapshot < Base
+      attr_accessor :resource
+
+      destroy_action 'DeleteSnapshots'
+
+      def self.list()
+        describe([],{:'status.1' => :available}) do |hash|
+          new hash['snapshot_id'], hash.slice('status','resource')
+        end
+      end
+
+      def self.create resource_id
+        result = conn.get 'CreateSnapshots', :'resources.1' => resource_id
+        info "snapshot added: #{result}"
+        result['snapshots'].map do |id|
+          promise(timeout:90){ new(id).wait_for :available }
+        end
+      end
+    end
+  end
+end

data/lib/larrow/qingcloud/version.rb

@@ -0,0 +1,5 @@
+module Larrow
+  module Qingcloud
+    VERSION = '0.0.1'
+  end
+end

data/lib/larrow/qingcloud.rb

@@ -0,0 +1,32 @@
+require 'active_support/deprecation'
+require 'active_support/core_ext/string'
+require 'active_support/core_ext/hash'
+require 'promising'
+
+module Larrow
+  # Qingcloud ruby sdk
+  module Qingcloud
+    def self.establish_connection(access_key, secret_key, zone_id)
+      @connection ||= Connection.new access_key, secret_key, zone_id
+    end
+
+    def self.remove_connection
+      @connection = nil
+    end
+
+    class << self
+      attr_reader :connection
+    end
+    autoload :Instance, 'larrow/qingcloud/instance'
+    autoload :Eip,      'larrow/qingcloud/eip'
+    autoload :Image,    'larrow/qingcloud/image'
+    autoload :Snapshot, 'larrow/qingcloud/snapshot'
+    autoload :KeyPair, 'larrow/qingcloud/key_pair'
+  end
+end
+
+require 'larrow/qingcloud/version'
+require 'larrow/qingcloud/logger'
+require 'larrow/qingcloud/errors'
+require 'larrow/qingcloud/connection'
+require 'larrow/qingcloud/base'

data/spec/base_spec.rb

@@ -0,0 +1,17 @@
+require 'spec_helper.rb'
+
+module Larrow
+  module Qingcloud
+    describe Base do
+      it 'param_by' do
+        expect(Base.param_by %w(a b c), 
+               key: 'somevalue'
+              ).to eq(:'bases.1' => 'a',
+                      :'bases.2' => 'b',
+                      :'bases.3' => 'c',
+                      :key       => 'somevalue'
+                     )
+      end
+    end
+  end
+end

data/spec/image_spec.rb

@@ -0,0 +1,40 @@
+require_relative 'spec_helper'
+
+module Larrow::Qingcloud
+  describe Image do
+
+    let(:base_image) do
+      Image.list.select do |i| 
+        i.status == :available and i.platform == 'linux'
+      end.first
+    end
+
+    it 'list not empty' do
+      expect(Image.list).not_to be_empty
+    end
+
+    it 'capture instance' do
+      instance = Instance.
+        create(image_id: base_image.id).
+        first.
+        stop(true)
+      new_image = Image.create instance.id
+      expect(new_image.status).to eq :available
+      
+      expect(instance.destroy).to be true
+      expect(new_image.destroy).to be true
+    end
+
+    it 'create from snapshot' do
+      instance = Instance.
+        create(image_id: base_image.id).
+        first
+      snapshot = Snapshot.create(instance.id).first
+      new_image = Image.create_from_snapshot snapshot.id
+
+      expect(instance.destroy).to be true
+      expect(snapshot.destroy).to be true
+      expect(new_image.destroy).to be true
+    end
+  end
+end

data/spec/key_pair_spec.rb

@@ -0,0 +1,11 @@
+require_relative 'spec_helper'
+
+module Larrow::Qingcloud
+  describe KeyPair do
+
+    it 'list not empty' do
+      expect(KeyPair.list).not_to be_empty
+    end
+
+  end
+end

data/spec/simple_story_spec.rb

@@ -0,0 +1,21 @@
+require 'spec_helper.rb'
+
+module Larrow::Qingcloud
+  describe 'simple story' do
+    it 'use_instance_by_password' do
+      # create instance and eip
+      instance = Instance.create.first
+      eip = Eip.create.first
+
+      # bind eip to instance
+      eip = eip.associate instance.id
+      eip = eip.dissociate instance.id
+
+      # destroy instance and eip
+      expect(instance.destroy.force).to be true
+      expect(eip.ensure_destroy).to be true
+      expect(eip.destroy).to eq(:already_deleted)
+      expect(eip.ensure_destroy).to be true
+    end
+  end
+end

data/spec/snapshot_spec.rb

@@ -0,0 +1,26 @@
+require_relative 'spec_helper'
+
+module Larrow::Qingcloud
+  describe Snapshot do
+    let(:base_image) do
+      Image.list.select do |i| 
+        i.status == :available and i.platform == 'linux'
+      end.first
+    end
+
+    it 'list not fail' do
+      expect{Snapshot.list}.not_to raise_error
+    end
+
+    it 'create snapshot' do
+      instance = Instance.
+        create(image_id: base_image.id).
+        first
+      snapshot = Snapshot.create(instance.id).first
+      expect(snapshot.status).to eq :available
+      
+      expect(instance.destroy).to be true
+      expect(snapshot.destroy).to be true
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,32 @@
+$LOAD_PATH << File.expand_path('../../lib', __FILE__)
+require 'larrow/qingcloud'
+require 'pry'
+require 'pry-nav'
+require 'simplecov'
+require 'yaml'
+SimpleCov.start
+
+module Helpers
+  extend self
+  include Larrow
+
+  def load_by_default
+    args = read_content_as_hash
+    [args['qy_access_key_id'],
+     args['qy_secret_access_key'], 
+     args['zone_id']]
+  end
+
+  def read_content_as_hash
+    file = "#{ENV['HOME']}/.larrow"
+    fail "cannot find keyfile: #{file}" unless File.exist?(file)
+    YAML.load(File.read file)['qingcloud']
+  end
+  
+  def establish_connection
+    access, secret, zone_id = load_by_default
+    Qingcloud.establish_connection access, secret, zone_id
+  end
+end
+
+Helpers.establish_connection

metadata

@@ -0,0 +1,147 @@
+--- !ruby/object:Gem::Specification
+name: larrow-qingcloud
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- fsword
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-10-06 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: promising
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.3'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.3'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.5'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.5'
+- !ruby/object:Gem::Dependency
+  name: rake
+  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: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.1'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.1'
+- !ruby/object:Gem::Dependency
+  name: faraday
+  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'
+description: access qingcloud with a simple way for ruby programmer
+email:
+- li.jianye@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- ".rubocop.yml"
+- ".ruby-version"
+- Gemfile
+- Gemfile.lock
+- LICENSE.txt
+- README.md
+- Rakefile
+- larrow-qingcloud.gemspec
+- lib/larrow/qingcloud.rb
+- lib/larrow/qingcloud/base.rb
+- lib/larrow/qingcloud/connection.rb
+- lib/larrow/qingcloud/eip.rb
+- lib/larrow/qingcloud/errors.rb
+- lib/larrow/qingcloud/image.rb
+- lib/larrow/qingcloud/instance.rb
+- lib/larrow/qingcloud/key_pair.rb
+- lib/larrow/qingcloud/logger.rb
+- lib/larrow/qingcloud/snapshot.rb
+- lib/larrow/qingcloud/version.rb
+- spec/base_spec.rb
+- spec/image_spec.rb
+- spec/key_pair_spec.rb
+- spec/simple_story_spec.rb
+- spec/snapshot_spec.rb
+- spec/spec_helper.rb
+homepage: http://github.com/fsword/larrow-qingcloud
+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.2.2
+signing_key: 
+specification_version: 4
+summary: qingcloud's ruby sdk, unofficial version
+test_files:
+- spec/base_spec.rb
+- spec/image_spec.rb
+- spec/key_pair_spec.rb
+- spec/simple_story_spec.rb
+- spec/snapshot_spec.rb
+- spec/spec_helper.rb