steamcannon-deltacloud-client 0.0.9.8.1 → 0.1.0.2

data/lib/documentation.rb

@@ -1,98 +1,62 @@
-require 'lib/deltacloud'
+#
+# Copyright (C) 2010  Red Hat, Inc.
+#
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements.  See the NOTICE file distributed with
+# this work for additional information regarding copyright ownership.  The
+# ASF licenses this file to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance with the
+# License.  You may obtain a copy of the License at
+#
+#       http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.  See the
+# License for the specific language governing permissions and limitations
+# under the License.
+
+module DeltaCloud
+  class Documentation
+
+    attr_reader :api, :description, :params, :collection_operations
+    attr_reader :collection, :operation
+
+    def initialize(api, opts={})
+      @description, @api = opts[:description], api
+      @params = parse_parameters(opts[:params]) if opts[:params]
+      @collection_operations = opts[:operations] if opts[:operations]
+      @collection = opts[:collection]
+      @operation = opts[:operation]
+      self
+    end
 
-skip_methods = [ "id=", "uri=" ]
+    def operations
+      @collection_operations.collect { |o| api.documentation(@collection, o) }
+    end
 
-begin
-  @dc=DeltaCloud.new('mockuser', 'mockpassword', 'http://localhost:3001/api')
-rescue
-  puts "Please make sure that Deltacloud API is running with Mock driver"
-  exit(1)
-end
+    class OperationParameter
+      attr_reader :name
+      attr_reader :type
+      attr_reader :required
+      attr_reader :description
 
-@dc.entry_points.keys.each do |ep|
-  @dc.send(ep)
-end
+      def initialize(data)
+        @name, @type, @required, @description = data[:name], data[:type], data[:required], data[:description]
+      end
 
-class_list = DeltaCloud::classes.collect { |c| DeltaCloud::module_eval("::DeltaCloud::API::#{c}")}
+      def to_comment
+        "   # @param [#{@type}, #{@name}] #{@description}"
+      end
 
-def read_method_description(c, method)
-  if method =~ /es$/
-    "    # Read #{c.downcase} collection from Deltacloud API"
-  else
-    case method
-      when "uri"
-        "    # Return URI to API for this object"
-      when "action_urls"
-        "    # Return available actions API URL"
-      when "client"
-        "    # Return instance of API client"
-      else
-        "    # Get #{method} attribute value from #{c.downcase}"
     end
-  end
-end
 
-def read_parameters(c, method)
-  out = []
-  if method =~ /es$/
-    out << "    # @param [String, #id] Filter by ID"
-  end
-  out.join("\n")
-end
+    private
 
-def read_return_value(c, method)
-  if method =~ /es$/
-    rt = "Array"
-  else
-    rt = "String"
-  end
-  "    # @return [String] Value of #{method}"
-end
-
-out = []
-
-class_list.each do |c|
-  class_name = "#{c}".gsub(/^DeltaCloud::/, '')
-  out << "module DeltaCloud"
-  out << "  class API"
-  @dc.entry_points.keys.each do |ep|
-    out << "# Return #{ep.to_s.classify} object with given id\n"
-    out << "# "
-    out << "# #{@dc.documentation(ep.to_s).description.split("\n").join("\n# ")}"
-    out << "# @return [#{ep.to_s.classify}]"
-    out << "def #{ep.to_s.gsub(/s$/, '')}"
-    out << "end"
-    out << "# Return collection of #{ep.to_s.classify} objects"
-    out << "# "
-    out << "# #{@dc.documentation(ep.to_s).description.split("\n").join("\n# ")}"
-    @dc.documentation(ep.to_s, 'index').params.each do |p|
-      out << p.to_comment
+    def parse_parameters(params)
+      params.collect { |p| OperationParameter.new(p) }
     end
-    out << "# @return [Array] [#{ep.to_s.classify}]"
-    out << "def #{ep}(opts={})"
-    out << "end"
-  end
-  out << "  end"
-  out << "  class #{class_name}"
-  c.instance_methods(false).each do |method|
-    next if skip_methods.include?(method)
-    params = read_parameters(class_name, method)
-    retval = read_return_value(class_name, method)
-    out << read_method_description(class_name, method)
-    out << params if params
-    out << retval if retval
-    out << "    def #{method}"
-    out << "      # This method was generated dynamically from API"
-    out << "    end\n"
+
   end
-  out << "  end"
-  out << "end"
-end
 
-FileUtils.rm_r('doc') rescue nil
-FileUtils.mkdir_p('doc')
-File.open('doc/deltacloud.rb', 'w') do |f|
-  f.puts(out.join("\n"))
 end
-system("yardoc -m markdown --readme README --title 'Deltacloud Client Library' 'lib/*.rb' 'doc/deltacloud.rb' --verbose")
-FileUtils.rm('doc/deltacloud.rb')

data/lib/hwp_properties.rb

