nettica 0.1.0

data/History.txt

@@ -0,0 +1,4 @@
+== 0.1.0 / 2008-01-28
+
+* Initial release
+

data/Manifest.txt

@@ -0,0 +1,13 @@
+History.txt
+Manifest.txt
+README.txt
+Rakefile
+bin/nettica
+lib/nettica.rb
+lib/nettica/client.rb
+lib/nettica/stubs/DnsApiAsmxClient.rb
+lib/nettica/stubs/nettica.rb
+lib/nettica/stubs/nettica.wsdl
+lib/nettica/stubs/netticaDriver.rb
+lib/nettica/stubs/netticaMappingRegistry.rb
+test/test_nettica.rb

data/README.txt

@@ -0,0 +1,50 @@
+nettica
+    by Matt Conway
+    http://simplygenius.com
+
+== DESCRIPTION:
+  
+A ruby client for managing nettica bulk-dns entries using the Nettica SOAP API
+
+== FEATURES/PROBLEMS:
+  
+* A thin wrapper for convenience around the soap4r generated stubs for the nettica wsdl.
+
+== SYNOPSIS:
+
+  require 'nettica/client'
+  client = Neticca::Client.new('joe_user', 'secret_password')
+  puts client.list_zones
+
+== REQUIREMENTS:
+
+* soap4r gem
+
+== INSTALL:
+
+* sudo gem install nettica
+
+== LICENSE:
+
+(The MIT License)
+
+Copyright (c) 2008 FIX
+
+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/Rakefile

@@ -0,0 +1,19 @@
+# -*- ruby -*-
+
+require 'rubygems'
+require 'hoe'
+require './lib/nettica.rb'
+
+Hoe.new('nettica', Nettica::VERSION) do |p|
+  p.rubyforge_name = 'nettica'
+  p.author = 'Matt Conway'
+  p.email = 'wr0ngway@yahoo.com'
+  p.summary = 'A ruby client for managing nettica bulk-dns entries using the Nettica SOAP API'
+  # p.description = p.paragraphs_of('README.txt', 2..5).join("\n\n")
+  # p.url = p.paragraphs_of('README.txt', 0).first.split(/\n/)[1..-1]
+  p.changes = p.paragraphs_of('History.txt', 0..1).join("\n\n")
+  p.extra_deps << ['soap4r']
+  p.remote_rdoc_dir = '' # Release to root
+end
+
+# vim: syntax=Ruby

data/bin/nettica

@@ -0,0 +1,44 @@
+#!/usr/bin/env ruby
+
+require 'optparse'
+require 'ostruct'
+
+require 'rubygems'
+require 'nettica/client'
+
+options = OpenStruct.new
+
+opts = OptionParser.new do |opts|
+  opts.banner = "Usage: nettica -u username -p password -c command"
+  opts.separator "Runs the given nettica service command"
+  opts.separator ""
+  opts.separator "Options:"
+
+  opts.on("-u", "--user USER", "Nettica username to use for authentication") do |val|
+    options.username = val
+  end
+  opts.on("-p", "--password PASSWORD", "Nettica password to use for authentication") do |val|
+    options.password = val
+  end
+  opts.on("-c", "--command COMMAND", [:list_zones, :get_service_info],
+           "Command to execute against nettica service.",
+           "One of list_zones, get_service_info") do |val|
+    options.command = val
+  end
+
+  opts.on_tail("-h", "--help", "Show this message") do
+    puts opts
+    exit
+  end
+end
+
+begin
+  args = opts.parse!(ARGV)
+  raise "Missing required flag" if ! options.username || ! options.password || ! options.command
+rescue Exception => e
+  puts e, "", opts
+  exit
+end
+
+client = Nettica::Client.new(options.username, options.password)
+puts client.send(options.command).inspect

data/lib/nettica.rb

@@ -0,0 +1,3 @@
+class Nettica
+  VERSION = '0.1.0'
+end

data/lib/nettica/client.rb

