Donas

Easily find DNS details for a domain or subdomain: Name servers, MX records, IP resolution.

Installation

With Bundler:

gem 'donas'

Without Bundler:

gem install donas

Usage

Command Line

If you want to use the command line tool:

$ donas ombushop.com
Domain: ombushop.com
IP: 50.16.228.254

Name servers:
ns-1222.awsdns-24.org
ns-2028.awsdns-61.co.uk
ns-38.awsdns-04.com
ns-779.awsdns-33.net

MX records:
1 aspmx.l.google.com
10 aspmx2.googlemail.com
10 aspmx3.googlemail.com
5 alt1.aspmx.l.google.com
5 alt2.aspmx.l.google.com

If you want to use it in your application:

DNS Records

This will return A, TXT, NS and CNAME records.

> Donas.get_record "ombulabs.com"
=> #<Resolv::DNS::Resource::IN::A:0x007f831d16c220 @address=#<Resolv::IPv4 50.16.228.254>, @ttl=59>
> Donas.get_record "shop.ombulabs.com"
=> #<Resolv::DNS::Resource::IN::CNAME:0x007f831d3174a8 @name=#<Resolv::DNS::Name: tiendaombulabs.ombushop.com.>, @ttl=21277>
> Donas.get_records "ombushop.com"
 => [#<Resolv::DNS::Resource::IN::A:0x007f831d81ff18 @address=#<Resolv::IPv4 50.16.228.254>, @ttl=3599>, #<Resolv::DNS::Resource::IN::NS:0x007f831d81f540 @name=#<Resolv::DNS::Name: ns-1222.awsdns-24.org.>, @ttl=21599>, #<Resolv::DNS::Resource::IN::NS:0x007f831d81eaa0 @name=#<Resolv::DNS::Name: ns-2028.awsdns-61.co.uk.>, @ttl=21599>, #<Resolv::DNS::Resource::IN::NS:0x007f831d81df88 @name=#<Resolv::DNS::Name: ns-38.awsdns-04.com.>, @ttl=21599>, #<Resolv::DNS::Resource::IN::NS:0x007f831d81d5b0 @name=#<Resolv::DNS::Name: ns-779.awsdns-33.net.>, @ttl=21599>, #<Resolv::DNS::Resource::IN::SOA:0x007f831d81c390 @mname=#<Resolv::DNS::Name: ns-1222.awsdns-24.org.>, @rname=#<Resolv::DNS::Name: awsdns-hostmaster.amazon.com.>, @serial=1, @refresh=7200, @retry=900, @expire=1209600, @minimum=86400, @ttl=899>, #<Resolv::DNS::Resource::IN::MX:0x007f831d827f38 @preference=1, @exchange=#<Resolv::DNS::Name: aspmx.l.google.com.>, @ttl=299>, #<Resolv::DNS::Resource::IN::MX:0x007f831d827308 @preference=10, @exchange=#<Resolv::DNS::Name: aspmx2.googlemail.com.>, @ttl=299>, #<Resolv::DNS::Resource::IN::MX:0x007f831d826598 @preference=10, @exchange=#<Resolv::DNS::Name: aspmx3.googlemail.com.>, @ttl=299>, #<Resolv::DNS::Resource::IN::MX:0x007f831d825698 @preference=5, @exchange=#<Resolv::DNS::Name: alt1.aspmx.l.google.com.>, @ttl=299>, #<Resolv::DNS::Resource::IN::MX:0x007f831d824798 @preference=5, @exchange=#<Resolv::DNS::Name: alt2.aspmx.l.google.com.>, @ttl=299>, #<Resolv::DNS::Resource::IN::TXT:0x007f831d824018 @strings=["v=spf1 include:_spf.google.com ~all"], @ttl=3599>, #<Resolv::DNS::Resource::IN::TXT:0x007f831d0f5a58 @strings=["v=spf1 include:sendgrid.net ~all"], @ttl=3599>, #<Resolv::DNS::Resource::Generic::Type99_Class1:0x007f831d82f9b8 @data="#v=spf1 include:_spf.google.com ~all", @ttl=3599>]

IP Addresses

This will return an IP address, even if the initial record is a CNAME.

> Donas.get_address "shop.ombulabs.com"
=> #<Resolv::IPv4 50.16.228.254>

MX Records

This will return the MX records for a domain.

> Donas.mx_records "ombulabs.com"
=> [#<Resolv::DNS::Resource::IN::MX:0x007f831c35eb60 @preference=1, @exchange=#<Resolv::DNS::Name: aspmx.l.google.com.>, @ttl=3599>, #<Resolv::DNS::Resource::IN::MX:0x007f831c35dc60 @preference=10, @exchange=#<Resolv::DNS::Name: alt3.aspmx.l.google.com.>, @ttl=3599>, #<Resolv::DNS::Resource::IN::MX:0x007f831c35cd60 @preference=10, @exchange=#<Resolv::DNS::Name: alt4.aspmx.l.google.com.>, @ttl=3599>, #<Resolv::DNS::Resource::IN::MX:0x007f831d114f70 @preference=5, @exchange=#<Resolv::DNS::Name: alt1.aspmx.l.google.com.>, @ttl=3599>, #<Resolv::DNS::Resource::IN::MX:0x007f831c3670f8 @preference=5, @exchange=#<Resolv::DNS::Name: alt2.aspmx.l.google.com.>, @ttl=3599>]

Name Servers

This will return the name servers for the main domain (even if you provide a subdomain)

> Donas.nameservers "ombulabs.com"
=> [#<Resolv::DNS::Resource::IN::NS:0x007f831d32e7c0 @name=#<Resolv::DNS::Name: ns-1052.awsdns-03.org.>, @ttl=21599>, #<Resolv::DNS::Resource::IN::NS:0x007f831d32dd20 @name=#<Resolv::DNS::Name: ns-1839.awsdns-37.co.uk.>, @ttl=21599>, #<Resolv::DNS::Resource::IN::NS:0x007f831d32d208 @name=#<Resolv::DNS::Name: ns-469.awsdns-58.com.>, @ttl=21599>, #<Resolv::DNS::Resource::IN::NS:0x007f831d32c830 @name=#<Resolv::DNS::Name: ns-665.awsdns-19.net.>, @ttl=21599>]

Summary of a Domain

This will return MX and name records.

> Donas.summary "ombulabs.com"
=> {:nameservers=>[#<Resolv::DNS::Resource::IN::NS:0x007f831c3779d0 @name=#<Resolv::DNS::Name: ns-1052.awsdns-03.org.>, @ttl=21599>, #<Resolv::DNS::Resource::IN::NS:0x007f831c376f30 @name=#<Resolv::DNS::Name: ns-1839.awsdns-37.co.uk.>, @ttl=21599>, #<Resolv::DNS::Resource::IN::NS:0x007f831c376418 @name=#<Resolv::DNS::Name: ns-469.awsdns-58.com.>, @ttl=21599>, #<Resolv::DNS::Resource::IN::NS:0x007f831c375a40 @name=#<Resolv::DNS::Name: ns-665.awsdns-19.net.>, @ttl=21599>], :mx_records=>[#<Resolv::DNS::Resource::IN::MX:0x007f831c37d1c8 @preference=1, @exchange=#<Resolv::DNS::Name: aspmx.l.google.com.>, @ttl=3599>, #<Resolv::DNS::Resource::IN::MX:0x007f831c37c2c8 @preference=10, @exchange=#<Resolv::DNS::Name: alt3.aspmx.l.google.com.>, @ttl=3599>, #<Resolv::DNS::Resource::IN::MX:0x007f831c387678 @preference=10, @exchange=#<Resolv::DNS::Name: alt4.aspmx.l.google.com.>, @ttl=3599>, #<Resolv::DNS::Resource::IN::MX:0x007f831c386778 @preference=5, @exchange=#<Resolv::DNS::Name: alt1.aspmx.l.google.com.>, @ttl=3599>, #<Resolv::DNS::Resource::IN::MX:0x007f831c385878 @preference=5, @exchange=#<Resolv::DNS::Name: alt2.aspmx.l.google.com.>, @ttl=3599>]}

Development

After checking out the repo, run bin/setup to install dependencies.

Then, run rake to run the tests.

You can also run bin/console for an interactive prompt that will allow you to experiment.

To install this gem onto your local machine, run bundle exec rake install. To release a new version, update the version number in version.rb, and then run bundle exec rake release, which will create a git tag for the version, push git commits and tags, and push the .gem file to rubygems.org.

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/ombulabs/donas. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the Contributor Covenant code of conduct.

License

The gem is available as open source under the terms of the MIT License.