domain_info 0.0.1

data/.gitignore

@@ -0,0 +1,5 @@
+*.gem
+.bundle
+Gemfile.lock
+pkg/*
+.rvmrc

data/.travis.yml

@@ -0,0 +1,3 @@
+rvm:
+  - 1.8.7
+  - 1.9.2

data/Gemfile

@@ -0,0 +1,8 @@
+source "http://rubygems.org"
+
+group :test do
+  gem "rake", "~> 0.9.2.2"
+end
+
+# Specify your gem's dependencies in domain_info.gemspec
+gemspec

data/README.md

@@ -0,0 +1,34 @@
+## Domain info
+
+[![Build Status](https://secure.travis-ci.org/iafonov/domain_info.png)](http://travis-ci.org/iafonov/domain_info)
+
+Basic domain configuration wrapper & verifier. Allows one to verify whether domain is configured correctly for sending emails under its name. Built on top of ruby's built-in [`Resolv`](http://ruby-doc.org/stdlib-1.9.2/libdoc/resolv/rdoc/Resolv.html).
+
+```ruby
+domain = DomainInfo::Domain.new("github.com")
+
+# IP
+domain.ip                     # => "207.97.227.239"
+
+# PTR record validation
+domain.ptr.value              # => "github.com"
+domain.ptr.present?           # => true
+domain.ptr.valid?             # => true, domain's ip resolves to itself
+
+# Extracting SPF record
+domain.spf.value              # => v=spf1 a mx include:spf.mtasv.net...
+domain.spf.present?           # => true
+
+# Extracting DKIM public key
+domain.dkim("_key").value     # => v=DKIM1...
+domain.dkim("_key").present?  # => true
+
+# Extracting DKIM record with defaut name usually generated by dkim-filter
+domain.default_dkim.value     # => v=DKIM1...
+```
+
+All values are lazy evaluated and cached on instance level after the first call so subsequent calls will not issue network requests. 
+
+For more advanced things I recommend to go with [dnsruby](http://rubyforge.org/projects/dnsruby).
+
+[Igor Afonov](http://iafonov.github.com) 2012 MIT License

data/Rakefile

@@ -0,0 +1,5 @@
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+task :default => [:spec]

data/domain_info.gemspec

@@ -0,0 +1,22 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "domain_info/version"
+
+Gem::Specification.new do |s|
+  s.name        = "domain_info"
+  s.version     = DomainInfo::VERSION
+  s.authors     = ["Igor Afonov"]
+  s.email       = ["afonov@gmail.com"]
+  s.homepage    = ""
+  s.summary     = %q{Wraps access to basic domain DNS records}
+  s.description = %q{Wraps access to basic domain DNS records needed to verify domain configuration}
+
+  s.rubyforge_project = "domain_info"
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+
+  s.add_development_dependency "rspec"
+end

data/lib/domain_info.rb

@@ -0,0 +1,10 @@
+require "domain_info/version"
+require 'resolv'
+
+module DomainInfo
+  require 'domain_info/record'
+  require 'domain_info/ptr'
+  require 'domain_info/spf'
+  require 'domain_info/dkim'
+  require 'domain_info/domain'
+end

data/lib/domain_info/dkim.rb

@@ -0,0 +1,16 @@
+require 'domain_info/util/dns_records'
+
+class DomainInfo::DKIM < DomainInfo::Record
+  def initialize(domain, txt_name)
+    @dkim = extract_dkim(domain, txt_name)
+  end
+
+  def value
+    @dkim
+  end
+
+private
+  def extract_dkim(domain, txt_name)
+    DomainInfo::DNSRecords.new("#{txt_name}.#{domain}").detect{|txt_record| txt_record.start_with?("v=DKIM")}
+  end
+end

data/lib/domain_info/domain.rb

@@ -0,0 +1,27 @@
+class DomainInfo::Domain
+  attr_accessor :domain
+
+  def initialize(domain)
+    @domain = domain
+  end
+
+  def ip
+    @ip ||= IPSocket::getaddress(domain)
+  end
+
+  def ptr
+    @ptr ||= DomainInfo::PTR.new(domain)
+  end
+
+  def spf
+    @spf ||= DomainInfo::SPF.new(domain)
+  end
+
+  def dkim(txt_name)
+    @dkim ||= DomainInfo::DKIM.new(domain, txt_name)
+  end
+
+  def default_dkim
+    @default_dkim_dkim ||= DomainInfo::DKIM.new(domain, "#{domain}._domainkey")
+  end
+end

data/lib/domain_info/ptr.rb

@@ -0,0 +1,14 @@
+class DomainInfo::PTR < DomainInfo::Record
+  def initialize(domain)
+    @domain = domain
+    @ptr = Resolv.getname(IPSocket::getaddress(domain))
+  end
+
+  def valid?
+    value == @domain
+  end
+
+  def value
+    @ptr
+  end
+end

data/lib/domain_info/record.rb

@@ -0,0 +1,5 @@
+class DomainInfo::Record
+  def present?
+    !value.nil?
+  end
+end

data/lib/domain_info/spf.rb

@@ -0,0 +1,12 @@
+require 'domain_info/util/dns_records'
+
+class DomainInfo::SPF < DomainInfo::Record
+  def initialize(domain)
+    @domain = domain
+    @spf = DomainInfo::DNSRecords.new(domain).detect{|txt_record| txt_record.start_with?("v=spf1")}
+  end
+
+  def value
+    @spf
+  end
+end

data/lib/domain_info/util/dns_records.rb

@@ -0,0 +1,15 @@
+class DomainInfo::DNSRecords
+  include Enumerable
+
+  def initialize(domain)
+    @domain = domain
+  end
+
+  def each
+    Resolv::DNS.open do |dns|
+      dns.each_resource(@domain, Resolv::DNS::Resource::IN::TXT) do |dns_record|
+        dns_record.strings.each{ |dns_string| yield dns_string }
+      end
+    end
+  end
+end

data/lib/domain_info/version.rb

@@ -0,0 +1,3 @@
+module DomainInfo
+  VERSION = "0.0.1"
+end

data/spec/lib/domain_info/dkim_spec.rb

@@ -0,0 +1,9 @@
+require "spec_helper"
+
+describe DomainInfo::DKIM do
+  let(:dkim) { DomainInfo::DKIM.new("plaintracker.com", "plaintracker.com._domainkey") }
+
+  it "returns DKIM record for ip associated with domain" do
+    dkim.value.should match("v=DKIM1")
+  end
+end

data/spec/lib/domain_info/domain_spec.rb

@@ -0,0 +1,25 @@
+require "spec_helper"
+
+describe DomainInfo::Domain do
+  let (:domain) { DomainInfo::Domain.new("github.com") }
+
+  it "has an IP address" do
+    domain.ip.should_not be_nil
+  end
+
+  it "has a PTR record" do
+    domain.ptr.should_not be_nil
+  end
+
+  it "has a SPF record" do
+    domain.ptr.should_not be_nil
+  end
+
+  it "has a DKIM record" do
+    domain.dkim("_key").should_not be_nil
+  end
+
+  it "has a default DKIM record" do
+    domain.default_dkim.should_not be_nil
+  end
+end

data/spec/lib/domain_info/ptr_spec.rb

@@ -0,0 +1,16 @@
+require "spec_helper"
+
+describe DomainInfo::PTR do
+  let(:ptr) { DomainInfo::PTR.new("github.com") }
+
+  it "returns PTR record for ip associated with domain" do
+    ptr.value.should == "github.com"
+  end
+
+  context "#valid?" do
+    it "returns true if domain resolves to itself" do
+      ptr.stub(:value).and_return("github.com")
+      ptr.should be_valid
+    end
+  end
+end

data/spec/lib/domain_info/spf_spec.rb

@@ -0,0 +1,9 @@
+require "spec_helper"
+
+describe DomainInfo::SPF do
+  let(:spf) { DomainInfo::SPF.new("plaintracker.com") }
+
+  it "returns SPF record for ip associated with domain" do
+    spf.value.should == "v=spf1 mx ip4:178.63.56.8 -all"
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1 @@
+require 'domain_info'

metadata

@@ -0,0 +1,85 @@
+--- !ruby/object:Gem::Specification 
+name: domain_info
+version: !ruby/object:Gem::Version 
+  version: 0.0.1
+platform: ruby
+authors: 
+- Igor Afonov
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2012-03-15 00:00:00 +02:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  type: :development
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+    version: 
+description: Wraps access to basic domain DNS records needed to verify domain configuration
+email: 
+- afonov@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .gitignore
+- .travis.yml
+- Gemfile
+- README.md
+- Rakefile
+- domain_info.gemspec
+- lib/domain_info.rb
+- lib/domain_info/dkim.rb
+- lib/domain_info/domain.rb
+- lib/domain_info/ptr.rb
+- lib/domain_info/record.rb
+- lib/domain_info/spf.rb
+- lib/domain_info/util/dns_records.rb
+- lib/domain_info/version.rb
+- spec/lib/domain_info/dkim_spec.rb
+- spec/lib/domain_info/domain_spec.rb
+- spec/lib/domain_info/ptr_spec.rb
+- spec/lib/domain_info/spf_spec.rb
+- spec/spec_helper.rb
+has_rdoc: false
+homepage: ""
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: domain_info
+rubygems_version: 1.3.1
+signing_key: 
+specification_version: 2
+summary: Wraps access to basic domain DNS records
+test_files: 
+- spec/lib/domain_info/dkim_spec.rb
+- spec/lib/domain_info/domain_spec.rb
+- spec/lib/domain_info/ptr_spec.rb
+- spec/lib/domain_info/spf_spec.rb
+- spec/spec_helper.rb