@@ -0,0 +1,74 @@
+require 'rubygems'
+gem 'soap4r'
+require "nettica/stubs/netticaDriver"
+require 'base64'
+
+# http://dev.ctor.org/soap4r
+# http://markthomas.org/2007/09/12/getting-started-with-soap4r/
+# wsdl2ruby.rb --module_path Nettica::Stubs --wsdl 'https://www.nettica.com/DNS/DnsApi.asmx?WSDL' --type client --classdef nettica --force
+
+module Nettica
+
+  class Client
+
+    include Nettica::Stubs
+
+    def initialize(username, password)
+      @username = username
+      @password = Base64.encode64(password).strip
+      @proxy = DnsApiAsmxSoap.new
+    end
+
+
+    #   domainName - SOAP::SOAPString
+    #   hostName - SOAP::SOAPString
+    #   recordType - SOAP::SOAPString
+    #   data - SOAP::SOAPString
+    #   ttl - SOAP::SOAPInt
+    #   priority - SOAP::SOAPInt
+    def self.create_domain_record(domainName = nil, hostName = nil, recordType = nil, data = nil, ttl = nil, priority = nil)
+      DomainRecord.new(domainName, hostName, recordType, data, ttl, priority)
+    end
+
+    def update_record(old_domain_record, new_domain_record)
+      @proxy.updateRecord(UpdateRecord.new(@username, @password, old_domain_record, new_domain_record)).updateRecordResult
+    end
+
+    def delete_record(domain_record)
+      @proxy.deleteRecord(DeleteRecord.new(@username, @password, domain_record)).deleteRecordResult
+    end
+
+    def list_zones()
+      @proxy.listZones(ListZones.new(@username, @password)).listZonesResult
+    end
+
+    def apply_template(domainName, groupName)
+      @proxy.applyTemplate(ApplyTemplate.new(@username, @password, domainName, groupName)).applyTemplateResult
+    end
+
+    def list_domain(domainName)
+      @proxy.listDomain(ListDomain.new(@username, @password, domainName)).listDomainResult
+    end
+
+    def create_secondary_zone(domainName, master, ipAddress)
+      @proxy.createSecondaryZone(CreateSecondaryZone.new(@username, @password, domainName, master, ipAddress)).createSecondaryZoneResult
+    end
+
+    def get_service_info()
+      @proxy.getServiceInfo(GetServiceInfo.new(@username, @password)).getServiceInfoResult
+    end
+
+    def delete_zone(domainName)
+      @proxy.deleteZone(DeleteZone.new(@username, @password, domainName)).deleteZoneResult
+    end
+
+    def create_zone(domainName, ipAddress)
+      @proxy.createZone(CreateZone.new(@username, @password, domainName, ipAddress)).createZoneResult
+    end
+
+    def add_record(domain_record)
+      @proxy.addRecord(AddRecord.new(@username, @password, domain_record)).addRecordResult
+    end
+  end
+
+end

data/lib/nettica/stubs/DnsApiAsmxClient.rb

