epp-eis 0.1.1

data/lib/epp-eis/session.rb

@@ -0,0 +1,94 @@
+module Epp
+  module Eis
+    
+    XML_NS_FRED = 'http://www.nic.cz/xml/epp/fred-1.4'
+    
+    class GetResultsResponse
+      def initialize(response)
+        @response = Nokogiri::XML(response)
+      end
+      
+      def code
+        @response.css('epp response result').first['code'].to_i
+      end
+
+      def message
+        @response.css('epp response result msg').text
+      end
+      
+      def items
+        @response.css('fred|resultsList fred|item', 'fred' => XML_NS_FRED).collect{ |item| item.text }
+      end
+    end
+    
+    class HelloResponse
+      def initialize(response)
+        @response = Nokogiri::XML(response)
+      end
+      
+      def version
+        @response.css('epp greeting svcMenu version').text
+      end
+    end
+    
+    module SessionCommands
+      
+      # Opens session to EPP server, and yields the block given. Wraps login and
+      # logout request around it.
+      def command_session(&block)
+        open_connection
+
+        @logged_in = true if login
+
+        begin
+          yield
+        ensure
+          @logged_in = false if @logged_in && logout
+          close_connection
+        end
+      end
+      
+      def list_command(command_name)
+        response = nil
+        
+        command_session do
+          builder = build_epp_request do |xml|
+            xml.extension {
+              xml.extcommand('xmlns:fred' => 'http://www.nic.cz/xml/epp/fred-1.4', 'xsi:schemaLocation' => 'http://www.nic.cz/xml/epp/fred-1.4 fred-1.4.xsd') {
+                xml.parent.namespace = xml.parent.namespace_definitions.first
+                xml.send(command_name)
+                xml.clTRID UUIDTools::UUID.timestamp_create.to_s
+              }
+            }
+          end
+          
+          response = send_request(builder.to_xml)
+          
+          builder = build_epp_request do |xml|
+            xml.extension {
+              xml.extcommand('xmlns:fred' => 'http://www.nic.cz/xml/epp/fred-1.4', 'xsi:schemaLocation' => 'http://www.nic.cz/xml/epp/fred-1.4 fred-1.4.xsd') {
+                xml.parent.namespace = xml.parent.namespace_definitions.first
+                xml.getResults
+                xml.clTRID UUIDTools::UUID.timestamp_create.to_s
+              }
+            }
+          end
+          
+          response = GetResultsResponse.new(send_request(builder.to_xml))
+        end
+        
+        return response
+      end
+      
+      def hello
+        builder = build_epp_request do |xml|
+          xml.hello
+        end
+        
+        HelloResponse.new(send_request(builder.to_xml))
+      end
+    end
+  end
+end
+
+Epp::Server.send(:include, Epp::Eis::SessionCommands)

data/lib/epp-eis/version.rb

@@ -0,0 +1,5 @@
+module Eis
+  module Epp
+    VERSION = '0.1.1'
+  end
+end

data/lib/epp-eis.rb

@@ -0,0 +1,8 @@
+require 'epp'
+
+require 'epp-eis/version'
+require 'epp-eis/session'
+require 'epp-eis/extensions'
+require 'epp-eis/domain'
+require 'epp-eis/contact'
+require 'epp-eis/nsset'

data/spec/lib/epp-eis/contact_spec.rb

