Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Ruby interface for the SUSE Studio API
Ruby

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
lib
test
.gitignore
Gemfile
README.md
Rakefile
VERSION
rubygem-studio_api.changes
rubygem-studio_api.spec.template
studio_api.gemspec

README.md

Studio API: Wrapper to STUDIO API

Synopsis

Studio API library is intended to easier access to Studio API from ruby, but keep it easily extensible and easy maintanable, so it not need rewritting when new attributes introduced to Studio. It leads also that user need to know API documentation, which specify what options you need to use (see http://susestudio.com/help/api/v2 ). It has also feature which allows using in multiuser system (like server).

Example

Example usage ( more in class documentation ). Example show how to clone appliance, upload own rpm, select it, find new software and add it, run new build and then print information about appliance. Note: All error handling is for simplicity removed. It is same as for ActiveResource so if you want see him, search for ActiveResource error handling.

require 'rubygems'
# If you want use it from git adapt LOAD_PATH
# you can load just required parts if you need, but Util loaded all classes to properly set it
require 'studio_api'

# Fill up Studio credentials (user name, API key, API URL)
# See https://susestudio.com/user/show_api_key if you are using SUSE Studio online
connection = StudioApi::Connection.new('user', 'pwd', 'https://susestudio.com/api/v2/user')
# Setup the connection for all ActiveResource based class
StudioApi::Util.configure_studio_connection connection

# Find template with KDE4 for SLE11SP1
templates = StudioApi::TemplateSet.find(:all).find {|s| s.name == "default" }.template
template = templates.find { |t| t.name == "SLED 11 SP1, KDE 4 desktop" }
# clone template to new appliance
appliance = StudioApi::Appliance.clone template.appliance_id, :name => "New cool appliance", :arch => "i686" 
puts "Created appliance #{appliance.inspect}"

#add own rpm built agains SLED11_SP1
File.open("/home/jreidinger/rpms/kezboard-1.0-1.60.noarch.rpm") do |file|
  StudioApi::Rpm.upload file, "SLED11_SP1"
end
# and choose it in appliance ( and of course add repository with own rpms)
appliance.add_user_repository
appliance.add_package "kezboard", :version => "1.0-1.60"

# find samba package and if it is not found in repositories in appliance, try it in all repos
result = appliance.search_software("samba").find { |s| s.name == "samba" }
unless result #it is not found in available repos
  result = appliance.search_software("samba", :all_repos => "true").find { |s| s.name == "samba" }
  # add repo which contain samba
  appliance.add_repository result.repository_id
end
appliance.add_package "samba"

#check if appliance is OK
if appliance.status.state != "ok"
  raise "appliance is not OK - #{appliance.status.issues.inspect}"
end
debugger
build = StudioApi::RunningBuild.new(:appliance_id => appliance.id, :image_type => "xen")
build.save
build.reload
while build.state != "finished"
  puts "building (#{build.state}) - #{build.percent}%"
  sleep 5
  build.reload
end

final_build = StudioApi::Build.find build.id
puts final_build.inspect

# to clear after playing with appliance if you keep same name, clean remove appliances with:
# appliances = StudioApi::Appliance.find :all
# appliances.select{ |a| a.name =~ /cool/i }.each{ |a| a.destroy }

Second example contain how to easy mock calling studio stuff without mock server. Using mocha

require 'mocha'
require 'studio_api'

APPLIANCE_UUID = "68c91080-ccca-4270-a1d3-10e714ddd1c6"
APPLIANCE_VERSION = "0.0.1"
APPLIANCE_STUDIO_ID = "97216"
BUILD_ID = "180420"
APPLIANCE_1 = StudioApi::Appliance.new :id => APPLIANCE_STUDIO_ID, :name => "Test", :arch => 'i386',
                          :last_edited => "2010-10-08 14:46:07 UTC", :estimated_raw_size => "390 MB", :estimated_compressed_size => "140 MB",
                          :edit_url => "http://susestudio.com/appliance/edit/266657", :icon_url => "http://susestudio.com/api/v2/user/appliance_icon/266657",
                          :basesystem => "SLES11_SP1", :uuid => APPLIANCE_UUID, :parent => {:id => "202443", :name => "SLES 11 SP1, Just enough OS (JeOS)"},
                          :builds => [{:id =>BUILD_ID,:version => APPLIANCE_VERSION, :image_type => "vmx", :image_size => "695",
                          :compressed_image_size => "121",
                          :download_url => "http://susestudio.com/download/a0f0217f0645099c9e41c42e9bf89976/josefs_SLES_11_SP1_git_test.i686-0.0.1.vmx.tar.gz"}] 

#real mocking
StudioApi::Appliance.stubs(:find).with(APPLIANCE_STUDIO_ID).returns(APPLIANCE_1)
Something went wrong with that request. Please try again.