public_suffix 5.1.0 → 5.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 327877edc15d2e701fe28dde5ebee9822842233c92796337604bf4b27db58c4a
-  data.tar.gz: c209561b2462cdee41e5752592781ee9ac598d314c0cf2743a32e904e6b1243b
+  metadata.gz: f95fd278200cbe3922d07b90ca7b51231509770ff2df64b45f1f0dd0aae532b5
+  data.tar.gz: 8ca654313480fdb64b80d1ac2e54150cc594d731a88dfee4a125c8a32bb6aecc
 SHA512:
-  metadata.gz: 0fc0513322551207e40fb215cf9b23470cf4c543d327ed66f87d0e05975c19eac11565102a80a1ec3bc97faa5dbdfc16d453b8172e994b31b8c8070de15a31a3
-  data.tar.gz: dea7ecb1c8486167400761171c38d521b2b29e36a11ae61180a888159381f725548bef7f1c61101fdf018f8faab5ac1366afb1e1b2627f90143b8d906bb7d906
+  metadata.gz: e7f9ae38d463e8ef8355e033606d5f0a7689976054127f9d5a32b9e0af0bca7f54fa3287678d85def68e73a3fc466fc01d4b39db511386e121ac8bab1fe8c728
+  data.tar.gz: 22bf9f457b5d961de5a8e40de03558bdca814bf565343ed0024be69b71b789b538ca497b856bfa9f294b9cbfcf4c9cf48d9fd7670628f5e0684dc05afa528d1c

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

@@ -2,13 +2,9 @@
 
 This project uses [Semantic Versioning 2.0.0](https://semver.org/).
 
+## 5.1.1
 
-## 5.1.0
-
-### Changed
-
-- Updated definitions.
-- Minimum Ruby version is 3.0
+No significant changes. Releasing a mini version to address 5.1.0 release with major ruby requirement change (GH-315).
 
 
 ## 5.0.5
@@ -17,7 +13,6 @@ This project uses [Semantic Versioning 2.0.0](https://semver.org/).
 
 - Updated definitions.
 
-
 ## 5.0.4
 
 ### Changed
@@ -25,21 +20,18 @@ This project uses [Semantic Versioning 2.0.0](https://semver.org/).
 - Reduced .gem file size (GH-258). [Thanks @ybiquitous]
 - Updated definitions.
 
-
 ## 5.0.3
 
 ### Fixed
 
 - Fixed automated release workflow.
 
-
 ## 5.0.2
 
 ### Changed
 
 - Updated definitions.
 
-
 ## 5.0.1
 
 ### Changed
@@ -52,6 +44,7 @@ This project uses [Semantic Versioning 2.0.0](https://semver.org/).
 ### Changed
 
 - Minimum Ruby version is 2.6
+
 - Updated definitions.
 
 

data/README.md

@@ -16,7 +16,7 @@
 
 ## Requirements
 
-<tt>PublicSuffix</tt> requires **Ruby >= 3.0**. For an older versions of Ruby use a previous release.
+<tt>PublicSuffix</tt> requires **Ruby >= 2.6**. For an older versions of Ruby use a previous release.
 
 
 ## Installation
@@ -33,6 +33,8 @@ Or use Bundler and define it as a dependency in your `Gemfile`:
 gem 'public_suffix'
 ```
 
+If you are upgrading to 2.0, see [2.0-Upgrade.md](2.0-Upgrade.md).
+
 ## Usage
 
 Extract the domain out from a name:

data/SECURITY.md

@@ -4,7 +4,8 @@
 
 Security updates are provided only for the current minor version.
 
-If you are using a previous minor version, we recommend to upgrade to the current minor version. This project uses [semantic versioning](https://semver.org/), therefore you can upgrade to a more recent minor version without incurring into breaking changes.
+If you are using a previous minor version, we recommend to upgrade to the current minor version.
+This project uses [semantic versioning](https://semver.org/), therefore you can upgrade to a more recent minor version without incurring into breaking changes.
 
 Exceptionally, we may support previous minor versions upon request if there are significant reasons preventing to immediately switch the latest minor version.