kubeclient 0.0.1

checksums.yaml

@@ -0,0 +1,15 @@
+---
+!binary "U0hBMQ==":
+  metadata.gz: !binary |-
+    MGZlMTgzYWFjNmZlY2M5YzRmMGUxNWMwNjhkZDFkOTMwMDJhOGI1ZQ==
+  data.tar.gz: !binary |-
+    ZDE0ZWMzMzQzZDk2MWUyMGY5MjA2NjBhYTAyZmI0M2UzMTBiYTJjOQ==
+SHA512:
+  metadata.gz: !binary |-
+    MGE0Y2QxNDRmYjZlNTQ1MmRjNTk1ZWZkMGVmOTY0MDI0M2U5NmFhMmEzNzk5
+    ZjExZGI3ODAwOGIxYzZlOGY3NWJkOTRiZWQ4ODEwOWFhNzY2NWNlODQ3NjVl
+    YzJlNDE0Yjk3ZWZiOGUzYjlmNGE1YmQ5ZjllNTBhOGQ3YTg3Y2I=
+  data.tar.gz: !binary |-
+    ZDExN2UyYzUyNGIwNDY3NmFlOTk1ZGM1MmQxNGQwNDgxMDFmMDc2MmJlNGVl
+    YzM1MWI0MTlhYThkYzVmNzQxNmU5MDY3Mjk5NmY2OTZiNDViYTVkYjYwMDI0
+    N2E1YWUyNGRiYmE0N2E0NGM1MmE2MGJiNzBiZDYwMmVjNjFjOGI=

data/.gitignore

@@ -0,0 +1,15 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+*.bundle
+*.so
+*.o
+*.a
+mkmf.log
+*.idea*

data/Gemfile

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

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2014 Alissa Bonas
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,86 @@
+# Kubeclient
+
+A Ruby client for Kubernetes REST api.
+The client supports GET, POST, PUT, DELETE on pods, services and replication controllers.
+Also, GET and DELETE is supported for nodes.
+The client currently supports Kubernetes REST api version v1beta1.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'kubeclient'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install kubeclient
+
+## Usage
+
+Please note that all the properties in json objects
+are converted to ruby style in the client (and converted back to k8s side
+before sent to k8s).
+So, containerPort on k8s side is container_port in the client.
+resourceVersion --> resource_version
+
+Initialize the client: <br>
+`client = Kubeclient::Client.new 'http://localhost:8080/api/' , "v1beta1"`
+
+Examples:
+
+1. Get all pods (and respectively: get_services, get_nodes, get_replication_controllers)
+<br>
+`pods = client.get_pods`
+<br>
+
+2. Get a specific node (and respectively: get_service "service id" , get_pod "pod id" , get_replication_controller "rc id" )
+<br>
+`node1 = client.get_node "127.0.0.1"`
+<br>
+Note - Kubernetes doesn't work with the uid, but rather with the 'id' property.
+Querying with uid causes 404.
+
+3. Delete a service (and respectively delete_pod "pod id" , delete_replication_controller "rc id", delete node "node id") <br>
+Input parameter - id (string) specifying service id, pod id, replication controller id.
+<br>
+`client.delete_service "redis-service"`
+<br>
+
+4. Create a service (and respectively: create_pod pod_object, create_replication_controller rc_obj) <br>
+Input parameter - object of type Service, Pod, ReplicationController
+<br>
+`service = Service.new` <br>
+`service.id = "redis-master"`<br>
+`service.port = 6379`<br>
+`service.container_port  = "redis-server"`<br>
+`service.selector = {}`<br>
+`service.selector.name = "redis"`<br>
+`service.selector.role = "master"`<br>
+`client.create_service service`<br>
+`<br>
+
+5. Update entity (update pod, service, replication controller) <br>
+Input parameter - object of type Service, Pod, ReplicationController <br>
+`client.update_service rc1`
+
+## Contributing
+
+1. Fork it ( https://github.com/[my-github-username]/kubeclient/fork )
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create a new Pull Request
+
+## Tests
+
+This client is tested with Minitest.
+Please run all tests before submitting a Pull Request, and add new tests for new functionality.
+
+Running tests: <br>
+`rake test`

data/Rakefile

@@ -0,0 +1,7 @@
+require "bundler/gem_tasks"
+require 'rake/testtask'
+
+task :default => :test
+task :test do
+  Dir.glob('./test/*_test.rb').each { |file| require file}
+end

data/kubeclient.gemspec

@@ -0,0 +1,30 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'kubeclient/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "kubeclient"
+  spec.version       = Kubeclient::VERSION
+  spec.authors       = ["Alissa Bonas"]
+  spec.email         = ["abonas@redhat.com"]
+  spec.summary       = %q{A client for Kubernetes REST api}
+  spec.description   = "A client for Kubernetes REST api"
+  spec.homepage      = ""
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files -z`.split("\x0")
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.6"
+  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency 'minitest'
+  spec.add_development_dependency 'webmock'
+  spec.add_dependency 'rest-client'
+  spec.add_dependency 'activesupport'
+  spec.add_dependency 'json'
+  spec.add_dependency 'recursive-open-struct'
+
+end

