reg.api2 0.0.1 → 0.0.2

data/lib/reg_api2/zone.rb

@@ -0,0 +1,236 @@
+# -*- encoding : utf-8 -*-
+module RegApi2
+  # REG.API zone category
+  module Zone
+
+    include RegApi2::Builder
+
+    category :zone
+
+    # @!method nop(opts = {})
+    # @param [Hash] opts
+    # @option opts [Array(dname:String)] :domains A list if domains.
+    # This function serves for testing purposes. You can check if you can manage DNS zones of domains. DNS zone management is possible only with domains associated with REG.RU DNS servers.
+    # @return [Hash(domains)] A list of domains. Domains that allow DNS zone management will have the “success” value in the “result” field, otherwise the “result” field will feature an error code explaining the error reason.
+    # @note Support of service lists: yes
+    # @note Accessibility: clients
+    # @example Get domains
+    #    RegApi2.zone.nop domains: [ { dname: "test.ru" }, { dname: "test.com" } ]
+    define :nop
+
+    # @!method add_alias(opts = {})
+    # @param [Hash] opts
+    # @option opts [String] :subdomain Name of the subdomain assigned an IP address. To assign an IP address to a domain, transfer the “@” value. To assign an IP address to all subdomains, which are not explicitly defined in other records, use the “*” value.
+    # @option opts [String or IPAddr] :ipaddr IP address assigned to the subdomain.
+    # Use this function to tie subdomains to IP addresses.
+    # @return [Hash(domains)] A list of domains with results.
+    # @note Support of service lists: yes
+    # @note Accessibility: clients
+    # @example Assign the IP address 111.111.111.111 to the domains test.ru and test.com.
+    #    RegApi2.zone.add_alias domains: [ { dname: "test.ru" }, { dname: "test.com" } ], subdomain: '@', ipaddr: IPAddr.new("111.111.111.111")
+    # @example Same with ip addresses as strings.
+    #    RegApi2.zone.add_alias domains: [ { dname: "test.ru" }, { dname: "test.com" } ], subdomain: '@', ipaddr: "111.111.111.111"
+    define :add_alias, required: { ipaddr: { ipaddr: true }, subdomain: {} }
+
+    # @!method add_aaaa(opts = {})
+    # @param [Hash] opts
+    # @option opts [String] :subdomain Name of the subdomain assigned an IP address. To assign an IP address to a domain, transfer the “@” value. To assign an IP address to all subdomains, which are not explicitly defined in other records, use the “*” value.
+    # @option opts [String or IPAddr] :ipaddr The IPv6 address assigned to the subdomain.
+    # Use this function to tie subdomains to IPv6 addresses.
+    # @return [Hash(domains)] A list of domains with results.
+    # @note Support of service lists: yes
+    # @note Accessibility: clients
+    # @example Assign the IPv6 address aa11::a111:11aa:aaa1:aa1a to the domains test.ru and test.com.
+    #    RegApi2.zone.add_aaaa domains: [ { dname: "test.ru" }, { dname: "test.com" } ], subdomain: '@', ipaddr: IPAddr.new("aa11::a111:11aa:aaa1:aa1a")
+    # @example Same with ipv6 addresses as strings.
+    #    RegApi2.zone.add_aaaa domains: [ { dname: "test.ru" }, { dname: "test.com" } ], subdomain: '@', ipaddr: "aa11::a111:11aa:aaa1:aa1a"
+    define :add_aaaa, required: { ipaddr: { ipaddr: true }, subdomain: {} }
+
+    # @!method add_cname(opts = {})
+    # @param [Hash] opts
+    # @option opts [String] :subdomain Name of the subdomain assigned an IP address. To assign an IP address to a domain, transfer the “@” value. To assign an IP address to all subdomains, which are not explicitly defined in other records, use the “*” value.
+    # @option opts [String] :canonical_name Name of the domain assigned a synonym.
+    # Use this function to tie a subdomain to another’s domain name.
+    # @return [Hash(domains)] A list of domains with results.
+    # @note Support of service lists: yes
+    # @note Accessibility: clients
+    # @example Tie the third-level domains mail.test.ru and mail.test.com to mx10.test.ru.
+    #    RegApi2.zone.add_cname domains: [ { dname: "test.ru" }, { dname: "test.com" } ], subdomain: "mail", canonical_name: "mx10.test.ru"
+    define :add_cname, required: { canonical_name: {}, subdomain: {} }
+
+    # @!method add_mx(opts = {})
+    # @param [Hash] opts
+    # @option opts [String] :subdomain Name of the subdomain, to which the address is assigned. The default value is “@”, i.e. the main domain.
+    # @option opts [Fixnum] :priority Mail server priority: from 0 (highest) through 10 (lowest).
+    # @option opts [String or IPAddr] :mail_server Domain name or IP address of the mail server (domain name is more preferable because not all mail servers admit IP addresses).
+    # Use this function to define the IP address or domain name of the mail server, which will received email destined to your domain.
+    # @return [Hash(domains)] A list of domains with results.
+    # @note Support of service lists: yes
+    # @note Accessibility: clients
+    # @example Tie the the domains test.ru and test.com to the mail servers mail.test.ru and mail.test.com.
+    #    RegApi2.zone.add_mx domains: [ { dname: "test.ru" }, { dname: "test.com" } ], subdomain: "@", mail_server: "mail"
+    define :add_mx, required: { mail_server: { ipaddr: :optional } }, optional: %w[ subdomain ]
+
+    # @!method add_ns(opts = {})
+    # @param [Hash] opts
+    # @option opts [String] :subdomain Name of the subdomain that will be handed over to other DNS servers.
+    # @option opts [String] :dns_server Domain name of the DNS-server.
+    # @option opts [Fixnum] :record_number Order number of the NS record that determines relative arrangement of NS records for the subdomain.
+    # You can use this function to hand over a subdomain to other DNS servers.
+    # @return [Hash(domains)] A list of domains with results.
+    # @note Support of service lists: yes
+    # @note Accessibility: clients
+    # @example Hand over domains tt.test.ru and tt.test.com to the DNS server ns1.test.ru.
+    #    RegApi2.zone.add_ns domains: [ { dname: "test.ru" }, { dname: "test.com" } ], subdomain: "tt", dns_server: "ns1.test.ru", record_number: 10
+    define :add_ns, required: { dns_server: {}, subdomain: {}, record_number: { re: /\d\d?/ } }
+
+    # @!method add_txt(opts = {})
+    # @param [Hash] opts
+    # @option opts [String] :subdomain Name of the subdomain, about which the record is added.
+    # @option opts [String] :text Text of the note. Only ASCII alphanumeric characters are allowed.
+    # Add an arbitrary note about the subdomain.
+    # @return [Hash(domains)] A list of domains with results.
+    # @note Support of service lists: yes
+    # @note Accessibility: clients
+    # @example Add notes about the mail.test.ru and mail.test.com domains.
+    #    RegApi2.zone.add_txt domains: [ { dname: "test.ru" }, { dname: "test.com" } ], subdomain: "mail", text: "testmail"
+    define :add_txt, required: { text: {}, subdomain: {} }
+
+    # @!method add_srv(opts = {})
+    # @param [Hash] opts
+    # @option opts [String] :service The service that will be matched against the defined server. For example, to make the sip.test.ru server handle SIP calls over UDP, you should specify the following string: _sip._udp.
+    # @option opts [Fixnum] :priority Record priority.
+    # @option opts [Fixnum] :weight The load that the servers can handle. Optional field. Default value: 0.
+    # @option opts [String] :target The server used by the service.
+    # @option opts [Fixnum] :port The port used by the service.
+    # Add service record.
+    # @return [Hash(domains)] A list of domains with results.
+    # @note Support of service lists: yes
+    # @note Accessibility: clients
+    # @example Make the sip.test.ru server handle SIP calls destined to xxx@test.ru and xxx@test.com on port 5060 over UDP.
+    #    RegApi2.zone.add_srv domains: [ { dname: "test.ru" }, { dname: "test.com" } ], service: "_sip._udp", priority: 0, port: 5060, target: "sip.test.ru"
+    define :add_srv, required: { service: {}, priority: { re: /\A\d+\z/ }, target: {}, port: { re: /\A\d+\z/ } }, optional: { weight: { re: /\A\d+\z/ } }
+
+    # @!method get_resource_records(opts = {})
+    # Use this fuction to get zone resource records for each domains.
+    # @param [Hash] opts
+    # @option opts [Array(Hash(dname))] :domains A list of domains, where domains that allow zone management will have the “success” value in the “result” field. Otherwise the “result” field will include the error code explaining the reason of error.
+    # @return [Hash(domains)] A list of domains with results.
+    # @note Support of service lists: yes
+    # @note Accessibility: clients
+    # @example Request records for test.ru and test.com.
+    #    RegApi2.zone.get_resource_records domains: [ { dname: "test.ru" }, { dname: "test.com" } ]
+    define :get_resource_records
+
+    # @!method update_records(opts = {})
+    # You can use this function to add and/or delete several resource records by means of a single request. The order of elements in the transferred array is important. Records can interrelate with each other, and if an error is found in one of the records from the action_list fields, the rest of the records will be ignored.
+    # @param [Hash] opts
+    # @option opts [Array(Hash)] :action_list A hash array, where every hash provides parameters for creation/deletion of a resource record. The class/type of the created records is defined in the “action” field, allowed values are: add_alias, add_aaaa, add_cname, add_mx, add_ns, add_txt, add_srv, remove_record. The rest of hash fields depend on the “action” value and correspond to the functions described above.
+    #                                         For the example given below the structure of action_list will look as follows:
+    #                                         ```
+    #                                         action_list => [
+    #                                             {
+    #                                                 action    => 'add_alias',
+    #                                                 subdomain => 'www',
+    #                                                 ipaddr    => '11.22.33.44'
+    #                                             },
+    #                                             {
+    #                                                 action         => 'add_cname',
+    #                                                 subdomain      => '@',
+    #                                                 canonical_name => 'www.test.ru'
+    #                                             }
+    #                                         ]
+    #                                         ```
+    # @return [Hash(domains)] A list of domains with results.
+    # @note Support of service lists: yes
+    # @note Accessibility: partners
+    # @example Tie the IP address 11.22.33.44 to the www.test.ru domain and assign the test.ru alias to it.
+    #    RegApi2.zone.update_records domain_name: "test.ru", action_list: [
+    #      { action: :add_alias, subdomain: "www", ipaddr: "11.22.33.44" },
+    #      { action: :add_cname, subdomain: "@", canonical_name: "www.test.ru" }
+    #    ]
+    define :update_records
+
+    # @!method update_soa(opts = {})
+    # You can use this function to change a zone cache TTL.
+    # @param [Hash] opts
+    # @option opts [Fixnum or String] :ttl Cache TTL of a zone. Valid values: a number for seconds or a number with a suffix (m – for months, w – for weeks, d – for days, h – for hours). Example: 600 (seconds), 5m (months).
+    # @option opts [Fixnum or String] :minimum_ttl Cache TTL for negative responses. The format is the same as for the “ttl” field.
+    # @return [Hash(domains)] A list of domains with results.
+    # @note Support of service lists: yes
+    # @note Accessibility: clients
+    # @example Set TTL.
+    #     RegApi2.zone.update_soa domains: [ { dname: "test.ru" }, { dname: "test.com" } ], ttl: "1d", minimum_ttl: "4h"
+    define :update_soa, required: %w[ ttl minimum_ttl ]
+
+    # @!method tune_forwarding(opts = {})
+    # Use this function to add resource records required for web forwarding.
+    # @param [Hash] opts
+    # @return [Hash(domains)] A list of domains with results.
+    # @note Support of service lists: yes
+    # @note Accessibility: clients
+    # @see #clear_forwarding
+    # @example Add resource records required for web forwarding.
+    #     RegApi2.zone.tune_forwarding domains: [ { dname: "test.ru" }, { dname: "test.com" } ]
+    define :tune_forwarding
+
+    # @!method clear_forwarding(opts = {})
+    # Use this function to delete resource records required for web forwarding.
+    # @param [Hash] opts
+    # @return [Hash(domains)] A list of domains with results.
+    # @note Support of service lists: yes
+    # @note Accessibility: clients
+    # @see #tune_forwarding
+    # @example Delete resource records required for web forwarding.
+    #     RegApi2.zone.clear_forwarding domains: [ { dname: "test.ru" }, { dname: "test.com" } ]
+    define :clear_forwarding
+
+    # @!method tune_parking(opts = {})
+    # Use this function to add resource records required for domain parking.
+    # @param [Hash] opts
+    # @return [Hash(domains)] A list of domains with results.
+    # @note Support of service lists: yes
+    # @note Accessibility: clients
+    # @see #clear_parking
+    # @example Add resource records required for domain parking.
+    #     RegApi2.zone.tune_parking domains: [ { dname: "test.ru" }, { dname: "test.com" } ]
+    define :tune_parking
+
+    # @!method clear_parking(opts = {})
+    # Use this function to delete resource records required for domain parking.
+    # @param [Hash] opts
+    # @return [Hash(domains)] A list of domains with results.
+    # @note Support of service lists: yes
+    # @note Accessibility: clients
+    # @see #tune_parking
+    # @example Delete resource records required for domain parking.
+    #     RegApi2.zone.clear_parking domains: [ { dname: "test.ru" }, { dname: "test.com" } ]
+    define :clear_parking
+
+    # @!method remove_record(opts = {})
+    # Use this function to delete resource records.
+    # @param [Hash] opts
+    # @option opts [String] :subdomain The subdomain for which the resource record will be deleted.
+    # @option opts [String or Symbol] :record_type The class/type of the deleted record. Mandatory field.
+    # @option opts [Fixnum] :priority Optional field. Default value: 0. Not applicable to the request for removal of an A-record (and similar records).
+    # @option opts [String] :content The content of the record. Optional field. If it is not available, all records satisfying the settings of the rest of parameters will be deleted.
+    # @return [Hash(domains)] A list of domains with results.
+    # @note Support of service lists: yes
+    # @note Accessibility: clients
+    # @example Delete A record with 111.111.111.111 ip from @.
+    #     RegApi2.zone.remove_record domains: [ { dname: "test.ru" }, { dname: "test.com" } ], subdomain: '@', content: '111.111.111.111', record_type: :A
+    define :remove_record, required: %w[ subdomain record_type ]
+
+    # @!method clear(opts = {})
+    # Delete all resource records.
+    # @param [Hash] opts
+    # @return [Hash(domains)] A list of domains with results.
+    # @note Support of service lists: yes
+    # @note Accessibility: clients
+    # @example Delete all resource records.
+    #     RegApi2.zone.clear domains: [ { dname: "test.ru" }, { dname: "test.com" } ]
+    define :clear
+
+    extend self
+  end
+end

