public_suffix 3.1.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: c55510fd81cb1ec900d6aaa3728880850148b57f81621ce5a0c1e93f3811a163
+  data.tar.gz: 9f76520d1a8a28ef3ffeda93ebaac0368113c02208093a57621443195629ef98
+SHA512:
+  metadata.gz: 41bafee63060875aa1456f916947e50cd12ff5895dedfc781a444edb86db4d3e1877f20a6b5baae6277838b48ae3a40e6e634f0c71566fc5cf1673ca401cdb0c
+  data.tar.gz: 6e7e87dbdc0fcc12606e5696965e0e0cc50310721a03aaca88e90170cbd6876f510cea3b79f22c574de8efe626220d621be79f4da5ae4b3bf8a43c27fc56cc6f

data/.gitignore

@@ -0,0 +1,11 @@
+# Bundler
+.bundle
+Gemfile.lock
+pkg/*
+
+# Rubinius
+*.rbc
+
+# YARD
+.yardoc
+yardoc/

data/.rubocop.yml

@@ -0,0 +1,36 @@
+inherit_from:
+  - .rubocop_defaults.yml
+
+AllCops:
+  Exclude:
+    # Exclude .gemspec files because they are generally auto-generated
+    - '*.gemspec'
+    # Exclude vendored folders
+    - 'tmp/**/*'
+    - 'vendor/**/*'
+    # Exclude artifacts
+    - 'pkg/**/*'
+    # Other
+    - 'test/benchmarks/**/*'
+    - 'test/profilers/**/*'
+
+# I often use @_variable to avoid clashing.
+Naming/MemoizedInstanceVariableName:
+  Enabled: false
+
+Style/ClassAndModuleChildren:
+  Exclude:
+    - 'spec/**/*_spec.rb'
+    - 'test/**/*_test.rb'
+
+# Dear Rubocop, I don't want to use String#strip_heredoc
+Layout/IndentHeredoc:
+  Enabled: false
+
+Style/WordArray:
+  Enabled: false
+  MinSize: 3
+
+Style/SymbolArray:
+  Enabled: false
+  MinSize: 3

data/.rubocop_defaults.yml

