vas 0.3.0

data/LICENSE

@@ -0,0 +1,174 @@
+Apache License 
+
+Version 2.0, January 2004 
+http://www.apache.org/licenses/ 
+
+TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION 
+
+1. Definitions.
+
+"License" shall mean the terms and conditions for use, reproduction,
+and distribution as defined by Sections 1 through 9 of this document.
+
+"Licensor" shall mean the copyright owner or entity authorized by the
+copyright owner that is granting the License.  
+
+"Legal Entity" shall mean the union of the acting entity and all other
+entities that control, are controlled by, or are under common control
+with that entity. For the purposes of this definition, "control" means
+(i) the power, direct or indirect, to cause the direction or management
+of such entity, whether by contract or otherwise, or (ii) ownership
+of fifty percent (50%) or more of the outstanding shares, or (iii)
+beneficial ownership of such entity.
+
+"You" (or "Your") shall mean an individual or Legal Entity exercising
+permissions granted by this License.  
+
+"Source" form shall mean the preferred form for making modifications,
+including but not limited to software source code, documentation source,
+and configuration files.
+
+"Object" form shall mean any form resulting from mechanical transformation
+or translation of a Source form, including but not limited to compiled
+object code, generated documentation, and conversions to other media
+types.  
+
+"Work" shall mean the work of authorship, whether in Source or
+Object form, made available under the License, as indicated by a copyright
+notice that is included in or attached to the work (an example is provided
+in the Appendix below).  
+
+"Derivative Works" shall mean any work, whether in Source or Object form,
+that is based on (or derived from) the Work and for which the editorial
+revisions, annotations, elaborations, or other modifications represent,
+as a whole, an original work of authorship. For the purposes of this
+License, Derivative Works shall not include works that remain separable
+from, or merely link (or bind by name) to the interfaces of, the Work
+and Derivative Works thereof.
+
+"Contribution" shall mean any work of authorship, including the
+original version of the Work and any modifications or additions to
+that Work or Derivative Works thereof, that is intentionally submitted
+to Licensor for inclusion in the Work by the copyright owner or by an
+individual or Legal Entity authorized to submit on behalf of the copyright
+owner. For the purposes of this definition, "submitted" means any form of
+electronic, verbal, or written communication sent to the Licensor or its
+representatives, including but not limited to communication on electronic
+mailing lists, source code control systems, and issue tracking systems
+that are managed by, or on behalf of, the Licensor for the purpose of
+discussing and improving the Work, but excluding communication that is
+conspicuously marked or otherwise designated in writing by the copyright
+owner as "Not a Contribution."
+
+"Contributor" shall mean Licensor and any individual or Legal Entity
+on behalf of whom a Contribution has been received by Licensor and
+subsequently incorporated within the Work.
+
+2. Grant of Copyright License.
+Subject to the terms and conditions of this License, each Contributor
+hereby grants to You a perpetual, worldwide, non-exclusive, no-charge,
+royalty-free, irrevocable copyright license to reproduce, prepare
+Derivative Works of, publicly display, publicly perform, sublicense, and
+distribute the Work and such Derivative Works in Source or Object form.
+
+3. Grant of Patent License.
+Subject to the terms and conditions of this License, each Contributor
+hereby grants to You a perpetual, worldwide, non-exclusive, no-charge,
+royalty- free, irrevocable (except as stated in this section) patent
+license to make, have made, use, offer to sell, sell, import, and
+otherwise transfer the Work, where such license applies only to those
+patent claims licensable by such Contributor that are necessarily
+infringed by their Contribution(s) alone or by combination of
+their Contribution(s) with the Work to which such Contribution(s)
+was submitted. If You institute patent litigation against any entity
+(including a cross-claim or counterclaim in a lawsuit) alleging that the
+Work or a Contribution incorporated within the Work constitutes direct
+or contributory patent infringement, then any patent licenses granted
+to You under this License for that Work shall terminate as of the date
+such litigation is filed.
+
+4. Redistribution.
+You may reproduce and distribute copies of the Work or Derivative Works
+thereof in any medium, with or without modifications, and in Source or
+Object form, provided that You meet the following conditions:
+
+  a. You must give any other recipients of the Work or Derivative Works
+     a copy of this License; and
+
+  b. You must cause any modified files to carry prominent notices stating
+     that You changed the files; and
+
+  c. You must retain, in the Source form of any Derivative Works that
+     You distribute, all copyright, patent, trademark, and attribution
+     notices from the Source form of the Work, excluding those notices
+     that do not pertain to any part of the Derivative Works; and
+
+  d. If the Work includes a "NOTICE" text file as part of its
+     distribution, then any Derivative Works that You distribute must
+     include a readable copy of the attribution notices contained
+     within such NOTICE file, excluding those notices that do not
+     pertain to any part of the Derivative Works, in at least one of
+     the following places: within a NOTICE text file distributed as part
+     of the Derivative Works; within the Source form or documentation,
+     if provided along with the Derivative Works; or, within a display
+     generated by the Derivative Works, if and wherever such third-party
+     notices normally appear. The contents of the NOTICE file are for
+     informational purposes only and do not modify the License. You
+     may add Your own attribution notices within Derivative Works that
+     You distribute, alongside or as an addendum to the NOTICE text
+     from the Work, provided that such additional attribution notices
+     cannot be construed as modifying the License.  You may add Your own
+     copyright statement to Your modifications and may provide additional
+     or different license terms and conditions for use, reproduction, or
+     distribution of Your modifications, or for any such Derivative Works
+     as a whole, provided Your use, reproduction, and distribution of the
+     Work otherwise complies with the conditions stated in this License.
+
+5. Submission of Contributions.
+Unless You explicitly state otherwise, any Contribution intentionally
+submitted for inclusion in the Work by You to the Licensor shall be
+under the terms and conditions of this License, without any additional
+terms or conditions.  Notwithstanding the above, nothing herein shall
+supersede or modify the terms of any separate license agreement you may
+have executed with Licensor regarding such Contributions.
+
+6. Trademarks.
+This License does not grant permission to use the trade names, trademarks,
+service marks, or product names of the Licensor, except as required for
+reasonable and customary use in describing the origin of the Work and
+reproducing the content of the NOTICE file.
+
+7. Disclaimer of Warranty.
+Unless required by applicable law or agreed to in writing, Licensor
+provides the Work (and each Contributor provides its Contributions) on
+an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either
+express or implied, including, without limitation, any warranties or
+conditions of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR
+A PARTICULAR PURPOSE. You are solely responsible for determining the
+appropriateness of using or redistributing the Work and assume any risks
+associated with Your exercise of permissions under this License.
+
+8. Limitation of Liability.
+In no event and under no legal theory, whether in tort (including
+negligence), contract, or otherwise, unless required by applicable law
+(such as deliberate and grossly negligent acts) or agreed to in writing,
+shall any Contributor be liable to You for damages, including any direct,
+indirect, special, incidental, or consequential damages of any character
+arising as a result of this License or out of the use or inability to
+use the Work (including but not limited to damages for loss of goodwill,
+work stoppage, computer failure or malfunction, or any and all other
+commercial damages or losses), even if such Contributor has been advised
+of the possibility of such damages.
+
+9. Accepting Warranty or Additional Liability.
+While redistributing the Work or Derivative Works thereof, You may
+choose to offer, and charge a fee for, acceptance of support, warranty,
+indemnity, or other liability obligations and/or rights consistent with
+this License. However, in accepting such obligations, You may act only
+on Your own behalf and on Your sole responsibility, not on behalf of
+any other Contributor, and only if You agree to indemnify, defend, and
+hold each Contributor harmless for any liability incurred by, or claims
+asserted against, such Contributor by reason of your accepting any such
+warranty or additional liability.
+
+END OF TERMS AND CONDITIONS