data/lib/reg_api2.rb

@@ -1,19 +1,21 @@
 # -*- encoding : utf-8 -*-
 require "reg_api2/version"
 
-require "reg_api2/request_contract/default"
-require "reg_api2/result_contract/default"
+require "reg_api2/request_contract"
+require "reg_api2/result_contract"
 
 require "reg_api2/impl"
 require 'reg_api2/builder'
 
 require 'reg_api2/common'
-require 'reg_api2/domains'
-require 'reg_api2/clients'
+require 'reg_api2/domain'
 require 'reg_api2/user'
 require 'reg_api2/service'
+require 'reg_api2/bill'
+require 'reg_api2/folder'
+require 'reg_api2/zone'
 
-# REG.API v2
+# # REG.API v2
 # @example List of services by specified identifiers
 #  RegApi2.service.nop(services: [
 #    { dname:"test.ru" },
@@ -22,32 +24,70 @@ require 'reg_api2/service'
 #    { service_id: "22bug22" },
 #    { surprise: "surprise.ru" }
 #  ])
+#
+# ## RegApi2 module
+#
+# Provides r/w settings for API connection:
+#
+# * {RegApi2.username} - Your user name. `test` by default.
+# * {RegApi2.password} - Your password. `test` by default.
+# * {RegApi2.io_encoding} - Input/ouput encoding. `utf-8` by default.
+# * {RegApi2.lang} - Language of API answers. `en` by default.
+#
+# Provides shortcuts for API categories:
+#
+# * {RegApi2.common} API category implemented as {RegApi2::Common} methods.
+# * {RegApi2.domain} API category implemented as {RegApi2::Domain} methods.
+# * {RegApi2.user} API category implemented as {RegApi2::User} methods.
+# * {RegApi2.service} API category implemented as {RegApi2::Service} methods.
+# * {RegApi2.bill} API category implemented as {RegApi2::Bill} methods.
+# * {RegApi2.folder} API category implemented as {RegApi2::Folder} methods.
+# * {RegApi2.zone} API category implemented as {RegApi2::Zone} methods.
+#
+# Please read {file:README.md} for API overview.
 
 module RegApi2
 
   # Shortcut for {RegApi2::Common} methods