@@ -0,0 +1,107 @@
+require 'spec_helper'
+
+describe Epp::Eis::ContactCommands do
+  
+  before(:each) do
+    @server = Epp::Server.new(:server => '127.0.0.1', :tag => 'username', :password => 'password')
+  end
+  
+  describe 'check_contact' do
+
+    context 'when response is successful' do
+
+      before(:each) do
+        @server.stub(:send_request).and_return(xml_mock('responses/contact/check_contact_1000.xml'))
+      end
+
+      it 'has status code 1000' do
+        @server.check_contact('CID:FRAKTAL:1').code.should == 1000
+      end
+
+      context 'when multiple contact names are provided' do
+        it 'has multiple contact check items in response object' do
+          @server.check_contact('CID:FRAKTAL:1', 'CID:FRAKTAL:2').items.size.should == 2
+        end
+      end
+    end
+  end
+  
+  describe 'create_contact' do
+    context 'when response is successful' do
+      before(:each) do
+        @server.stub(:send_request).and_return(xml_mock('responses/contact/create_contact_1000.xml'))
+        @response = @server.create_contact('CID:TEST:10', 'Test', 'Test Street 11-2', 'Test City', '123456', 'EE', '+372.5555555', 'test@test.com', '37812124567', 'op')
+      end
+
+      it 'returns contact id' do
+        @response.contact_id.should == 'CID:TEST:10'
+      end
+
+      it 'returns contact create date' do
+        @response.contact_create_date.should == '2010-02-08T15:50:55+02:00'
+      end
+    end
+  end
+  
+  describe 'info_contact' do
+    context 'when response is successful' do
+      before(:each) do
+        @server.stub(:send_request).and_return(xml_mock('responses/contact/info_contact_1000.xml'))
+        @response = @server.info_contact('CID:TEST:1')
+      end
+      
+      it 'returns contact id' do
+        @response.contact_id.should == 'CID:TEST:1'
+      end
+
+      it 'returns roid' do
+        @response.contact_roid.should == 'C0000000006-EPP'
+      end
+
+      it 'returns status' do
+        @response.contact_status.should == 'linked'
+      end
+      
+      it 'returns name' do
+        @response.contact_name.should == 'Uus nimi ajee'
+      end
+      
+      it 'returns street' do
+        @response.contact_street.should == 'Kastani'
+      end
+      
+      it 'returns city' do
+        @response.contact_city.should == 'Tallinn'
+      end
+      
+      it 'returns postal code' do
+        @response.contact_postal_code.should == '10613'
+      end
+      
+      it 'returns country code' do
+        @response.contact_country_code.should == 'EE'
+      end
+      
+      it 'returns contact email' do
+        @response.contact_email.should == 'test@test.host'
+      end
+    end
+  end
+  
+  describe 'update_contact' do
+    context 'when response is successful' do
+      before(:each) do
+        @server.stub(:send_request).and_return(xml_mock('responses/contact/update_contact_1000.xml'))
+        @response = @server.update_contact('CID:TEST:10', nil, nil, nil, nil, nil, nil, nil, nil, 'op', legal_mock('test.pdf'), 'pdf')
+      end
+
+      it 'returns response code' do
+        @response.code.should == 1000
+      end
+
+      it 'returns response message' do
+        @response.message.should == 'Command completed successfully'
+      end
+    end
+  end
+end

data/spec/lib/epp-eis/domain_spec.rb

