netscaler 0.4.0 → 0.5.0

checksums.yaml

@@ -1,15 +1,15 @@
 ---
 !binary "U0hBMQ==":
   metadata.gz: !binary |-
-    MDAxODcxZGY0ZWZmNmRmYzdhYWRmZjkxMTRjMjEwOTcwYjA3NzcyMg==
+    YjU2YmQ4NTU0MjdhMzc4ZDljNGNiN2ZlMjIwNGI2ODQ0ZjU1NzNjZQ==
   data.tar.gz: !binary |-
-    YzUxNDE2M2E1MGYyOTdlYWQ2ZTg3YTVkNmI4OTgwY2RkOTNiYmY4Mg==
+    ODlmZmMyODA1M2QyYTRmMDc2YjVhYzhkZjdkNTVhZGZmZTZhZTBkMA==
 SHA512:
   metadata.gz: !binary |-
-    NDFlMDViZGVkZGVhMTk5YjBjODQ2NzY0Y2ZiN2UyMjUwNTVlMzFlZjBhZTYz
-    YTM0NzMzNzlmOTdiMzg5ZWI5YjgxYzc1MjVjNWM4MThhZTExYzUxYTc1Y2Nl
-    NWVmY2QwY2EyZjAxNmJkZmEzMDMzY2JkMzcxMGM3ZDU3YmQ3NDA=
+    NmE5ODE4NzFiMDU4NDM0NzU4ZmYyMjFmZjc0ZGE4NTNhMzMyYjk4YTM1MzVi
+    OTQwYTU3YjI2ZDYwZjk5NDE0M2ViMDI2OWZjNzA4ZTNiYTAwMGQ2NjZlY2M5
+    YmFmNWM5NDViMDBmYjdjODVjMzY4M2Q4ZDc3YTg3ZjFlYTYxYTk=
   data.tar.gz: !binary |-
-    OTY3MGI4MTg2ZWU4ZmFmNDBlYWIyY2JkOTkwZWI5MmMwZmFkMDE3ZjVhMWVh
-    Y2NlZjlmMzNkNWQ5Mzk4MGUwOGNkN2FhMmYxMDJlZjI0YTJiYmM0ZmQzNzFm
-    ODIwNTRjZjExMjQ1NzFhMTU1MDdkYmZlMTFjNjhmZGZjNDc0ZWI=
+    MzliMjI5NjY1ZWJiNjQzNmRjNWNhMDEzZmRlZTk2Mjk2MzcxYWZkMTcxNDli
+    MjIzMjcyYTUzNDYxOWZmMDc1YjdlOTY5OGJhZDE4ZTY2ZWU3MjJkNTA3MDRm
+    OWUxZDNlYTlhZjhiZDVlZDg4YTY2YWYzMjBmZWE0NzdlYzE0NmE=

data/Gemfile.lock

@@ -1,13 +1,13 @@
 GEM
   remote: http://rubygems.org/
   specs:
-    addressable (2.3.5)
+    addressable (2.3.6)
     builder (3.2.2)
     diff-lcs (1.1.3)
-    docile (1.1.2)
+    docile (1.1.5)
     faraday (0.8.9)
       multipart-post (~> 1.2.0)
-    git (1.2.6)
+    git (1.2.8)
     github_api (0.10.1)
       addressable
       faraday (~> 0.8.1)
@@ -15,8 +15,8 @@ GEM
       multi_json (~> 1.4)
       nokogiri (~> 1.5.2)
       oauth2
-    hashie (2.0.5)
-    highline (1.6.20)
+    hashie (3.3.2)
+    highline (1.6.21)
     jeweler (1.8.8)
       builder
       bundler (~> 1.0)
@@ -26,26 +26,27 @@ GEM
       nokogiri (= 1.5.10)
       rake
       rdoc
-    json (1.7.5)
-    jwt (0.1.11)
-      multi_json (>= 1.5)
-    mime-types (1.19)
-    multi_json (1.8.4)
+    json (1.8.1)
+    jwt (1.2.0)
+    mime-types (2.4.3)
+    multi_json (1.10.1)
     multi_xml (0.5.5)
     multipart-post (1.2.0)
+    netrc (0.10.2)
     nokogiri (1.5.10)
-    oauth2 (0.9.3)
+    oauth2 (1.0.0)
       faraday (>= 0.8, < 0.10)
-      jwt (~> 0.1.8)
+      jwt (~> 1.0)
       multi_json (~> 1.3)
       multi_xml (~> 0.5)
       rack (~> 1.2)
-    rack (1.5.2)
-    rake (10.1.1)
-    rdoc (3.12)
+    rack (1.6.0)
+    rake (10.4.2)
+    rdoc (3.12.2)
       json (~> 1.4)
-    rest-client (1.6.7)
-      mime-types (>= 1.16)
+    rest-client (1.7.2)
+      mime-types (>= 1.16, < 3.0)
+      netrc (~> 0.7)
     rspec (2.8.0)
       rspec-core (~> 2.8.0)
       rspec-expectations (~> 2.8.0)
@@ -54,9 +55,9 @@ GEM
     rspec-expectations (2.8.0)
       diff-lcs (~> 1.1.2)
     rspec-mocks (2.8.0)