-  # @return [Module]
+  # @return [Module] {RegApi2::Common}
+  # @api Shortcuts
   def common; RegApi2::Common; end
   module_function :common
 
-  # Shortcut for {RegApi2::Domains} methods.
-  # @return [Module]
-  def domains; RegApi2::Domains; end
-  module_function :domains
-
-  # Shortcut for {RegApi2::Clients} methods.
-  # @return [Module]
-  def clients; RegApi2::Clients; end
-  module_function :clients
+  # Shortcut for {RegApi2::Domain} methods.
+  # @return [Module] {RegApi2::Domain} 
+  # @api Shortcuts
+  def domain; RegApi2::Domain; end
+  module_function :domain
 
   # Shortcut for {RegApi2::User} methods.
-  # @return [Module]
+  # @return [Module] {RegApi2::User}
+  # @api Shortcuts
   def user; RegApi2::User; end
   module_function :user
 
   # Shortcut for {RegApi2::Service} methods.
-  # @return [Module]
+  # @return [Module] {RegApi2::Service}
+  # @api Shortcuts
   def service; RegApi2::Service; end
   module_function :service
 
+  # Shortcut for {RegApi2::Bill} methods.
+  # @return [Module] {RegApi2::Bill}
+  # @api Shortcuts
+  def bill; RegApi2::Bill; end
+  module_function :bill
+
+  # Shortcut for {RegApi2::Folder} methods.
+  # @return [Module] {RegApi2::Folder}
+  # @api Shortcuts
+  def folder; RegApi2::Folder; end
+  module_function :folder
+
+  # Shortcut for {RegApi2::Zone} methods.
+  # @return [Module] {RegApi2::Zone}
+  # @api Shortcuts
+  def zone; RegApi2::Zone; end
+  module_function :zone
+
 end