data/lib/kubeclient/entity_list.rb

@@ -0,0 +1,10 @@
+class EntityList < Array
+  attr_reader :kind, :resource_version
+
+  def initialize(kind,resource_version)
+    @kind = kind
+    @resource_version = resource_version
+    super()
+  end
+
+end

data/lib/kubeclient/kube_exception.rb

@@ -0,0 +1,13 @@
+class KubeException < Exception
+  attr_reader :error_code, :message
+
+  def initialize(error_code, message)
+    @error_code = error_code
+    @message = message
+  end
+
+  def to_s
+    "HTTP status code " + @error_code.to_s + ", " + @message
+  end
+
+end

data/lib/kubeclient/node.rb

@@ -0,0 +1,4 @@
+require 'recursive_open_struct'
+class Node <  RecursiveOpenStruct
+
+end

data/lib/kubeclient/pod.rb

@@ -0,0 +1,4 @@
+require 'recursive_open_struct'
+class Pod < RecursiveOpenStruct
+
+end

data/lib/kubeclient/replication_controller.rb

@@ -0,0 +1,4 @@
+require 'recursive_open_struct'
+class ReplicationController <  RecursiveOpenStruct
+
+end

data/lib/kubeclient/service.rb

@@ -0,0 +1,5 @@
+require 'recursive_open_struct'
+
+class Service  < RecursiveOpenStruct
+
+end

data/lib/kubeclient/version.rb

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

data/lib/kubeclient.rb

