vas 0.3.0

data/lib/vas/shared/collection.rb

@@ -0,0 +1,46 @@
+#--
+# vFabric Administration Server Ruby API
+# Copyright (c) 2012 VMware, Inc. All Rights Reserved.
+#
+# Licensed 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 Shared
+  
+  class Collection < Shared::Resource
+
+    private
+    attr_reader :entry_class
+
+    def initialize(location, client, type, entry_class) #:nodoc:
+      super(location, client)
+      @type = type
+      @entry_class = entry_class
+    end
+
+    public
+
+    # Gets the items in the collection from the server. Calls the block once for each item.
+    def each # :yields: item
+      items = client.get(location)[@type]
+
+      if (!items.nil?)
+        client.get(location)[@type].each { |item|
+          yield entry_class.new(Util::LinkUtils.get_self_link_href(item), client)
+        }
+      end
+    end
+  
+  end
+  
+end

data/lib/vas/shared/configuration.rb

@@ -0,0 +1,59 @@
+#--
+# vFabric Administration Server Ruby API
+# Copyright (c) 2012 VMware, Inc. All Rights Reserved.
+#
+# Licensed 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 Shared
+
+  class Configuration < Shared::Resource
+
+    # The path of the configuration
+    attr_reader :path
+
+    # The size of the configuration
+    attr_reader :size
+
+    private
+    attr_reader :content_location
+
+    def initialize(location, client, instance_type, instance_class) #:nodoc:
+      super(location, client)
+
+      @path = details["path"]
+      @size = details["size"]
+
+      @instance_location = Util::LinkUtils.get_link_href(details, instance_type)
+      @content_location = Util::LinkUtils.get_link_href(details, "content")
+
+      @instance_class = instance_class
+    end
+
+    public
+    # Retrieves the configuration's content and passes it to the block
+    def content(&block)
+      client.get_stream(@content_location, &block)
+    end
+
+    # The instance that owns the configuration
+    def instance
+      @instance_class.new(@instance_location, client)
+    end
+
+    def to_s #:nodoc:
+      "#<#{self.class} name='#@path' size=#@size>"
+    end
+
+  end
+end

data/lib/vas/shared/groups.rb

@@ -0,0 +1,74 @@
+#--
+# vFabric Administration Server Ruby API
+# Copyright (c) 2012 VMware, Inc. All Rights Reserved.
+#
+# Licensed 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 Shared
+
+  class Groups < MutableCollection
+
+    def initialize(location, client, group_class) #:nodoc:
+      super(location, client, "groups", group_class)
+    end
+
+    # Creates a Group named +name+ from the given +nodes+.
+    def create(name, nodes)
+      node_locations = []
+      nodes.each { |node| node_locations << node.location }
+      entry_class.new(client.post(location, {:name => name, :nodes => node_locations}, "group"), client)
+    end
+
+  end
+
+  class Group < Shared::Resource
+
+    # The group's installations
+    attr_reader :installations
+
+    # The name of the group
+    attr_reader :name
+
+    def initialize(location, client, nodes_class, installations_class) #:nodoc:#
+      super(location, client)
+      @name = details["name"]
+      @installations = installations_class.new(Util::LinkUtils.get_link_href(details, "installations"), client)
+      @nodes_class = nodes_class
+    end
+
+    # An array of the group's nodes
+    def nodes
+      nodes = []
+      Util::LinkUtils.get_link_hrefs(client.get(location), "node").each { |node_location| nodes << @nodes_class.new(node_location, client)}
+      nodes
+    end
+
+    def to_s #:nodoc:
+      "#<#{self.class} name='#@name'>"
+    end
+
+  end
+
+  class MutableGroup < Group
+
+    # Updates the group to contain the given +nodes+.
+    def update(nodes)
+      node_locations = []
+      nodes.each { |node| node_locations << node.location }
+      client.post(location, {:nodes => node_locations})
+    end
+
+  end
+
+end

data/lib/vas/shared/installation_images.rb

@@ -0,0 +1,62 @@
+#--
+# vFabric Administration Server Ruby API
+# Copyright (c) 2012 VMware, Inc. All Rights Reserved.
+#
+# Licensed 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 Shared
+
+  class InstallationImages < MutableCollection
+
+    def initialize(location, client, installation_image_class) #:nodoc:
+      super(location, client, "installation-images", installation_image_class)
+    end
+
+    # Creates an installation image with the version +version+ by uploading the file at the given +path+.
+    def create(path, version)
+      entry_class.new(client.post_image(location, path, { :version => version }), client)
+    end
+
+  end
+
+  class InstallationImage < Resource
+    
+    # The installation image's version
+    attr_reader :version
+
+    # The installation image's size
+    attr_reader :size
+
+    def initialize(location, client, installation_class) #:nodoc:
+      super(location, client)
+      @version = details["version"]
+      @size = details["size"]
+      @installation_class = installation_class
+    end
+
+    def installations
+      installations = []
+      Util::LinkUtils.get_link_hrefs(client.get(location), "installation").each { |installation_location|
+        installations << @installation_class.new(installation_location, client)
+      }
+      installations
+    end
+
+    def to_s #:nodoc:
+      "#<#{self.class} version='#@version'>"
+    end
+
+  end
+
+end

data/lib/vas/shared/installations.rb

