qc.rb 0.0.1 → 0.0.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 4580a07ef6b2a0ce936e3044b00dc5d1d6d1b777
-  data.tar.gz: 5eb71554537db1e81fef56c5e337dc7a72859c06
+  metadata.gz: 5dccf331efcb29098e651c3865f5d4d63f019586
+  data.tar.gz: 066553273f56fcbd831063096393b7bced68ce9c
 SHA512:
-  metadata.gz: 673d374b1847215fea439935597aadde90e9b25b7ac29b347dbc889203752f1a12d22712ef443ca3651c400210859ff17177fa6257a10841afc7ba962bfe1c8c
-  data.tar.gz: fa0e2d2b7bdb3dd6133745e72517451a6b73c177d95ea3e8145f88d5ccda80e14a0babd3bcb49928d5b261bd4d2dd961a441af08dc7e2fba31631dfc6e6d1681
+  metadata.gz: 1a25f3e039f696056512a592178509232ade5119662f25eb12f1473d4a1c722d89813cbf809b8f648364ee5f467cf84d5a3c1ecd2269ed14ab443a0700b08077
+  data.tar.gz: 4060d4ae2a012ec7ad54ba05763cd7b0a12812948b31730f929be7cbc6714ee843b607af14e8ed93c659d9751800f5e0d6d9f251088c1b5d3f8db55a25ced1fb

data/README.md

@@ -2,3 +2,129 @@ qc.rb
 =====
 
 QingCloud API Library to handle instances, networks, etc. on QingCloud.com
+
+### Installation
+
+You can install *qc.rb* via RubyGems:
+
+```bash
+gem install qc.rb
+```
+
+### Important Notice
+
+I'm not a native chinese speaker! Yet the complete documentation of QingCloud.com is in chinese! Due to that it is reasonable to expect that my understanding of the API might not be 100% correct! You are very welcome to improve the code!
+
+### Usage
+
+You can use *qc.rb* via *qc* as a CLI or direct as a Ruby library.
+
+#### SSH
+
+Get all public keys:
+
+CLI Version:
+
+```bash
+qc ssh describe
+```
+
+.rb Version:
+
+```ruby
+# Each Public Key is available in *s*
+QC::KeyPair.describe {|s| puts s}
+```
+
+#### Instances
+
+Get all instances:
+
+CLI Version:
+
+```bash
+qc ins describe
+```
+
+.rb Version:
+
+```ruby
+# Each instance is available in *i*
+QC::Instance.describe {|i| puts i}
+```
+
+Create new Instance:
+
+```ruby
+QC::Instance.run instance_name: 'NameOfInstance', login_keypair: 'kp-sadasd67' # => instance_id
+```
+
+Delete Instance:
+
+```ruby
+i = QC::Instance.load 'i-adssad7'
+i.terminate! # => {"action"=>"TerminateInstancesResponse", "job_id"=>"j-asd7djk", "ret_code"=>0}
+```
+
+Add IP device to Instance:
+
+```ruby
+i = QC::Instance.load 'i-adssad7'
+i.ip = 'eip-sadjkdsa7'  # => 'eip-sadjkdsa7'
+```
+
+#### IPs
+
+Get all IPs:
+
+CLI Version:
+
+```bash
+qc ip describe
+```
+
+.rb Version:
+
+```ruby
+# Each IP is available in *i*
+QC::Eip.describe {|i| puts i}
+```
+
+Allocate new IP:
+
+```ruby
+# Create IP width bandwidth 3MB
+Eip.allocate bandwidth: 3   # => eip_id
+```
+
+Release IP:
+
+```ruby
+# Release IP with ID 'eip-12djpg8q'
+Eip.load('eip-12djpg8q').release!   # => true | false
+```
+
+Change Bandwidth:
+
+```ruby
+# Change bandwidth of IP with ID 'eip-12djpg8q' to 2MB
+ip = Eip.load('eip-12djpg8q')
+ip.bandwidth = 2     # => 2
+```
+
+#### Volumes
+
+Get all Volumes:
+
+CLI Version:
+
+```bash
+qc vol describe
+```
+
+.rb Version:
+
+```ruby
+# Each Volume is available in *v*
+QC::Volume.describe {|v| puts v}
+```

data/bin/qc

@@ -1,6 +1,6 @@
 #!/usr/bin/env ruby
 