@@ -0,0 +1,136 @@
+#!/usr/bin/env ruby
+require 'nettica/stubs/netticaDriver.rb'
+
+
+module Nettica::Stubs
+
+endpoint_url = ARGV.shift
+obj = DnsApiAsmxSoap.new(endpoint_url)
+
+# run ruby with -d to see SOAP wiredumps.
+obj.wiredump_dev = STDERR if $DEBUG
+
+# SYNOPSIS
+#   GetServiceInfo(parameters)
+#
+# ARGS
+#   parameters      GetServiceInfo - {http://www.nettica.com/DNS/DnsApi}GetServiceInfo
+#
+# RETURNS
+#   parameters      GetServiceInfoResponse - {http://www.nettica.com/DNS/DnsApi}GetServiceInfoResponse
+#
+parameters = nil
+puts obj.getServiceInfo(parameters)
+
+# SYNOPSIS
+#   CreateZone(parameters)
+#
+# ARGS
+#   parameters      CreateZone - {http://www.nettica.com/DNS/DnsApi}CreateZone
+#
+# RETURNS
+#   parameters      CreateZoneResponse - {http://www.nettica.com/DNS/DnsApi}CreateZoneResponse
+#
+parameters = nil
+puts obj.createZone(parameters)
+
+# SYNOPSIS
+#   CreateSecondaryZone(parameters)
+#
+# ARGS
+#   parameters      CreateSecondaryZone - {http://www.nettica.com/DNS/DnsApi}CreateSecondaryZone
+#
+# RETURNS
+#   parameters      CreateSecondaryZoneResponse - {http://www.nettica.com/DNS/DnsApi}CreateSecondaryZoneResponse
+#
+parameters = nil
+puts obj.createSecondaryZone(parameters)
+
+# SYNOPSIS
+#   DeleteZone(parameters)
+#
+# ARGS
+#   parameters      DeleteZone - {http://www.nettica.com/DNS/DnsApi}DeleteZone
+#
+# RETURNS
+#   parameters      DeleteZoneResponse - {http://www.nettica.com/DNS/DnsApi}DeleteZoneResponse
+#
+parameters = nil
+puts obj.deleteZone(parameters)
+
+# SYNOPSIS
+#   ListZones(parameters)
+#
+# ARGS
+#   parameters      ListZones - {http://www.nettica.com/DNS/DnsApi}ListZones
+#
+# RETURNS
+#   parameters      ListZonesResponse - {http://www.nettica.com/DNS/DnsApi}ListZonesResponse
+#
+parameters = nil
+puts obj.listZones(parameters)
+
+# SYNOPSIS
+#   ListDomain(parameters)
+#
+# ARGS
+#   parameters      ListDomain - {http://www.nettica.com/DNS/DnsApi}ListDomain
+#
+# RETURNS
+#   parameters      ListDomainResponse - {http://www.nettica.com/DNS/DnsApi}ListDomainResponse
+#
+parameters = nil
+puts obj.listDomain(parameters)
+
+# SYNOPSIS
+#   AddRecord(parameters)
+#
+# ARGS
+#   parameters      AddRecord - {http://www.nettica.com/DNS/DnsApi}AddRecord
+#
+# RETURNS
+#   parameters      AddRecordResponse - {http://www.nettica.com/DNS/DnsApi}AddRecordResponse
+#
+parameters = nil
+puts obj.addRecord(parameters)
+
+# SYNOPSIS
+#   UpdateRecord(parameters)
+#
+# ARGS
+#   parameters      UpdateRecord - {http://www.nettica.com/DNS/DnsApi}UpdateRecord
+#
+# RETURNS
+#   parameters      UpdateRecordResponse - {http://www.nettica.com/DNS/DnsApi}UpdateRecordResponse
+#
+parameters = nil
+puts obj.updateRecord(parameters)
+
+# SYNOPSIS
+#   DeleteRecord(parameters)
+#
+# ARGS
+#   parameters      DeleteRecord - {http://www.nettica.com/DNS/DnsApi}DeleteRecord
+#
+# RETURNS
+#   parameters      DeleteRecordResponse - {http://www.nettica.com/DNS/DnsApi}DeleteRecordResponse
+#
+parameters = nil
+puts obj.deleteRecord(parameters)
+
+# SYNOPSIS
+#   ApplyTemplate(parameters)
+#
+# ARGS
+#   parameters      ApplyTemplate - {http://www.nettica.com/DNS/DnsApi}ApplyTemplate
+#
+# RETURNS
+#   parameters      ApplyTemplateResponse - {http://www.nettica.com/DNS/DnsApi}ApplyTemplateResponse
+#
+parameters = nil
+puts obj.applyTemplate(parameters)
+
+
+
+
+end

data/lib/nettica/stubs/nettica.rb

