lazy_domain 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 22211abf594c3ca41c920dedf2556c9c8181fb06
+  data.tar.gz: 2bb691ae29b03dfb5c262c235f23c663c65b65c4
+SHA512:
+  metadata.gz: ff14b0436b383ca2266a878246e9b9ba43efe424b2e5a165ac0bd4c462436564254cc7f2c0a253c2056a1e87e80fc4986020ee7edfa52b61f4517fd157f1bf33
+  data.tar.gz: 2212be8528f9e956ee427e393a00c8307d73baf3f4a52a3dc98c0359b548ac26bc586b5d0dff6af7a78f4bb913a487f7d70c963e4b3bd7590262f0cd13778d42

data/LICENSE.md

@@ -0,0 +1,19 @@
+The MIT License (MIT)
+Copyright (c) 2015 John Mason
+
+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,101 @@
+# LazyDomain
+
+Parse varying urls with [PublicSuffix](https://github.com/weppos/publicsuffix-ruby) the easy way.
+
+## Description
+
+The PublicSuffix gem works great if you give it nice, clean urls WITHOUT a transfer protocol.  But what if your application has one (or multiple) urls with or without protocols? 
+
+LazyDomain assumes it could be either way and uses URI to make up the difference. Because URI can only parse a url WITH a protocol, Lazy Domain automatically adds 'http://' if it is not already present in a url. Now, you can easily use PublicSuffix for varying urls.
+
+## Installation
+
+```
+gem install lazy_domain
+
+```
+
+## Usage
+
+Because LazyDomain is simply a wrapper for [PublicSuffix](https://github.com/weppos/publicsuffix-ruby), the usage is exactly the same.
+
+## Basic Usage
+
+Example domain without subdomains.
+
+```ruby
+	domain = LazyDomain.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.
+
+```ruby
+	domain = LazyDomain.parse("www.google.com")
+	# => #<PublicSuffix::Domain>
+	domain.tld
+	# => "com"
+	domain.sld
+	# => "google"
+	domain.trd
+	# => "www"
+	domain.domain
+	# => "google.com"
+	domain.subdomain
+	# => "www.google.com"
+```
+
+Simple validation example.
+
+```ruby
+	LazyDomain.valid?("google.com")
+	# => true
+
+	LazyDomain.valid?("www.google.com")
+	# => true
+
+	LazyDomain.valid?("x.yz")
+	# => false
+```
+
+## Advanced Usage
+
+You can do everything mentioned above, but the magic of LazyDomain is you can now pass different types of urls!
+
+For example, all of this...
+
+```ruby
+	domain = LazyDomain.parse("google.com")
+
+	domain = LazyDomain.parse("http://google.com")
+
+	domain = LazyDomain.parse("ftp://google.com")	
+
+	domain = LazyDomain.parse("somethingcrazy://google.com")
+
+	domain = LazyDomain.parse("http://abc.defg.hijk.google.com")
+
+	domain = LazyDomain.parse("http://abc.defg.hijk.google.com/asubdirectory/andanother")
+
+```
+
+...returns something like this.
+
+```ruby
+
+=> #<PublicSuffix::Domain:0x0055c2344f0168 @sld="google", @tld="com", @trd="abc.defg.hijk">
+
+
+```
+
+Enjoy!

data/Rakefile

@@ -0,0 +1,7 @@
+require 'rubygems'
+require 'rake'
+
+desc 'Open console with lazy_domain loaded'
+task :console do
+  exec 'pry -r ./lib/lazy_domain.rb'
+end

data/lib/lazy_domain/version.rb

@@ -0,0 +1,3 @@
+module LazyDomain
+  VERSION = '0.0.1'
+end

data/lib/lazy_domain.rb

@@ -0,0 +1,75 @@
+require 'uri'
+require 'public_suffix'
+
+# Add http:// if a protocol isn't already there.
+module AutoHTTP
+  # Looks for any character before '://'
+  TP_REGEX = %r{[\w]+(\b:\/\/)}
+
+  # Returns true if there is any character before '://'' in a url.
+  # ie. 'something://google.com' or 'xyz://google.com'
+  #
+  # Returns false if somehting like '://google.com' or 'google.com'.
+  def hastp(str)
+    !(str =~ TP_REGEX).nil?
+  end
+
+  # Add 'http://' if something is not already present.
+  def autohttp(str)
+    str.prepend('http://') unless hastp(str)
+    str
+  end
+end
+
+# Make parsing PublicSuffix domains easier.
+module LazyDomain
+  class << self
+    include AutoHTTP
+
+    # Because URI cannot parse anything without a transfer protocol,
+    # this automagically adds one if not present.
+    #
+    # This method always PublicSuffix to parse varying urls that may or
+    # may not have a protocol.
+    def uri_host(str)
+      URI.parse(autohttp(str)).host
+    end
+
+    # All PublicSuffix methods are available.
+    # PublicSuffix reference is here: http://bit.ly/1WTiwGR
+    # -----------------------------------------------------------
+
+    # Example:
+    # domain = LazyDomain.parse(google.com)
+    #
+    # domain.tld
+    # => 'com'
+    #
+    # domain.sld
+    # => 'google'
+    #
+    # domain.trd
+    # => nil
+    #
+    # domain.domain
+    # => 'google.com'
+    #
+    # domain.subdomain # => nil
+    def parse(str)
+      PublicSuffix.parse(uri_host(str))
+    end
+
+    # Example:
+    # LazyDomain.valid?("google.com")
+    # => true
+    #
+    # LazyDomain.valid?("www.google.com")
+    # => true
+
+    # LazyDomain.valid?("x.yz")
+    # => false
+    def valid?(str)
+      PublicSuffix.valid?(uri_host(str))
+    end
+  end
+end

metadata

@@ -0,0 +1,109 @@
+--- !ruby/object:Gem::Specification
+name: lazy_domain
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- John Mason
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-10-10 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: public_suffix
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.5'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.5'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.3'
+- !ruby/object:Gem::Dependency
+  name: pry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.3'
+description: The PublicSuffix gem works great if you give it nice, clean domains WITHOUT
+  a transfer protocol.  But what if your application has one (or multiple) urls with
+  or without protocols? LazyDomain assumes it could be either way and uses URI to
+  make up the difference. Because URI can only parse a url WITH a protocol, Lazy Domain
+  automatically adds 'http://' if it is not already present in a url. Now you can
+  easily use PublicSuffix for varying urls.
+email: mace2345@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE.md
+- README.md
+- Rakefile
+- lib/lazy_domain.rb
+- lib/lazy_domain/version.rb
+homepage: http://github.com/m8ss/lazy_domain
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.4.5
+signing_key: 
+specification_version: 4
+summary: Parse multiple URIs with PublicSuffix the easy way.
+test_files: []