@@ -0,0 +1,179 @@
+AllCops:
+  Exclude:
+    # Exclude .gemspec files because they are generally auto-generated
+    - '*.gemspec'
+    # Exclude vendored folders
+    - 'tmp/**/*'
+    - 'vendor/**/*'
+
+# [codesmell]
+Metrics/AbcSize:
+  Enabled: false
+  Exclude:
+    - 'spec/**/*_spec.rb'
+    - 'test/**/*_test.rb'
+
+# [codesmell]
+Metrics/BlockLength:
+  Enabled: false
+
+# [codesmell]
+Metrics/CyclomaticComplexity:
+  Enabled: false
+  Exclude:
+    - 'spec/**/*_spec.rb'
+    - 'test/**/*_test.rb'
+
+# [codesmell]
+Metrics/ClassLength:
+  Enabled: false
+  Exclude:
+    - 'spec/**/*_spec.rb'
+    - 'test/**/*_test.rb'
+
+# [codesmell]
+Metrics/LineLength:
+  Enabled: false
+  Exclude:
+    - 'spec/**/*_spec.rb'
+    - 'test/**/*_test.rb'
+  Max: 100
+
+# [codesmell]
+Metrics/MethodLength:
+  Enabled: false
+  Exclude:
+    - 'spec/**/*_spec.rb'
+    - 'test/**/*_test.rb'
+  Max: 10
+
+# [codesmell]
+Metrics/ModuleLength:
+  Enabled: false
+  Exclude:
+    - 'spec/**/*_spec.rb'
+    - 'test/**/*_test.rb'
+
+# [codesmell]
+Metrics/ParameterLists:
+  Enabled: false
+  Max: 5
+
+# [codesmell]
+Metrics/PerceivedComplexity:
+  Enabled: false
+
+# Do not use "and" or "or" in conditionals, but for readability we can use it
+# to chain executions. Just beware of operator order.
+Style/AndOr:
+  EnforcedStyle: conditionals
+
+Style/Documentation:
+  Exclude:
+    - 'spec/**/*'
+    - 'test/**/*'
+
+# Double empty lines are useful to separate conceptually different methods
+# in the same class or module.
+Layout/EmptyLines:
+  Enabled: false
+
+# In most cases, a space is nice. Sometimes, it's not.
+# Just be consistent with the rest of the surrounding code.
+Layout/EmptyLinesAroundClassBody:
+  Enabled: false
+
+# In most cases, a space is nice. Sometimes, it's not.
+# Just be consistent with the rest of the surrounding code.
+Layout/EmptyLinesAroundModuleBody:
+  Enabled: false
+
+# This is quite buggy, as it doesn't recognize double lines.
+# Double empty lines are useful to separate conceptually different methods
+# in the same class or module.
+Layout/EmptyLineBetweenDefs:
+  Enabled: false
+
+# I personally don't care about the format style.
+# In most cases I like to use %, but not at the point I want to enforce it
+# as a convention in the entire code.
+Style/FormatString:
+  Enabled: false
+
+# Annotated tokens (like %<foo>s) are a good thing, but in most cases we don't need them.
+# %s is a simpler and straightforward version that works in almost all cases. So don't complain.
+Style/FormatStringToken:
+  Enabled: false
+
+# Prefer the latest Hash syntax
+Style/HashSyntax:
+  Exclude:
+    # But Rakefiles generally have some definition like
+    #   :default => :test
+    # that looks nicer with the old rocket syntax.
+    - 'Rakefile'
+
+Style/RescueStandardError:
+  Enabled: false
+
+# Array indentation should be considered like MultilineMethodCallIndentation indentation
+# and use 4 spaces instead of 2.
+Layout/IndentFirstArrayElement:
+  IndentationWidth: 4
+
+# Hash indentation should be considered like MultilineMethodCallIndentation indentation
+# and use 4 spaces instead of 2.
+Layout/IndentFirstHashElement:
+  IndentationWidth: 4
+
+# Multi-line differs from standard indentation, they are indented twice.
+Layout/MultilineMethodCallIndentation:
+  EnforcedStyle: indented
+  IndentationWidth: 4
+
+# unless is not always cool.
+Style/NegatedIf:
+  Enabled: false
+
+# For years, %w() has been the de-facto standard. A lot of libraries are using ().
+# Switching to [] would be a nightmare.
+Style/PercentLiteralDelimiters:
+  Enabled: false
+
+# There are cases were the inline rescue is ok. We can either downgrade the severity,
+# or rely on the developer judgement on a case-by-case basis.
+Style/RescueModifier:
+  Enabled: false
+
+# Sorry, but using trailing spaces helps readability.
+#
+#   %w( foo bar )
+#
+# looks better to me than
+#
+#   %w( foo bar )
+#
+Layout/SpaceInsidePercentLiteralDelimiters:
+  Enabled: false
+
+# Hate It or Love It, I prefer double quotes as this is more consistent
+# with several other programming languages and the output of puts and inspect.
+Style/StringLiterals:
+  EnforcedStyle: double_quotes
+
+# It's nice to be consistent. The trailing comma also allows easy reordering,
+# and doesn't cause a diff in Git when you add a line to the bottom.
+Style/TrailingCommaInArrayLiteral:
+  EnforcedStyleForMultiline: consistent_comma
+Style/TrailingCommaInHashLiteral:
+  EnforcedStyleForMultiline: consistent_comma
+
+Style/TrivialAccessors:
+  # IgnoreClassMethods because I want to be able to define class-level accessors
+  # that sets an instance variable on the metaclass, such as:
+  #
+  #    def self.default=(value)
+  #      @default = value
+  #    end
+  #
+  IgnoreClassMethods: true

data/.ruby-gemset

@@ -0,0 +1 @@
+-global

data/.travis.yml

@@ -0,0 +1,31 @@
+language: ruby
+
+rvm:
+  - 2.3
+  - 2.4
+  - 2.5
+  - 2.6
+  - jruby-9.1.5.0
+  - ruby-head
+
+env:
+  - COVERAGE=1
+
+cache:
+  - bundler
+
+matrix:
+  include:
+    - rvm: 2.1
+      before_install:
+        - gem install bundler -v '< 2.0'
+    - rvm: 2.2
+      before_install:
+        - gem install bundler -v '< 2.0'
+  allow_failures:
+    - rvm: ruby-head
+    - rvm: jruby-9.1.5.0
+
+before_install:
+  - gem update --system
+  - gem install bundler

data/.yardopts

@@ -0,0 +1 @@
+--title 'Ruby Public Suffix API Documentation'

data/2.0-Upgrade.md