@@ -0,0 +1,189 @@
+require 'spec_helper'
+
+describe Epp::Eis::DomainCommands do
+
+  before(:each) do
+    @server = Epp::Server.new(:server => '127.0.0.1', :tag => 'username', :password => 'password')
+  end
+
+  describe 'create_domain' do
+    context 'when response is successful' do
+      before(:each) do
+        @server.stub(:send_request).and_return(xml_mock('responses/domain/create_domain_1000.xml'))
+        @response = @server.create_domain('testing.ee', 'name_server_set1', 'domain_registrator1', 'administrative_contact1', legal_mock('test.pdf'), 'pdf')
+      end
+      
+      it 'returns domain name' do
+        @response.domain_name.should == 'testing.ee'
+      end
+      
+      it 'returns domain create date' do
+        @response.domain_create_date.should == '2010-02-15T19:50:00+02:00'
+      end
+      
+      it 'returns domain expire date' do
+        @response.domain_expire_date.should == '2011-02-15'
+      end
+    end
+  end
+  
+  describe 'delete_domain' do
+    context 'when response is successful' do
+      before(:each) do
+        @server.stub(:send_request).and_return(xml_mock('responses/domain/delete_domain_1000.xml'))
+        @response = @server.delete_domain('testing.ee', legal_mock('test.pdf'), 'pdf')
+      end
+      
+      it 'returns response code' do
+        @response.code.should == 1000
+      end
+      
+      it 'returns response message' do
+        @response.message.should == 'Command completed successfully'
+      end
+    end
+  end
+  
+  describe 'info_domain' do
+    context 'when response is successful' do
+      before(:each) do
+        @server.stub(:send_request).and_return(xml_mock('responses/domain/info_domain_1000.xml'))
+        @response = @server.info_domain('testing.ee')
+      end
+      
+      it 'returns domain name' do
+        @response.domain_name.should == 'testing.ee'
+      end
+  
+      it 'returns domain roid' do
+        @response.domain_roid.should == 'D0000000052-EPP'
+      end
+      
+      it 'returns domain status' do
+        @response.domain_status.should == 'Objekt is without restrictions'
+      end
+      
+      it 'returns domain registrant' do
+        @response.domain_registrant.should == 'MARGUSTEST2'
+      end
+      
+      it 'returns domain admin contact' do
+        @response.domain_admin.should == 'MARGUSTEST3'
+      end
+      
+      it 'returns domain nsset' do
+        @response.domain_nsset.should == 'RACKSPACE1'
+      end
+      
+      it 'returns domain clid' do
+        @response.domain_clid.should == 'margus'
+      end
+  
+      it 'returns domain crid' do
+        @response.domain_crid.should == 'margus'
+      end
+      
+      it 'returns domain create date' do
+        @response.domain_create_date.should == '2010-02-15T19:50:00+02:00'
+      end
+      
+      it 'returns domain expire date' do
+        @response.domain_expire_date.should == '2011-02-15'
+      end
+      
+      it 'returns domain password' do
+        @response.domain_authinfo.should == 'b23G6IDH'
+      end
+    end
+  end
+  
+  describe 'renew_domain' do
+    context 'when response is successful' do
+      before(:each) do
+        @server.stub(:send_request).and_return(xml_mock('responses/domain/renew_domain_1000.xml'))
+      end
+      
+      it 'returns domain name' do
+        @server.renew_domain('testing.ee', '2011-02-15').domain_name.should == 'testing.ee'
+      end
+      
+      it 'returns next expire date' do
+        @server.renew_domain('testing.ee', '2011-02-15').domain_expire_date.should == '2012-02-15'
+      end
+    end
+  end
+  
+  describe 'transfer_domain' do
+    context 'when response is successful' do
+      before(:each) do
+        @server.stub(:send_request).and_return(xml_mock('responses/domain/transfer_domain_1000.xml'))
+        @response = @server.transfer_domain('teinetest.ee', 'r3aVYGOz', legal_mock('test.pdf'), 'pdf')
+      end
+      
+      it 'returns response code' do
+        @response.code.should == 1000
+      end
+      
+      it 'returns response message' do
+        @response.message.should == 'Command completed successfully'
+      end
+    end
+  end
+  
+  describe 'update_domain' do
+    context 'when response is successful' do
+      before(:each) do
+        @server.stub(:send_request).and_return(xml_mock('responses/domain/update_domain_1000.xml'))
+        @response = @server.update_domain('testimine.ee', nil, nil, nil, nil, nil, legal_mock('test.pdf'), 'pdf')
+      end
+      
+      it 'returns response code' do
+        @response.code.should == 1000
+      end
+      
+      it 'returns response message' do
+        @response.message.should == 'Command completed successfully'
+      end
+    end
+  end
+  
+  describe 'check_domain' do
+    context 'when response is successful' do
+      before(:each) do
+        @server.stub(:send_request).and_return(xml_mock('responses/domain/check_domain_1000.xml'))
+      end
+      
+      it 'has status code 1000' do
+        @server.check_domain('fraktal.ee').code.should == 1000
+      end
+      
+      context 'when multiple domain names are provided' do
+        it 'has multiple domain check items in response object' do
+          @server.check_domain('fraktal.ee', 'edicypages.ee').items.size.should == 2
+        end
+      end
+    end
+  end
+  
+  describe 'is_domain_available?' do
+    context 'when domain is available' do
+      before(:each) do
+        @server.stub(:send_request).and_return(xml_mock('responses/domain/check_domain_available_1000.xml'))
+      end
+      
+      it 'returns true' do
+        @server.is_domain_available?('edicypages.ee').should be_true
+      end
+    end
+    
+    context 'when domain is not available' do
+      before(:each) do
+        @server.stub(:send_request).and_return(xml_mock('responses/domain/check_domain_taken_1000.xml'))
+      end
+      
+      it 'returns false' do
+        @server.is_domain_available?('fraktal.ee').should be_false
+      end
+    end
+  end
+end

data/spec/lib/epp-eis/nsset_spec.rb

@@ -0,0 +1,87 @@
+require 'spec_helper'
+
+describe Epp::Eis::NssetCommands do
+  
+  before(:each) do
+    @server = Epp::Server.new(:server => '127.0.0.1', :tag => 'username', :password => 'password')
+  end
+  
+  describe 'check_nsset' do
+
+    context 'when response is successful' do
+
+      before(:each) do
+        @server.stub(:send_request).and_return(xml_mock('responses/nsset/check_nsset_1000.xml'))
+      end
+
+      it 'has status code 1000' do
+        @server.check_nsset('NSSID:TEST:1').code.should == 1000
+      end
+
+      context 'when multiple nsset names are provided' do
+        it 'has multiple nsset check items in response object' do
+          @server.check_nsset('NSSID:TEST:1', 'NSSID:TEST:2').items.size.should == 2
+        end
+      end
+    end
+  end
+  
+  describe 'create_nsset' do
+    context 'when response is successful' do
+      before(:each) do
+        @server.stub(:send_request).and_return(xml_mock('responses/nsset/create_nsset_1000.xml'))
+        @response = @server.create_nsset('NSSID:TEST:2', [['test.com', '123.123.123.123'], ['ns2.test.com', '111.111.111.111']], 'test1')
+      end
+
+      it 'returns nsset id' do
+        @response.nsset_id.should == 'NSSID:TEST:2'
+      end
+
+      it 'returns nsset create date' do
+        @response.nsset_create_date.should == '2010-02-08T16:27:22+02:00'
+      end
+    end
+  end
+
+  describe 'info_nsset' do
+    context 'when response is successful' do
+      before(:each) do
+        @server.stub(:send_request).and_return(xml_mock('responses/nsset/info_nsset_1000.xml'))
+        @response = @server.info_nsset('NSSID:TEST:2')
+      end
+      
+      it 'returns nsset id' do
+        @response.nsset_id.should == 'NSSID:TEST:2'
+      end
+
+      it 'returns roid' do
+        @response.nsset_roid.should == 'N0000000051-EPP'
+      end
+
+      it 'returns status' do
+        @response.nsset_status.should == 'ok'
+      end
+      
+      it 'returns nameservers' do
+        @response.nameservers.should == [['test.com', '123.123.123.123'], ['ns2.test.com', '111.111.111.111']]
+      end
+    end
+  end
+  
+  describe 'update_nsset' do
+    context 'when response is successful' do
+      before(:each) do
+        @server.stub(:send_request).and_return(xml_mock('responses/nsset/update_nsset_1000.xml'))
+        @response = @server.update_nsset('NSSID:TEST:2', [['ns3.test.com', '112.112.112.112']], 'margustech1', 'ns2.test.com', 'tech1')
+      end
+
+      it 'returns response code' do
+        @response.code.should == 1000
+      end
+
+      it 'returns response message' do
+        @response.message.should == 'Command completed successfully'
+      end
+    end
+  end
+end

data/spec/lib/epp-eis/session_spec.rb

@@ -0,0 +1,18 @@
+require 'spec_helper'
+
+describe 'hello' do
+  before(:each) do
+    @server = Epp::Server.new(:server => '127.0.0.1', :tag => 'username', :password => 'password')
+  end
+  
+  context 'when response is successful' do
+    before(:each) do
+      @server.stub(:request).and_return(xml_mock('responses/session/hello.xml'))
+      @response = @server.hello
+    end
+    
+    it 'returns version number' do
+      @response.version.should == '1.0'
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,10 @@
+require 'rspec'
+require 'epp-eis'
+
+# Requires supporting files with custom matchers and macros, etc,
+# in ./support/ and its subdirectories.
+Dir[File.expand_path(File.join(File.dirname(__FILE__),'support','**','*.rb'))].each {|f| require f}
+
+RSpec.configure do |c|
+  c.mock_with :rspec
+end

data/spec/support/file_mocks.rb

@@ -0,0 +1,7 @@
+def legal_mock(name)
+  File.read(File.expand_path(File.join('../../legaldocs', name), __FILE__))
+end
+
+def xml_mock(name)
+  File.read(File.expand_path(File.join('../../xml/', name), __FILE__))
+end

data/spec/xml/requests/contact/check_contact.xml

@@ -0,0 +1,11 @@
+<?xml version="1.0" encoding="utf-8" standalone="no"?>
+<epp xmlns="urn:ietf:params:xml:ns:epp-1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="urn:ietf:params:xml:ns:epp-1.0 epp-1.0.xsd">
+<command>
+  <check>
+    <contact:check xmlns:contact="http://www.nic.cz/xml/epp/contact-1.6" xsi:schemaLocation="http://www.nic.cz/xml/epp/contact-1.6 contact-1.6.xsd">
+      <contact:id>CID:TEST:1</contact:id>
+    </contact:check>
+  </check>
+  <clTRID>neka002#10-02-08at13:46:29</clTRID>
+</command>
+</epp>

data/spec/xml/requests/contact/create_contact.xml

@@ -0,0 +1,23 @@
+<?xml version="1.0" encoding="utf-8" standalone="no"?>
+<epp xmlns="urn:ietf:params:xml:ns:epp-1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="urn:ietf:params:xml:ns:epp-1.0 epp-1.0.xsd">
+  <command>
+    <create>
+      <contact:create xmlns:contact="http://www.nic.cz/xml/epp/contact-1.6" xsi:schemaLocation="http://www.nic.cz/xml/epp/contact-1.6 contact-1.6.xsd">
+        <contact:id>CID:TEST:10</contact:id>
+        <contact:postalInfo>
+          <contact:name>Test</contact:name>
+          <contact:addr>
+            <contact:street>Test Street 11-2</contact:street>
+            <contact:city>Test City</contact:city>
+            <contact:pc>123456</contact:pc>
+            <contact:cc>EE</contact:cc>
+          </contact:addr>
+        </contact:postalInfo>
+        <contact:voice>+372.5555555</contact:voice>
+        <contact:email>test@test.com</contact:email>
+        <contact:ident type="op">37812124567</contact:ident>
+      </contact:create>
+    </create>
+    <clTRID>neka005#10-02-08at13:51:37</clTRID>
+  </command>
+</epp>

data/spec/xml/requests/contact/delete_contact.xml

@@ -0,0 +1,11 @@
+<?xml version="1.0" encoding="utf-8" standalone="no"?>
+<epp xmlns="urn:ietf:params:xml:ns:epp-1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="urn:ietf:params:xml:ns:epp-1.0 epp-1.0.xsd">
+  <command>
+    <delete>
+      <contact:delete xmlns:contact="http://www.nic.cz/xml/epp/contact-1.6" xsi:schemaLocation="http://www.nic.cz/xml/epp/contact-1.6 contact-1.6.xsd">
+        <contact:id>CID:TEST:10</contact:id>
+      </contact:delete>
+    </delete>
+    <clTRID>wgyn007#10-02-08at14:03:17</clTRID>
+  </command>
+</epp>

data/spec/xml/requests/contact/info_contact.xml

@@ -0,0 +1,11 @@
+<?xml version="1.0" encoding="utf-8" standalone="no"?>
+<epp xmlns="urn:ietf:params:xml:ns:epp-1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="urn:ietf:params:xml:ns:epp-1.0 epp-1.0.xsd">
+  <command>
+    <info>
+      <contact:info xmlns:contact="http://www.nic.cz/xml/epp/contact-1.6" xsi:schemaLocation="http://www.nic.cz/xml/epp/contact-1.6 contact-1.6.xsd">
+        <contact:id>CID:TEST:1</contact:id>
+      </contact:info>
+    </info>
+    <clTRID>wgyn008#10-02-08at14:05:57</clTRID>
+  </command>
+</epp>

data/spec/xml/requests/contact/update_contact.xml