@@ -0,0 +1,131 @@
+require 'kubeclient/version'
+require 'json'
+require 'rest-client'
+require 'active_support/inflector'
+require 'kubeclient/pod'
+require 'kubeclient/node'
+require 'kubeclient/service'
+require 'kubeclient/replication_controller'
+require 'kubeclient/entity_list'
+require 'kubeclient/kube_exception'
+
+
+module Kubeclient
+  class Client
+   attr_reader :api_endpoint
+   entities = %w(Pod Service ReplicationController Node)
+
+    def initialize(api_endpoint,version)
+      if !api_endpoint.end_with? "/"
+         api_endpoint = api_endpoint + "/"
+      end
+      @api_endpoint = api_endpoint+version
+    end
+
+   #todo should a new one be created for every request?
+    def rest_client
+      RestClient::Resource.new(@api_endpoint)
+    end
+
+   entities.each do |entity|
+
+     #get all entities of a type e.g. get_nodes, get_pods, etc.
+     define_method("get_#{entity.underscore.pluralize}") do |labels=nil|
+       #todo labels support
+       #todo namespace support?
+       begin
+         response = rest_client[entity.pluralize.camelize(:lower)].get # nil, labels
+       rescue  RestClient::Exception => e
+         exception = KubeException.new(e.http_code, JSON.parse(e.response)['message'] )
+         raise exception
+       end
+        result = JSON.parse(response)
+        collection = EntityList.new(entity,result["resourceVersion"])
+        result["items"].each { |item | collection.push(create_entity(item, entity, "underscore"))  }
+        collection
+     end
+
+     #get a single entity of a specific type by id
+     define_method("get_#{entity.underscore}") do |id|
+       begin
+         response = rest_client[entity.pluralize.camelize(:lower)+"/#{id}"].get
+       rescue  RestClient::Exception => e
+         exception = KubeException.new(e.http_code, JSON.parse(e.response)['message'] )
+         raise exception
+       end
+         result = JSON.parse(response)
+         create_entity(result, entity, "underscore")
+     end
+
+     protected
+     def create_entity(hash, entity, method_name)
+       rename_keys(hash,method_name, nil)
+       entity.classify.constantize.new(hash)
+     end
+
+     #recursively rename the keys in hash including
+     #nested hashes to/from ruby style
+     protected
+     def rename_keys(hash, method_name, method_param)
+       hash.keys.each { |key|
+         method_object = key.to_s.method(method_name)
+         if method_param != nil
+           new_key = method_object.call(method_param)
+         else
+           new_key = method_object.call
+         end
+         hash[new_key] = hash[key]
+         hash.delete(key) unless new_key == key
+
+         #recursive call to take care of values that are hashes themselves
+         if hash[new_key].is_a?(Hash) then rename_keys(hash[new_key],method_name, method_param) end
+
+       }
+       hash
+     end
+
+     define_method("delete_#{entity.underscore}") do |id|
+       begin
+         rest_client[entity.underscore.pluralize+"/" +id].delete
+       rescue  RestClient::Exception => e
+         exception = KubeException.new(e.http_code, JSON.parse(e.response)['message'] )
+         raise exception
+       end
+
+     end
+
+     unless entity == 'Node' #nodes don't support create/update right now via REST api
+       define_method("create_#{entity.underscore}") do |entity_config|
+         #to_hash should be called because of issue #9 in recursive open struct
+         hash = entity_config.to_hash
+         #keys should be renamed from underscore to k8s json naming style (camelized w first word lowercase)
+         hash = rename_keys(hash, "camelize", :lower)
+         begin
+           rest_client[entity.pluralize.camelize(:lower)].post(hash.to_json)
+         rescue  RestClient::Exception => e
+           exception = KubeException.new(e.http_code, JSON.parse(e.response)['message'] )
+           raise exception
+         end
+       end
+
+       define_method("update_#{entity.underscore}") do |entity_config|
+         id = entity_config.id
+         #to_hash should be called because of issue #9 in recursive open struct
+         hash = entity_config.to_hash
+         #temporary solution to delete id till this issue is solved: https://github.com/GoogleCloudPlatform/kubernetes/issues/3085
+         hash.delete(:id)
+         #keys should be renamed from underscore to k8s json naming style (camelized w first word lowercase)
+         hash = rename_keys(hash, "camelize", :lower)
+         begin
+           rest_client[entity.underscore.pluralize+"/#{id}"].put(hash.to_json)
+         rescue  RestClient::Exception => e
+           exception = KubeException.new(e.http_code, JSON.parse(e.response)['message'] )
+           raise exception
+         end
+       end
+
+     end
+
+   end
+  end
+end

data/test/kubeclient.rb

@@ -0,0 +1,6 @@
+module Kubeclient
+  #using this in order to test a protected method
+  class Client
+    public :rename_keys
+   end
+end

data/test/kubeclient_test.rb

