whois-parser 0.0.1 → 1.0.0.pre.beta1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 93d1c642700ef38eadea4fb183d03cbe7a7ff336
-  data.tar.gz: 5fd4aebbd630fd41d0099b55e3ace7653876ba72
+  metadata.gz: af38e1acd98423594909a861cb24844f20750ad3
+  data.tar.gz: 0018ffd2edd5fd685d8767fedd598b9e00a708c5
 SHA512:
-  metadata.gz: 4d6a252a349db37f7fe352899cac7707f3fa025bc17d338a308d3daa1a88d6d3b58b593ac77cc0502522a577b34f134152a6d32e98f30ee4b923f9ffd30b68c0
-  data.tar.gz: e1199508bd270d12f51f08df7961889ad581549c4b7218a766cdbcb98b4434b65cb036bcde6321dc9c239444affca9f0d3d265cbff1c4907ba189e6a26539087
+  metadata.gz: fd44abb95f7be9e4d60cbd8c63e14a9e2272770aea82ced954f57d5ba40225ff2ef9b58cc26be35a93b305edd741d4a835d3c686fdc5801fff6d0cf84d7bd205
+  data.tar.gz: c7e36ae017065a96f41b096c59bcb909c3da4bf2bd92ac9b68ad5c210ff798dd74753dc944890cff5c2a929e614b4873e74d292b5d8657e5ff79fe1e863ab902

data/.yardopts

@@ -0,0 +1,2 @@
+--readme README.md
+--title 'Whois::Parser API Documentation'

data/CHANGELOG.md