@@ -0,0 +1,29 @@
+<?xml version="1.0" encoding="utf-8" standalone="no"?>
+<epp xmlns="urn:ietf:params:xml:ns:epp-1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="urn:ietf:params:xml:ns:epp-1.0 epp-1.0.xsd">
+  <command>
+    <update>
+      <contact:update xmlns:contact="http://www.nic.cz/xml/epp/contact-1.6" xsi:schemaLocation="http://www.nic.cz/xml/epp/contact-1.6 contact-1.6.xsd">
+        <contact:id>CID:TEST:10</contact:id>
+        <contact:chg>
+          <contact:postalInfo>
+            <contact:addr>
+              <contact:street>Test Street New 2</contact:street>
+              <contact:city>New Test City</contact:city>
+              <contact:pc>12345</contact:pc>
+              <contact:cc>GB</contact:cc>
+            </contact:addr>
+          </contact:postalInfo>
+          <contact:voice>+372.5555555</contact:voice>
+          <contact:email>test@test.com</contact:email>
+          <contact:ident type="op">37812123456</contact:ident>
+        </contact:chg>
+      </contact:update>
+    </update>
+    <extension>
+      <eis:extdata xmlns:eis="urn:ee:eis:xml:epp:eis-1.0" xsi:schemaLocation="urn:ee:eis:xml:epp:eis-1.0 eis-1.0.xsd">
+        <eis:legalDocument type="ddoc">.... base64 encoded document ....</eis:legalDocument>
+      </eis:extdata>
+    </extension>
+    <clTRID>wgyn002#10-02-08at13:59:51</clTRID>
+  </command>
+</epp>

data/spec/xml/requests/domain/create_domain.xml

@@ -0,0 +1,21 @@
+<?xml version="1.0" encoding="utf-8" standalone="no"?>
+<epp xmlns="urn:ietf:params:xml:ns:epp-1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="urn:ietf:params:xml:ns:epp-1.0 epp-1.0.xsd">
+  <command>
+    <create>
+      <domain:create xmlns:domain="http://www.nic.cz/xml/epp/domain-1.4" xsi:schemaLocation="http://www.nic.cz/xml/epp/domain-1.4 domain-1.4.xsd">
+        <domain:name>testing.ee</domain:name>
+        <domain:period unit="y">1</domain:period>
+        <domain:nsset>name_server_set1</domain:nsset>
+        <domain:registrant>domain_registrator1</domain:registrant>
+        <domain:admin>administrative_contact1</domain:admin>
+        <domain:authInfo>password</domain:authInfo>
+      </domain:create>
+    </create>
+    <extension>
+      <eis:extdata xmlns:eis="urn:ee:eis:xml:epp:eis-1.0" xsi:schemaLocation="urn:ee:eis:xml:epp:eis-1.0 eis-1.0.xsd">
+        <eis:legalDocument type="ddoc">.... base64 encoded document ....</eis:legalDocument>
+      </eis:extdata>
+    </extension>
+    <clTRID>dpbx005#10-01-29at19:21:47</clTRID>
+  </command>
+</epp>

data/spec/xml/requests/domain/delete_domain.xml

@@ -0,0 +1,16 @@
+<?xml version="1.0" encoding="utf-8" standalone="no"?>
+<epp xmlns="urn:ietf:params:xml:ns:epp-1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="urn:ietf:params:xml:ns:epp-1.0 epp-1.0.xsd">
+  <command>
+    <delete>
+      <domain:delete xmlns:domain="http://www.nic.cz/xml/epp/domain-1.4" xsi:schemaLocation="http://www.nic.cz/xml/epp/domain-1.4 domain-1.4.xsd">
+        <domain:name>testing.ee</domain:name>
+      </domain:delete>
+    </delete>
+    <extension>
+      <eis:extdata xmlns:eis="urn:ee:eis:xml:epp:eis-1.0" xsi:schemaLocation="urn:ee:eis:xml:epp:eis-1.0 eis-1.0.xsd">
+        <eis:legalDocument type="ddoc">.... base64 encoded document ....</eis:legalDocument>
+      </eis:extdata>
+    </extension>
+    <clTRID>kmki002#10-02-15at18:15:58</clTRID>
+  </command>
+</epp>