@@ -0,0 +1,104 @@
+require 'minitest/autorun'
+require 'json'
+require 'webmock/minitest'
+require './lib/kubeclient'
+require './test/kubeclient'
+
+
+class KubeClientTest < MiniTest::Test
+
+  def test_renaming_keys
+    json_response = "{\n  \"kind\": \"Node\",\n  \"id\": \"127.0.0.1\",\n  \"uid\": \"b0ddfa00-8b5b-11e4-a8c4-3c970e4a436a\",\n  \"creationTimestamp\": \"2014-12-24T12:57:45+02:00\",\n  \"selfLink\": \"/api/v1beta1/nodes/127.0.0.1\",\n  \"resourceVersion\": 7,\n  \"apiVersion\": \"v1beta1\",\n  \"resources\": {\n    \"capacity\": {\n      \"cpu\": 1000,\n      \"memory\": 3221225472\n    }\n  }\n}"
+    stub_request(:get, /.*nodes*/).
+        to_return(:body => json_response, :status => 200)
+
+    client = Kubeclient::Client.new 'http://localhost:8080/api/' , "v1beta1"
+    original_hash = JSON.parse(json_response)
+    #convert to ruby style
+    hash_after_rename_underscore = client.rename_keys(deep_copy(original_hash),"underscore", nil)
+    #convert back to camelized style with first word downcase
+    hash_after_rename_camelize = client.rename_keys(deep_copy(hash_after_rename_underscore), "camelize", :lower)
+
+    assert_equal(original_hash, hash_after_rename_camelize)
+    assert_equal(7,hash_after_rename_camelize["resourceVersion"])
+    assert_equal(7,hash_after_rename_underscore["resource_version"])
+    assert_equal(nil, hash_after_rename_underscore["resourceVersion"])
+
+
+  end
+
+  #testing that keys renaming works on deeper level
+  #the json doesn't necessarily represent a valid k8s entity , it's for testing renaming purposes
+  def test_renaming_keys_deep
+    json_response = "{\n  \"kind\": \"Node\",\n  \"id\": \"127.0.0.1\",\n  \"uid\": \"b0ddfa00-8b5b-11e4-a8c4-3c970e4a436a\",\n  \"creationTimestamp\": \"2014-12-24T12:57:45+02:00\",\n  \"selfLink\": \"/api/v1beta1/nodes/127.0.0.1\",\n  \"resourceVersion\": 7,\n  \"apiVersion\": \"v1beta1\",\n  \"hostResources\": {\n    \"capacity\": {\n      \"cpu\": 1000,\n      \"memorySize\": 3221225472\n    }\n  }\n}"
+    stub_request(:get, /.*nodes*/).
+        to_return(:body => json_response, :status => 200)
+
+    client = Kubeclient::Client.new 'http://localhost:8080/api/' , "v1beta1"
+    original_hash = JSON.parse(json_response)
+    #convert to ruby style
+    hash_after_rename_underscore = client.rename_keys(deep_copy(original_hash),"underscore", nil)
+    #convert back to camelized style with first word downcase
+    hash_after_rename_camelize = client.rename_keys(deep_copy(hash_after_rename_underscore), "camelize", :lower)
+
+    assert_equal(original_hash, hash_after_rename_camelize)
+    assert_equal(3221225472,hash_after_rename_camelize["hostResources"]["capacity"]["memorySize"])
+    assert_equal(nil,hash_after_rename_underscore["host_resources"]["capacity"]["memorySize"])
+    assert_equal(3221225472,hash_after_rename_underscore["host_resources"]["capacity"]["memory_size"])
+  end
+
+  def test_json
+    our_object = Service.new
+    our_object.foo = 'bar'
+    our_object.nested = {}
+    our_object.nested.again = {}
+    our_object.nested.again.again = {}
+    our_object.nested.again.again.name = "aaron"
+
+    hash = JSON.parse(JSON.dump(our_object.to_h))
+    assert_equal({"foo"=>"bar", "nested"=>{"again"=>{"again"=>{"name"=>"aaron"}}}},
+                 hash)
+  end
+
+  def test_exception
+    json_response =  "{\n \"kind\": \"Status\",\n \"apiVersion\": \"v1beta1\",\n  \"status\": \"Failure\",\n \"message\": \"service redisslave already exists\",\n \"reason\": \"AlreadyExists\",\n \"details\": {\n \"id\": \"redisslave\",\n \"kind\": \"service\"\n},\n \"code\": 409\n}"
+
+    stub_request(:post, /.*services*/).
+        to_return(:body => json_response, :status => 409)
+
+    service = Service.new
+    service.id = 'redisslave'
+    service.port = 80
+    service.container_port = 6379
+    service.protocol = "TCP"
+
+    client = Kubeclient::Client.new 'http://localhost:8080/api/' , "v1beta1"
+    exception = assert_raises(KubeException) { service = client.create_service service }
+
+    assert_instance_of(KubeException, exception)
+    assert_equal( "service redisslave already exists", exception.message )
+    assert_equal( 409, exception.error_code )
+
+  end
+
+  def test_entity_list
+    json_response = "{\n  \"kind\": \"ServiceList\",\n  \"creationTimestamp\": null,\n  \"selfLink\": \"/api/v1beta1/services\",\n  \"resourceVersion\": 8,\n  \"apiVersion\": \"v1beta1\",\n  \"items\": [\n    {\n      \"id\": \"kubernetes\",\n      \"uid\": \"be10c0ba-8f4e-11e4-814c-3c970e4a436a\",\n      \"creationTimestamp\": \"2014-12-29T13:35:08+02:00\",\n      \"selfLink\": \"/api/v1beta1/services/kubernetes?namespace=default\",\n      \"resourceVersion\": 4,\n      \"namespace\": \"default\",\n      \"port\": 443,\n      \"protocol\": \"TCP\",\n      \"labels\": {\n        \"component\": \"apiserver\",\n        \"provider\": \"kubernetes\"\n      },\n      \"selector\": null,\n      \"containerPort\": 0,\n      \"portalIP\": \"10.0.0.151\"\n    },\n    {\n      \"id\": \"kubernetes-ro\",\n      \"uid\": \"be106b89-8f4e-11e4-814c-3c970e4a436a\",\n      \"creationTimestamp\": \"2014-12-29T13:35:08+02:00\",\n      \"selfLink\": \"/api/v1beta1/services/kubernetes-ro?namespace=default\",\n      \"resourceVersion\": 3,\n      \"namespace\": \"default\",\n      \"port\": 80,\n      \"protocol\": \"TCP\",\n      \"labels\": {\n        \"component\": \"apiserver\",\n        \"provider\": \"kubernetes\"\n      },\n      \"selector\": null,\n      \"containerPort\": 0,\n      \"portalIP\": \"10.0.0.171\"\n    }\n  ]\n}"
+    stub_request(:get, /.*services*/).
+        to_return(:body => json_response, :status => 200)
+    client = Kubeclient::Client.new 'http://localhost:8080/api/' , "v1beta1"
+    services = client.get_services
+    refute_empty(services)
+    assert_instance_of(EntityList,services)
+    assert_equal("Service",services.kind)
+    assert_equal(2,services.size)
+    assert_instance_of(Service,services[0])
+    assert_instance_of(Service,services[1])
+  end
+
+  #dup method creates a shallow copy which is not good in this case since rename_keys changes the input hash
+  private
+  def deep_copy(hash)
+    Marshal.load(Marshal.dump(hash))
+  end
+
+end