-    simplecov (0.8.2)
+    simplecov (0.9.1)
       docile (~> 1.1.0)
-      multi_json
+      multi_json (~> 1.0)
       simplecov-html (~> 0.8.0)
     simplecov-html (0.8.0)
     simplecov-rcov (0.2.3)

data/LICENSE.txt

@@ -1,4 +1,4 @@
-Copyright (c) 2012 Jeremy Custenborder
+Copyright (c) 2014 Gravity.com, Inc
 
 Permission is hereby granted, free of charge, to any person obtaining
 a copy of this software and associated documentation files (the

data/README.md

@@ -0,0 +1,87 @@
+[![Build Status](https://travis-ci.org/GravityLabs/netscaler.svg?branch=master)](https://travis-ci.org/GravityLabs/netscaler)
+
+# Netscaler Gem
+
+A gem that uses the Netscaler [Nitro API][1] to access configs and stats.  This has been tested only on Netscaler 9.3.  Hoping to have Netscaler 10.0 support added in the near future.
+
+[1]: http://support.citrix.com/proddocs/topic/netscaler-main-api-10-map/ns-nitro-wrapper-con.html        "Nitro API"
+
+
+# THIS IS PRE-ALPHA!!!
+
+It is currently *Pre-Alpha* hence the 0-dot version and is susceptible to methods, classes and modules being renamed, added or deleted.  I will try my best to back support as much as I can but will provide release notes of changes.  Would love to get community support, I have access to a Netscaler and will add this to the spec as well down the road.
+
+## How it works
+### Connecting to a Netscaler
+All params are hash keys.  So to create a new connection to a netscaler:
+```ruby
+conn = Netscaler::Connection :hostname => 'netscaler01', :username => 'foo', :password => 'bar'
+```
+
+If you want to disable ssl verification provide the optional param :verify_ssl => false
+```ruby
+conn = Netscaler::Connection :hostname => 'netscaler01', :username => 'foo', :password => 'bar', :verify_ssl => false
+```
+
+### Disabling and Enabling a Service
+We try to keep the classes and methods match the command groups that are in the netscaler cli.  So if you are familiar with this then it should be pretty easy to guess what the methods will look like.  Such as:
+
+disable service service01
+```ruby
+conn.service.disable(:name => 'service01')
+```
+
+enable service service01
+```ruby
+conn.service.enable(:name => 'service01')
+```
+
+
+## TODO
+
+* Classes and methods for Rewrite policies and actions
+* Classes and methods for Responder policies and actions
+* Classes and methods for Content Switching policies
+* Add new definitions for deleting netscaler object entities
+* Add stats
+* Add support for Nitro 10.0, 10.1
+
+## Contributing to Netscaler Gem
+
+When writing a new class or method we want to try to follow the same names as the command(s) that is in the NSCLI.  For instance:
+
+NSCLI
+```bash
+add server <name> (<IPAddress> | (<domain>)
+```
+RUBY
+```ruby
+conn.server.add :name => 'foo', :domain => '1.1.1.1'
+```
+
+Here is another example, adding an lb vserver.  We created a sub class of Lb called Netscaler::Lb::Vserver.  So it would look something like:
+
+NSCLI
+```bash
+add lb vserver vip1 HTTP 1.1.1.1 80
+```
+
+RUBY
+```ruby
+conn.lb.vserver.add :name => 'vip1', :serviceType => HTTP, :ipv46 => '1.1.1.1', :port => '80'
+```
+
+Otherwise if there are features that are missing or bugs in the code that need fixing, pull requests are welcome.  I am mostly using this for disabling and enabling services but new features are welcome so long as they follow this convention to keep consistency.
+* Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet.
+* Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it.
+* Fork the project.
+* Start a feature/bugfix branch.
+* Commit and push until you are happy with your contribution.
+* Make sure to add tests for it. This is important so I don't break it in a future version unintentionally.
+* Please try not to mess with the Rakefile, version, or history. If you want to have your own version, or is otherwise necessary, that is fine, but please isolate to its own commit so I can cherry-pick around it.
+
+## Copyright
+
+Copyright (c) 2014 Gravity.com, Inc. See LICENSE.txt for
+further details.
+

data/Rakefile

@@ -50,4 +50,4 @@ Rake::RDocTask.new do |rdoc|
   rdoc.rdoc_files.include('lib/**/*.rb')
 end
 
-CLOBBER.include('coverage')
+CLOBBER.include('coverage')

data/VERSION

@@ -1 +1 @@
-0.4.0
+0.5.0

data/lib/netscaler/connection.rb

@@ -11,6 +11,9 @@ require 'netscaler/http_adapter'
 require 'netscaler/adapter'
 require 'netscaler/policy'
 require 'netscaler/lb'
+require 'netscaler/cs'
+require 'netscaler/rewrite'
+require 'netscaler/responder'
 
 module Netscaler
   class Connection
@@ -33,6 +36,9 @@ module Netscaler
       @servers = Server.new self
       @policy = Policy.new self
       @lb = Lb.new self
+      @cs = Cs.new self
+      @rewrite = Rewrite.new self
+      @responder = Responder.new self
     end
 
     def adapter
@@ -67,6 +73,18 @@ module Netscaler
       @lb
     end
 
+    def cs
+      @cs
+    end
+
+    def rewrite
+      @rewrite
+    end
+
+    def responder
+      @responder
+    end
+
     def servers
       return @servers
     end

data/lib/netscaler/cs.rb

@@ -0,0 +1,17 @@
+require 'netscaler/cs/vserver'
+require 'netscaler/cs/vserver/bind'
+require 'netscaler/cs/vserver/unbind'
+
+module Netscaler
+  class Cs
+
+    def initialize(netscaler)
+      @netscaler = netscaler
+    end
+
+    def vserver
+      Vserver.new @netscaler
+    end
+
+  end
+end

data/lib/netscaler/cs/vserver.rb

@@ -0,0 +1,55 @@
+require 'netscaler/netscaler_service'
+
+module Netscaler
+  class Cs
+    class Vserver < NetscalerService
+      def initialize(netscaler)
+        @netscaler=netscaler
+      end
+
+      def show(payload={})
+        if payload[:name] != nil then
+          validate_payload(payload, [:name])
+          return @netscaler.adapter.get("config/csvserver/#{payload[:name]}")
+        elsif payload == {} then
+          return @netscaler.adapter.get('config/csvserver/')
+        else
+          raise ArgumentError, 'payload supplied must have been missing :name'
+        end
+      end
+
+      def show_binding(payload)
+        raise ArgumentError, 'payload cannot be null' if payload.nil?
+        validate_payload(payload, [:name])
+        return @netscaler.adapter.get("config/csvserver_binding/#{payload[:name]}")
+      end
+
+      def remove(payload) # :args: :name
+        raise ArgumentError, 'payload cannot be null' if payload.nil?
+        validate_payload(payload, [:name])
+        return @netscaler.adapter.delete("config/csvserver/#{payload[:name]}")
+      end
+
+      def add(payload)
+        raise ArgumentError, 'payload cannot be null' if payload.nil?
+        validate_payload(payload, [:name, :serviceType, :ipv46, :port])
+        return @netscaler.adapter.post_no_body('config/csvserver/', {'csvserver' => payload})
+      end
+
+      def stat(payload)
+        raise ArgumentError, 'payload cannot be null' if payload.nil?
+        validate_payload(payload, [:name])
+        return @netscaler.adapter.get("stat/csvserver/#{payload[:name]}")
+      end
+
+      def bind
+        Bind.new @netscaler
+      end
+
+      def unbind
+        Unbind.new @netscaler
+      end
+
+    end
+  end
+end

data/lib/netscaler/cs/vserver/bind.rb

@@ -0,0 +1,50 @@
+module Netscaler
+  class Cs
+    class Vserver
+      class Bind < NetscalerService
+        def initialize(netscaler)
+          @netscaler=netscaler
+        end
+
+=begin
+
+        object=
+            {
+                'params': {'action':'bind'},
+            "csvserver_cspolicy_binding":
+            {
+                "name":"cs_test_80",
+            "targetvserver":"lb_thumby_80",
+            "policyname": "cs_test_rule",
+            "priority": "800",
+
+        }
+        }
+
+=end
+        def cs_policy(payload)
+          raise ArgumentError, 'payload cannot be null' if payload.nil?
+          validate_payload(payload, [:name, :targetvserver])
+          # Need to find a way to throw optional args as well, including :policyname and :priority
+          return @netscaler.adapter.post_no_body("config/csvserver_cspolicy_binding/#{payload['name']}", {'params' => {'action' => 'bind'}, 'csvserver_cspolicy_binding' => payload})
+        end
+
+        def rewrite_policy(payload)
+          raise ArgumentError, 'payload cannot be null' if payload.nil?
+          validate_payload(payload, [:name, :policyName, :priority, :bindpoint])
+          return @netscaler.adapter.post_no_body("config/csvserver_rewritepolicy_binding/#{payload['name']}", {'params' => {'action' => 'bind'}, 'csvserver_rewritepolicy_binding' => payload})
+        end
+
+        def responder_policy(payload)
+          raise ArgumentError, 'payload cannot be null' if payload.nil?
+          validate_payload(payload, [:name, :policyName, :priority])
+          return @netscaler.adapter.post_no_body("config/csvserver_responderpolicy_binding/#{payload['name']}", {'params' => {'action' => 'bind'}, 'csvserver_responderpolicy_binding' => payload})
+        end
+
+      end
+    end
+  end
+end
+
+
+

data/lib/netscaler/cs/vserver/unbind.rb

@@ -0,0 +1,49 @@
+module Netscaler
+  class Cs
+    class Vserver
+      class Unbind < NetscalerService
+        def initialize(netscaler)
+          @netscaler=netscaler
+        end
+
+=begin
+
+        object=
+            {
+                'params': {'action':'bind'},
+            "csvserver_cspolicy_binding":
+            {
+                "name":"cs_test_80",
+            "targetvserver":"lb_thumby_80",
+            "policyname": "cs_test_rule",
+            "priority": "800",
+
+        }
+        }
+
+=end
+        def cs_policy(payload)
+          raise ArgumentError, 'payload cannot be null' if payload.nil?
+          validate_payload(payload, [:name])
+          # Need to find a way to throw optional args as well, including :policyname and :priority
+          return @netscaler.adapter.post_no_body("config/csvserver_cspolicy_binding/#{payload['name']}?action=unbind/", {'params' => {'action' => 'unbind'}, 'csvserver_cspolicy_binding' => payload})
+        end
+
+        # Creates new methods that share the same args but have slightly different endpoints
+        %w( rewrite responder).each do |type|
+
+          define_method(type + '_policy') do |payload|
+            raise ArgumentError, 'payload cannot be null' if payload.nil?
+            validate_payload(payload, [:name, :policyName])
+            return @netscaler.adapter.post_no_body("config/csvserver_#{type}policy_binding/#{payload['name']}?action=unbind/", {'params' => {'action' => 'unbind'}, "lbvserver_#{type}policy_binding" => payload})
+          end
+
+        end
+
+      end
+    end
+  end
+end
+
+
+

data/lib/netscaler/responder.rb

@@ -0,0 +1,20 @@
+require 'netscaler/responder/action'
+require 'netscaler/responder/policy'
+
+module Netscaler
+  class Responder
+
+    def initialize(netscaler)
+      @netscaler = netscaler
+    end
+
+    def action
+      Action.new @netscaler
+    end
+
+    def policy
+      Policy.new @netscaler
+    end
+
+  end
+end

data/lib/netscaler/responder/action.rb

@@ -0,0 +1,25 @@
+require 'netscaler/netscaler_service'
+
+module Netscaler
+  class Responder
+    class Action < NetscalerService
+
+      def initialize(netscaler)
+        @netscaler=netscaler
+      end
+
+      def show(payload={})
+        if payload[:name] != nil then
+          validate_payload(payload, [:name])
+          return @netscaler.adapter.get("config/responderaction/#{payload[:name]}")
+        elsif payload == {} then
+          return @netscaler.adapter.get('config/responderaction/')
+        else
+          raise ArgumentError, 'payload supplied must have been missing :name'
+        end
+      end
+
+    end
+  end
+end
+

data/lib/netscaler/responder/policy.rb

@@ -0,0 +1,25 @@
+require 'netscaler/netscaler_service'
+
+module Netscaler
+  class Responder
+    class Policy < NetscalerService
+
+      def initialize(netscaler)
+        @netscaler=netscaler
+      end
+
+      def show(payload={})
+        if payload[:name] != nil then
+          validate_payload(payload, [:name])
+          return @netscaler.adapter.get("config/responderpolicy/#{payload[:name]}")
+        elsif payload == {} then
+          return @netscaler.adapter.get('config/responderpolicy/')
+        else
+          raise ArgumentError, 'payload supplied must have been missing :name'
+        end
+      end
+
+    end
+  end
+end
+

data/lib/netscaler/rewrite.rb

@@ -0,0 +1,20 @@
+require 'netscaler/rewrite/action'
+require 'netscaler/rewrite/policy'
+
+module Netscaler
+  class Rewrite
+
+    def initialize(netscaler)
+      @netscaler = netscaler
+    end
+
+    def action
+      Action.new @netscaler
+    end
+
+    def policy
+      Policy.new @netscaler
+    end
+
+  end
+end

data/lib/netscaler/rewrite/action.rb

@@ -0,0 +1,25 @@
+require 'netscaler/netscaler_service'
+
+module Netscaler
+  class Rewrite
+    class Action < NetscalerService
+
+      def initialize(netscaler)
+        @netscaler=netscaler
+      end
+
+      def show(payload={})
+        if payload[:name] != nil then
+          validate_payload(payload, [:name])
+          return @netscaler.adapter.get("config/rewriteaction/#{payload[:name]}")
+        elsif payload == {} then
+          return @netscaler.adapter.get('config/rewriteaction/')
+        else
+          raise ArgumentError, 'payload supplied must have been missing :name'
+        end
+      end
+
+    end
+  end
+end
+

data/lib/netscaler/rewrite/policy.rb

@@ -0,0 +1,25 @@
+require 'netscaler/netscaler_service'
+
+module Netscaler
+  class Rewrite
+    class Policy < NetscalerService
+
+      def initialize(netscaler)
+        @netscaler=netscaler
+      end
+
+      def show(payload={})
+        if payload[:name] != nil then
+          validate_payload(payload, [:name])
+          return @netscaler.adapter.get("config/rewritepolicy/#{payload[:name]}")
+        elsif payload == {} then
+          return @netscaler.adapter.get('config/rewritepolicy/')
+        else
+          raise ArgumentError, 'payload supplied must have been missing :name'
+        end
+      end
+
+    end
+  end
+end
+

data/lib/netscaler/service.rb

@@ -18,6 +18,12 @@ module Netscaler
       return @netscaler.adapter.post_no_body('config/service/', {'service' => payload})
     end
 
+    def remove(payload) # :args: :server
+      raise ArgumentError, 'payload cannot be null' if payload.nil?
+      validate_payload(payload, [:name])
+      return @netscaler.adapter.delete("config/service/#{payload[:name]}")
+    end
+
     ##
     # :serverName is optional, if omitted it will return all services
     # configured on the Netscaler.

data/lib/netscaler/servicegroup.rb

@@ -21,7 +21,7 @@ module Netscaler
     ##
     # argument is optional, if left empty it will return all servicegroups
     def show(payload={}) # :arg: servicegroupname
-      return @netscaler.adapter.get("config/servicegroup/") if payload = {}
+      return @netscaler.adapter.get("config/servicegroup/") if payload.empty?
       return @netscaler.adapter.get("config/servicegroup/#{payload}")
     end
 

data/netscaler.gemspec

@@ -2,21 +2,21 @@
 # DO NOT EDIT THIS FILE DIRECTLY
 # Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
 # -*- encoding: utf-8 -*-
-# stub: netscaler 0.4.0 ruby lib
+# stub: netscaler 0.5.0 ruby lib
 
 Gem::Specification.new do |s|
   s.name = "netscaler"
-  s.version = "0.4.0"
+  s.version = "0.5.0"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.require_paths = ["lib"]
   s.authors = ["Jeremy Custenborder", "David Andrew", "Jarrett Irons"]
-  s.date = "2014-12-20"
+  s.date = "2015-01-19"
   s.description = "Netscaler api working against the Citrix Nitro api.  Currently supports Nitro 9.3.  Hope to add support for 10.X.  Currently has support for som basics such as adding servers/services/servicegroups."
   s.email = ["jeremy@scarcemedia.com", "david.andrew@webtrends.com", "jarrett.irons@gmail.com"]
   s.extra_rdoc_files = [
     "LICENSE.txt",
-    "README.rdoc"
+    "README.md"
   ]
   s.files = [
     ".document",
@@ -24,12 +24,16 @@ Gem::Specification.new do |s|
     "Gemfile",
     "Gemfile.lock",
     "LICENSE.txt",
-    "README.rdoc",
+    "README.md",
     "Rakefile",
     "VERSION",
     "lib/netscaler.rb",
     "lib/netscaler/adapter.rb",
     "lib/netscaler/connection.rb",
+    "lib/netscaler/cs.rb",
+    "lib/netscaler/cs/vserver.rb",
+    "lib/netscaler/cs/vserver/bind.rb",
+    "lib/netscaler/cs/vserver/unbind.rb",
     "lib/netscaler/http_adapter.rb",
     "lib/netscaler/lb.rb",
     "lib/netscaler/lb/monitor.rb",
@@ -42,13 +46,22 @@ Gem::Specification.new do |s|
     "lib/netscaler/netscaler_service.rb",
     "lib/netscaler/policy.rb",
     "lib/netscaler/policy/stringmap.rb",
+    "lib/netscaler/responder.rb",
+    "lib/netscaler/responder/action.rb",
+    "lib/netscaler/responder/policy.rb",
+    "lib/netscaler/rewrite.rb",
+    "lib/netscaler/rewrite/action.rb",
+    "lib/netscaler/rewrite/policy.rb",
     "lib/netscaler/server.rb",
     "lib/netscaler/service.rb",
     "lib/netscaler/servicegroup.rb",
     "netscaler.gemspec",
+    "spec/csvserver_spec.rb",
     "spec/lbvserver_spec.rb",
     "spec/netscaler_spec.rb",
     "spec/policy_stringmap_spec.rb",
+    "spec/responder_spec.rb",
+    "spec/rewrite_spec.rb",
     "spec/server_spec.rb",
     "spec/service_spec.rb",
     "spec/servicegroup_spec.rb",

data/spec/csvserver_spec.rb

@@ -0,0 +1,212 @@
+require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
+require 'netscaler'
+require 'netscaler/mock_adapter'
+
+describe Netscaler::Cs::Vserver do
+
+  connection = Netscaler::Connection.new 'hostname' => 'foo', 'password' => 'bar', 'username' => 'bar'
+  connection.adapter = Netscaler::MockAdapter.new :body => '{ "errorcode": 0, "message": "Done" }'
+
+  context 'when adding a new csvserver' do
+    it 'a name is required' do
+      expect {
+        connection.cs.vserver.add(:serviceType => 'HTTP', :port => '80', :ipv46 => '1.1.1.1')
+      }.should raise_error(ArgumentError, /name/)
+    end
+
+    it 'a service type is required' do
+      expect {
+        connection.cs.vserver.add(:name => 'foo', :port => '80', :ipv46 => '1.1.1.1')
+      }.should raise_error(ArgumentError, /serviceType/)
+    end
+
+    it 'a port is required' do
+      expect {
+        connection.cs.vserver.add(:name => 'foo', :serviceType => 'HTTP', :ipv46 => '1.1.1.1')
+      }.should raise_error(ArgumentError, /port/)
+    end
+
+    it 'a ipv46 is required' do
+      expect {
+        connection.cs.vserver.add(:name => 'foo', :serviceType => 'HTTP', :port => '80')
+      }.should raise_error(ArgumentError, /ipv46/)
+    end
+
+    it 'return hash when supplied all required params' do
+      result = connection.cs.vserver.add(:name => 'foo', :serviceType => 'HTTP', :port => '80', :ipv46 => '1.1.1.1')
+      result.should be_kind_of(Hash)
+    end
+  end
+
+  context 'when using the show method in Cs::Vserver' do
+    it 'with no param used it will return all vservers' do
+      result = connection.cs.vserver.show
+      result.should be_kind_of(Hash)
+    end
+
+    it 'supplying the name parameter will return Hash' do
+      result = connection.cs.vserver.show :name => 'foo'
+      result.should be_kind_of(Hash)
+    end
+
+    it 'when showing a particular lb vserver string is invalid' do
+      expect {
+        connection.cs.vserver.show('asdf')
+      }.should raise_error(TypeError, /conver(t|sion)/)
+    end
+
+    it 'when showing a particular lb vserver :name is required' do
+      expect {
+        connection.cs.vserver.show(:foo => 'bar')
+      }.should raise_error(ArgumentError, /name/)
+    end
+  end
+
+  context 'when removing an lb vserver' do
+    it 'a name is required' do
+      expect {
+        connection.cs.vserver.remove()
+      }.should raise_error(ArgumentError, /wrong number/)
+    end
+
+    it 'throw an arg error if :name arg is missing' do
+      expect {
+        connection.cs.vserver.remove(:foo => 'bar')
+      }.should raise_error(ArgumentError, /name/)
+    end
+
+    it 'should return a hash if :name is supplied' do
+      result = connection.cs.vserver.remove :name => 'foo'
+      result.should be_kind_of(Hash)
+    end
+  end
+
+  context 'when showing csvserver bindings' do
+    it 'should throw an error if there is no arg' do
+      expect {
+        connection.cs.vserver.show_binding()
+      }.should raise_error(ArgumentError, /wrong number/)
+    end
+
+    it 'throw an arg error if :name arg is missing' do
+      expect {
+        connection.cs.vserver.show_binding(:foo => 'bar')
+      }.should raise_error(ArgumentError, /name/)
+    end
+
+    it 'should return a hash if :name is supplied' do
+      result = connection.cs.vserver.show_binding :name => 'foo'
+      result.should be_kind_of(Hash)
+    end
+  end
+
+  context 'when [un]binding lb vservers to cs vserver' do
+    it 'should throw an error if :name arg is not given' do
+      expect {
+        connection.cs.vserver.bind.cs_policy :serviceName => 'foo'
+      }.should raise_error(ArgumentError, /name/)
+      expect {
+        connection.cs.vserver.unbind.cs_policy :serviceName => 'foo'
+      }.should raise_error(ArgumentError, /name/)
+    end
+
+    it 'should throw an error if :targetvserver arg is not given' do
+      expect {
+        connection.cs.vserver.bind.cs_policy :name => 'foo'
+      }.should raise_error(ArgumentError, /targetvserver/)
+
+      #This is actually not expected when unbinding.
+      # expect {
+      #   connection.cs.vserver.unbind.cs_policy :name => 'foo'
+      # }.should raise_error(ArgumentError, /targetvserver/)
+
+    end
+
+    it 'should return a Hash if all require arguments are supplied' do
+      result = connection.cs.vserver.bind.cs_policy :name => 'foo', :targetvserver => 'bar'
+      result.should be_kind_of(Hash)
+      unbind_result = connection.cs.vserver.unbind.cs_policy :name => 'foo'
+      unbind_result.should be_kind_of(Hash)
+
+    end
+  end
+
+  context 'when [un]binding rewritepolicies to cs vserver' do
+    it 'should throw an error if :name arg is not given' do
+      expect {
+        connection.cs.vserver.bind.rewrite_policy :policyName => 'bar', :priority => '10', :bindpoint => 'request'
+      }.should raise_error(ArgumentError, /name/)
+
+      expect {
+        connection.cs.vserver.unbind.rewrite_policy :policyName => 'bar', :priority => '10', :bindpoint => 'request'
+      }.should raise_error(ArgumentError, /name/)
+
+    end
+
+    it 'should throw an error if :policyName arg is not given' do
+      expect {
+        connection.cs.vserver.bind.rewrite_policy :name => 'foo', :priority => '10', :bindpoint => 'request'
+      }.should raise_error(ArgumentError, /policyName/)
+
+      expect {
+        connection.cs.vserver.unbind.rewrite_policy :name => 'foo', :priority => '10', :bindpoint => 'request'
+      }.should raise_error(ArgumentError, /policyName/)
+    end
+
+    it 'should throw an error if :priority arg is not given' do
+      expect {
+        connection.cs.vserver.bind.rewrite_policy :name => 'foo', :policyName => 'bar', :bindpoint => 'request'
+      }.should raise_error(ArgumentError, /priority/)
+    end
+
+    it 'should throw an error if :bindpoint arg is not given' do
+      expect {
+        connection.cs.vserver.bind.rewrite_policy :name => 'foo', :policyName => 'bar', :priority => '10'
+      }.should raise_error(ArgumentError, /bindpoint/)
+    end
+
+    it 'should return a Hash if all require arguments are supplied' do
+      result = connection.cs.vserver.bind.rewrite_policy :name => 'foo', :policyName => 'bar', :priority => '10', :bindpoint => 'request'
+      result.should be_kind_of(Hash)
+      unbind_result = connection.cs.vserver.unbind.rewrite_policy :name => 'foo', :policyName => 'bar'
+      unbind_result.should be_kind_of(Hash)
+    end
+  end
+
+  context 'when [un]binding responderpolicies to cs vserver' do
+    it 'should throw an error if :name arg is not given' do
+      expect {
+        connection.cs.vserver.bind.responder_policy :policyName => 'bar', :priority => '10'
+      }.should raise_error(ArgumentError, /name/)
+
+      expect {
+        connection.cs.vserver.unbind.responder_policy :policyName => 'bar', :priority => '10'
+      }.should raise_error(ArgumentError, /name/)
+
+    end
+
+    it 'should throw an error if :policyName arg is not given' do
+      expect {
+        connection.cs.vserver.bind.responder_policy :name => 'foo', :priority => '10'
+      }.should raise_error(ArgumentError, /policyName/)
+
+      expect {
+        connection.cs.vserver.unbind.responder_policy :name => 'foo', :priority => '10'
+      }.should raise_error(ArgumentError, /policyName/)
+    end
+
+    it 'should throw an error if :priority arg is not given' do
+      expect {
+        connection.cs.vserver.bind.responder_policy :name => 'foo', :policyName => 'bar'
+      }.should raise_error(ArgumentError, /priority/)
+    end
+
+    it 'should return a Hash if all require arguments are supplied' do
+      result = connection.cs.vserver.bind.responder_policy :name => 'foo', :policyName => 'bar', :priority => '10', :bindpoint => 'request'
+      result.should be_kind_of(Hash)
+      unbind_result = connection.cs.vserver.unbind.responder_policy :name => 'foo', :policyName => 'bar'
+      unbind_result.should be_kind_of(Hash)
+    end
+  end
+
+end

data/spec/lbvserver_spec.rb

@@ -52,7 +52,7 @@ describe Netscaler::Lb::Vserver do
     it 'when showing a particular lb vserver string is invalid' do
       expect {
         connection.lb.vserver.show('asdf')
-      }.should raise_error(TypeError, /convert/)
+      }.should raise_error(TypeError, /conver(t|sion)/)
     end
 
     it 'when showing a particular lb vserver :name is required' do

data/spec/responder_spec.rb

@@ -0,0 +1,63 @@
+require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
+require 'netscaler'
+require 'netscaler/mock_adapter'
+
+describe Netscaler::Responder::Action do
+
+  connection = Netscaler::Connection.new 'hostname' => 'foo', 'password' => 'bar', 'username' => 'bar'
+  connection.adapter = Netscaler::MockAdapter.new :body => '{ "errorcode": 0, "message": "Done" }'
+
+  context 'when using the show method in Responder::Action' do
+    it 'with no param used it will return all responder actions' do
+      result = connection.responder.action.show
+      result.should be_kind_of(Hash)
+    end
+
+    it 'supplying the name parameter will return Hash' do
+      result = connection.responder.action.show :name => 'foo'
+      result.should be_kind_of(Hash)
+    end
+
+    it 'when showing a particular responder action, string is invalid' do
+      expect {
+        connection.responder.action.show('asdf')
+      }.should raise_error(TypeError, /conver(t|sion)/)
+    end
+
+    it 'when showing a particular responder action :name is required' do
+      expect {
+        connection.responder.action.show(:foo => 'bar')
+      }.should raise_error(ArgumentError, /name/)
+    end
+  end
+end
+
+describe Netscaler::Responder::Policy do
+
+  connection = Netscaler::Connection.new 'hostname' => 'foo', 'password' => 'bar', 'username' => 'bar'
+  connection.adapter = Netscaler::MockAdapter.new :body => '{ "errorcode": 0, "message": "Done" }'
+
+  context 'when using the show method in Responder::Policy' do
+    it 'with no param used it will return all responder policies' do
+      result = connection.responder.policy.show
+      result.should be_kind_of(Hash)
+    end
+
+    it 'supplying the name parameter will return Hash' do
+      result = connection.responder.policy.show :name => 'foo'
+      result.should be_kind_of(Hash)
+    end
+
+    it 'when showing a particular responder policy, string is invalid' do
+      expect {
+        connection.responder.policy.show('asdf')
+      }.should raise_error(TypeError, /conver(t|sion)/)
+    end
+
+    it 'when showing a particular responder policy :name is required' do
+      expect {
+        connection.responder.policy.show(:foo => 'bar')
+      }.should raise_error(ArgumentError, /name/)
+    end
+  end
+end

data/spec/rewrite_spec.rb

@@ -0,0 +1,63 @@
+require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
+require 'netscaler'
+require 'netscaler/mock_adapter'
+
+describe Netscaler::Rewrite::Action do
+
+  connection = Netscaler::Connection.new 'hostname' => 'foo', 'password' => 'bar', 'username' => 'bar'
+  connection.adapter = Netscaler::MockAdapter.new :body => '{ "errorcode": 0, "message": "Done" }'
+
+  context 'when using the show method in Rewrite::Action' do
+    it 'with no param used it will return all rewrite actions' do
+      result = connection.rewrite.action.show
+      result.should be_kind_of(Hash)
+    end
+
+    it 'supplying the name parameter will return Hash' do
+      result = connection.rewrite.action.show :name => 'foo'
+      result.should be_kind_of(Hash)
+    end
+
+    it 'when showing a particular rewrite action, string is invalid' do
+      expect {
+        connection.rewrite.action.show('asdf')
+      }.should raise_error(TypeError, /conver(t|sion)/)
+    end
+
+    it 'when showing a particular rewrite action :name is required' do
+      expect {
+        connection.rewrite.action.show(:foo => 'bar')
+      }.should raise_error(ArgumentError, /name/)
+    end
+  end
+end
+
+describe Netscaler::Rewrite::Policy do
+
+  connection = Netscaler::Connection.new 'hostname' => 'foo', 'password' => 'bar', 'username' => 'bar'
+  connection.adapter = Netscaler::MockAdapter.new :body => '{ "errorcode": 0, "message": "Done" }'
+
+  context 'when using the show method in Rewrite::Policy' do
+    it 'with no param used it will return all rewrite policies' do
+      result = connection.rewrite.policy.show
+      result.should be_kind_of(Hash)
+    end
+
+    it 'supplying the name parameter will return Hash' do
+      result = connection.rewrite.policy.show :name => 'foo'
+      result.should be_kind_of(Hash)
+    end
+
+    it 'when showing a particular rewrite policy, string is invalid' do
+      expect {
+        connection.rewrite.policy.show('asdf')
+      }.should raise_error(TypeError, /conver(t|sion)/)
+    end
+
+    it 'when showing a particular rewrite policy :name is required' do
+      expect {
+        connection.rewrite.policy.show(:foo => 'bar')
+      }.should raise_error(ArgumentError, /name/)
+    end
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: netscaler
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.5.0
 platform: ruby
 authors:
 - Jeremy Custenborder
@@ -10,7 +10,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-12-20 00:00:00.000000000 Z
+date: 2015-01-19 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rest-client
@@ -135,19 +135,23 @@ executables: []
 extensions: []
 extra_rdoc_files:
 - LICENSE.txt
-- README.rdoc
+- README.md
 files:
 - .document
 - .rspec
 - Gemfile
 - Gemfile.lock
 - LICENSE.txt
-- README.rdoc
+- README.md
 - Rakefile
 - VERSION
 - lib/netscaler.rb
 - lib/netscaler/adapter.rb
 - lib/netscaler/connection.rb
+- lib/netscaler/cs.rb
+- lib/netscaler/cs/vserver.rb
+- lib/netscaler/cs/vserver/bind.rb
+- lib/netscaler/cs/vserver/unbind.rb
 - lib/netscaler/http_adapter.rb
 - lib/netscaler/lb.rb
 - lib/netscaler/lb/monitor.rb
@@ -160,13 +164,22 @@ files:
 - lib/netscaler/netscaler_service.rb
 - lib/netscaler/policy.rb
 - lib/netscaler/policy/stringmap.rb
+- lib/netscaler/responder.rb
+- lib/netscaler/responder/action.rb
+- lib/netscaler/responder/policy.rb
+- lib/netscaler/rewrite.rb
+- lib/netscaler/rewrite/action.rb
+- lib/netscaler/rewrite/policy.rb
 - lib/netscaler/server.rb
 - lib/netscaler/service.rb
 - lib/netscaler/servicegroup.rb
 - netscaler.gemspec
+- spec/csvserver_spec.rb
 - spec/lbvserver_spec.rb
 - spec/netscaler_spec.rb
 - spec/policy_stringmap_spec.rb
+- spec/responder_spec.rb
+- spec/rewrite_spec.rb
 - spec/server_spec.rb
 - spec/service_spec.rb
 - spec/servicegroup_spec.rb

data/README.rdoc

@@ -1,31 +0,0 @@
-[![Build Status](https://travis-ci.org/GravityLabs/netscaler.svg?branch=master)](https://travis-ci.org/GravityLabs/netscaler)
-
-= Netscaler Gem
-
-A gem that uses the Netscaler {Nitro API}[http://support.citrix.com/proddocs/topic/netscaler-main-api-10-map/ns-nitro-wrapper-con.html] to access configs and stats.  This has been tested only on Netscaler 9.3.  Hoping to have Netscaler 10.0 support added in the near future.
-
-= THIS IS PRE-ALPHA!!!
-
-It is currently *Pre-Alpha* hence the 0-dot version and is suseptible to methods, classes and modules being renamed, added or deleted.  I will try my best to back support as much as i can but will provide release notes of changes.  Would love to get community support, i have access to a Netscaler and will add this to the spec as well down the road.
-
-== TODO
-
-* Add new definitions for deleting netscaler object entities
-* Add stats
-* Add support for Nitro 10.0, 10.1
-
-== Contributing to Netscaler Gem
- 
-* Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet.
-* Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it.
-* Fork the project.
-* Start a feature/bugfix branch.
-* Commit and push until you are happy with your contribution.
-* Make sure to add tests for it. This is important so I don't break it in a future version unintentionally.
-* Please try not to mess with the Rakefile, version, or history. If you want to have your own version, or is otherwise necessary, that is fine, but please isolate to its own commit so I can cherry-pick around it.
-
-== Copyright
-
-Copyright (c) 2012 Jeremy Custenborder. See LICENSE.txt for
-further details.
-