data/reg.api2.gemspec

@@ -5,7 +5,7 @@ require 'reg_api2/version'
 
 Gem::Specification.new do |spec|
   spec.name          = "reg.api2"
-  spec.version       = RegApi2::VERSION
+  spec.version       = RegApi2::VERSION.dup
   spec.authors       = ["Akzhan Abdulin"]
   spec.email         = ["akzhan.abdulin@gmail.com"]
   spec.description   = %q{REG.API v2 Implementation}
@@ -17,6 +17,7 @@ Gem::Specification.new do |spec|
   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.has_rdoc      = 'yard'
 
   spec.add_runtime_dependency "yajl-ruby", "~> 1.0"
   spec.add_development_dependency "bundler", "~> 1.3"
@@ -28,4 +29,5 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency "machinist"
   spec.add_development_dependency "yard"
   spec.add_development_dependency "redcarpet"
+  spec.add_development_dependency "yard-redcarpet-ext"
 end

data/spec/lib/reg_api2/bill_spec.rb

@@ -0,0 +1,80 @@
+# -*- encoding : utf-8 -*-
+
+describe RegApi2::Bill do
+
+  include RegApi2
+
+  describe :nop do
+    it "should raise nothing" do
+      lambda { bill.nop }.should_not raise_error
+    end
+    
+    it "should return nil" do
+      bill.nop.should be_nil
+    end
+
+    it "should return bill if specified" do
+      bill.nop(bill_id: 12345).bills.should have(1).bill
+    end
+
+    it "should return bills if specified" do
+      bill.nop(bills: [ 12345, 12346 ]).bills.should have(2).bills
+    end  
+  end
+
+  describe :get_not_payed do
+    it "should raise nothing" do
+      lambda { bill.get_not_payed }.should_not raise_error
+    end
+
+    it "should return something real" do
+      bill.get_not_payed.bills.should have(1).bill
+    end
+  end
+
+  describe :get_for_period do
+    it "should raise ContractError without dates" do
+      lambda { bill.get_for_period }.should raise_error RegApi2::ContractError
+    end
+
+    it "should return something real" do
+      bill.get_for_period(
+        start_date: Date.new(2000, 1, 1),
+        end_date: Date.new(2015, 1, 1)
+      ).bills.should have(1).bill
+    end
+  end
+
+  describe :change_pay_type do
+    it "should raise if no currency given" do
+      lambda { bill.change_pay_type(
+        pay_type: :prepay, 
+        bills: [ 123456 ] 
+      ) }.should raise_error RegApi2::ContractError
+    end
+    it "should raise if no pay_type given" do
+      lambda { bill.change_pay_type(
+        currency: :RUR, 
+        bills: [ 123456 ]
+      ) }.should raise_error RegApi2::ContractError
+    end
+    it "should raise nothing if ok" do
+      bill.change_pay_type(
+        pay_type: :prepay,
+        currency: :RUR,
+        bills: [ 123456 ]
+      ).bills.should have(1).bill
+    end
+  end
+
+  describe :delete do
+    it "should remove three bills if specified" do
+      ans = bill.delete(
+        bills: [ { bill_id: 12345 }, { bill_id: 12346 }, { bill_id: 12347 } ]
+      ).bills
+      ans.map { |b| b.bill_id }.should == [ 12345, 12346, 12347 ]
+      ans.each { |b| b.result.should == 'success' }
+      ans.each { |b| b.status.should == 'deleted' }
+    end
+  end
+end

