netsol 0.1

checksums.yaml

@@ -0,0 +1,7 @@
+--- 
+SHA512: 
+  metadata.gz: 456ae34da22a474169e49e446cad41794d34fc028324d9ec2e8d83202427902b9943dafd417c2091f5cd96479632105789f8ef50b9d96963176c432e7c8df869
+  data.tar.gz: af1f3982e3fa2615532e68d344260e45b0a1f76ce2425a4c76efce6f0ca5b531d3b7e5234d1c6e0882a8e887b5800c861eead0ff747cb1fc20ca182988e94b65
+SHA1: 
+  metadata.gz: c5b89f6dc37ca7e3e7e32f25d069ee12b3a83263
+  data.tar.gz: 7f05543a30650aa955da407da61735199a20d859

data/.gitignore

@@ -0,0 +1 @@
+Gemfile.lock

data/Gemfile

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

data/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2014 Malet
+
+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,17 @@
+netsol
+======
+
+NetSol Partners API Gem
+
+```ruby
+require 'netsol'
+
+ns = Netsol.new('12345678', 'test_password', :test)
+# ns = Netsol.new('12345678', 'live_password', :live)
+
+customers = ns.find_all_customers_for_partner
+# => {:nic_handle=>"1234567P", :type=>"Individual", :login_name=>"1234567", :first_name=>"John", :last_name=>"Smith", :user_id=>"1234567"}, ...
+
+domains = ns.find_all_domains_for_partner
+# => {:auto_renew=>false, :product_id=>"WN.D.XXXXXXX", :domain_name=>"XXXXXX.COM", :customer_id=>"1234567", :product_type=>"Registration"}, ...
+```

data/lib/netsol.rb

