occi-cli 4.0.0.alpha.1

data/config/warble.rb

@@ -0,0 +1,151 @@
+# Disable Rake-environment-task framework detection by uncommenting/setting to false
+# Warbler.framework_detection = false
+
+# Warbler web application assembly configuration file
+Warbler::Config.new do |config|
+  # Features: additional options controlling how the jar is built.
+  # Currently the following features are supported:
+  # - gemjar: package the gem repository in a jar file in WEB-INF/lib
+  # - executable: embed a web server and make the war executable
+  # - compiled: compile .rb files to .class files
+  config.features = %w(compiled)
+
+  # Application directories to be included in the webapp.
+  config.dirs = %w(config lib)
+
+  # Additional files/directories to include, above those in config.dirs
+  # config.includes = FileList["db"]
+
+  # Additional files/directories to exclude
+  # config.excludes = FileList["lib/tasks/*"]
+
+  # Additional Java .jar files to include.  Note that if .jar files are placed
+  # in lib (and not otherwise excluded) then they need not be mentioned here.
+  # JRuby and JRuby-Rack are pre-loaded in this list.  Be sure to include your
+  # own versions if you directly set the value
+  # config.java_libs += FileList["lib/java/*.jar"]
+
+  # Loose Java classes and miscellaneous files to be included.
+  # config.java_classes = FileList["target/classes/**.*"]
+
+  # One or more pathmaps defining how the java classes should be copied into
+  # the archive. The example pathmap below accompanies the java_classes
+  # configuration above. See http://rake.rubyforge.org/classes/String.html#M000017
+  # for details of how to specify a pathmap.
+  # config.pathmaps.java_classes << "%{target/classes/,}p"
+
+  # Bundler support is built-in. If Warbler finds a Gemfile in the
+  # project directory, it will be used to collect the gems to bundle
+  # in your application. If you wish to explicitly disable this
+  # functionality, uncomment here.
+  # config.bundler = false
+
+  # An array of Bundler groups to avoid including in the war file.
+  # Defaults to ["development", "test", "assets"].
+  # config.bundle_without = []
+
+  # Other gems to be included. If you don't use Bundler or a gemspec
+  # file, you need to tell Warbler which gems your application needs
+  # so that they can be packaged in the archive.
+  # For Rails applications, the Rails gems are included by default
+  # unless the vendor/rails directory is present.
+  # config.gems += ["activerecord-jdbcmysql-adapter", "jruby-openssl"]
+  # config.gems << "tzinfo"
+
+  # Uncomment this if you don't want to package rails gem.
+  # config.gems -= ["rails"]
+
+  # The most recent versions of gems are used.
+  # You can specify versions of gems by using a hash assignment:
+  # config.gems["rails"] = "2.3.10"
+
+  # You can also use regexps or Gem::Dependency objects for flexibility or
+  # finer-grained control.
+  # config.gems << /^merb-/
+  # config.gems << Gem::Dependency.new("merb-core", "= 0.9.3")
+
+  # Include gem dependencies not mentioned specifically. Default is
+  # true, uncomment to turn off.
+  # config.gem_dependencies = false
+
+  # Array of regular expressions matching relative paths in gems to be
+  # excluded from the war. Defaults to empty, but you can set it like
+  # below, which excludes test files.
+  # config.gem_excludes = [/^(test|spec)\//]
+
+  # Pathmaps for controlling how application files are copied into the archive
+  # config.pathmaps.application = ["WEB-INF/%p"]
+
+  # Name of the archive (without the extension). Defaults to the basename
+  # of the project directory.
+  config.jar_name = "occi"
+
+  # Name of the MANIFEST.MF template for the war file. Defaults to a simple
+  # MANIFEST.MF that contains the version of Warbler used to create the war file.
+  # config.manifest_file = "config/MANIFEST.MF"
+
+  # When using the 'compiled' feature and specified, only these Ruby
+  # files will be compiled. Default is to compile all \.rb files in
+  # the application.
+  # config.compiled_ruby_files = FileList['app/**/*.rb']
+
+  # === War files only below here ===
+
+  # Path to the pre-bundled gem directory inside the war file. Default
+  # is 'WEB-INF/gems'. Specify path if gems are already bundled
+  # before running Warbler. This also sets 'gem.path' inside web.xml.
+  # config.gem_path = "WEB-INF/vendor/bundler_gems"
+
+  # Files for WEB-INF directory (next to web.xml). This contains
+  # web.xml by default. If there is an .erb-File it will be processed
+  # with webxml-config. You may want to exclude this file via
+  # config.excludes.
+  # config.webinf_files += FileList["jboss-web.xml"]
+
+  # Files to be included in the root of the webapp.  Note that files in public
+  # will have the leading 'public/' part of the path stripped during staging.
+  # config.public_html = FileList["public/**/*", "doc/**/*"]
+
+  # Pathmaps for controlling how public HTML files are copied into the .war
+  # config.pathmaps.public_html = ["%{public/,}p"]
+
+  # Embedded webserver to use with the 'executable' feature. Currently supported
+  # webservers are:
+  # * <tt>winstone</tt> (default) - Winstone 0.9.10 from sourceforge
+  # * <tt>jenkins-ci.winstone</tt> - Improved Winstone from Jenkins CI
+  # * <tt>jetty</tt> - Embedded Jetty from Eclipse
+  # config.webserver = 'jetty'
+
+  # Value of RAILS_ENV for the webapp -- default as shown below
+  # config.webxml.rails.env = ENV['RAILS_ENV'] || 'production'
+
+  # Application booter to use, one of :rack, :rails, or :merb (autodetected by default)
+  # config.webxml.booter = :rails
+
+  # Set JRuby to run in 1.9 mode.
+  # config.webxml.jruby.compat.version = "1.9"
+
+  # When using the :rack booter, "Rackup" script to use.
+  # - For 'rackup.path', the value points to the location of the rackup
+  # script in the web archive file. You need to make sure this file
+  # gets included in the war, possibly by adding it to config.includes
+  # or config.webinf_files above.
+  # - For 'rackup', the rackup script you provide as an inline string
+  #   is simply embedded in web.xml.
+  # The script is evaluated in a Rack::Builder to load the application.
+  # Examples:
+  # config.webxml.rackup.path = 'WEB-INF/hello.ru'
+  # config.webxml.rackup = %{require './lib/demo'; run Rack::Adapter::Camping.new(Demo)}
+  # config.webxml.rackup = require 'cgi' && CGI::escapeHTML(File.read("config.ru"))
+
+  # Control the pool of Rails runtimes. Leaving unspecified means
+  # the pool will grow as needed to service requests. It is recommended
+  # that you fix these values when running a production server!
+  # If you're using threadsafe! mode, you probably don't want to set these values,
+  # since 1 runtime(default for threadsafe mode) will be enough.
+  # config.webxml.jruby.min.runtimes = 2
+  # config.webxml.jruby.max.runtimes = 4
+
+  # JNDI data source name
+  # config.webxml.jndi = 'jdbc/rails'
+end

data/doc/macosx.md

@@ -0,0 +1,27 @@
+# rOCCI on Mac OS X
+
+## Installation
+
+To use a recent version of Ruby on Mac OS X, a few preparations are needed. Installing Ruby on Apple Mac OS X is not as 
+straightforward as it is on other platforms, hence following detailed instructions.
+
+1. Install the latest version of Xcode either
+[from the Mac OS X App Store](itms://itunes.apple.com/de/app/xcode/id497799835?mt=12#) or by downloading it from
+[[http://developer.apple.com]] and then installing the package.
+2. Open Xcode, then download and install the Xcode command line tools (Menu->Xcode->Preferences->Downloads)
+3. In the Terminal, install RVM with `curl -L https://get.rvm.io | bash -s stable`
+4. Read the plattform requirements for your specific setup by running `rvm requirements` in the Terminal. Execute any
+tasks mentioned there for installing Ruby 1.9.3 (you can ignore hints for Ruby 1.8.7). If you need to install additional
+packages it is recommended to use Homebew for it (unless you already use MacPorts). To install Homebrew paste the
+following in your Terminal `ruby -e "$(curl -fsSL https://raw.github.com/mxcl/homebrew/go)"`
+5. Install Ruby 1.9.3 with `rvm install ruby-1.9.3`
+
+Now that you have Ruby 1.9.3 installed, you can intall rOCCI.
+
+To install the most recent stable version
+
+    gem install occi
+
+To install the most recent beta version
+
+    gem install occi --pre

data/ext/mkrf_conf.rb

@@ -0,0 +1,34 @@
+require 'rubygems'
+require 'rubygems/command.rb'
+require 'rubygems/dependency_installer.rb' 
+
+begin
+  Gem::Command.build_args = ARGV
+rescue NoMethodError
+  # do nothing but warn the user
+  warn "Gem::Command doesn't have a method named 'build_args'!"
+end 
+
+warn 'Installing platform-specific dependencies.'
+
+warn 'Installing the most recent version of \'rake\''
+inst = Gem::DependencyInstaller.new
+inst.install "rake"
+
+if RUBY_PLATFORM == "java"
+  warn 'Installing dependencies specific for jRuby'
+
+  jrver = (JRUBY_VERSION || "").split('.').map{ |elm| elm.to_i }
+  if jrver[0] == 1 && jrver[1] < 7
+    warn 'Installing \'jruby-openssl\' for jRuby 1.6.x'
+    inst.install "jruby-openssl"
+  end
+else
+  # Nothing to install for rOCCI-api here
+  #warn 'Installing dependencies specific for Ruby'
+end
+
+# create dummy rakefile to indicate success
+f = File.open(File.join(File.dirname(__FILE__), "Rakefile"), "w")
+f.write "task :default\n"
+f.close

data/lib/occi/cli/helpers.rb

@@ -0,0 +1,149 @@
+# a bunch of OCCI client helpers for bin/occi
+
+def helper_list(options, output = nil)
+  found = []
+
+  if resource_types.include? options.resource
+    Occi::Log.debug "#{options.resource} is a resource type."
+    found = list options.resource
+  elsif mixin_types.include? options.resource
+    Occi::Log.debug "#{options.resource} is a mixin type."
+    found = mixins options.resource
+  else
+    Occi::Log.warn "I have no idea what #{options.resource} is ..."
+    raise "Unknown resource #{options.resource}, there is nothing to list here!"
+  end
+
+  return found if output.nil?
+
+  if Occi::Cli::ResourceOutputFactory.allowed_resource_types.include? options.resource.to_sym
+    puts output.format(found, :locations, options.resource.to_sym)
+  else
+    Occi::Log.warn "Not printing, the resource type is not supported!"
+  end
+end
+
+def helper_describe(options, output = nil)
+  found = []
+
+  if resource_types.include?(options.resource) || options.resource.start_with?(options.endpoint) || options.resource.start_with?('/')
+    Occi::Log.debug "#{options.resource} is a resource type or an actual resource."
+
+    found = describe(options.resource)
+  elsif mixin_types.include? options.resource
+    Occi::Log.debug "#{options.resourcre} is a mixin type."
+
+    mixins(options.resource).each do |mxn|
+      mxn = mxn.split("#").last
+      found << mixin(mxn, options.resource, true)
+    end
+  elsif mixin_types.include? options.resource.split('#').first
+    Occi::Log.debug "#{options.resource} is a specific mixin type."
+
+    mxn_type,mxn = options.resource.split('#')
+    found << mixin(mxn, mxn_type, true)
+  else
+    Occi::Log.warn "I have no idea what #{options.resource} is ..."
+    raise "Unknown resource #{options.resource}, there is nothing to describe here!"
+  end
+
+  return found if output.nil?
+
+  if options.resource.start_with? options.endpoint
+    # resource contains full endpoint URI
+    # e.g., http://localhost:3300/network/adfgadf-daf5a6df4afadf-adfad65f4ad
+    resource_type = options.resource.split('/')[3].to_sym
+  elsif options.resource.start_with? '/'
+    # resource contains a path relative to endpoint URI
+    # e.g., /network/adfgadf-daf5a6df4afadf-adfad65f4ad
+    resource_type = options.resource.split('/')[1].to_sym
+  elsif mixin_types.include? options.resource.split('#').first
+    # resource contains a mixin with a type
+    # e.g., os_tpl#debian6
+    resource_type = options.resource.split('#').first.to_sym
+  else
+    # resource probably contains RAW resource_type
+    resource_type = options.resource.to_sym
+  end
+
+  if Occi::Cli::ResourceOutputFactory.allowed_resource_types.include? resource_type
+    puts output.format(found, :resources, resource_type)
+  else
+    Occi::Log.warn "Not printing, the resource type [#{resource_type.to_s}] is not supported!"
+  end
+end
+
+def helper_create(options, output = nil)
+  location = nil
+
+  if resource_types.include? options.resource
+    Occi::Log.debug "#{options.resource} is a resource type."
+    raise "Not yet implemented!" unless options.resource.include? "compute"
+
+    res = resource options.resource
+
+    Occi::Log.debug "Creating #{options.resource}:\n#{res.inspect}"
+
+    if options.links
+      Occi::Log.debug "with links: #{options.links}"
+
+      options.links.each do |link|
+        link = options.endpoint.chomp('/') + link unless link.start_with? options.endpoint
+
+        if link.include? "/storage/"
+          Occi::Log.debug "Adding storagelink to #{options.resource}"
+          res.storagelink link
+        elsif link.include? "/network/"
+          Occi::Log.debug "Adding networkinterface to #{options.resource}"
+          res.networkinterface link
+        else
+          raise "Unknown link type #{link}, stopping here!"
+        end
+      end
+    end
+
+    if options.mixins
+      Occi::Log.debug "with mixins: #{options.mixins}"
+
+      options.mixins.keys.each do |type|
+        Occi::Log.debug "Adding mixins of type #{type} to #{options.resource}"
+
+        options.mixins[type].each do |name|
+          mxn = mixin name, type
+
+          raise "Unknown mixin #{type}##{name}, stopping here!" if mxn.nil?
+          Occi::Log.debug "Adding mixin #{mxn} to #{options.resource}"
+          res.mixins << mxn
+        end
+      end
+    end
+
+    #TODO: set other attributes
+    res.title = options.attributes[:title]
+
+    Occi::Log.debug "Creating #{options.resource}:\n#{res.inspect}"
+
+    location = create res
+  else
+    Occi::Log.warn "I have no idea what #{options.resource} is ..."
+    raise "Unknown resource #{options.resource}, there is nothing to create here!"
+  end
+
+  return location if output.nil?
+
+  puts location
+end
+
+def helper_delete(options, output = nil)
+  if delete(options.resource)
+    Occi::Log.info "Resource #{options.resource} successfully removed!"
+  else
+    raise "Failed to remove resource #{options.resource}!"
+  end
+
+  true
+end
+
+def helper_trigger(options, output = nil)
+  raise "Not yet implemented!"
+end