data/spec/lib/reg_api2/common_spec.rb

@@ -1,39 +1,41 @@
 # -*- encoding : utf-8 -*-
-describe RegApi2 do
+describe RegApi2::Common do
+
+  include RegApi2
 
   describe :nop do
     it "should raise nothing" do
-      lambda { RegApi2.common.nop }.should_not raise_error
+      lambda { common.nop }.should_not raise_error
     end
     it "should return login" do
-      RegApi2.common.nop['login'].should == RegApi2.username
+      common.nop.login.should == RegApi2.username
     end
   end
 
   describe :reseller_nop do
     it "should raise nothing" do
-      lambda { RegApi2.common.reseller_nop }.should_not raise_error
+      lambda { common.reseller_nop }.should_not raise_error
     end
     it "should return login" do
-      RegApi2.common.reseller_nop['login'].should == RegApi2.username
+      common.reseller_nop.login.should == RegApi2.username
     end
   end
 
   describe :get_user_id do
     it "should raise nothing" do
-      lambda { RegApi2.common.get_user_id }.should_not raise_error
+      lambda { common.get_user_id }.should_not raise_error
     end
     it "should return user id" do
-      RegApi2.common.get_user_id.should be_kind_of(Fixnum)
+      common.get_user_id.should be_kind_of(Fixnum)
     end
   end
 
   describe :get_service_id do
     it "should raise nothing" do