-require 'qc'
+require "#{File.dirname(__FILE__)}/../lib/qc.rb"
 
 def help_header cmd, options
   <<HEADER
@@ -16,24 +16,53 @@ HEADER
 end
 
 case ARGV[0]
+when 'vol'
+  case ARGV[1]
+  when 'describe'
+    QC::Volume.describe {|v| puts v}
+  else
+    puts help_header('vol [option]', <<HELP)
+  describe     List all volumes
+HELP
+  end
 when 'ssh'
   case ARGV[1]
-  when 'list'
-    QC::SSH.each {|s| puts s}
+  when 'describe'
+    QC::KeyPair.describe {|s| puts s}
   else
     puts help_header('ssh [option]', <<HELP)
-  list     List all public keys  
+  describe     List all public keys  
 HELP
   end
 when 'ins'
   case ARGV[1]
-  when 'list'
-    QC::Instance.each {|s| puts s}
+  when 'describe'
+    QC::Instance.describe {|i| puts i}
   else
     puts help_header('ins [option]', <<HELP)
-  list     List all machines 
+  describe     List all machines 
+HELP
+  end
+when 'ip'
+  case ARGV[1]
+  when 'describe'
+    QC::Eip.describe {|s| puts s}
+  else
+    puts help_header('ip [option]', <<HELP)
+  describe     List all IPs  
 HELP
   end
+
+when 'img'
+  case ARGV[1]
+  when 'describe'
+    QC::Image.describe.sort.each {|s| puts s}
+  else
+    puts help_header('img [option]', <<HELP)
+  describe     List all Images
+HELP
+  end
+
 else
   puts help_header('[option]', <<HELP)
   ssh      SSH Key Management

data/lib/qc.rb

@@ -7,7 +7,7 @@ require 'yaml'
 require 'fileutils'
 
 module QC
-  VERSION = '0.0.1'
+  VERSION = '0.0.2'
 
   def QC.load_config key
     f = File.expand_path('~/.qingcloud/config.yaml')
@@ -56,58 +56,135 @@ module QC
     url_b64_hmac = CGI.escape(b64_hmac)
   end
 
-  class SSH
-    def initialize s
-      @id = s['keypair_id']
-      @name = s['keypair_name']
-      @date = s['create_time']
-      @e_method = s['encrypt_method']
-      @desc = s['description']
-      @key = s['pub_key']
+  class DataType
+    attr_reader :result
+
+    @identifier = 'NOT_IMPLEMENTED'
+
+    def initialize h
+      @values = h
     end
 
     def to_s
-      <<STR
-ID:                "#{@id}"
-Name:              "#{@name}"
-Creation Date:     "#{@date}"
-Encryption Method: "#{@e_method}"
-Description:       "#{@desc}"
-Public Key:
-"#{@key}"
-STR
+      @values.to_yaml
+    end
+
+    def method_missing met
+      if @values.has_key? met.to_s
+        @values[met.to_s]
+      else
+        raise NoMethodError.new "undefined method `#{met}'"
+      end
+    end
+
+    def self.describe p = {}, &block
+      req = QC::API::Request.new "Describe#{@identifier}s", p
+      @result = req.execute!(QC::Key)
+      if block_given?
+        @result["#{@identifier.downcase}_set"].to_a.each {|s| block.call(self.new(s))}
+      else
+        @result["#{@identifier.downcase}_set"].to_a.map {|s| self.new(s)}
+      end
+    end
+  end
+
+  class KeyPair < DataType
+    @identifier = 'KeyPair'
+  end
+
+  class Instance < DataType
+    @identifier = 'Instance'
+
+    def Instance.run p = {image_id: 'precisex64a', instance_name: nil, count: 1, login_mode: 'keypair',
+                          login_keypair: nil, login_passwd: nil, security_group: nil, zone: nil, instance_type: 'small_b'}
+      p[:image_id] = 'precisex64a' if p[:image_id].nil?
+      p[:login_mode] = 'keypair' if p[:login_mode].nil?
+      p[:instance_type] = 'small_b' if p[:instance_type].nil?
+      p['vxnets.1'] = 'vxnet-0' if p['vxnets.1'].nil?
+      ret = API::Request.execute! 'RunInstances', p
+      ret['instances']
+    end
+
+    def Instance.load instance_id
+      Instance.describe('instances.1' => instance_id)[0]
+    end
+
+    def terminate!
+      p = {'instances.1' => @values['instance_id']}
+      API::Request.execute!('TerminateInstances', p)
+    end
+
+    def ip= eip_id
+      p = {'instance' => @values['instance_id'], 'eip' => eip_id}
+      API::Request.execute!('AssociateEip', p)
+    end
+  end
+
+  class Volume < DataType
+    @identifier = 'Volume'
+  end
+
+  class Eip < DataType
+    @identifier = 'Eip'
+
+    def Eip.allocate p = {bandwidth: 1, eip_name: nil, count: 1, need_icp: nil, zone: nil}
+      ret = API::Request.execute! 'AllocateEips', p
+      if ret.respond_to? :has_key?
+        ret['eips']
+      else
+        false
+      end
+    end
+
+    def Eip.release eips: [], zone: nil
+      if eips.size > 0
+        p = {}
+        1.upto(eips.size).each { |i| p["eips.#{i}"] = eips[i-1] }
+        p[:zone] = zone
+        API::Request.execute!('ReleaseEips', p)
+      else
+        false
+      end
     end
 