data/test/node_test.rb

@@ -0,0 +1,44 @@
+require 'minitest/autorun'
+require 'webmock/minitest'
+require 'kubeclient/node'
+require 'json'
+require './lib/kubeclient'
+
+class NodeTest < MiniTest::Test
+  def test_get_from_json
+    json_response = "{\n  \"kind\": \"Node\",\n  \"id\": \"127.0.0.1\",\n  \"uid\": \"b0ddfa00-8b5b-11e4-a8c4-3c970e4a436a\",\n  \"creationTimestamp\": \"2014-12-24T12:57:45+02:00\",\n  \"selfLink\": \"/api/v1beta1/nodes/127.0.0.1\",\n  \"resourceVersion\": 7,\n  \"apiVersion\": \"v1beta1\",\n  \"resources\": {\n    \"capacity\": {\n      \"cpu\": 1000,\n      \"memory\": 3221225472\n    }\n  }\n}"
+
+    stub_request(:get, /.*nodes*/).
+        to_return(:body => json_response, :status => 200)
+
+    client = Kubeclient::Client.new 'http://localhost:8080/api/' , "v1beta1"
+    node = client.get_node "127.0.0.1"
+
+    assert_instance_of(Node,node)
+    #checking that creationTimestamp was renamed properly
+    assert_respond_to(node, "creation_timestamp")
+    assert_respond_to(node, "uid")
+    assert_respond_to(node, "id")
+    assert_respond_to(node, "resources")
+    assert_respond_to(node, "resource_version")
+    assert_respond_to(node, "api_version")
+    assert_respond_to(node, "resources")
+
+    assert_equal 7, node.resource_version
+    assert_equal 1000, node.resources.capacity.cpu
+
+  end
+
+  def test_create_node_fail
+    our_node = Node.new
+    our_node.id = 'newnode'
+
+    stub_request(:delete, /.*nodes*/).
+        to_return(:status => 405)
+
+    client = Kubeclient::Client.new 'http://localhost:8080/api/' , "v1beta1"
+    assert_raises(NoMethodError) { client.create_node our_node }
+
+
+  end
+end

data/test/pod_test.rb

@@ -0,0 +1,24 @@
+require 'minitest/autorun'
+require 'webmock/minitest'
+require 'kubeclient/pod'
+require 'json'
+require './lib/kubeclient'
+
+class PodTest < MiniTest::Test
+
+  def test_get_from_json
+    json_response =  " { \"apiVersion\": \"v1beta1\",\n \"kind\": \"Pod\", \n \"id\": \"redis-master-pod\", \n  \"desiredState\": { \"manifest\": { \"version\": \"v1beta1\", \"id\": \"redis-master-pod\", \n
+    \"containers\": [{ \"name\": \"redis-master\", \"image\": \"gurpartap/redis\", \"ports\": [{ \"name\": \"redis-server\", \"containerPort\": 6379 }] }] } }, \"labels\": { \"name\": \"redis\", \"role\": \"master\" } }"
+
+    stub_request(:get, /.*pods*/).
+        to_return(:body => json_response, :status => 200)
+
+    client = Kubeclient::Client.new 'http://localhost:8080/api/' , "v1beta1"
+    pod = client.get_pod "redis-master-pod"
+
+    assert_instance_of(Pod,pod)
+    assert_equal("redis-master-pod",pod.id)
+    assert_equal("redis-master",pod.desired_state.manifest.containers[0]['name'])
+  end
+
+end