@@ -0,0 +1,373 @@
+require 'xsd/qname'
+
+module Nettica; module Stubs
+
+
+# {http://www.nettica.com/DNS/DnsApi}ServiceResult
+#   result - Nettica::Stubs::DnsResult
+#   remainingCredits - SOAP::SOAPInt
+#   totalCredits - SOAP::SOAPInt
+#   serviceRenewalDate - SOAP::SOAPDateTime
+class ServiceResult
+  attr_accessor :result
+  attr_accessor :remainingCredits
+  attr_accessor :totalCredits
+  attr_accessor :serviceRenewalDate
+
+  def initialize(result = nil, remainingCredits = nil, totalCredits = nil, serviceRenewalDate = nil)
+    @result = result
+    @remainingCredits = remainingCredits
+    @totalCredits = totalCredits
+    @serviceRenewalDate = serviceRenewalDate
+  end
+end
+
+# {http://www.nettica.com/DNS/DnsApi}DnsResult
+#   status - SOAP::SOAPInt
+#   description - SOAP::SOAPString
+class DnsResult
+  attr_accessor :status
+  attr_accessor :description
+
+  def initialize(status = nil, description = nil)
+    @status = status
+    @description = description
+  end
+end
+
+# {http://www.nettica.com/DNS/DnsApi}ZoneResult
+#   result - Nettica::Stubs::DnsResult
+#   count - SOAP::SOAPInt
+#   zone - Nettica::Stubs::ArrayOfString
+class ZoneResult
+  attr_accessor :result
+  attr_accessor :count
+  attr_accessor :zone
+
+  def initialize(result = nil, count = nil, zone = nil)
+    @result = result
+    @count = count
+    @zone = zone
+  end
+end
+
+# {http://www.nettica.com/DNS/DnsApi}ArrayOfString
+class ArrayOfString < ::Array
+end
+
+# {http://www.nettica.com/DNS/DnsApi}DomainResult
+#   result - Nettica::Stubs::DnsResult
+#   count - SOAP::SOAPInt
+#   record - Nettica::Stubs::ArrayOfDomainRecord
+class DomainResult
+  attr_accessor :result
+  attr_accessor :count
+  attr_accessor :record
+
+  def initialize(result = nil, count = nil, record = nil)
+    @result = result
+    @count = count
+    @record = record
+  end
+end
+
+# {http://www.nettica.com/DNS/DnsApi}ArrayOfDomainRecord
+class ArrayOfDomainRecord < ::Array
+end
+
+# {http://www.nettica.com/DNS/DnsApi}DomainRecord
+#   domainName - SOAP::SOAPString
+#   hostName - SOAP::SOAPString
+#   recordType - SOAP::SOAPString
+#   data - SOAP::SOAPString
+#   tTL - SOAP::SOAPInt
+#   priority - SOAP::SOAPInt
+class DomainRecord
+  attr_accessor :domainName
+  attr_accessor :hostName
+  attr_accessor :recordType
+  attr_accessor :data
+  attr_accessor :tTL
+  attr_accessor :priority
+
+  def initialize(domainName = nil, hostName = nil, recordType = nil, data = nil, tTL = nil, priority = nil)
+    @domainName = domainName
+    @hostName = hostName
+    @recordType = recordType
+    @data = data
+    @tTL = tTL
+    @priority = priority
+  end
+end
+
+# {http://www.nettica.com/DNS/DnsApi}GetServiceInfo
+#   userName - SOAP::SOAPString
+#   password - SOAP::SOAPString
+class GetServiceInfo
+  attr_accessor :userName
+  attr_accessor :password
+
+  def initialize(userName = nil, password = nil)
+    @userName = userName
+    @password = password
+  end
+end
+
+# {http://www.nettica.com/DNS/DnsApi}GetServiceInfoResponse
+#   getServiceInfoResult - Nettica::Stubs::ServiceResult
+class GetServiceInfoResponse
+  attr_accessor :getServiceInfoResult
+
+  def initialize(getServiceInfoResult = nil)
+    @getServiceInfoResult = getServiceInfoResult
+  end
+end
+
+# {http://www.nettica.com/DNS/DnsApi}CreateZone
+#   userName - SOAP::SOAPString
+#   password - SOAP::SOAPString
+#   domainName - SOAP::SOAPString
+#   ipAddress - SOAP::SOAPString
+class CreateZone
+  attr_accessor :userName
+  attr_accessor :password
+  attr_accessor :domainName
+  attr_accessor :ipAddress
+
+  def initialize(userName = nil, password = nil, domainName = nil, ipAddress = nil)
+    @userName = userName
+    @password = password
+    @domainName = domainName
+    @ipAddress = ipAddress
+  end
+end
+
+# {http://www.nettica.com/DNS/DnsApi}CreateZoneResponse
+#   createZoneResult - Nettica::Stubs::DnsResult
+class CreateZoneResponse
+  attr_accessor :createZoneResult
+
+  def initialize(createZoneResult = nil)
+    @createZoneResult = createZoneResult
+  end
+end
+
+# {http://www.nettica.com/DNS/DnsApi}CreateSecondaryZone
+#   userName - SOAP::SOAPString
+#   password - SOAP::SOAPString
+#   domainName - SOAP::SOAPString
+#   master - SOAP::SOAPString
+#   ipAddress - SOAP::SOAPString
+class CreateSecondaryZone
+  attr_accessor :userName
+  attr_accessor :password
+  attr_accessor :domainName
+  attr_accessor :master
+  attr_accessor :ipAddress
+
+  def initialize(userName = nil, password = nil, domainName = nil, master = nil, ipAddress = nil)
+    @userName = userName
+    @password = password
+    @domainName = domainName
+    @master = master
+    @ipAddress = ipAddress
+  end
+end
+
+# {http://www.nettica.com/DNS/DnsApi}CreateSecondaryZoneResponse
+#   createSecondaryZoneResult - Nettica::Stubs::DnsResult
+class CreateSecondaryZoneResponse
+  attr_accessor :createSecondaryZoneResult
+
+  def initialize(createSecondaryZoneResult = nil)
+    @createSecondaryZoneResult = createSecondaryZoneResult
+  end
+end
+
+# {http://www.nettica.com/DNS/DnsApi}DeleteZone
+#   userName - SOAP::SOAPString
+#   password - SOAP::SOAPString
+#   domainName - SOAP::SOAPString
+class DeleteZone
+  attr_accessor :userName
+  attr_accessor :password
+  attr_accessor :domainName
+
+  def initialize(userName = nil, password = nil, domainName = nil)
+    @userName = userName
+    @password = password
+    @domainName = domainName
+  end
+end
+
+# {http://www.nettica.com/DNS/DnsApi}DeleteZoneResponse
+#   deleteZoneResult - Nettica::Stubs::DnsResult
+class DeleteZoneResponse
+  attr_accessor :deleteZoneResult
+
+  def initialize(deleteZoneResult = nil)
+    @deleteZoneResult = deleteZoneResult
+  end
+end
+
+# {http://www.nettica.com/DNS/DnsApi}ListZones
+#   userName - SOAP::SOAPString
+#   password - SOAP::SOAPString
+class ListZones
+  attr_accessor :userName
+  attr_accessor :password
+
+  def initialize(userName = nil, password = nil)
+    @userName = userName
+    @password = password
+  end
+end
+
+# {http://www.nettica.com/DNS/DnsApi}ListZonesResponse
+#   listZonesResult - Nettica::Stubs::ZoneResult
+class ListZonesResponse
+  attr_accessor :listZonesResult
+
+  def initialize(listZonesResult = nil)
+    @listZonesResult = listZonesResult
+  end
+end
+
+# {http://www.nettica.com/DNS/DnsApi}ListDomain
+#   userName - SOAP::SOAPString
+#   password - SOAP::SOAPString
+#   domainName - SOAP::SOAPString
+class ListDomain
+  attr_accessor :userName
+  attr_accessor :password
+  attr_accessor :domainName
+
+  def initialize(userName = nil, password = nil, domainName = nil)
+    @userName = userName
+    @password = password
+    @domainName = domainName
+  end
+end
+
+# {http://www.nettica.com/DNS/DnsApi}ListDomainResponse
+#   listDomainResult - Nettica::Stubs::DomainResult
+class ListDomainResponse
+  attr_accessor :listDomainResult
+
+  def initialize(listDomainResult = nil)
+    @listDomainResult = listDomainResult
+  end
+end
+
+# {http://www.nettica.com/DNS/DnsApi}AddRecord
+#   userName - SOAP::SOAPString
+#   password - SOAP::SOAPString
+#   d - Nettica::Stubs::DomainRecord
+class AddRecord
+  attr_accessor :userName
+  attr_accessor :password
+  attr_accessor :d
+
+  def initialize(userName = nil, password = nil, d = nil)
+    @userName = userName
+    @password = password
+    @d = d
+  end
+end
+
+# {http://www.nettica.com/DNS/DnsApi}AddRecordResponse
+#   addRecordResult - Nettica::Stubs::DnsResult
+class AddRecordResponse
+  attr_accessor :addRecordResult
+
+  def initialize(addRecordResult = nil)
+    @addRecordResult = addRecordResult
+  end
+end
+
+# {http://www.nettica.com/DNS/DnsApi}UpdateRecord
+#   userName - SOAP::SOAPString
+#   password - SOAP::SOAPString
+#   old - Nettica::Stubs::DomainRecord
+#   new - Nettica::Stubs::DomainRecord
+class UpdateRecord
+  attr_accessor :userName
+  attr_accessor :password
+  attr_accessor :old
+  attr_accessor :new
+
+  def initialize(userName = nil, password = nil, old = nil, new = nil)
+    @userName = userName
+    @password = password
+    @old = old
+    @new = new
+  end
+end
+
+# {http://www.nettica.com/DNS/DnsApi}UpdateRecordResponse
+#   updateRecordResult - Nettica::Stubs::DnsResult
+class UpdateRecordResponse
+  attr_accessor :updateRecordResult
+
+  def initialize(updateRecordResult = nil)
+    @updateRecordResult = updateRecordResult
+  end
+end
+
+# {http://www.nettica.com/DNS/DnsApi}DeleteRecord
+#   userName - SOAP::SOAPString
+#   password - SOAP::SOAPString
+#   d - Nettica::Stubs::DomainRecord
+class DeleteRecord
+  attr_accessor :userName
+  attr_accessor :password
+  attr_accessor :d
+
+  def initialize(userName = nil, password = nil, d = nil)
+    @userName = userName
+    @password = password
+    @d = d
+  end
+end
+
+# {http://www.nettica.com/DNS/DnsApi}DeleteRecordResponse
+#   deleteRecordResult - Nettica::Stubs::DnsResult
+class DeleteRecordResponse
+  attr_accessor :deleteRecordResult
+
+  def initialize(deleteRecordResult = nil)
+    @deleteRecordResult = deleteRecordResult
+  end
+end
+
+# {http://www.nettica.com/DNS/DnsApi}ApplyTemplate
+#   userName - SOAP::SOAPString
+#   password - SOAP::SOAPString
+#   domainName - SOAP::SOAPString
+#   groupName - SOAP::SOAPString
+class ApplyTemplate
+  attr_accessor :userName
+  attr_accessor :password
+  attr_accessor :domainName
+  attr_accessor :groupName
+
+  def initialize(userName = nil, password = nil, domainName = nil, groupName = nil)
+    @userName = userName
+    @password = password
+    @domainName = domainName
+    @groupName = groupName
+  end
+end
+
+# {http://www.nettica.com/DNS/DnsApi}ApplyTemplateResponse
+#   applyTemplateResult - Nettica::Stubs::DnsResult
+class ApplyTemplateResponse
+  attr_accessor :applyTemplateResult
+
+  def initialize(applyTemplateResult = nil)
+    @applyTemplateResult = applyTemplateResult
+  end
+end
+
+
+end; end