data/NOTICE

@@ -0,0 +1,5 @@
+vFabric Administration Server API
+Copyright (c) 2012 VMware, Inc. All Rights Reserved.
+
+This product is licensed to you under the Apache License, Version 2.0 (the "License").
+You may not use this product except in compliance with the License.  

data/README.md

@@ -0,0 +1,26 @@
+# vFabric Administration Server Ruby API
+
+The vFabric Administration Server (VAS) API is a Ruby library used for interacting with the
+[vFabric Administration Server](http://www.vmware.com/support/pubs/vfabric-vas.html).
+
+VAS's primary mode of interaction is via RESTful interface. This API enables the use of VAS using
+rich Ruby types, eliminating the need for a detailed understanding of the REST API and its JSON
+payloads.
+
+## Requirements
+
+The VAS Ruby API requires Ruby 1.8.7 or 1.9.x. It has been built and tested on 1.8.7 and 1.9.3.
+
+## Installation
+
+The VAS Ruby API is not yet available on [RubyGems](https://rubygems.org/). However, pre-built
+gems can be [downloaded](https://github.com/vFabric/vas-ruby-api/downloads) and installed. For
+example:
+
+	gem install vas-<version>.gem
+
+## Licence
+
+The VAS Ruby API is licensed under the [Apache Licence, Version 2.0][asl2].
+
+[asl2]: http://www.apache.org/licenses/LICENSE-2.0.html

data/Rakefile

@@ -0,0 +1,20 @@
+require 'rubygems'
+require 'rubygems/package_task'
+require 'rake/clean'
+require 'rake/testtask'
+
+CLEAN.include("pkg", "coverage")
+
+spec = Gem::Specification.load('vas.gemspec')
+
+Gem::PackageTask.new(spec) do |pkg|
+  pkg.need_zip = true
+  pkg.need_tar = true
+end
+
+Rake::TestTask.new do |t|
+  t.pattern = "test/**/test_*.rb"
+end
+
+
+task :default => [:clean, :test, :package]

data/lib/vas.rb

@@ -0,0 +1,103 @@
+#--
+# 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.
+#++
+
+require 'json'
+require 'net/http'
+require 'net/https'
+require 'net/http/post/multipart'
+require 'vas/shared/resource'
+require 'vas/shared/collection'
+require 'vas/shared/mutable_collection'
+require 'vas/shared/configuration'
+require 'vas/shared/groups'
+require 'vas/shared/installations'
+require 'vas/shared/installation_images'
+require 'vas/shared/pending_configuration'
+require 'vas/shared/security'
+require 'vas/shared/state_resource'
+require 'vas/shared/instances'
+require 'vas/shared/logs'
+require 'vas/shared/node_instances'
+require 'vas/shared/nodes'
+require 'vas/gemfire/agent_configuration'
+require 'vas/gemfire/agent_instances'
+require 'vas/gemfire/agent_live_configurations'
+require 'vas/gemfire/agent_logs'
+require 'vas/gemfire/agent_node_instances'
+require 'vas/gemfire/agent_pending_configurations'
+require 'vas/gemfire/application_code_images'
+require 'vas/gemfire/application_code'
+require 'vas/gemfire/cache_server_configuration'
+require 'vas/gemfire/cache_server_instances'
+require 'vas/gemfire/cache_server_live_configurations'
+require 'vas/gemfire/cache_server_logs'
+require 'vas/gemfire/cache_server_node_instances'
+require 'vas/gemfire/cache_server_pending_configurations'
+require 'vas/gemfire/disk_stores'
+require 'vas/gemfire/gemfire'
+require 'vas/gemfire/groups'
+require 'vas/gemfire/installation_images'
+require 'vas/gemfire/installations'
+require 'vas/gemfire/live_application_codes'
+require 'vas/gemfire/locator_configuration'
+require 'vas/gemfire/locator_instances'
+require 'vas/gemfire/locator_live_configurations'
+require 'vas/gemfire/locator_logs'
+require 'vas/gemfire/locator_node_instances'
+require 'vas/gemfire/locator_pending_configurations'
+require 'vas/gemfire/nodes'
+require 'vas/gemfire/pending_application_codes'
+require 'vas/gemfire/statistics'
+require 'vas/rabbitmq/configuration'
+require 'vas/rabbitmq/groups'
+require 'vas/rabbitmq/installation_images'
+require 'vas/rabbitmq/plugin_images'
+require 'vas/rabbitmq/plugins'
+require 'vas/rabbitmq/installations'
+require 'vas/rabbitmq/instances'
+require 'vas/rabbitmq/live_configurations'
+require 'vas/rabbitmq/logs'
+require 'vas/rabbitmq/node_instances'
+require 'vas/rabbitmq/nodes'
+require 'vas/rabbitmq/pending_configurations'
+require 'vas/rabbitmq/rabbitmq'
+require 'vas/tc_server/applications'
+require 'vas/tc_server/configuration'
+require 'vas/tc_server/groups'
+require 'vas/tc_server/installation_images'
+require 'vas/tc_server/installations'
+require 'vas/tc_server/instances'
+require 'vas/tc_server/live_configurations'
+require 'vas/tc_server/logs'
+require 'vas/tc_server/node_applications'
+require 'vas/tc_server/node_instances'
+require 'vas/tc_server/node_revisions'
+require 'vas/tc_server/nodes'
+require 'vas/tc_server/pending_configurations'
+require 'vas/tc_server/revision_images'
+require 'vas/tc_server/revisions'
+require 'vas/tc_server/tc_server'
+require 'vas/tc_server/template_images'
+require 'vas/tc_server/templates'
+require 'vas/util/client'
+require 'vas/util/link_utils'
+require 'vas/vas_exception'
+require 'vas/vfabric/agent_image'
+require 'vas/vfabric/nodes'
+require 'vas/vfabric/v_fabric'
+require 'vas/vfabric_administration_server'
+require 'zip/zipfilesystem'

data/lib/vas/gemfire/agent_configuration.rb

@@ -0,0 +1,28 @@
+#--
+# 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 Gemfire
+
+  # A configuration file in an agent instance
+  class AgentConfiguration < Shared::Configuration
+
+    def initialize(location, client) #:nodoc:
+      super(location, client, "agent-group-instance", AgentInstance)
+    end
+
+  end
+end

data/lib/vas/gemfire/agent_instances.rb

@@ -0,0 +1,49 @@
+#--
+# 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 Gemfire
+
+  # Used to enumerate, create, and delete agent instances.
+  class AgentInstances < Shared::MutableCollection
+
+    def initialize(location, client) #:nodoc:
+      super(location, client, "agent-group-instances", AgentInstance)
+    end
+
+    # Creates a new instance named +name+, using the given +installation+.
+    def create(installation, name)
+      payload = { :installation => installation.location, :name => name }
+      AgentInstance.new(client.post(location, payload, "agent-group-instance"), client)
+    end
+
+  end
+
+  # An agent instance
+  class AgentInstance < Shared::Instance
+
+    def initialize(location, client) #:nodoc:
+      super(location, client, Group, Installation, AgentLiveConfigurations, AgentPendingConfigurations, AgentNodeInstance, 'agent-node-instance')
+    end
+
+    # Updates the instance to use the given +installation+
+    def update(installation)
+      client.post(location, { :installation => installation.location });
+    end
+
+  end
+
+end

data/lib/vas/gemfire/agent_live_configurations.rb

@@ -0,0 +1,29 @@
+#--
+# 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 Gemfire
+
+  # Used to enumerate an agent instance's live configuration
+  class AgentLiveConfigurations < Shared::Collection
+
+    def initialize(location, client) #:nodoc:
+      super(location, client, "live-configurations", AgentConfiguration)
+    end
+
+  end
+
+end

data/lib/vas/gemfire/agent_logs.rb

@@ -0,0 +1,38 @@
+#--
+# 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 Gemfire
+
+  # Used to enumerate an agent node instance's logs
+  class AgentLogs < Shared::Logs
+
+    def initialize(location, client) #:nodoc:
+      super(location, client, AgentLog)
+    end
+
+  end
+
+  # A log file in an agent node instance
+  class AgentLog < Shared::Log
+
+    def initialize(location, client) #:nodoc:
+      super(location, client, 'agent-node-instance', AgentNodeInstance)
+    end
+
+  end
+
+end