@@ -0,0 +1,52 @@
+# Welcome to PublicSuffix 2.0!
+
+PublicSuffix 2.0 contains a rewritten internal representation and comparison logic, that drastically increases the lookup performance. The new version also changes several internal and external API.
+
+This document documents the most relevant changes to help you upgrading from PublicSuffix 1.0 to 2.0.
+
+## What's New
+
+- The library is now 100% compliants with the official PublicSuffix tests. The major breaking change you may experience, is that if a domain passed as input doesn't match any rule, the rule `*` is assumed. You can override this behavior by passing a custom default rule with the `default_rule` option. The old behavior can be restored by passing `default_rule: nil`.
+- `PublicSuffix.domain` is a new method that parses the input and returns the domain (combination of second level domain + suffix). This is a convenient helper to parse a domain name, for example when you need to determine the cookie or SSL scope.
+- Added the ability to disable the use of private domains either at runtime, in addition to the ability to not load the private domains section when reading the list (`private_domains: false`). This feature also superseded the `private_domains` class-level attribute, that is no longer available.
+
+## Upgrade
+
+When upgrading, here's the most relevant changes to keep an eye on:
+
+- Several futile utility helpers were removed, such as `Domain#rule`, `Domain#is_a_domain?`, `Domain#is_a_subdomain?`, `Domain#valid?`. You can easily obtain the same result by having a custom method that reconstructs the logic, and/or calling `PublicSuffix.{domain|parse}(domain.to_s)`.
+- `PublicSuffix::List.private_domains` is no longer available. Instead, you now have two ways to enable/disable the private domains:
+
+    1. At runtime, by using the `ignore_private` option
+
+    ```ruby
+    PublicSuffix.domain("something.blogspot.com", ignore_private: true)
+    ```
+
+    1. Loading a filtered list:
+
+    ```ruby
+    # Disable support for private TLDs
+    PublicSuffix::List.default = PublicSuffix::List.parse(File.read(PublicSuffix::List::DEFAULT_LIST_PATH), private_domains: false)
+    # => "blogspot.com"
+    PublicSuffix.domain("something.blogspot.com")
+    # => "blogspot.com"
+    ```
+- Now that the library is 100% compliant with the official PublicSuffix algorithm, if a domain passed as input doesn't match any rule, the wildcard rule `*` is assumed. This means that unlisted TLDs will be considered valid by default, when they would have been invalid in 1.x. However, you can override this behavior to emulate the 1.x behavior if needed:
+
+    ```ruby
+    # 1.x:
+
+    PublicSuffix.valid?("google.commm")
+    # => false
+
+    # 2.x:
+
+    PublicSuffix.valid?("google.commm")
+    # => true
+
+    # Overriding 2.x behavior if needed:
+
+    PublicSuffix.valid?("google.commm", default_rule: nil)
+    # => false
+    ````

data/CHANGELOG.md

@@ -0,0 +1,353 @@
+# Changelog
+
+
+#### Release 3.1.1
+
+- CHANGED: Updated definitions.
+- CHANGED: Rolled back support for Ruby 2.3 (GH-161, GH-162)
+
+
+#### Release 3.1.0
+
+- CHANGED: Updated definitions.
+- CHANGED: Minimum Ruby version is 2.3
+- CHANGED: Upgraded to Bundler 2.x
+
+
+#### Release 3.0.3
+
+- CHANGED: Updated definitions.
+
+
+#### Release 3.0.2
+
+- CHANGED: Updated definitions.
+
+
+#### Release 3.0.1
+
+- CHANGED: Updated definitions.
+- CHANGED: Improve performance and avoid allocation (GH-146). [Thanks @robholland]
+
+
+#### Release 3.0.0
+
+This new version includes a major redesign of the library internals, with the goal to drastically
+improve the lookup time while reducing storage space.
+
+For this reason, several public methods that are no longer applicable have been deprecated
+and/or removed. You can find more information at GH-133.
+
+- CHANGED: Updated definitions.
+- CHANGED: Dropped support for Ruby < 2.1
+- CHANGED: `PublicSuffix::List#rules` is now protected. You should not rely on it as the internal rule representation is subject to change to optimize performances.
+- CHANGED: Removed `PublicSuffix::List.clear`, it was an unnecessary accessor method. Use `PublicSuffix::List.default = nil` if you **really** need to reset the default list. You shouldn't.
+- CHANGED: `PublicSuffix::List#select` is now private. You should not use it, instead use `PublicSuffix::List#find`.
+- CHANGED: `PublicSuffix::List` no longer implements Enumerable. Instead, use `#each` to loop over, or get an Enumerator.
+- CHANGED: Redesigned internal list storage and lookup algorithm to achieve O(1) lookup time (see GH-133).
+
+
+#### Release 2.0.5
+
+- CHANGED: Updated definitions.
+- CHANGED: Initialization performance improvements (GH-128). [Thanks @casperisfine]
+
+
+#### Release 2.0.4
+
+- FIXED: Fix a bug that caused the GEM to be published with the wrong version number in the gemspec (GH-121).
+
+- CHANGED: Updated definitions.
+
+
+#### Release 2.0.3
+
+- CHANGED: Updated definitions.
+
+
+#### Release 2.0.2
+
+- CHANGED: Updated definitions.
+
+
+#### Release 2.0.1
+
+- FIXED: Fix bug that prevented .valid? to reset the default rule
+
+
+#### Release 2.0.0
+
+- NEW: Added PublicSuffix.domain # => sld.tld
+- NEW: Added the ability to disable the use of private domains either at runtime, in addition to the ability to not load the private domains section when reading the list (`private_domains: false`). This feature also superseded the `private_domains` class-level attribute, that is no longer available.
+
+- CHANGED: Considerable performance improvements (GH-92)
+- CHANGED: Updated definitions.
+- CHANGED: Removed deprecated PublicSuffix::InvalidDomain exception
+- CHANGED: If the suffix is now listed, then the prevaling rule is "*" as defined by the PSL algorithm (GH-91)
+- CHANGED: Input validation is performed only if you call `PublicSuffix.parse` or `PublicSuffix.list`
+- CHANGED: Input with leading dot is invalid per PSL acceptance tests
+- CHANGED: Removed `private_domains` class-level attribute. It is replaced by the `private_domains: false` option in the list parse method.
+- CHANGED: The default list now assumes you use UTF-8 for reading the input (GH-94),
+
+- REMOVED: Removed futile utility helpers such as `Domain#rule`, `Domain#is_a_domain?`, `Domain#is_a_subdomain?`, `Domain#valid?`. You can easily obtain the same result by having a custom method that reconstructs the logic, and/or calling `PublicSuffix.{domain|parse}(domain.to_s)`.
+
+
+#### Release 1.5.3
+
+- FIXED: Don't duplicate rule indices when creating index (GH-77). [Thanks @ags]
+
+- CHANGED: Updated definitions.
+
+
+#### Release 1.5.2
+
+- CHANGED: Updated definitions.
+
+
+#### Release 1.5.1
+
+- FIXED: Ignore case for parsing and validating (GH-62)
+
+- CHANGED: Updated definitions.
+
+
+#### Release 1.5.0
+
+- CHANGED: Dropped support for Ruby < 2.0
+
+- CHANGED: Updated definitions.
+
+
+#### Release 1.4.6
+
+- CHANGED: Updated definitions.
+
+
+#### Release 1.4.5
+
+- CHANGED: Updated definitions.
+
+
+#### Release 1.4.4
+
+- CHANGED: Updated definitions.
+
+
+#### Release 1.4.3
+
+- CHANGED: Updated definitions.
+
+
+#### Release 1.4.2
+
+- CHANGED: Updated definitions.
+
+
+#### Release 1.4.1
+
+- CHANGED: Updated definitions.
+
+
+#### Release 1.4.0
+
+- CHANGED: Moved the definitions in the lib folder.
+
+- CHANGED: Updated definitions.
+
+
+#### Release 1.3.3
+
+- CHANGED: Updated definitions.
+
+
+#### Release 1.3.2
+
+- CHANGED: Updated definitions.
+
+
+#### Release 1.3.1
+
+- CHANGED: Updated definitions.
+
+
+#### Release 1.3.0
+
+- NEW: Ability to skip Private Domains (GH-28). [Thanks @rb2k]
+
+- CHANGED: Updated definitions.
+
+
+#### Release 1.2.1
+
+- CHANGED: Updated definitions.
+
+
+#### Release 1.2.0
+
+- NEW: Allow a custom List on `PublicSuffix.parse` (GH-26). [Thanks @itspriddle]
+
+- FIXED: PublicSuffix.parse and PublicSuffix.valid? crashes when input is nil (GH-20).
+
+- CHANGED: Updated definitions.
+
+
+#### Release 1.1.3
+
+- CHANGED: Updated definitions.
+
+
+#### Release 1.1.2
+
+- CHANGED: Updated definitions.
+
+
+#### Release 1.1.1
+
+- CHANGED: Updated definitions.
+
+
+#### Release 1.1.0
+
+- FIXED: #valid? and #parse consider URIs as valid domains (GH-15)
+
+- CHANGED: Updated definitions.
+
+- CHANGED: Removed deprecatd PublicSuffixService::RuleList.
+
+
+#### Release 1.0.0
+
+- CHANGED: Updated definitions.
+
+
+#### 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