@@ -0,0 +1,20 @@
+# Changelog
+
+This project uses [Semantic Versioning 2.0.0](http://semver.org/).
+
+
+##### master
+
+Initial import from the `whois` library.
+
+- NEW: whois.dk-hostmaster.dk parser now recognizes throttled responses (whois/GH-382). [Thanks @troelskn]
+
+- NEW: Safer time parsing (GH-18). [Thanks @davidcornu]
+
+- NEW: Detect reserved .INFO domains (whois/GH-468).
+
+- FIXED: whois.audns.net.au removed the registrar ID field (GH-20, GH-21). Thanks [@afoster]
+
+- CHANGED: Updated .JOBS from obswhois.verisign-grs.com to whois.nic.jobs (GH-23).
+
+- CHANGED: Updated .PRO from whois.dotproregistry.net to whois.afilias.net (GH-24).

data/CONTRIBUTING.md

@@ -0,0 +1,40 @@
+# Contributing
+
+## Workflow
+
+Fork, then clone the repo:
+
+    $ git clone git@github.com:your-username/whois-parser.git
+
+Set up your machine:
+
+    $ bundle
+
+Make sure the tests pass:
+
+    $ bundle exec rake
+
+To propose a change/feature/patch, create your feature branch:
+
+    $ git checkout -b my-new-feature
+
+Make your change. Add tests for your change. Make the tests pass:
+
+    $ bundle exec rake
+
+`utils/mkwhois.rb` can be used to quicky generate `status_available.txt` and `status_registered.txt` files for your tests
+
+    $ ruby utils/mkwhois.rb google.com status_available
+
+Commit your changes:
+
+    $ git commit -am 'Add some feature'
+
+Push to your fork and [submit a pull request](https://github.com/weppos/whois-parser/compare/).
+
+
+## Tests
+
+To increase the chance that your pull request is accepted please **make sure to write tests**. Changes without corresponding tests will likely not be included as they will produce fragile code that can easily break whenever the registry changes the response format.
+
+Some examples: [84dbdde320f31c20184bcfe5e544e8fd3cd32862](https://github.com/weppos/whois/commit/84dbdde320f31c20184bcfe5e544e8fd3cd32862), [3b6688b95e6fadcf720cc777ef4bbd2cd644e62b](https://github.com/weppos/whois/commit/3b6688b95e6fadcf720cc777ef4bbd2cd644e62b)

data/LICENSE.txt

@@ -1,22 +1,21 @@
-Copyright (c) 2016 Simone Carletti
+The MIT License (MIT)
 
-MIT License
+Copyright (c) 2009-2015 Simone Carletti
 
-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:
+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 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.
+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

@@ -1,31 +1,13 @@
-# Whois::Parser
+# [Whois](http://whoisrb.org/) Parser
 
-TODO: Write a gem description
+[![Build Status](https://travis-ci.org/weppos/whois-parser.svg?branch=master)](https://travis-ci.org/weppos/whois-parser)
 
-## Installation
 
-Add this line to your application's Gemfile:
+## Versioning
 
-```ruby
-gem 'whois-parser'
-```
+<tt>Whois::Parser</tt> uses [Semantic Versioning 2.0.0](http://semver.org)
 
-And then execute:
 
-    $ bundle
+## License
 
-Or install it yourself as:
-
-    $ gem install whois-parser
-
-## Usage
-
-TODO: Write usage instructions here
-
-## Contributing
-
-1. Fork it ( https://github.com/[my-github-username]/whois-parser/fork )
-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 a new Pull Request
+Copyright (c) 2009-2015 Simone Carletti. This is Free Software distributed under the MIT license.

data/lib/whois/parser/contact.rb

@@ -0,0 +1,56 @@
+require_relative 'super_struct'
+
+
+module Whois
+  class Parser
+
+    # Holds the details of a contact extracted from the WHOIS response.
+    #
+    # A contact is composed by the several attributes,
+    # accessible through corresponding getter / setter methods.
+    #
+    # Please note that a response is not required to provide
+    # all the attributes. When an attribute is not available,
+    # the corresponding value is set to nil.
+    #
+    # @attr [String] id
+    # @attr [String] type
+    # @attr [String] name
+    # @attr [String] organization
+    # @attr [String] address
+    # @attr [String] city
+    # @attr [String] zip
+    # @attr [String] state
+    # @attr [String] country
+    # @attr [String] country_code
+    # @attr [String] phone
+    # @attr [String] fax
+    # @attr [String] email
+    # @attr [String] url - e. g. to the contact form
+    # @attr [Time] created_on
+    # @attr [Time] updated_on
+    #
+    class Contact < SuperStruct.new(:id, :type, :name, :organization,
+                                    :address, :city, :zip, :state, :country, :country_code,
+                                    :phone, :fax, :email, :url,
+                                    :created_on, :updated_on)
+
+      TYPE_REGISTRANT     = 1
+      TYPE_ADMINISTRATIVE = 2
+      TYPE_TECHNICAL      = 3
+
+
+      def self.const_missing(name)
+        case name
+        when :TYPE_ADMIN
+          Whois.deprecate("Whois::Record::Contact::TYPE_ADMIN is now Whois::Record::Contact::TYPE_ADMINISTRATIVE")
+          self.const_set(name, TYPE_ADMINISTRATIVE)
+        else
+          super
+        end
+      end
+
+    end
+
+  end
+end

data/lib/whois/parser/errors.rb

@@ -0,0 +1,46 @@
+module Whois
+
+  # @!group Parser
+
+  # Generic class for parser errors.
+  class ParserError < Error
+  end
+
+  # Raised when the library hasn't been able to load a valid parser
+  # according to current settings and you're trying to access a property
+  # that requires a valid parser.
+  class ParserNotFound < ParserError
+  end
+
+  # Raised when you are trying to access an attribute that has not been implemented.
+  class AttributeNotImplemented < ParserError
+  end
+
+  # Raised when you are trying to access an attribute that is not supported.
+  class AttributeNotSupported < ParserError
+  end
+
+  # @!endgroup
+
+
+  # @!group Response
+
+  # Generic class for response errors.
+  class ResponseError < Error
+  end
+
+  # Raised when attempting to access a property when the response is throttled.
+  #
+  # @see Whois::Parsers::Base#response_throttled?
+  class ResponseIsThrottled < ResponseError
+  end
+
+  # Raised when attempting to access a property when the response is unavailable.
+  #
+  # @see Whois::Parsers::Base#response_unavailable?
+  class ResponseIsUnavailable < ResponseError
+  end
+
+  # @!endgroup
+
+end

data/lib/whois/parser/nameserver.rb

@@ -0,0 +1,39 @@
+require_relative 'super_struct'
+
+
+module Whois
+  class Parser
+
+    # Holds the details of the Name Servers extracted from the WHOIS response.
+    #
+    # A name server is composed by the several attributes,
+    # accessible through corresponding getter / setter methods.
+    #
+    # Please note that a response is not required to provide
+    # all the attributes. When an attribute is not available,
+    # the corresponding value is set to nil.
+    #
+    # @attr [String] name
+    # @attr [String] ipv4
+    # @attr [String] ipv6
+    #
+    class Nameserver < SuperStruct.new(:name, :ipv4, :ipv6)
+
+      # Returns a string representation of this object
+      # composed by the host +name+.
+      #
+      # @example
+      #   Nameserver.new(:name => "ns.example.com").to_s
+      #   # => "ns.example.com"
+      #   Nameserver.new.to_s
+      #   # => ""
+      #
+      # @return [String] The string representation.
+      def to_s
+        name.to_s
+      end
+
+    end
+
+  end
+end

data/lib/whois/parser/registrar.rb

@@ -0,0 +1,25 @@
+require_relative 'super_struct'
+
+
+module Whois
+  class Parser
+
+    # Holds the details of the Registrar extracted from the WHOIS response.
+    #
+    # A registrar is composed by the several attributes,
+    # accessible through corresponding getter / setter methods.
+    #
+    # Please note that a response is not required to provide
+    # all the attributes. When an attribute is not available,
+    # the corresponding value is set to nil.
+    #
+    # @attr [String] id
+    # @attr [String] name
+    # @attr [String] organization
+    # @attr [String] url
+    #
+    class Registrar < SuperStruct.new(:id, :name, :organization, :url)
+    end
+
+  end
+end

data/lib/whois/parser/super_struct.rb

@@ -0,0 +1,53 @@
+require 'ostruct'
+
+
+# SuperStruct is an enhanced version of the Ruby Standard library {Struct}.
+#
+# Compared with the original version, it provides the following additional features:
+# * ability to initialize an instance from Hash
+# * ability to pass a block on creation
+#
+class SuperStruct < Struct
+
+  # Overwrites the standard {Struct} initializer
+  # to add the ability to create an instance from a {Hash} of parameters.
+  #
+  # @overload initialize({ Symbol => Object })
+  #   Initializes the object with a key/value hash.
+  #   @param [{ Symbol => Object }] values
+  #   @return [SuperStruct]
+  # @overload initialize([ value1, value1, ... ])
+  #   Initializes the object with given values.
+  #   @param [Array] values
+  #   @return [SuperStruct]
+  # @overload initialize(value1, value1, ...)
+  #   Initializes the object with given values.
+  #   @return [SuperStruct]
+  #
+  # @yield  self
+  #
+  # @example
+  #   attributes = { :foo => 1, :bar => "baz" }
+  #   Struct.new(attributes)
+  #   # => #<Struct foo=1, bar="baz">
+  #
+  def initialize(*args)
+    if args.first.is_a? Hash
+      initialize_with_hash(args.first)
+    elsif args.size == 0
+      super
+    else
+      raise ArgumentError
+    end
+    yield(self) if block_given?
+  end
+
+  private
+
+  def initialize_with_hash(attributes = {})
+    attributes.each do |key, value|
+      self[key] = value
+    end
+  end
+
+end

data/lib/whois/parser/version.rb

@@ -1,5 +1,6 @@
 module Whois
-  module Parser
-    VERSION = "0.0.1"
+  class Parser
+    # The current library version.
+    VERSION = "1.0.0-beta1"
   end
 end