ogle 0.0.1

data/.gitignore

@@ -0,0 +1,4 @@
+*.gem
+.bundle
+Gemfile.lock
+pkg/*

data/.rvmrc

@@ -0,0 +1 @@
+rvm ruby-1.9.2-p136@ogle

data/Gemfile

@@ -0,0 +1,4 @@
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in ogle.gemspec
+gemspec

data/README.md

@@ -0,0 +1,47 @@
+# Ogle
+
+> Go ahead and ogle, it's so much more than a glance.
+
+Lean Ruby bindings to OpenStack's [Glance](http://glance.openstack.org/). Exposes the Glance API endpoints in an easy to access manner.
+
+# Why
+
+Depending on the call you make, glance will sometimes return JSON and others XML. This will normalize the returned data for easy use. Plus, I was bored.
+
+## Usage
+
+### Bundler
+
+    gem "ogle"
+
+### Examples
+
+    require "ogle"
+
+    CONNECTION = Ogle::Client.new(
+      :host => "example.com"
+    )
+
+    # This will give a list of all the images
+    response = CONNECTION.resource.all
+    puts response
+    puts response.body
+    puts response.code
+
+    # This will give a detailed list of all the images
+    response = CONNECTION.resource true
+    puts response
+    puts response.body
+    puts response.code
+
+    # This will return the x-image-meta-* headers for a specific image as a hash
+    response = CONNECTION.resource 6
+    puts response.inspect
+
+## Compatability
+
+ruby 1.9.2
+
+## Testing
+
+    $ bundle exec rake

data/Rakefile

@@ -0,0 +1,11 @@
+require "bundler"
+Bundler::GemHelper.install_tasks
+
+require "rake/testtask"
+Rake::TestTask.new(:test) do |test|
+  test.libs   << "./lib" << "./test"
+  test.pattern = "test/**/*_test.rb"
+  test.verbose = true
+end
+
+task :default => :test

data/lib/ogle/client.rb

@@ -0,0 +1,23 @@
+%w(hugs ogle/resource).each { |r| require r }
+
+module Ogle
+  class Client
+    ##
+    # Required:
+    # +host+: A string containing the hostname or IP of your glance server
+
+    def initialize options
+      @connection = Hugs::Client.new(
+        :host     => options[:host],
+        :scheme   => options[:scheme] || "http",
+        :port     => options[:port] || 9292,
+      )
+      @connection.raise_4xx = true
+      @connection.raise_5xx = true
+    end
+
+    def resource
+      @resource ||= Resource.new @connection
+    end
+  end
+end

data/lib/ogle/resource.rb

@@ -0,0 +1,50 @@
+module Ogle
+  class Resource
+    def initialize connection
+      @connection = connection
+    end
+
+    ##
+    # Returns information about images.
+    #
+    # +verbose+: A Boolean toggling the returning of
+    # additional image information.
+
+    def all verbose = false
+      path = verbose ? "/images/detail" : "/images"
+
+      response = @connection.get path
+
+      response.body['images']
+    end
+
+    ##
+    # Returns information about the given 'image_id'.
+    #
+    # +image_id+: A String representing an image_id.
+
+    def find image_id
+      headers = @connection.head "/images/#{image_id}"
+
+      meta ={}
+
+      headers.each_header do |k, v|
+        if k.match('x-image-meta-')
+          meta["#{k}"] = v
+        end
+      end
+
+      meta
+    end
+
+    ##
+    # Stores the disk provided disk image in glance
+    # Stores provided meta-data about the image in glance
+    #
+    # +image_location+: A string representing the location of the image to updload
+    
+    def add image_location
+    end
+  
+  end
+end

data/lib/ogle/version.rb

@@ -0,0 +1,3 @@
+module Ogle
+  VERSION = "0.0.1"
+end

data/lib/ogle.rb

@@ -0,0 +1 @@
+require "ogle/client"

data/ogle.gemspec