-    def SSH.each &block
-      r = QC::API::Request.new 'DescribeKeyPairs'
-      r.execute!(QC::Key)['keypair_set'].to_a.each {|s| block.call(SSH.new(s))}
+    def Eip.load eip_id
+      Eip.describe('eips.1' => eip_id)[0]
+    end
+
+    def bandwidth= b
+      p = {'eips.1' => @values['eip_id'], 'bandwidth' => b}
+      ret = API::Request.execute!('ChangeEipsBandwidth', p)
+      if ret.respond_to? :has_key?
+        b
+      else
+        false
+      end
+    end
+
+    def release!
+      p = {'eips.1' => @values['eip_id']}
+      API::Request.execute!('ReleaseEips', p)
     end
   end
 
-  class Instance
-    def initialize s
-      @id = s['instance_id']
-      @name = s['instance_name']
-      @type = s['instance_type']
-      @vcpu = s['vcpu_current']
-      @desc = s['description']
-      @status = s['status']
+  class Image < DataType
+    include Comparable
+    @identifier = 'Image'
+
+    def Image.describe p = {}, &block
+      _p = p.dup
+      unless _p.has_key? 'provider'
+        _p['provider'] = 'system'
+      end
+      super _p, &block
     end
 
     def to_s
-      <<STR
-ID:                "#{@id}"
-Name:              "#{@name}"
-Type:              "#{@type}"
-VCPU:              "#{@vcpu}"
-Description:       "#{@desc}"
-Status:            "#{@status}"
-STR
+      [@values['image_id'], @values['image_name']].to_yaml
     end
 
-    def Instance.each &block
-      r = QC::API::Request.new 'DescribeInstances'
-      r.execute!(QC::Key)['instance_set'].to_a.each {|s| block.call(Instance.new(s))}
+    def <=> o
+      @values['image_id'] <=> o.image_id
     end
   end
 
@@ -115,7 +192,17 @@ STR
     class Request
       attr_reader :response
 
-      def initialize action, extra_params = []
+      def Request.execute! a, p = {}
+        req = QC::API::Request.new a, p
+        @result = req.execute!(QC::Key)
+        if @result['ret_code'] == 0
+          @result
+        else
+          raise ArgumentError.new("#{@result['ret_code']}: #{@result['message']}")
+        end
+      end
+
+      def initialize action, extra_params = {}
         @response = :not_requested
 
         @params = []
@@ -123,8 +210,13 @@ STR
         @params << ['access_key_id', QC::AccessKeyId]
         @params << ['signature_method', 'HmacSHA256']
         @params << ['signature_version', 1]
-        @params << ['zone', QC::Zone]
-        extra_params.each {|i| @params << i}
+        zone_set = false
+        extra_params.each_pair do |k,v|
+          zone_set = true if k == 'zone'
+          next if v.nil?
+          @params << [k.to_s, v]
+        end
+        @params << ['zone', QC::Zone] unless zone_set
       end
 
       def execute!(key)

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: qc.rb
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.0.2
 platform: ruby
 authors:
 - Daniel Bovensiepen
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-02-15 00:00:00.000000000 Z
+date: 2014-02-16 00:00:00.000000000 Z
 dependencies: []
 description: QingCloud API Library to handle instances, networks, internetconnections,
   etc. on QingCloud.com