-      lambda { RegApi2.common.get_service_id(service_id: 123456) }.should_not raise_error
+      lambda { common.get_service_id(service_id: 123456) }.should_not raise_error
     end
     it "should return user id" do
-      RegApi2.common.get_service_id(service_id: 123456) == 123456
+      common.get_service_id(service_id: 123456) == 123456
     end
   end
 end

data/spec/lib/reg_api2/domain_spec.rb

@@ -0,0 +1,26 @@
+# -*- encoding : utf-8 -*-
+describe RegApi2::Domain do
+
+  include RegApi2
+
+  describe :nop do
+    it "should raise nothing" do
+      lambda { domain.nop }.should_not raise_error
+    end
+
+    it "should return service id if domain exist"
+    #  RegApi2.domain.nop(dname: 'test.ru').should be_nil
+  end
+
+  describe :get_prices do
+    it "should return prices" do
+      prices = domain.get_prices(
+        show_renew_data: true,
+        show_update_data: true, 
+        currency: :USD
+      )
+      prices.should have_key(:price_group)
+      prices.currency.should == 'USD'
+    end
+  end
+end

data/spec/lib/reg_api2/folder_spec.rb

@@ -0,0 +1,52 @@
+# -*- encoding : utf-8 -*-
+
+describe RegApi2::Folder do
+
+  include RegApi2
+
+  EXAMPLE_FOLDER_DATA = { "name" => "test_folder_name", "id" => "-1" }.freeze
+
+  describe :nop do
+    it "should raise nothing" do
+      lambda { folder.nop }.should_not raise_error
+    end
+    
+    it "should return default folder if no ops set" do
+      folder.nop.should == EXAMPLE_FOLDER_DATA
+    end
+
+    it "should return folder data if folder_id specified" do
+      folder.nop(folder_id: 12345).should == EXAMPLE_FOLDER_DATA
+    end
+    
+    it "should return folder data if test_folder_name specified" do
+      folder.nop(folder_name: "test_folder_name").should == EXAMPLE_FOLDER_DATA
+    end  
+  end
+
+  describe :create do
+    it "should create a folder" do
+      folder.create(folder_name: 'test_folder_name').should be_nil
+    end
+  end
+
+  describe :remove do
+    it "should remove a folder by id" do
+      folder.remove(folder_id: 123456).should be_nil
+    end
+
+    it "should remove a folder by name" do
+      folder.remove(folder_name: 'test_folder_name').should be_nil
+    end
+  end
+
+  describe :rename do
+    it "should rename a folder by id" do
+      folder.rename(folder_id: 123456, new_folder_name: 'new_test_folder_name').should have_key(:folder_content)
+    end
+
+    it "should rename a folder by name" do
+      folder.rename(folder_name: 'test_folder_name', new_folder_name: 'new_test_folder_name').should have_key(:folder_content)
+    end
+  end
+end