@@ -0,0 +1,67 @@
+#--
+# vFabric Administration Server Ruby API
+# Copyright (c) 2012 VMware, Inc. All Rights Reserved.
+#
+# Licensed 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 Shared
+
+  class Installations < Shared::MutableCollection
+    
+    def initialize(location, client, installation_class) #:nodoc:
+      super(location, client, "installations", installation_class)
+    end
+    
+    # Creates an installation from the +installation_image+
+    def create(installation_image)
+      entry_class.new(client.post(location, { :image => installation_image.location }, "installation"), client)
+    end
+    
+  end
+
+  class Installation < Shared::Resource
+
+    # The installation's version
+    attr_reader :version
+
+    # The installation image that was used to create the installation
+    attr_reader :installation_image
+
+    # The group that contains the installation
+    attr_reader :group
+
+    def initialize(location, client, installation_image_class, group_class) #:nodoc:
+      super(location, client)
+
+      @version = details["version"]
+      @installation_image = installation_image_class.new(Util::LinkUtils.get_link_href(details, "installation-image"), client)
+      @group = group_class.new(Util::LinkUtils.get_link_href(details, "group"), client)
+    end
+
+    def to_s #:nodoc:
+      "#<#{self.class} version='#@version'>"
+    end
+
+    private
+    def retrieve_instances(instance_rel, instance_class)
+      instances = []
+      Util::LinkUtils.get_link_hrefs(client.get(location), instance_rel).each { |instance_location|
+        instances << instance_class.new(instance_location, client)
+      }
+      instances
+    end
+
+  end
+  
+end

data/lib/vas/shared/instances.rb

@@ -0,0 +1,74 @@
+#--
+# vFabric Administration Server Ruby API
+# Copyright (c) 2012 VMware, Inc. All Rights Reserved.
+#
+# Licensed 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 Shared
+
+  class Instance < Shared::StateResource
+
+    # The instance's name
+    attr_reader :name
+
+    # The instance's live configurations
+    attr_reader :live_configurations
+
+    # The instance's pending configurations
+    attr_reader :pending_configurations
+
+    # The group that contains this instance
+    attr_reader :group
+
+    # An array of the instance's individual node instances
+    attr_reader :node_instances
+
+    def initialize(location, client,
+        group_class,
+        installation_class,
+        live_configurations_class,
+        pending_configurations_class,
+        node_instance_class,
+        node_instance_type) #:nodoc:
+      super(location, client)
+
+      @name = details["name"]
+      @live_configurations = live_configurations_class.new(Util::LinkUtils.get_link_href(details, "live-configurations"), client)
+      @pending_configurations = pending_configurations_class.new(Util::LinkUtils.get_link_href(details, "pending-configurations"), client)
+      @group = group_class.new(Util::LinkUtils.get_link_href(details, "group"), client)
+      @installation_class = installation_class
+      @node_instance_class = node_instance_class
+      @node_instance_type = node_instance_type
+    end
+
+    # The installation that this instance is using
+    def installation
+      @installation_class.new(Util::LinkUtils.get_link_href(client.get(location), 'installation'), client)
+    end
+
+    # An array of the instance's individual node instances
+    def node_instances
+      node_instances = []
+      Util::LinkUtils.get_link_hrefs(client.get(location), @node_instance_type).each {
+          |node_instance_location| node_instances << @node_instance_class.new(node_instance_location, client)}
+      node_instances
+    end
+
+    def to_s #:nodoc:
+      "#<#{self.class} name='#@name'>"
+    end
+
+  end
+
+end

data/lib/vas/shared/logs.rb

@@ -0,0 +1,89 @@
+#--
+# vFabric Administration Server Ruby API
+# Copyright (c) 2012 VMware, Inc. All Rights Reserved.
+#
+# Licensed 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 Shared
+
+  # Used to enumerate a node instance's logs
+  class Logs < Shared::MutableCollection
+
+    def initialize(location, client, log_class) #:nodoc:
+      super(location, client, 'logs', log_class)
+    end
+
+  end
+
+  # A log file in a node instance
+  class Log < Shared::Resource
+
+    # The name of the log
+    attr_reader :name
+
+    # The node instance that the log belongs to
+    attr_reader :instance
+
+    def initialize(location, client, instance_type, instance_class) #:nodoc:
+      super(location, client)
+
+      @name = details['name']
+      @content_location = Util::LinkUtils.get_link_href(details, 'content')
+      @instance = instance_class.new(Util::LinkUtils.get_link_href(details, instance_type), client)
+    end
+
+    # The Log's content. The content that is passed to the block can be controlled using +options+.
+    #
+    # Recognized options are:
+    #
+    # start_line::  The start point, in lines, of the content to pass to the block. Omitting the parameter will result
+    #               in content from the start of the file being passed. If the provided value is greater than the
+    #               number of lines in the file, no content will be passed.
+    # end_line::    The end point, in lines, of the content to pass to the block. Omitting the parameter will result in
+    #               content up to the end of the file being passed. If the provided value is greater than the number of
+    #               lines in the file, content up to and including the last line in the file will be passed.
+    def content(options = {}, &block)
+      query=""
+      if (!options[:start_line].nil?)
+        query << "start-line=#{options[:start_line]}"
+      end
+      if (!options[:end_line].nil?)
+        if (query.length > 0)
+          query << '&'
+        end
+        query << "end-line=#{options[:end_line]}"
+      end
+
+      if (query.length > 0)
+        client.get_stream("#{@content_location}?#{query}", &block)
+      else
+        client.get_stream(@content_location, &block)
+      end
+    end
+
+    # The size of the log
+    def size
+      client.get(location)['size']
+    end
+
+    # The last_modified stamp of the log
+    def last_modified
+      client.get(location)['last-modified']
+    end
+
+    def to_s #:nodoc:
+      "#<#{self.class} name='#@name' size'#@size' services='#@last_modified'>"
+    end
+  end
+end