Project

ryodo

0.01
Repository is archived
No release in over 3 years
Low commit activity in last 3 years
ryodoasaaki/ryodoHomepageDocumentationSource CodeBug Tracker
ryōdo【領土】 りょうど — A domain name parser gem using public suffix list (provided by publicsuffix.org / mozilla)
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Popularity
Downloads
184,452
Stars
20
Forks
2
Watchers
2
 Releases
Current version
0.3.2
Total releases
13
First release
2012-06-02
Latest release
2015-04-19
 Issues
Open Issues
1
Closed Issues
4
Total Issues
5
Issue Closure Rate
80%
 Pull Requests
Open Pull Requests
0
Closed Pull Requests
2
Merged Pull Requests
9
Pull Request Acceptance Rate
81%
 Development
Primary Language
Ruby
Licenses
MIT
Average date of last 50 commits
2020-01-04
Reverse Dependencies
1

 Dependencies

Development

bundler
>= 0
fakeweb
~> 1.3
pry
~> 0.10
pry-doc
~> 0.6
rake
>= 0
rspec
~> 3.2
 Project Readme

ryodo

gem version ci

ryōdo【領土】 りょうど — A domain name parser using public suffix list

Do you ever wanted to know if suspicious.domain.name.blerp is really a valid (registerable) domain?

Do you ever wanted to know what is the actual domain portion of yet.another.awesome.domain.co.jp?

Then you should try ryodo and get the answers!

Notice: This gem does not check DNS records to verify if a name was taken and registered, this is not its purpose. I am a big fan of the UNIX philosophy: »Write programs that do one thing and do it well.«

My blog post about ryodo: ryodo - domain parser (2012-06-02)

Usage

# Gemfile
gem 'ryodo'
require 'ryodo'

dom = Ryodo.parse('my.awesome.domain.co.jp')
#=> Ryodo::Domain

                  #    SUBDOMAIN  DOMAIN   TLD
dom.tld           #=>                   'co.jp'  - public suffix
dom.domain        #=>            'domain.co.jp'  - registered/registrable domain
dom.sld           #=>            'domain'        - registered/registrable domain name w/o TLD
dom.subdomain     #=> 'my.awesome'               - subdomain parts
dom               #=> 'my.awesome.domain.co.jp'  - full domain string
dom.fqdn          #=> 'my.awesome.domain.co.jp.' - full domain + trailing dot

# all parts also reversable
# mostly used on domain/FQDN
dom.reverse            #=> 'jp.co.domain.awesome.my'
dom.fqdn.reverse       #=> '.jp.co.domain.awesome.my'

dom.to_a               #=> ['my','awesome','domain','co','jp']
dom.domain.to_a        #=> ['domain','co','jp']
dom.sld.to_a           #=> ['domain']
dom.subdomain.to_a     #=> ['my','awesome']
dom.fqdn.to_a          #=> ['my','awesome','domain','co','jp','']

# .to_a also usable with parameter :reverse (or shorthand :r)
dom.domain.to_a(:reverse) #=> ['jp','co','domain','awesome','my']
dom.fqdn.to_a(:reverse)   #=> ['','jp','co','domain','awesome','my']
dom.fqdn.to_a(:r)         #=> ['','jp','co','domain','awesome','my']

Quick check (.domain_valid?)

Ryodo.domain_valid?('my.awesome.domain.co.jp') #=> true
Ryodo.domain_valid?('co.jp')                   #=> false

Kernel extension

require 'ryodo/ext/kernel'

Ryodo('my.awesome.domain.co.jp')
#=> returns a Ryodo::Domain

Ryodo?('my.awesome.domain.co.jp')
#=> true

String extension

require 'ryodo/ext/string'

'my.awesome.domain.co.jp'.to_domain
'my.awesome.domain.co.jp'.ryodo

# validation
'my.awesome.domain.co.jp'.valid_domain?

In Gemfile:

gem 'ryodo', require: %w[ryodo ryodo/ext/string]

Extension of URI

Ryodo can transparently hook into URI, so you can use every described method on .host.

require 'ryodo/ext/uri'

uri = URI.parse('http://my.awesome.domain.jp:5555/path')
uri.host
#=> 'my.awesome.domain.jp'

uri.host.class
#=> Ryodo::Domain
# but decorates the String class transparently

uri.host.domain
#=> 'domain.com'

# awesome quick check before doing further stuff with URI
# because why you would do a request to an URI with obviously invalid domain?
uri.host.is_valid?
#=> true

In Gemfile:

gem 'ryodo', require: %w[ryodo ryodo/ext/uri]

License

Licensed under MIT license (LICENSE or http://opensource.org/licenses/MIT)