public_suffix 1.0.0.rc1

data/.gitignore

@@ -0,0 +1,4 @@
+.bundle
+.yardoc
+pkg/*
+yardoc

data/.travis.yml

@@ -0,0 +1,11 @@
+rvm:
+  - 1.8.7
+  - 1.9.2
+  - ruby-head
+  - ree
+  - jruby
+  - rbx
+  - rbx-2.0
+notifications:
+  recipients:
+    - weppos@weppos.net

data/.yardopts

@@ -0,0 +1,2 @@
+--readme README.rdoc
+--title 'Ruby Public Suffix API Documentation'

data/CHANGELOG.md

@@ -0,0 +1,134 @@
+# Changelog
+
+
+## Release 1.0.0.rc1
+
+The library is now known as PublicSuffix.
+
+
+## Release 0.9.1
+
+* CHANGED: Renamed PublicSuffixService::RuleList to PublicSuffixService::List.
+
+* CHANGED: Renamed PublicSuffixService::List#list to PublicSuffixService::List#rules.
+
+* CHANGED: Renamed PublicSuffixService to PublicSuffix.
+
+* CHANGED: Updated definitions.
+
+
+## Release 0.9.0
+
+* CHANGED: Minimum Ruby version increased to Ruby 1.8.7.
+
+* CHANGED: rake/gempackagetask is deprecated.  Use rubygems/package_task instead.
+
+
+## Release 0.8.4
+
+* FIXED: Reverted bugfix for issue #12 for Ruby 1.8.6.
+  This is the latest version compatible with Ruby 1.8.6.
+
+
+## Release 0.8.3
+
+* FIXED: Fixed ArgumentError: invalid byte sequence in US-ASCII with Ruby 1.9.2 (#12).
+
+* CHANGED: Updated definitions (#11).
+
+* CHANGED: Renamed definitions.txt to definitions.dat.
+
+
+## Release 0.8.2
+
+* NEW: Added support for rubygems-test.
+
+* CHANGED: Integrated Bundler.
+
+* CHANGED: Updated definitions.
+
+
+## Release 0.8.1
+
+* FIXED: The files in the release 0.8.0 have wrong permission 600 and can't be loaded (#10).
+
+
+## Release 0.8.0
+
+* CHANGED: Update public suffix list to d1a5599b49fa 2010-10-25 15:10 +0100 (#9)
+
+* NEW: Add support for Fully Qualified Domain Names (#7)
+
+
+## Release 0.7.0
+
+* CHANGED: Using YARD to document the code instead of RDoc.
+
+* FIXED: RuleList cache is not recreated when a new rule is appended to the list (#6)
+
+* FIXED: PublicSuffixService.valid? should return false if the domain is not defined or not allowed (#4, #5)
+
+
+## Release 0.6.0
+
+* NEW:  PublicSuffixService.parse raises DomainNotAllowed when trying to parse a domain name
+  which exists, but is not allowed by the current definition list (#3)
+
+        PublicSuffixService.parse("nic.do")
+        # => PublicSuffixService::DomainNotAllowed
+
+* CHANGED: Renamed PublicSuffixService::InvalidDomain to PublicSuffixService::DomainInvalid
+
+
+## Release 0.5.2
+
+* CHANGED: Update public suffix list to 248ea690d671 2010-09-16 18:02 +0100
+
+
+## Release 0.5.1
+
+* CHANGED: Update public suffix list to 14dc66dd53c1 2010-09-15 17:09 +0100
+
+
+## Release 0.5.0
+
+* CHANGED: Improve documentation for Domain#domain and Domain#subdomain (#1).
+
+* CHANGED: Performance improvements (#2).
+
+
+## Release 0.4.0
+
+* CHANGED: Rename library from DomainName to PublicSuffixService to reduce the probability of name conflicts.
+
+
+## Release 0.3.1
+
+* Deprecated DomainName library.
+
+
+## Release 0.3.0
+
+* CHANGED: DomainName#domain and DomainName#subdomain are no longer alias of Domain#sld and Domain#tld.
+
+* CHANGED: Removed DomainName#labels and decoupled Rule from DomainName.
+
+* CHANGED: DomainName#valid? no longer instantiates new DomainName objects. This means less overhead.
+
+* CHANGED: Refactoring the entire DomainName API. Removed the internal on-the-fly parsing. Added a bunch of new methods to check and validate the DomainName.
+
+
+## Release 0.2.0
+
+* NEW: DomainName#valid?
+
+* NEW: DomainName#parse and DomainName#parse!
+
+* NEW: DomainName#valid_domain? and DomainName#valid_subdomain?
+
+* CHANGED: Make sure RuleList lookup is only performed once.
+
+
+## Release 0.1.0
+
+* Initial version

data/Gemfile

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

data/Gemfile.lock

@@ -0,0 +1,22 @@
+PATH
+  remote: .
+  specs:
+    public_suffix (1.0.0.rc1)
+
+GEM
+  remote: http://rubygems.org/
+  specs:
+    metaclass (0.0.1)
+    mocha (0.10.0)
+      metaclass (~> 0.0.1)
+    rake (0.9.2)
+    yard (0.7.4)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  mocha
+  public_suffix!
+  rake
+  yard

data/LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2009-2011 Simone Carletti <weppos@weppos.net>
+
+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,151 @@
+# Public Suffix List - Ruby implementation
+
+*Public Suffix* is a Ruby domain name parser based on the [Public Suffix List](http://publicsuffix.org).
+
+[![Build Status](https://secure.travis-ci.org/weppos/public_suffix_service.png)](http://travis-ci.org/weppos/public_suffix_service)
+
+
+## What is the Public Suffix List?
+
+The Public Suffix List is a cross-vendor initiative to provide an accurate list of domain name suffixes.
+
+The Public Suffix List is an initiative of the Mozilla Project, but is maintained as a community resource. It is available for use in any software, but was originally created to meet the needs of browser manufacturers.
+
+A "public suffix" is one under which Internet users can directly register names. Some examples of public suffixes are ".com", ".co.uk" and "pvt.k12.wy.us". The Public Suffix List is a list of all known public suffixes.
+
+Source: http://publicsuffix.org
+
+
+## Why the Public Suffix List is better than any available Regular Expression parser?
+
+Previously, browsers used an algorithm which basically only denied setting wide-ranging cookies for top-level domains with no dots (e.g. com or org). However, this did not work for top-level domains where only third-level registrations are allowed (e.g. co.uk). In these cases, websites could set a cookie for co.uk which will be passed onto every website registered under co.uk.
+
+Clearly, this was a security risk as it allowed websites other than the one setting the cookie to read it, and therefore potentially extract sensitive information.
+
+Since there is no algorithmic method of finding the highest level at which a domain may be registered for a particular top-level domain (the policies differ with each registry), the only method is to create a list of all top-level domains and the level at which domains can be registered. This is the aim of the effective TLD list.
+
+As well as being used to prevent cookies from being set where they shouldn't be, the list can also potentially be used for other applications where the registry controlled and privately controlled parts of a domain name need to be known, for example when grouping by top-level domains.
+
+Source: https://wiki.mozilla.org/Public_Suffix_List
+
+Not convinced yet? Check out a real world example:
+http://stackoverflow.com/questions/288810/get-the-subdomain-from-a-url
+
+
+## Requirements
+
+* Ruby >= 1.8.7
+
+*Public Suffix* >= 0.9.0 requires Ruby 1.8.7 or newer.
+For older versions of Ruby, see the CHANGELOG.md file.
+
+Successfully tested against the following interpreters:
+
+* "Ruby":http://www.ruby-lang.org/ 1.8.x MRI
+* "Ruby":http://www.ruby-lang.org/ 1.9.x MRI
+* "Ruby Enterprise Edition":http://www.rubyenterpriseedition.com/
+* "JRuby":http://jruby.org/
+* "Rubinius":http://rubini.us/
+* "MacRuby":http://www.macruby.org/
+
+
+## Installation
+
+The best way to install *Public Suffix* is via [RubyGems](http://www.rubygems.org).
+
+    $ gem install public_suffix_service
+
+You might need administrator privileges on your system to install the gem.
+
+
+## Basic Usage
+
+Example domain without subdomains.
+
+    domain = PublicSuffix.parse("google.com")
+    # => #<PublicSuffix::Domain>
+    domain.tld
+    # => "com"
+    domain.sld
+    # => "google"
+    domain.trd
+    # => nil
+    domain.domain
+    # => "google.com"
+    domain.subdomain
+    # => nil
+
+Example domain with subdomains.
+
+    domain = PublicSuffix.parse("www.google.com")
+    # => #<PublicSuffix::Domain>
+    domain.tld
+    # => "com"
+    domain.sld
+    # => "google"
+    domain.trd
+    # => "www"
+    domain.domain
+    # => "google.com"
+    domain.subdomain
+    # => "google.com"
+
+Simple validation example.
+
+    PublicSuffix.valid?("google.com")
+    # => true
+
+    PublicSuffix.valid?("www.google.com")
+    # => true
+
+    PublicSuffix.valid?("x.yz")
+    # => false
+
+## Fully Qualified Domain Names
+
+This library automatically recognizes Fully Qualified Domain Names. A FQDN is a domain name that end with a trailing dot.
+
+    # Parse a standard domain name
+    domain = PublicSuffix.parse("www.google.com")
+    # => #<PublicSuffix::Domain>
+    domain.tld
+    # => "com"
+
+    # Parse a fully qualified domain name
+    domain = PublicSuffix.parse("www.google.com.")
+    # => #<PublicSuffix::Domain>
+    domain.tld
+    # => "com"
+
+
+## Credits
+
+* **Author:** [Simone Carletti](http://www.simonecarletti.com/)
+
+
+## FeedBack and Bug reports
+
+If you use this library and find yourself missing any functionality, please [let me know](mailto:weppos@weppos.net).
+
+Pull requests are very welcome! Please include spec and/or feature coverage for every patch, and create a topic branch for every separate change you make.
+
+Report issues or feature requests to [GitHub Issues](https://github.com/weppos/public_suffix_service/issues).
+
+
+## More
+
+* [Homepage](http://www.simonecarletti.com/code/public_suffix_service)
+* [Repository](https://github.com/weppos/public_suffix_service)
+* [API Documentation](http://rubydoc.info/gems/public_suffix_service)
+* [Introducing the Public Suffix List library for Ruby](http://www.simonecarletti.com/blog/2010/06/public-suffix-list-library-for-ruby/)
+
+
+## Changelog
+
+See the CHANGELOG.md file for details.
+
+
+## License
+
+*Public Suffix* is copyright (c) 2009-2011 Simone Carletti.
+This is Free Software distributed under the MIT license.

data/Rakefile

@@ -0,0 +1,109 @@
+require 'rubygems'
+require 'rubygems/package_task'
+require 'bundler'
+require 'rake/testtask'
+
+$:.unshift(File.dirname(__FILE__) + "/lib")
+require 'public_suffix'
+
+
+# Common package properties
+PKG_NAME    = ENV['PKG_NAME']    || PublicSuffix::GEM
+PKG_VERSION = ENV['PKG_VERSION'] || PublicSuffix::VERSION
+RUBYFORGE_PROJECT = nil
+
+
+# Run test by default.
+task :default => :test
+
+
+spec = Gem::Specification.new do |s|
+  s.name              = PKG_NAME
+  s.version           = PKG_VERSION
+  s.summary           = "Domain name parser based in the Public Suffix List."
+  s.description       = "PublicSuffix can parse and decompose a domain name into top level domain, domain and subdomains."
+
+  s.required_ruby_version = ">= 1.8.7"
+
+  s.author            = "Simone Carletti"
+  s.email             = "weppos@weppos.net"
+  s.homepage          = "http://www.simonecarletti.com/code/public_suffix_service"
+
+  # Add any extra files to include in the gem (like your README)
+  s.files             = `git ls-files`.split("\n")
+  s.test_files        = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.require_paths     = %w( lib )
+
+  # If your tests use any gems, include them here
+  s.add_development_dependency("rake")
+  s.add_development_dependency("mocha")
+  s.add_development_dependency("yard")
+end
+
+Gem::PackageTask.new(spec) do |pkg|
+  pkg.gem_spec = spec
+end
+
+desc "Build the gemspec file #{spec.name}.gemspec"
+task :gemspec do
+  file = File.dirname(__FILE__) + "/#{spec.name}.gemspec"
+  File.open(file, "w") {|f| f << spec.to_ruby }
+end
+
+desc "Remove any temporary products, including gemspec"
+task :clean => [:clobber] do
+  rm "#{spec.name}.gemspec" if File.file?("#{spec.name}.gemspec")
+end
+
+desc "Remove any generated file"
+task :clobber => [:clobber_package]
+
+desc "Package the library and generates the gemspec"
+task :package => [:gemspec]
+
+
+# Run all the tests in the /test folder
+Rake::TestTask.new do |t|
+  t.libs << "test"
+  t.test_files = FileList["test/**/*_test.rb"]
+  t.verbose = !!ENV["VERBOSE"]
+  t.warning = !!ENV["WARNING"]
+end
+
+
+require 'yard'
+require 'yard/rake/yardoc_task'
+
+YARD::Rake::YardocTask.new(:yardoc) do |y|
+  y.options = ["--output-dir", "yardoc"]
+end
+
+namespace :yardoc do
+  task :clobber do
+    rm_r "yardoc" rescue nil
+  end
+end
+
+task :clobber => "yardoc:clobber"
+
+
+desc "Open an irb session preloaded with this library"
+task :console do
+  sh "irb -rubygems -I lib -r public_suffix.rb"
+end
+
+
+desc <<-DESC
+  Downloads the Public Suffix List file from the repository \
+  and stores it locally.
+DESC
+task :download_definitions do
+  require "net/http"
+
+  DEFINITION_URL = "http://mxr.mozilla.org/mozilla-central/source/netwerk/dns/effective_tld_names.dat?raw=1"
+
+  File.open("lib/public_suffix/definitions.txt", "w+") do |f|
+    response = Net::HTTP.get_response(URI.parse(DEFINITION_URL))
+    f.write(response.body)
+  end
+end