nic_ar 0.0.1

data/.gitignore

@@ -0,0 +1,18 @@
+*.gem
+*.rbc
+*.rvmrc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/Gemfile

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

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2012 Cristian R. Arroyo
+
+MIT License
+
+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,65 @@
+# NicAr::Client
+
+The NicAr::Client gem allows to programatically extract information about any ".ar" (Argentina) domain name. 
+
+It uses the public information as is made available at the [Dirección Nacional del Registro de Dominios de Internet](http://www.nic.ar) via the third-party [nic!alert API](http://api.nicalert.com.ar) webservice.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'nic_ar'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install nic_ar
+
+## Usage
+
+The NicAr::Client class supports lookups for domain names, domain transactions, entities, people, DNS servers.
+
+All the following lookups will raise a NicAr::NotFound exception if the requested resource could not be found.
+
+    NicAr::Client.domains("vivaserver.com.ar")
+    => {"available"=>false, "delegated"=>true, "expiring"=>false, "pending"=>false, "registered"=>true, "name"=>"vivaserver", "domain"=>".com.ar", "created_on"=>"2004-11-18", "expires_on"=>"2012-11-18", "contacts"=>{"registrant"=>{"name"=>"Cristian Renato Arroyo", "occupation"=>"Diseno de Paginas Web", "address"=>"Pje. Vucetich 676. Ciudad De Nieva", "city"=>"S. S. de Jujuy", "province"=>"Jujuy", "zip_code"=>"4600", "country"=>"Argentina", "phone"=>"(0388)155827713", "fax"=>"(0388)155827713"}, "responsible"=>{"name"=>"Cristian Renato Arroyo", "address"=>"Pje. Vucetich 676. Ciudad De Nieva.", "city"=>"S. S. de jujuy", "province"=>"Jujuy", "zip_code"=>"4600", "country"=>"Argentina", "phone"=>"(0388)155827713", "fax"=>"(0388)155827713", "work_hours"=>"8am-1pm"}, "administrative"=>{"name"=>"Dynamic DNS Network Services", "address"=>"210 Park Ave. #267", "city"=>"Worcester", "province"=>"", "zip_code"=>"MA 01609", "country"=>"USA", "phone"=>"1-508-798-2145", "fax"=>"1-508-798-5748", "activity"=>"Network Services"}, "technical"=>{"name"=>"Andre Dure", "address"=>"Humahuaca 1303", "city"=>"Capital Federal", "province"=>"Ciudad de Buenos Aires", "zip_code"=>"C1405BIA", "country"=>"Argentina", "phone"=>"49588864", "fax"=>"43335885", "work_hours"=>"10 a 22"}}, "dns_servers"=>{"primary"=>{"host"=>"ns1.mydyndns.org", "ip"=>nil}, "secondary"=>{"host"=>"ns2.mydyndns.org", "ip"=>nil}, "alternate1"=>{"host"=>"ns3.mydyndns.org", "ip"=>nil}, "alternate2"=>{"host"=>"ns4.mydyndns.org", "ip"=>nil}, "alternate3"=>{"host"=>"ns5.mydyndns.org", "ip"=>nil}}}
+
+    NicAr::Client.entities("Dynamic DNS Network Services")
+    => {"name"=>"Dynamic DNS Network Services", "type"=>"ADMINISTRADORA", "address"=>"210 Park Ave. #267", "city"=>"Worcester", "province"=>nil, "country"=>"USA", "activity"=>"Network Services", "handle"=>"NICAR-E607791"}
+
+    NicAr::Client.people("Andre Dure")
+    => {"name"=>"Andre Dure", "handle"=>"NICAR-P425476"}
+
+    NicAr::Client.dns_servers("ns1.mydyndns.org")
+    => {"host"=>"ns1.mydyndns.org", "ip"=>nil, "owner"=>"Andre Dure", "operator"=>"Andre Dure", "handle"=>"NICAR-H12587"}
+
+If a domain name has no recent transactions, a NicAr::NoContent exception will be raised.
+
+    NicAr::Client.transactions("nazarenorock.com.ar")
+    => [{"id"=>"REG18127727", "created_at"=>"2012-10-03T15:11:01-03:00", "description"=>"Registro de Nombre", "status"=>"PENDIENTE", "notes"=>"Se envio acuse de recibo al solicitante"}]
+
+Transactions can also be queried by it's unique identifier:
+
+    NicAr::Client.transactions("REG18127727")
+    => {"domain"=>"nazarenorock.com.ar", "created_at"=>"2012-10-03T15:11:01-03:00", "description"=>"Registro de Nombre", "status"=>"PENDIENTE", "notes"=>"Se envio acuse de recibo al solicitante"}
+
+The full documentation of the nic!alert API is available at [api.nicalert.com.ar](http://api.nicalert.com.ar) if you want to write your own client, use any other language, or just use CURL in a RESTful way.
+
+## Live sample
+
+A live test application is set up at the [nic!alert](http://www.nicalert.com.ar) website that allows for the automatic renewal of ".ar" domain names within their 30-day expiring period. The application also has the added feature of resolving the CAPTCHA challenge for the submission of the renewal request.
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request
+
+## Copyright
+
+Copyright (c)2012 [Cristian R. Arroyo](mailto:cristian.arroyo@vivasserver.com). MIT Licensed.

data/Rakefile

@@ -0,0 +1 @@
+require "bundler/gem_tasks"

data/lib/nic_ar/client.rb

@@ -0,0 +1,86 @@
+module NicAr
+  class Client
+    class << self
+      def method_missing(name, *args)
+        unless args.empty?
+          params = args.map { |p| CGI.escape(p) }.join '/'
+          resource = name.to_s
+          # send the bang! trailing the request (upcoming API feat.)
+          if unbanged = resource[/(\w+)!$/,1]
+            resource = unbanged
+            params += '!'
+          end
+          get "/#{resource}/#{params}"
+        else
+          raise ArgumentError
+        end
+      end
+
+      private
+
+      def get(path)  #:nodoc:
+        RestClient.get("#{api_host}/#{path}") do |response, request, result, &block|
+          message = message_from(response)
+
+          case response.code
+          #200: Success
+          when 200
+            JSON.parse(response)
+
+          #204: No Content
+          when 204
+            raise NoContent
+
+          #424: Failed Dependency
+          when 424
+            raise CaptchaError, message
+
+          #406: Not Acceptable
+          when 406  
+            raise DomainError, message
+
+          #417: Expectation Failed
+          when 417  
+            raise ExpectationError, message
+
+          #404: Not Found
+          when 404
+            raise NotFound
+
+          #400: Bad Request
+          when 400
+            raise ParameterError, message
+
+          #412: Precondition Failed
+          when 412
+            raise PreconditionError, message
+
+          #408: Request Timeout
+          #503: Service Unavailable
+          when 408, 503
+            raise TimeoutError, message
+
+          #500: System Error
+          when 500
+            raise ServiceError, message
+
+          else
+            response.return!(request, response, &block)
+          end
+        end
+      end
+
+      def message_from(response)  #:nodoc:
+        JSON.parse(response)['message']
+      rescue
+        nil
+      end
+
+      # override to support multiple API hosts
+
+      def api_host  #:nodoc:
+        API_URI
+      end
+    end
+  end
+end

data/lib/nic_ar/version.rb

@@ -0,0 +1,3 @@
+module NicAr
+  VERSION = "0.0.1"
+end

data/lib/nic_ar.rb

@@ -0,0 +1,24 @@
+require 'cgi'
+require 'json'
+require 'rubygems'
+require 'bundler/setup'
+require 'rest_client'
+
+module NicAr
+  API_URI = 'http://api.nicalert.com.ar'
+
+  # exceptions match API's error codes
+
+  class CaptchaError      < StandardError; end  # 424: Failed Dependency
+  class DomainError       < StandardError; end  # 406: Not Acceptable
+  class ExpectationError  < StandardError; end  # 417: Expectation Failed (available?, pending?)
+  class NoContent         < StandardError; end  # 204: No Content
+  class NotFound          < StandardError; end  # 404: Not Found
+  class ParameterError    < StandardError; end  # 400: Bad Request
+  class PreconditionError < StandardError; end  # 412: Precondition Failed
+  class ServiceError      < StandardError; end  # 500: System Error
+  class TimeoutError      < StandardError; end  # 408: Request Timeout
+end
+
+require "nic_ar/client"
+require "nic_ar/version"

data/nic_ar.gemspec

@@ -0,0 +1,21 @@
+# -*- encoding: utf-8 -*-
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'nic_ar/version'
+
+Gem::Specification.new do |gem|
+  gem.name          = "nic_ar"
+  gem.version       = NicAr::VERSION
+  gem.authors       = ["Cristian R. Arroyo"]
+  gem.email         = ["cristian.arroyo@vivaserver.com"]
+  gem.description   = %q{A simple client for the nic!alert API}
+  gem.summary       = %q{A simple client for ".ar" (Argentina) domain names lookup using the nic!alert API}
+  gem.homepage      = "https://github.com/vivaserver/nic_ar"
+
+  gem.add_runtime_dependency 'rest-client', "~> 1.6"
+
+  gem.files         = `git ls-files`.split($/)
+  gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.require_paths = ["lib"]
+end

metadata

@@ -0,0 +1,66 @@
+--- !ruby/object:Gem::Specification
+name: nic_ar
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Cristian R. Arroyo
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-10-31 00:00:00.000000000Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rest-client
+  requirement: &85718140 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.6'
+  type: :runtime
+  prerelease: false
+  version_requirements: *85718140
+description: A simple client for the nic!alert API
+email:
+- cristian.arroyo@vivaserver.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- lib/nic_ar.rb
+- lib/nic_ar/client.rb
+- lib/nic_ar/version.rb
+- nic_ar.gemspec
+homepage: https://github.com/vivaserver/nic_ar
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.10
+signing_key: 
+specification_version: 3
+summary: A simple client for ".ar" (Argentina) domain names lookup using the nic!alert
+  API
+test_files: []