@@ -0,0 +1,28 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "ogle/version"
+
+Gem::Specification.new do |s|
+  s.name        = "ogle"
+  s.version     = Ogle::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ["Kevin Bringard"]
+  s.email       = ["kbringard@attinteractive.com"]
+  s.homepage    = ""
+  s.summary     = %q{Ruby interface for OpenStack Glance}
+  s.description = %q{Exposes the API for OpenStack Glance. Go ahead and ogle, it's so much more than a glance.}
+
+  s.rubyforge_project = "ogle"
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+
+  s.add_dependency "hugs", "~> 2.5.2"
+
+  s.add_development_dependency "rake"
+  s.add_development_dependency "vcr", "1.5.0"
+  s.add_development_dependency "webmock"
+  s.add_development_dependency "minitest"
+end

data/test/cassettes/resource_all.yml

@@ -0,0 +1,28 @@
+--- 
+- !ruby/struct:VCR::HTTPInteraction 
+  request: !ruby/struct:VCR::Request 
+    method: :get
+    uri: http://10.1.170.33:9292/images
+    body: 
+    headers: 
+      accept: 
+      - application/json
+      connection: 
+      - keep-alive
+      keep-alive: 
+      - 30
+  response: !ruby/struct:VCR::Response 
+    status: !ruby/struct:VCR::ResponseStatus 
+      code: 200
+      message: OK
+    headers: 
+      content-type: 
+      - text/html; charset=UTF-8
+      content-length: 
+      - "1067"
+      date: 
+      - Fri, 08 Apr 2011 17:56:53 GMT
+      connection: 
+      - keep-alive
+    body: "{\"images\": [{\"name\": \"ttylinux-uec-amd64-12.1_2.6.35-22_1-initrd\", \"container_format\": \"ari\", \"disk_format\": \"ari\", \"checksum\": \"2d222d406f3ed30e03ed44123c33cba6\", \"id\": 1, \"size\": 5882349}, {\"name\": \"ttylinux-uec-amd64-12.1_2.6.35-22_1-vmlinuz\", \"container_format\": \"aki\", \"disk_format\": \"aki\", \"checksum\": \"3ed2965d3f8d877a3ee3e061fd648e9a\", \"id\": 2, \"size\": 4404752}, {\"name\": \"ttylinux-uec-amd64-12.1_2.6.35-22_1.img\", \"container_format\": \"ami\", \"disk_format\": \"ami\", \"checksum\": \"10047a119149e08fb206eea89832eee0\", \"id\": 3, \"size\": 25165824}, {\"name\": \"CentOS5-5.5-Base_VM-032311-212432\", \"container_format\": \"ami\", \"disk_format\": \"ami\", \"checksum\": \"6277381feb8708c393c64499a0ce7e1e\", \"id\": 4, \"size\": 816906240}, {\"name\": \"maverick-server-uec-amd64-vmlinuz-virtual\", \"container_format\": \"aki\", \"disk_format\": \"aki\", \"checksum\": \"73152adae523a52d481f5150deb30356\", \"id\": 5, \"size\": 4408912}, {\"name\": \"maverick-server-uec-amd64.img\", \"container_format\": \"ami\", \"disk_format\": \"ami\", \"checksum\": \"d511da81009517c53f36ff4e8602ff62\", \"id\": 6, \"size\": 1476395008}]}"
+    http_version: "1.1"

data/test/cassettes/resource_all_verbose.yml

@@ -0,0 +1,28 @@
+--- 
+- !ruby/struct:VCR::HTTPInteraction 
+  request: !ruby/struct:VCR::Request 
+    method: :get
+    uri: http://10.1.170.33:9292/images/detail
+    body: 
+    headers: 
+      accept: 
+      - application/json
+      connection: 
+      - keep-alive
+      keep-alive: 
+      - 30
+  response: !ruby/struct:VCR::Response 
+    status: !ruby/struct:VCR::ResponseStatus 
+      code: 200
+      message: OK
+    headers: 
+      content-type: 
+      - text/html; charset=UTF-8
+      content-length: 
+      - "3294"
+      date: 
+      - Fri, 08 Apr 2011 17:56:53 GMT
+      connection: 
+      - keep-alive
+    body: "{\"images\": [{\"status\": \"active\", \"name\": \"ttylinux-uec-amd64-12.1_2.6.35-22_1-initrd\", \"deleted\": false, \"container_format\": \"ari\", \"created_at\": \"2011-04-06T20:03:11.914270\", \"disk_format\": \"ari\", \"updated_at\": \"2011-04-06T20:03:12.206204\", \"id\": 1, \"location\": \"file:///var/lib/glance/images/1\", \"checksum\": \"2d222d406f3ed30e03ed44123c33cba6\", \"is_public\": true, \"deleted_at\": null, \"properties\": {\"arch\": \"amd64\", \"type\": \"ramdisk\", \"uploader\": \"root@e3ab3\", \"distro\": \"ttylinux\"}, \"size\": 5882349}, {\"status\": \"active\", \"name\": \"ttylinux-uec-amd64-12.1_2.6.35-22_1-vmlinuz\", \"deleted\": false, \"container_format\": \"aki\", \"created_at\": \"2011-04-06T20:03:12.585510\", \"disk_format\": \"aki\", \"updated_at\": \"2011-04-06T20:03:12.846637\", \"id\": 2, \"location\": \"file:///var/lib/glance/images/2\", \"checksum\": \"3ed2965d3f8d877a3ee3e061fd648e9a\", \"is_public\": true, \"deleted_at\": null, \"properties\": {\"arch\": \"amd64\", \"version\": \"2.5.35-22_1\", \"type\": \"kernel\", \"uploader\": \"root@e3ab3\", \"distro\": \"ttylinux\"}, \"size\": 4404752}, {\"status\": \"active\", \"name\": \"ttylinux-uec-amd64-12.1_2.6.35-22_1.img\", \"deleted\": false, \"container_format\": \"ami\", \"created_at\": \"2011-04-06T20:03:13.227286\", \"disk_format\": \"ami\", \"updated_at\": \"2011-04-06T20:03:13.602220\", \"id\": 3, \"location\": \"file:///var/lib/glance/images/3\", \"checksum\": \"10047a119149e08fb206eea89832eee0\", \"is_public\": true, \"deleted_at\": null, \"properties\": {\"kernel_id\": \"2\", \"arch\": \"amd64\", \"ramdisk_id\": \"1\", \"version\": \"1.0\", \"kernel_name\": \"ttylinux-uec-amd64-12.1_2.6.35-22_1-vmlinuz\", \"ramdisk_name\": \"ttylinux-uec-amd64-12.1_2.6.35-22_1-initrd\", \"uploader\": \"root@e3ab3\", \"type\": \"machine\", \"distro\": \"ttylinux\"}, \"size\": 25165824}, {\"status\": \"active\", \"name\": \"CentOS5-5.5-Base_VM-032311-212432\", \"deleted\": false, \"container_format\": \"ami\", \"created_at\": \"2011-04-06T20:03:59.759260\", \"disk_format\": \"ami\", \"updated_at\": \"2011-04-06T20:04:04.498592\", \"id\": 4, \"location\": \"file:///var/lib/glance/images/4\", \"checksum\": \"6277381feb8708c393c64499a0ce7e1e\", \"is_public\": true, \"deleted_at\": null, \"properties\": {\"arch\": \"x86_64\", \"builder\": \"kevin\", \"version\": \"5.5\", \"uploader\": \"root@e3ab3\", \"type\": \"machine\", \"distro\": \"CentOS\"}, \"size\": 816906240}, {\"status\": \"active\", \"name\": \"maverick-server-uec-amd64-vmlinuz-virtual\", \"deleted\": false, \"container_format\": \"aki\", \"created_at\": \"2011-04-06T20:04:47.984648\", \"disk_format\": \"aki\", \"updated_at\": \"2011-04-06T20:04:48.281538\", \"id\": 5, \"location\": \"file:///var/lib/glance/images/5\", \"checksum\": \"73152adae523a52d481f5150deb30356\", \"is_public\": true, \"deleted_at\": null, \"properties\": {\"arch\": \"amd64\", \"version\": \"2.6.32\", \"type\": \"kernel\", \"uploader\": \"root@e3ab3\", \"distro\": \"Ubuntu\"}, \"size\": 4408912}, {\"status\": \"active\", \"name\": \"maverick-server-uec-amd64.img\", \"deleted\": false, \"container_format\": \"ami\", \"created_at\": \"2011-04-06T20:04:48.664176\", \"disk_format\": \"ami\", \"updated_at\": \"2011-04-06T20:04:57.042658\", \"id\": 6, \"location\": \"file:///var/lib/glance/images/6\", \"checksum\": \"d511da81009517c53f36ff4e8602ff62\", \"is_public\": true, \"deleted_at\": null, \"properties\": {\"kernel_id\": \"5\", \"type\": \"machine\", \"version\": \"10.10\", \"kernel_name\": \"maverick-server-uec-amd64-vmlinuz-virtual\", \"uploader\": \"root@e3ab3\", \"arch\": \"amd64\", \"distro\": \"Ubuntu\"}, \"size\": 1476395008}]}"
+    http_version: "1.1"

data/test/cassettes/resource_find.yml

@@ -0,0 +1,72 @@
+--- 
+- !ruby/struct:VCR::HTTPInteraction 
+  request: !ruby/struct:VCR::Request 
+    method: :head
+    uri: http://10.1.170.33:9292/images/6
+    body: 
+    headers: 
+      accept: 
+      - application/json
+      connection: 
+      - keep-alive
+      keep-alive: 
+      - 30
+  response: !ruby/struct:VCR::Response 
+    status: !ruby/struct:VCR::ResponseStatus 
+      code: 200
+      message: OK
+    headers: 
+      content-type: 
+      - text/html; charset=UTF-8
+      content-length: 
+      - "0"
+      x-image-meta-property-distro: 
+      - Ubuntu
+      x-image-meta-id: 
+      - "6"
+      x-image-meta-property-arch: 
+      - amd64
+      x-image-meta-deleted: 
+      - "False"
+      x-image-meta-container-format: 
+      - ami
+      x-image-meta-property-uploader: 
+      - root@e3ab3
+      x-image-meta-location: 
+      - file:///var/lib/glance/images/6
+      x-image-meta-deleted-at: 
+      - ""
+      x-image-meta-created-at: 
+      - 2011-04-06T20:04:48.664176
+      x-image-meta-size: 
+      - "1476395008"
+      x-image-meta-status: 
+      - active
+      x-image-meta-property-type: 
+      - machine
+      x-image-meta-property-kernel-name: 
+      - maverick-server-uec-amd64-vmlinuz-virtual
+      x-image-meta-is-public: 
+      - "True"
+      x-image-meta-property-kernel-id: 
+      - "5"
+      x-image-meta-updated-at: 
+      - 2011-04-06T20:04:57.042658
+      x-image-meta-checksum: 
+      - d511da81009517c53f36ff4e8602ff62
+      x-image-meta-property-version: 
+      - "10.10"
+      x-image-meta-disk-format: 
+      - ami
+      x-image-meta-name: 
+      - maverick-server-uec-amd64.img
+      location: 
+      - http://10.1.170.33:9292/images/6
+      etag: 
+      - d511da81009517c53f36ff4e8602ff62
+      date: 
+      - Fri, 08 Apr 2011 17:56:53 GMT
+      connection: 
+      - keep-alive
+    body: 
+    http_version: "1.1"

data/test/lib/ogle/resource_test.rb

@@ -0,0 +1,37 @@
+require "test_helper"
+
+CONNECTION = Ogle::Client.new(
+  :host => "10.1.170.33"
+)
+
+describe Ogle::Resource do
+  describe "#all" do
+    it "returns a hash of images" do
+      VCR.use_cassette "resource_all" do
+        response = CONNECTION.resource.all
+
+        response.size.must_equal 6
+      end
+    end
+  end
+
+  describe "#all true" do
+    it "returns a detailed hash of images (verbose = true)" do
+      VCR.use_cassette "resource_all_verbose" do
+        response = CONNECTION.resource.all true
+
+        response.size.must_equal 6
+      end
+    end
+  end
+
+  describe "#find" do
+    it "returns X-Image-Meta-* headers as a hash" do
+      VCR.use_cassette "resource_find" do
+        response = CONNECTION.resource.find 6
+
+        response.size.must_equal 20
+      end
+    end
+  end
+end

data/test/test_helper.rb

@@ -0,0 +1,18 @@
+%w(bundler minitest/spec ogle vcr webmock).each { |r| require r }
+
+Bundler.setup :default, :test
+
+class MiniTest::Unit::TestCase
+  def cassette_for cassette
+    c = VCR::Cassette.new(cassette).send :recorded_interactions
+  end
+end
+
+VCR.config do |c|
+  c.stub_with :webmock
+  c.cassette_library_dir      = "test/cassettes"
+  c.default_cassette_options  = { :record => :none }
+end
+
+
+MiniTest::Unit.autorun

metadata

@@ -0,0 +1,129 @@
+--- !ruby/object:Gem::Specification 
+name: ogle
+version: !ruby/object:Gem::Version 
+  prerelease: 
+  version: 0.0.1
+platform: ruby
+authors: 
+- Kevin Bringard
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-04-08 00:00:00 -06:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: hugs
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        version: 2.5.2
+  type: :runtime
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: rake
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+  type: :development
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: vcr
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - "="
+      - !ruby/object:Gem::Version 
+        version: 1.5.0
+  type: :development
+  version_requirements: *id003
+- !ruby/object:Gem::Dependency 
+  name: webmock
+  prerelease: false
+  requirement: &id004 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+  type: :development
+  version_requirements: *id004
+- !ruby/object:Gem::Dependency 
+  name: minitest
+  prerelease: false
+  requirement: &id005 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+  type: :development
+  version_requirements: *id005
+description: Exposes the API for OpenStack Glance. Go ahead and ogle, it's so much more than a glance.
+email: 
+- kbringard@attinteractive.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .gitignore
+- .rvmrc
+- Gemfile
+- README.md
+- Rakefile
+- lib/ogle.rb
+- lib/ogle/client.rb
+- lib/ogle/resource.rb
+- lib/ogle/version.rb
+- ogle.gemspec
+- test/cassettes/resource_all.yml
+- test/cassettes/resource_all_verbose.yml
+- test/cassettes/resource_find.yml
+- test/lib/ogle/resource_test.rb
+- test/test_helper.rb
+has_rdoc: true
+homepage: ""
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+requirements: []
+
+rubyforge_project: ogle
+rubygems_version: 1.6.2
+signing_key: 
+specification_version: 3
+summary: Ruby interface for OpenStack Glance
+test_files: 
+- test/cassettes/resource_all.yml
+- test/cassettes/resource_all_verbose.yml
+- test/cassettes/resource_find.yml
+- test/lib/ogle/resource_test.rb
+- test/test_helper.rb