@@ -0,0 +1,64 @@
+#
+# Copyright (C) 2009  Red Hat, Inc.
+#
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements.  See the NOTICE file distributed with
+# this work for additional information regarding copyright ownership.  The
+# ASF licenses this file to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance with the
+# License.  You may obtain a copy of the License at
+#
+#       http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.  See the
+# License for the specific language governing permissions and limitations
+# under the License.
+
+module DeltaCloud
+
+  module HWP
+
+   class Property
+      attr_reader :name, :unit, :value, :kind
+
+      def initialize(xml, name)
+        @name, @kind, @value, @unit = xml['name'], xml['kind'].to_sym, xml['value'], xml['unit']
+        declare_ranges(xml)
+        self
+      end
+
+      def present?
+        ! @value.nil?
+      end
+
+      private
+
+      def declare_ranges(xml)
+        case xml['kind']
+          when 'range' then
+            self.class.instance_eval do
+              attr_reader :range
+            end
+            @range = { :from => xml.xpath('range').first['first'], :to => xml.xpath('range').first['last'] }
+          when 'enum' then
+            self.class.instance_eval do
+              attr_reader :options
+            end
+            @options = xml.xpath('enum/entry').collect { |e| e['value'] }
+        end
+      end
+
+    end
+
+    # FloatProperty is like Property but return value is Float instead of String.
+    class FloatProperty < Property
+      def initialize(xml, name)
+        super(xml, name)
+        @value = @value.to_f if @value
+      end
+    end
+  end
+
+end

data/lib/instance_state.rb

@@ -0,0 +1,29 @@
+module DeltaCloud
+  module InstanceState
+
+    class State
+      attr_reader :name
+      attr_reader :transitions
+
+      def initialize(name)
+        @name, @transitions = name, []
+      end
+    end
+
+    class Transition
+      attr_reader :to
+      attr_reader :action
+
+      def initialize(to, action)
+        @to = to
+        @action = action
+      end
+
+      def auto?
+        @action.nil?
+      end
+    end
+
+  end
+
+end

data/lib/string.rb

@@ -0,0 +1,53 @@
+#
+# Copyright (C) 2010  Red Hat, Inc.
+#
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements.  See the NOTICE file distributed with
+# this work for additional information regarding copyright ownership.  The
+# ASF licenses this file to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance with the
+# License.  You may obtain a copy of the License at
+#
+#       http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.  See the
+# License for the specific language governing permissions and limitations
+# under the License.
+
+class String
+
+  unless method_defined?(:classify)
+    # Create a class name from string
+    def classify
+      self.singularize.camelize
+    end
+  end
+
+  unless method_defined?(:camelize)
+    # Camelize converts strings to UpperCamelCase
+    def camelize
+      self.to_s.gsub(/\/(.?)/) { "::#{$1.upcase}" }.gsub(/(?:^|_)(.)/) { $1.upcase }
+    end
+  end
+
+  unless method_defined?(:singularize)
+    # Strip 's' character from end of string
+    def singularize
+      self.gsub(/s$/, '')
+    end
+  end
+
+  # Convert string to float if string value seems like Float
+  def convert
+    return self.to_f if self.strip =~ /^([\d\.]+$)/
+    self
+  end
+
+  # Simply converts whitespaces and - symbols to '_' which is safe for Ruby
+  def sanitize
+    self.strip.gsub(/(\W+)/, '_')
+  end
+
+end

data/specs/hardware_profiles_spec.rb

@@ -64,7 +64,7 @@ describe "hardware_profiles" do
   it "should allow fetching different hardware_profiles" do
     client = DeltaCloud.new( API_NAME, API_PASSWORD, API_URL )
     hwp1 = client.hardware_profile( 'm1-small' )
-    hwp2 = client.hardware_profile( 'm1-xlarge' )
+    hwp2 = client.hardware_profile( 'm1-large' )
     hwp1.storage.value.should_not eql(hwp2.storage.value)
     hwp1.memory.value.should_not eql(hwp2.memory.value)
   end

data/specs/instances_spec.rb

@@ -85,7 +85,7 @@ describe "instances" do
 
   it "should allow creation of new instances with reasonable defaults" do
     DeltaCloud.new( API_NAME, API_PASSWORD, API_URL ) do |client|