data/spec/lib/reg_api2/{request_contract/default_spec.rb → request_contract_spec.rb}

@@ -1,8 +1,8 @@
 # -*- encoding : utf-8 -*-
-describe RegApi2::RequestContract::Default do
+describe RegApi2::RequestContract do
 
   let!(:contract) {
-    RegApi2::RequestContract::Default.new(
+    RegApi2::RequestContract.new(
       required: %w[ a b ],
       optional: %w[ c d ]
     )

data/spec/lib/reg_api2/result_contract_spec.rb

@@ -0,0 +1,58 @@
+# -*- encoding : utf-8 -*-
+describe RegApi2::ResultContract do
+
+  let!(:contract) { RegApi2::ResultContract.new(a: 1, b: 4) }
+
+  describe :initialize do
+    it "should assign opts" do
+      contract.opts.should == { a: 1, b: 4 }
+    end
+  end
+
+  describe :handle_result do
+    it "should return handle_answer" do
+      expected = 'OOLOLLO'
+      mock(contract).handle_answer({}) { expected } 
+      contract.handle_result({ "answer" => {} }).should == expected
+    end
+  end
+
+  describe :handle_answer do
+    it "should return specified value" do
+      contract.handle_answer("FX").should == "FX"
+    end
+
+    it "should return field value if exists" do
+      contract = RegApi2::ResultContract.new(a:1, field: :a)
+      contract.handle_result({ answer: { "a" => "FX" } }).should == "FX"
+    end
+  end
+
+  describe :convert do
+    it "should convert fields of some types for hashes" do
+      ans = contract.convert({
+        active_domains_cnt: "6",
+        success: "0",
+        amount: "15",
+        text: "2323" 
+      })
+      ans.should == {
+        active_domains_cnt: 6,
+        success: false,
+        amount: 15.0,
+        text: "2323"
+      }
+      ans = contract.convert({
+        success: "1",
+      })
+      ans.should == {
+        success: true,
+      }
+    end
+
+    it "should proceed arrays too" do
+      ans = contract.convert([ 1, 2, [ 1 ], { amount: "4543" } ])
+      ans.should == [ 1, 2, [ 1 ], { amount: 4543.0} ]
+    end
+  end
+end