data/test/replication_controller_test.rb

@@ -0,0 +1,27 @@
+require 'minitest/autorun'
+require 'webmock/minitest'
+require './lib/kubeclient'
+require 'kubeclient/replication_controller'
+require 'json'
+
+class ReplicationControllerTest < MiniTest::Test
+
+  def test_get_from_json
+    json_response = "{\n  \"kind\": \"ReplicationController\",\n  \"id\": \"frontendController\",\n  \"uid\": \"f4e5966c-8eb2-11e4-a6e7-3c970e4a436a\",\n  \"creationTimestamp\": \"2014-12-28T18:59:59+02:00\",\n  \"selfLink\": \"/api/v1beta1/replicationControllers/frontendController?namespace=default\",\n  \"resourceVersion\": 11,\n  \"apiVersion\": \"v1beta1\",\n  \"namespace\": \"default\",\n  \"desiredState\": {\n    \"replicas\": 3,\n    \"replicaSelector\": {\n      \"name\": \"frontend\"\n    },\n    \"podTemplate\": {\n      \"desiredState\": {\n        \"manifest\": {\n          \"version\": \"v1beta2\",\n          \"id\": \"\",\n          \"volumes\": null,\n          \"containers\": [\n            {\n              \"name\": \"php-redis\",\n              \"image\": \"brendanburns/php-redis\",\n              \"ports\": [\n                {\n                  \"hostPort\": 8000,\n                  \"containerPort\": 80,\n                  \"protocol\": \"TCP\"\n                }\n              ],\n              \"imagePullPolicy\": \"\"\n            }\n          ],\n          \"restartPolicy\": {\n            \"always\": {}\n          }\n        }\n      },\n      \"labels\": {\n        \"name\": \"frontend\"\n      }\n    }\n  },\n  \"currentState\": {\n    \"replicas\": 3,\n    \"podTemplate\": {\n      \"desiredState\": {\n        \"manifest\": {\n          \"version\": \"\",\n          \"id\": \"\",\n          \"volumes\": null,\n          \"containers\": null,\n          \"restartPolicy\": {}\n        }\n      }\n    }\n  },\n  \"labels\": {\n    \"name\": \"frontend\"\n  }\n}"
+    stub_request(:get, /.*replicationControllers*/).
+        to_return(:body => json_response, :status => 200)
+
+    client = Kubeclient::Client.new 'http://localhost:8080/api/' , "v1beta1"
+    rc = client.get_replication_controller "frontendController"
+
+    assert_instance_of(ReplicationController,rc)
+    assert_equal("frontendController",rc.id)
+    assert_equal("f4e5966c-8eb2-11e4-a6e7-3c970e4a436a",rc.uid)
+    assert_equal("default",rc.namespace)
+    assert_equal(3,rc.desired_state.replicas)
+    assert_equal("frontend",rc.desired_state.replica_selector.name)
+    #the access to containers is not as nice as rest of the properties, but it's about to change in beta v3,
+    #hence it can significantly impact the design of the client. to be revisited after beta v3 api is released.
+    assert_equal("php-redis",rc.desired_state.pod_template.desired_state.manifest.containers[0]['name'])
+  end
+end

data/test/service_test.rb