-      instance = client.create_instance( 'img1', :name=>'TestInstance' )
+      instance = client.create_instance( 'img1', :name=>'TestInstance', :hardware_profile => 'm1-large' )
       instance.should_not be_nil
       instance.uri.should match( %r{#{API_URL}/instances/inst[0-9]+} )
       instance.id.should match( /inst[0-9]+/ )
@@ -98,7 +98,7 @@ describe "instances" do
 
   it "should allow creation of new instances with specific realm" do
     DeltaCloud.new( API_NAME, API_PASSWORD, API_URL ) do |client|
-      instance = client.create_instance( 'img1', :realm=>'eu' )
+      instance = client.create_instance( 'img1', :realm=>'eu', :hardware_profile => 'm1-large' )
       instance.should_not be_nil
       instance.uri.should match( %r{#{API_URL}/instances/inst[0-9]+} )
       instance.id.should match( /inst[0-9]+/ )

data/specs/storage_volume_spec.rb

@@ -44,7 +44,6 @@ describe "storage volumes" do
       storage_volume = client.storage_volume( 'vol3' )
       storage_volume.id.should eql( 'vol3' )
       storage_volume.uri.should eql( API_URL + '/storage_volumes/vol3' )
-      storage_volume.state.should eql( 'IN-USE' )
       storage_volume.capacity.should eql( 1.0 )
       storage_volume.device.should eql( '/dev/sda1' )
       storage_volume.instance.should_not be_nil
@@ -61,7 +60,6 @@ describe "storage volumes" do
       storage_volume.should_not be_nil
       storage_volume.id.should eql( 'vol3' )
       storage_volume.uri.should eql( API_URL + '/storage_volumes/vol3' )
-      storage_volume.state.should eql( 'IN-USE' )
       storage_volume.capacity.should eql( 1.0 )
       storage_volume.device.should eql( '/dev/sda1' )
       storage_volume.instance.should_not be_nil

metadata

@@ -4,11 +4,10 @@ version: !ruby/object:Gem::Version
   prerelease: false
   segments: 
     - 0
-    - 0
-    - 9
-    - 8
     - 1
-  version: 0.0.9.8.1
+    - 0
+    - 2
+  version: 0.1.0.2
 platform: ruby
 authors: 
   - Red Hat, Inc.
@@ -16,7 +15,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-10-21 00:00:00 -04:00
+date: 2010-11-29 00:00:00 -05:00
 default_executable: deltacloudc
 dependencies: 
   - !ruby/object:Gem::Dependency 
@@ -29,9 +28,9 @@ dependencies:
           - !ruby/object:Gem::Version 
             segments: 
               - 1
-              - 4
-              - 2
-            version: 1.4.2
+              - 6
+              - 1
+            version: 1.6.1
     type: :runtime
     version_requirements: *id001
   - !ruby/object:Gem::Dependency 
@@ -45,8 +44,8 @@ dependencies:
             segments: 
               - 1
               - 4
-              - 1
-            version: 1.4.1
+              - 3
+            version: 1.4.3
     type: :runtime
     version_requirements: *id002
   - !ruby/object:Gem::Dependency 
@@ -75,7 +74,11 @@ extra_rdoc_files:
 files: 
   - Rakefile
   - lib/plain_formatter.rb
+  - lib/string.rb
   - lib/deltacloud.rb
+  - lib/base_object.rb
+  - lib/hwp_properties.rb
+  - lib/instance_state.rb
   - lib/documentation.rb
   - init.rb
   - bin/deltacloudc
@@ -88,18 +91,6 @@ files:
   - specs/spec_helper.rb
   - specs/instance_states_spec.rb
   - specs/initialization_spec.rb
-  - specs/data/storage_volumes/vol3.yml
-  - specs/data/storage_volumes/vol1.yml
-  - specs/data/storage_volumes/vol2.yml
-  - specs/data/images/img2.yml
-  - specs/data/images/img3.yml
-  - specs/data/images/img1.yml
-  - specs/data/instances/inst2.yml
-  - specs/data/instances/inst1.yml
-  - specs/data/instances/inst0.yml
-  - specs/data/storage_snapshots/snap3.yml
-  - specs/data/storage_snapshots/snap1.yml
-  - specs/data/storage_snapshots/snap2.yml
   - specs/fixtures/storage_volumes/vol3.yml
   - specs/fixtures/storage_volumes/vol1.yml
   - specs/fixtures/storage_volumes/vol2.yml
@@ -156,18 +147,6 @@ test_files:
   - specs/spec_helper.rb
   - specs/instance_states_spec.rb
   - specs/initialization_spec.rb
-  - specs/data/storage_volumes/vol3.yml
-  - specs/data/storage_volumes/vol1.yml
-  - specs/data/storage_volumes/vol2.yml
-  - specs/data/images/img2.yml
-  - specs/data/images/img3.yml
-  - specs/data/images/img1.yml
-  - specs/data/instances/inst2.yml
-  - specs/data/instances/inst1.yml
-  - specs/data/instances/inst0.yml
-  - specs/data/storage_snapshots/snap3.yml
-  - specs/data/storage_snapshots/snap1.yml
-  - specs/data/storage_snapshots/snap2.yml
   - specs/fixtures/storage_volumes/vol3.yml
   - specs/fixtures/storage_volumes/vol1.yml
   - specs/fixtures/storage_volumes/vol2.yml

data/specs/data/images/img1.yml

@@ -1,4 +0,0 @@
-:description: Fedora 10
-:owner_id: fedoraproject
-:architecture: x86_64
-:id: img1

data/specs/data/images/img2.yml

@@ -1,4 +0,0 @@
-:description: Fedora 10
-:owner_id: fedoraproject
-:architecture: i386
-:id: img2