infoblox 0.1.0 → 0.2.0

data/README.md

@@ -16,43 +16,28 @@ Or install it yourself as:
 
     $ gem install infoblox
 
-## Command-line usage
-The infoblox gem installs a command-line script called "infoblox," which supports
-querying, adding, and removing host names from dns records: 
-
-    infoblox --help
-
-
-## Ruby client usage
-The Client class has a few helper methods to make certain operations easier.  Creating a host record: 
-  
-    client = Infoblox::Client.new(:username => "foo", 
-                                  :password => "bar", 
-                                  :host => "https://foo-bar-dns.example.com")
-
-
-    client.create_host("build-machine.internal", "10.10.3.3")
-    client.delete_host("build-machine.internal")
-    client.find_host_by_name("build-")
-
-One can also use the resource classes directly to run arbitrary query logic.  An instance
-of the Infoblox::Connection class is necessary:
+# Usage
+An instance of the Infoblox::Connection class is necessary:
 
     connection = Infoblox::Connection.new(:username => '', :password => '', :host => '')
 
-    Infoblox::Network.find(connection, {"_return_fields" => "extensible_attributes"})
+Once a connection is made, one can use the resource class methods to query records: 
+
+    Infoblox::Network.all(connection)
     # => [...]
    
     Infoblox::Host.find(connection, {"name~" => "demo[0-9]{1,}-web.domain"})
     # => [...]
 
-The Resource sub-classes also support `get`, `post`, `put`, and `delete`.  For example, creating a network is pretty straightforward: 
+The resource class instances support `get`, `post`, `put`, and `delete`.  For example, creating a network is pretty straightforward: 
  
     network = Infoblox::Network.new(:connection => connection)
     network.network = "10.20.30.0/24"
     network.extensible_attributes = {"VLAN" => "my_vlan"}
     network.auto_create_reversezone = true
     network.post # true
+    network.network = "10.20.31.0/24"
+    network.put  # true
 
 ## Contributing
 

data/lib/infoblox.rb

@@ -6,7 +6,6 @@ require 'openssl'
 require 'infoblox/version'
 require 'infoblox/connection'
 require 'infoblox/resource'
-require 'infoblox/client'
 require 'infoblox/resource/cname'
 require 'infoblox/resource/host'
 require 'infoblox/resource/host_ipv4addr'

data/lib/infoblox/version.rb

@@ -1,3 +1,3 @@
 module Infoblox
-  VERSION = "0.1.0"
+  VERSION = "0.2.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: infoblox
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
   prerelease: 
 platform: ruby
 authors:
@@ -110,8 +110,7 @@ dependencies:
 description: A Ruby wrapper to the Infoblox WAPI
 email:
 - billy.reisinger@govdelivery.com
-executables:
-- infoblox
+executables: []
 extensions: []
 extra_rdoc_files: []
 files:
@@ -121,10 +120,8 @@ files:
 - LICENSE.txt
 - README.md
 - Rakefile
-- bin/infoblox
 - infoblox.gemspec
 - lib/infoblox.rb
-- lib/infoblox/client.rb
 - lib/infoblox/connection.rb
 - lib/infoblox/resource.rb
 - lib/infoblox/resource/cname.rb

data/bin/infoblox

@@ -1,56 +0,0 @@
-#!/usr/bin/env ruby
-
-require 'infoblox'
-require 'pp'
-require 'optparse'
-
-def print_host(*hosts)
-  hosts.flatten.each do |h|
-    puts "Host\t#{h.name}"
-    puts "IP  \t" + h.ipv4addrs.map{|i| i["ipv4addr"]}.join(",")
-    puts "Ref \t" + h._ref
-  end
-end
-
-options = {}
-OptionParser.new do |opts|
-  opts.banner = "Usage: #{$0}.rb [options]"
-  opts.on("-u", "--user USER", "username for infoblox") do |u|
-    options[:username] = u
-  end
-  opts.on("-p", "--pass PASSWORD", "password for infoblox") do |p|
-    options[:password] = p
-  end
-  opts.on("-f", "--find SEARCH", "find the specified hosts (fuzzy match) and print info") do |f|
-    options[:find] = f
-  end
-  opts.on("-h", "--host INFOBLOX_HOST", "the hostname of the Infoblox appliance, including protocol") do |h|
-    options[:host] = h
-  end
-  opts.on("-c", "--create HOST_AND_IP", "create the specified host. Supply the host and ip address, separated by a comma (no space).") do |c|
-    options[:create] = c
-  end
-  opts.on("-d", "--delete HOST", "delete the specified host ") do |d|
-    options[:delete] = d
-  end
-  opts.on("-v", "--[no-]verbose", "Run verbosely") do |v|
-    options[:verbose] = v
-  end
-
-end.parse!
-
-if options[:verbose] 
-  options[:logger] = Logger.new(STDOUT) 
-end
-
-client = Infoblox::Client.new(options)
-
-if options[:find]
-  print_host client.find_host_by_name(options[:find])
-end
-if options[:delete]
-  print_host client.delete_host(options[:delete])
-end
-if options[:create]
-  pp client.create_host(*options[:create].split(','))
-end

data/lib/infoblox/client.rb

@@ -1,53 +0,0 @@
-module Infoblox
-  class Client
-    ##
-    # :username
-    # :password
-    # :host (host if infoblox appliance, including protocol)
-    def initialize(options={})
-      self.connection = Connection.new(options)
-    end
-
-    def all_hosts
-      Host.all(connection)
-    end
-
-    ## 
-    # Find all host records by wildcard name. 
-    # 
-    def find_host_by_name(name)
-      Host.find(connection, :"name~" => name)
-    end
-
-    ##
-    # Find all ipv4addr records by ip address fragment.
-    # ex:  find_ips('10.10.2') => [#<Infoblox::Ipv4addr>...]
-    #
-    def find_ips(ip_fragment)
-      Ipv4addr.find(connection, :"ipv4addr~" => ip_fragment)
-    end
-
-    ##
-    # Create a host record for the given IP address
-    # hostname : string
-    # ip       : ipv4 string, i.e. "10.40.20.3"
-    def create_host(hostname, ip, dns=true)
-      host = Host.new(:name => hostname, :configure_for_dns => true, :connection => connection)
-      host.add_ipv4addr(ip)
-      host.create
-    end
-
-    ##
-    # Remove all host entries for a given host
-    #
-    def delete_host(hostname)
-      if !(hosts = Host.find(connection, :name => hostname)).empty?
-        hosts.map(&:delete)
-        hosts
-      else
-        raise Exception.new("host #{hostname} not found")
-        false
-      end
-    end
-  end
-end