@@ -0,0 +1,74 @@
+require 'minitest/autorun'
+require 'webmock/minitest'
+require 'kubeclient/service'
+require 'json'
+require './lib/kubeclient'
+
+class ServiceTest < MiniTest::Test
+  def test_get_from_json
+    # creation of the entity from json as if it was read from the server REST api
+    mock = Service.new({"kind"=>"Service", "id"=>"redis-service", "uid"=>"fb01a69c-8ae2-11e4-acc5-3c970e4a436a", "namespace"=>"default", "port"=>80, "protocol"=>"TCP", "labels"=>{"component"=>"apiserver", "provider"=>"kubernetes"}, "selector"=>nil, "creation_timestamp"=>"2014-12-23T22:33:40+02:00", "self_link"=>"/api/v1beta1/services/kubernetes-ro?namespace=default", "resource_version"=>4, "api_version"=>"v1beta1", "container_port"=>0, "portal_ip"=>"10.0.0.54"})
+
+    assert_equal 'redis-service', mock.id
+    assert_equal 'apiserver', mock.labels.component
+  end
+
+  def test_construct_our_own_service
+    our_service = Service.new
+    our_service.id = 'redis-service'
+    our_service.port = 80
+    our_service.protocol = "TCP"
+    our_service.labels = {}
+    our_service.labels.component = 'apiserver'
+    our_service.labels.provider = 'kubernetes'
+
+    assert_equal "kubernetes", our_service.labels.provider
+    assert_equal "apiserver", our_service.labels.component
+
+    hash = our_service.to_h
+
+    assert_equal our_service.labels.provider, hash[:labels][:provider]
+  end
+
+
+  def test_conversion_from_json
+    json_response = "{\n  \"kind\": \"Service\",\n  \"id\": \"redisslave\",\n  \"uid\": \"6a022e83-8ea7-11e4-a6e7-3c970e4a436a\",\n  \"creationTimestamp\": \"2014-12-28T17:37:21+02:00\",\n  \"selfLink\": \"/api/v1beta1/services/redisslave?namespace=default\",\n  \"resourceVersion\": 8,\n  \"apiVersion\": \"v1beta1\",\n  \"namespace\": \"default\",\n  \"port\": 10001,\n  \"protocol\": \"TCP\",\n  \"labels\": {\n    \"name\": \"redisslave\"\n  },\n  \"selector\": {\n    \"name\": \"redisslave\"\n  },\n  \"containerPort\": 6379,\n  \"portalIP\": \"10.0.0.248\"\n}"
+
+    stub_request(:get, /.*services*/).
+        to_return(:body => json_response, :status => 200)
+
+    client = Kubeclient::Client.new 'http://localhost:8080/api/' , "v1beta1"
+    service = client.get_service "redisslave"
+
+    assert_instance_of(Service,service)
+    #checking that creationTimestamp was renamed properly
+    assert_equal("2014-12-28T17:37:21+02:00",service.creation_timestamp)
+    assert_equal("6a022e83-8ea7-11e4-a6e7-3c970e4a436a",service.uid)
+    assert_equal("redisslave",service.id)
+    assert_equal(8,service.resource_version)
+    assert_equal("v1beta1",service.api_version)
+    assert_equal("10.0.0.248",service.portal_ip)
+    assert_equal(6379,service.container_port)
+    assert_equal("TCP",service.protocol)
+    assert_equal(10001,service.port)
+    assert_equal("default",service.namespace)
+
+  end
+
+  def test_delete_service
+    our_service = Service.new
+    our_service.id = 'redis-service'
+    our_service.port = 80
+    our_service.protocol = "TCP"
+    our_service.labels = {}
+    our_service.labels.component = 'apiserver'
+    our_service.labels.provider = 'kubernetes'
+
+    stub_request(:delete, /.*services*/).
+        to_return(:status => 200)
+
+    client = Kubeclient::Client.new 'http://localhost:8080/api/' , "v1beta1"
+    client.delete_service our_service.id
+
+  end
+end

metadata

@@ -0,0 +1,182 @@
+--- !ruby/object:Gem::Specification
+name: kubeclient
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Alissa Bonas
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-12-30 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.6'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.6'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rest-client
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: json
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: recursive-open-struct
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: A client for Kubernetes REST api
+email:
+- abonas@redhat.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- kubeclient.gemspec
+- lib/kubeclient.rb
+- lib/kubeclient/entity_list.rb
+- lib/kubeclient/kube_exception.rb
+- lib/kubeclient/node.rb
+- lib/kubeclient/pod.rb
+- lib/kubeclient/replication_controller.rb
+- lib/kubeclient/service.rb
+- lib/kubeclient/version.rb
+- test/kubeclient.rb
+- test/kubeclient_test.rb
+- test/node_test.rb
+- test/pod_test.rb
+- test/replication_controller_test.rb
+- test/service_test.rb
+homepage: ''
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.2.2
+signing_key: 
+specification_version: 4
+summary: A client for Kubernetes REST api
+test_files:
+- test/kubeclient.rb
+- test/kubeclient_test.rb
+- test/node_test.rb
+- test/pod_test.rb
+- test/replication_controller_test.rb
+- test/service_test.rb