@@ -0,0 +1,155 @@
+require 'net/https'
+require 'erb'
+require 'nokogiri'
+
+class Netsol
+  
+  CONFIG = {
+    :host => {
+      :test => 'partners.pte.networksolutions.com',
+      :live => 'partners.networksolutions.com'
+    },
+    :api => {
+      :availability => {
+        :path => '/invoke/vpp/AvailabilityService',
+        :port => 8010
+      },
+      :transaction  => {
+        :path => '/invoke/vpp/TransactionService',
+        :port => 8020
+      }
+    }
+  }
+
+  def initialize(user, pass, mode = :live)
+    environments = [:test, :live]
+    unless environments.include? mode
+      raise "mode is invalid, must be #{environments.map(&:inspect).join(' or ')}"
+    end
+
+    @user,@pass,@mode = user,pass,mode
+    @host = CONFIG[:host][@mode]
+  end
+
+  def find_all_customers_for_partner
+    response = transmit(CONFIG[:api][:transaction], request_body)
+
+    customers = Nokogiri::XML(response.body, &:noblanks).xpath('//Customer').map do |c|
+      type = c.children.first.name
+      data = {
+        :type => type,
+        :user_id => c.xpath("#{type}/UserID/text()")[0].to_s,
+        :nic_handle => c.xpath("#{type}/NicHandle/text()")[0].to_s,
+        :login_name => c.xpath("#{type}/LoginName/text()")[0].to_s
+      }
+
+      case data[:type]
+      when 'Individual'
+        data.merge!(
+          :first_name => c.xpath("#{type}/FirstName/text()")[0].to_s,
+          :last_name => c.xpath("#{type}/LastName/text()")[0].to_s
+        )
+      when 'Business'
+        data.merge!(
+          :company_name => c.xpath("#{type}/CompanyName/text()")[0].to_s,
+          :legal_contact => {
+            :first_name => c.xpath("#{type}/LegalContactFirstName/text()")[0].to_s,
+            :last_name => c.xpath("#{type}/LegalContactLastName/text()")[0].to_s
+          }
+        )
+      end
+
+      data
+    end
+  end
+
+  def find_all_domains_for_partner
+    response = transmit(CONFIG[:api][:transaction], request_body)
+    
+    domains = Nokogiri::XML(response.body, &:noblanks).xpath('//Domain').map do |domain|
+      {
+        :product_id  => domain.xpath('ProductID/text()')[0].to_s,
+        :domain_name => domain.xpath('DomainName/text()')[0].to_s,
+        :customer_id => domain.xpath('CustomerID/text()')[0].to_s,
+        :product_type => domain.xpath('ProductType/text()')[0].to_s,
+        :auto_renew => (domain.xpath('AutoRenew/text()')[0].to_s == 'Y')
+      }
+    end
+  end
+
+  def modify_registration
+    raise 'Not yet implemented'
+    # @domain_name = nil
+    # @customer_id = nil
+    # @auto_renew  = nil
+  end
+
+  def create_individual(individual)
+    @individual = {
+      :login_name  => nil,
+      :password    => nil,
+      :first_name  => nil,
+      :middle_name => nil,
+      :last_name   => nil,
+      :address => {
+        :line_1       => nil,
+        :city         => nil,
+        :state        => nil,
+        :post_code    => nil,
+        :country_code => nil
+      },
+      :phone => nil,
+      :fax   => nil,
+      :email => nil,
+      :auth => {
+        :question => nil,
+        :answer   => nil
+      }
+    }.merge(individual)
+
+    response = Nokogiri::XML(transmit(CONFIG[:api][:transaction], request_body).body, &:noblanks)
+
+    status = response.xpath('/UserResponse/Body/Status')
+    status_code = status.xpath('StatusCode/text()')[0].to_s.to_i
+    status_desc = status.xpath('Description/text()')[0].to_s
+    success_codes = [5700, 5703]
+
+    raise "Unable to create individual: [#{status_code}] #{status_desc}" unless success_codes.include?(status_code)
+    
+    {
+      :status => {
+        :code => status_code,
+        :message => status_desc
+      },
+      :user_id => response.xpath('/UserResponse/Body/UserID/text()')[0].to_s.to_i,
+      :login_name => response.xpath('/UserResponse/Body/LoginName/text()')[0].to_s
+    }
+  end
+
+private
+
+  def root
+    @@root ||= File.expand_path('../..', __FILE__)
+  end
+
+  def transmit(location, body)
+    https = Net::HTTP.new(@host, location[:port])
+    https.use_ssl = true
+    https.verify_mode = OpenSSL::SSL::VERIFY_NONE
+    response = https.start{ |http| http.post(location[:path], body) }
+    raise "Response returned code #{response.code}: #{response.msg}." unless response.code == '200'
+
+    response
+  end
+
+  def request_body
+    method = caller[0][/`([^']*)'/, 1]
+
+    ERB.new(File.read("#{root}/xml/#{method}.xml.erb")).result(binding)
+  end
+
+  def header
+    @header_xml ||= ERB.new(File.read("#{root}/xml/header.xml.erb")).result(binding)
+  end
+
+end

data/netsol.gemspec

@@ -0,0 +1,24 @@
+lib = File.expand_path('../lib', __FILE__)
+
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+
+Gem::Specification.new do |spec|
+  spec.name          = 'netsol'
+  spec.version       = '0.1'
+  spec.authors       = ['Michael Malet']
+  spec.email         = ['michael@tagadab.com']
+  spec.description   = %q{A gem to make interacting with NetSol's Partner API less painful}
+  spec.summary       = spec.description
+  spec.homepage      = 'http://www.tagadab.com'
+  spec.license       = 'MIT'
+
+  spec.files         = `git ls-files`.split($/)
+  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_dependency 'nokogiri', '~> 1.4.7'
+
+  spec.add_development_dependency 'bundler'
+  spec.add_development_dependency 'pry'
+end

data/xml/create_individual.xml.erb

@@ -0,0 +1,25 @@
+<?xml version='1.0' encoding='UTF-8' standalone='yes'?>
+<UserRequest>
+  <%= header %>
+  <Body>
+  <CreateIndividual>
+    <LoginName><%= @individual[:login_name] %></LoginName>
+    <Password><%= @individual[:password] %></Password>
+    <FirstName><%= @individual[:first_name] %></FirstName>
+    <MiddleName><%= @individual[:middle_name] %></MiddleName>
+    <LastName><%= @individual[:last_name] %></LastName>
+    <Address>
+      <AddressLine1><%= @individual[:address][:line_1] %></AddressLine1>
+      <City><%= @individual[:address][:city] %></City>
+      <State><%= @individual[:address][:state] %></State>
+      <PostalCode><%= @individual[:address][:post_code] %></PostalCode>
+      <CountryCode><%= @individual[:address][:country_code] %></CountryCode>
+    </Address>
+    <Phone><%= @individual[:phone] %></Phone>
+    <Fax><%= @individual[:fax] %></Fax>
+    <Email><%= @individual[:email] %></Email>
+    <AuthQuestion><%= @individual[:auth][:question] %></AuthQuestion>
+    <AuthAnswer><%= @individual[:auth][:answer] %></AuthAnswer>
+  </CreateIndividual>
+  </Body>
+</UserRequest>

data/xml/find_all_customers_for_partner.xml.erb

@@ -0,0 +1,7 @@
+<?xml version='1.0' encoding='UTF-8' standalone='yes'?>
+<PartnerManagerRequest>
+  <%= header %>
+  <Body>
+    <FindAllCustomersForPartner/>
+  </Body>
+</PartnerManagerRequest>

data/xml/find_all_domains_for_partner.xml.erb

@@ -0,0 +1,7 @@
+<?xml version='1.0' encoding='UTF-8' standalone='yes'?>
+<PartnerManagerRequest>
+  <%= header %>
+  <Body>
+    <FindAllDomainsForPartner/>
+  </Body>
+</PartnerManagerRequest>

data/xml/header.xml.erb

@@ -0,0 +1,7 @@
+  <RequestHeader>
+    <VERSION_6_7/>
+    <Authentication>
+      <PartnerID><%= @user %></PartnerID>
+      <PartnerPassword><%= @pass %></PartnerPassword>
+    </Authentication>
+  </RequestHeader>

data/xml/modify_registration.xml.erb

@@ -0,0 +1,21 @@
+<?xml version='1.0' encoding='UTF-8' standalone='yes'?>
+<OrderRequest>
+  <%= header %>
+  <Body>
+    <AuthorizedAgent SystemUserType="partner">
+      <SystemUser>
+        <UserID><%= @user %></UserID>
+        <Password><%= @pass %></Password>
+      </SystemUser>
+    </AuthorizedAgent>
+    <CustomerID><%= @customer_id %></CustomerID>
+    <Billing>
+      <AutoRenew><%= @auto_renew %></AutoRenew>
+    </Billing>
+    <Product>
+      <ModifyRegistration>
+        <DomainName><%= @domain_name %></DomainName>
+      </ModifyRegistration>
+    </Product>
+  </Body>
+</OrderRequest>

metadata

@@ -0,0 +1,89 @@
+--- !ruby/object:Gem::Specification 
+name: netsol
+version: !ruby/object:Gem::Version 
+  version: "0.1"
+platform: ruby
+authors: 
+- Michael Malet
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2014-04-29 00:00:00 Z
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: nokogiri
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        version: 1.4.7
+  type: :runtime
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: bundler
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    requirements: 
+    - &id003 
+      - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+  type: :development
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: pry
+  prerelease: false
+  requirement: &id004 !ruby/object:Gem::Requirement 
+    requirements: 
+    - *id003
+  type: :development
+  version_requirements: *id004
+description: A gem to make interacting with NetSol's Partner API less painful
+email: 
+- michael@tagadab.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .gitignore
+- Gemfile
+- LICENSE
+- README.md
+- lib/netsol.rb
+- netsol.gemspec
+- xml/create_individual.xml.erb
+- xml/find_all_customers_for_partner.xml.erb
+- xml/find_all_domains_for_partner.xml.erb
+- xml/header.xml.erb
+- xml/modify_registration.xml.erb
+homepage: http://www.tagadab.com
+licenses: 
+- MIT
+metadata: {}
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - *id003
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - *id003
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 2.0.14
+signing_key: 
+specification_version: 4
+summary: A gem to make interacting with NetSol's Partner API less painful
+test_files: []
+
+has_rdoc: