gitlab-net-dns 0.9.1

data/.travis.yml

@@ -0,0 +1,13 @@
+language: ruby
+
+rvm:
+  - 2.1
+  - 2.2
+  - 2.3
+  - 2.4
+  - 2.5
+  - jruby-9.1.5.0
+  - ruby-head
+
+cache:
+  - bundler

data/CHANGELOG.md

@@ -0,0 +1,113 @@
+# Changelog
+
+## Release 0.9.1
+
+- FIXED: Fixed undefined 'size' errors (https://gitlab.com/gitlab-org/gitlab-net-dns/merge_requests/2)
+
+- CHANGED: Test with GitLab CI (https://gitlab.com/gitlab-org/gitlab-net-dns/merge_requests/1)
+
+## Release 0.9.0
+
+- FIXED: Fixed CI run (GH-77).
+
+- FIXED: Fixed deprecated references to Fixnum.
+
+- CHANGED: Major code cleanup.
+
+- CHANGED: Minimum Ruby version is now 2.1
+
+
+## Release 0.8.0
+
+- FIXED: undefined local variable or method `source_address_inet6' (GH-40). [Thanks @simsicon]
+
+- FIXED: Fixed bug on parsing multiple nameservers on different lines (GH-45). [Thanks @nicholasren]
+
+- CHANGED: Dropped duplicate query ID filter. Query ID is now randomically generated but it's not guaranteed to be unique (GH-39). [Thanks @ebroder]
+
+- CHANGED: require 'net/dns' is now the preferred way to load the library (GH-37). [Thanks @johnroa]
+
+- CHANGED: Removed setup.rb installation script.
+
+
+## Release 0.7.1
+
+- FIXED: Invalid file permissions on several files (GH-35) [Thanks @jamespharaoh]
+
+
+## Release 0.7.0
+
+- ADDED: Added (experimental) Support for HINFO record.
+
+- FIXED: Use Net::DNS::Resolver::Error class (not ResolverError, which does not exist).
+
+- FIXED: Cleaned up require dependency and recursive require statements.
+
+- FIXED: Use RbConfig instead of obsolete and deprecated Config (GH-28, GH-33) [Thanks @shadowbq, @eik3]
+
+- FIXED: SRV record not required by Net::DNS::RR (GH-27) [Thanks @sebastian]
+
+- FIXED: Resolver now supports IPv6 (GH-32) [Thanks @jamesotron]
+
+- FIXED: Net::DNS::RR::PTR references an invalid parameter (GH-19) [Thanks @dd23]
+
+- FIXED: Net::DNS::Question changes input arguments (GH-7) [Thanks @gfarfl]
+
+- CHANGED: Refactoring unit test to follow most used Ruby conventions.
+
+- CHANGED: Rewritten and simplified Net::DNS::Classes. Improved test harness.
+
+- CHANGED: Removed Jeweler development dependency.
+
+- CHANGED: The library is now compatible with Bundler.
+
+- CHANGED: Minimum supported Ruby version changed to Ruby 1.8.7.
+
+- CHANGED: Rescue NameError so unsupported record types only result in a warning.
+
+- CHANGED: Renamed Net::DNS::Resolver#send to Net::DNS::Resolver#query to avoid overriding default meaning of send method.
+
+
+## Release 0.6.1
+
+- ADDED: Net::DNS::Packet#to_s method (alias of #inspect)
+
+- FIXED: typo in lib/net/dns/rr/ptr.rb [Thanks Chris Lundquist]
+
+- FIXED: warning: method redefined; discarding old inspect (GH-3) [Thanks Kevin Baker]
+
+- FIXED: issue with rescue ArgumentError (GH-5) and with IPAddr handling (GH-6)
+
+
+## Release 0.6.0
+
+*WARNING:- If you are upgrading from a previous minor release, check out the Compatibility issue list below.
+
+- FIXED: Added missing #to_s method to Net::DNS::Question.
+
+- FIXED: Compatibility with Ruby 1.9
+
+- FIXED: Types regexp order issue
+
+- CHANGED: Refactoring unit test to follow most used Ruby conventions
+
+- CHANGED: default timeout is now 5 seconds for both UDP and TCP
+
+- CHANGED: Moved main dns.rb file to lib/net folder as default for GEMs. In this way it can be autoloaded when the gem is required.
+
+### Compatibility issues
+
+- CHANGED: RR#set_stype scope is now private to prevent invalid usage.
+
+- CHANGED: DnsTimeout#timeout now raises LocalJumpError instead of DnsTimeoutArgumentError when block is missing.
+
+- CHANGED: Renamed Net::DNS::RR::Types::Types to Net::DNS::RR::Types::TYPES to follow Ruby coding standards.
+
+
+## Release 0.4
+
+- many bug fixes (thanks guys!)
+- a whole new class Net::DNS::Header::RCode
+- new methods in Net::DNS::Resolver class to do AXFR queries
+- a new SRV resource record written by Dan Janowski
+- more documentation written and corrected

data/Gemfile

@@ -0,0 +1,9 @@
+source "https://rubygems.org"
+
+gemspec
+
+gem "minitest"
+gem "minitest-reporters"
+gem "rspec"
+gem "rubocop", require: false
+gem "rubocop-performance", require: false

data/LICENSE.txt

@@ -0,0 +1,56 @@
+net-dns is copyrighted free software by Marco Ceresa (@bluemonk) and Simone Carletti (@weppos).
+You can redistribute it and/or modify it under either the terms of the
+2-clause BSDL (see the file BSDL), or the conditions below:
+
+  1. You may make and give away verbatim copies of the source form of the
+     software without restriction, provided that you duplicate all of the
+     original copyright notices and associated disclaimers.
+
+  2. You may modify your copy of the software in any way, provided that
+     you do at least ONE of the following:
+
+       a) place your modifications in the Public Domain or otherwise
+          make them Freely Available, such as by posting said
+	  modifications to Usenet or an equivalent medium, or by allowing
+	  the author to include your modifications in the software.
+
+       b) use the modified software only within your corporation or
+          organization.
+
+       c) give non-standard binaries non-standard names, with
+          instructions on where to get the original software distribution.
+
+       d) make other distribution arrangements with the author.
+
+  3. You may distribute the software in object code or binary form,
+     provided that you do at least ONE of the following:
+
+       a) distribute the binaries and library files of the software,
+	  together with instructions (in the manual page or equivalent)
+	  on where to get the original distribution.
+
+       b) accompany the distribution with the machine-readable source of
+	  the software.
+
+       c) give non-standard binaries non-standard names, with
+          instructions on where to get the original software distribution.
+
+       d) make other distribution arrangements with the author.
+
+  4. You may modify and include the part of the software into any other
+     software (possibly commercial).  But some files in the distribution
+     are not written by the author, so that they are not under these terms.
+
+     For the list of those files and their copying conditions, see the
+     file LEGAL.
+
+  5. The scripts and library files supplied as input to or produced as 
+     output from the software do not automatically fall under the
+     copyright of the software, but belong to whomever generated them, 
+     and may be sold commercially, and may be aggregated with this
+     software.
+
+  6. THIS SOFTWARE IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR
+     IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
+     WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+     PURPOSE.

data/README.md

@@ -0,0 +1,172 @@
+# Net::DNS
+
+Net::DNS is a DNS library written in pure Ruby. It started as a port of Perl Net::DNS module, but it evolved in time into a full Ruby library.  
+
+
+## Features
+
+- Complete OO interface
+- Clean and intuitive API
+- Modular and flexible
+
+
+## Requirements
+
+Ruby >= 2.1
+
+
+## Installation
+
+The best way to install this library is via [RubyGems](https://rubygems.org/).
+
+```
+gem install net-dns
+```
+
+
+## API Documentation
+
+Visit the page http://rdoc.info/gems/net-dns
+
+
+## Trivial resolver
+
+The simplest way to use the library is to invoke the Resolver() method:
+
+```ruby
+require 'rubygems' 
+require 'net/dns'
+p Resolver("www.google.com")
+```
+
+The output is compatible with BIND zone files and it's the same you would get with the dig utility.
+
+```
+;; Answer received from localhost:53 (212 bytes)
+;;
+;; HEADER SECTION
+;; id = 64075
+;; qr = 1       opCode: QUERY   aa = 0  tc = 0  rd = 1
+;; ra = 1       ad = 0  cd = 0  rcode = NoError
+;; qdCount = 1  anCount = 3     nsCount = 4     arCount = 4
+
+;; QUESTION SECTION (1 record):
+;; google.com.                  IN      A
+
+;; ANSWER SECTION (3 records):
+google.com.             212     IN      A       74.125.45.100
+google.com.             212     IN      A       74.125.67.100
+google.com.             212     IN      A       209.85.171.100
+
+;; AUTHORITY SECTION (4 records):
+google.com.             345512  IN      NS      ns1.google.com.
+google.com.             345512  IN      NS      ns4.google.com.
+google.com.             345512  IN      NS      ns2.google.com.
+google.com.             345512  IN      NS      ns3.google.com.
+
+;; ADDITIONAL SECTION (4 records):
+ns1.google.com.         170275  IN      A       216.239.32.10
+ns2.google.com.         170275  IN      A       216.239.34.10
+ns3.google.com.         170275  IN      A       216.239.36.10
+ns4.google.com.         170275  IN      A       216.239.38.10
+```
+
+An optional block can be passed yielding the Net::DNS::Packet object
+
+```ruby
+Resolver("www.google.com") { |packet| puts packet.size + " bytes" }
+# => 484 bytes
+```
+
+Same for Net::DNS::Resolver.start():
+
+```ruby
+Net::DNS::Resolver.start("google.com").answer.size
+# => 5
+```
+
+As optional parameters, +TYPE+ and +CLASS+ can be specified.
+
+```ruby
+p Net::DNS::Resolver.start("google.com", Net::DNS::MX)
+
+;; Answer received from localhost:53 (316 bytes)
+;;
+;; HEADER SECTION
+;; id = 59980
+;; qr = 1       opCode: QUERY   aa = 0  tc = 0  rd = 1
+;; ra = 1       ad = 0  cd = 0  rcode = NoError
+;; qdCount = 1  anCount = 4     nsCount = 4     arCount = 8
+
+;; QUESTION SECTION (1 record):
+;; google.com.                  IN      MX
+
+;; ANSWER SECTION (4 records):
+google.com.             10800   IN      MX      10 smtp2.google.com.
+google.com.             10800   IN      MX      10 smtp3.google.com.
+google.com.             10800   IN      MX      10 smtp4.google.com.
+google.com.             10800   IN      MX      10 smtp1.google.com.
+```
+
+## Handling the response packet
+
+The method Net::DNS::Resolver.start is a wrapper around Resolver.new. It returns a new Net::DNS::Packet object.
+
+A DNS packet is divided into 5 sections:
+
+- header section # => a Net::DNS::Header object
+- question section # => a Net::DNS::Question object
+- answer section # => an Array of Net::DNS::RR objects
+- authority section # => an Array of Net::DNS::RR objects
+- additional section # => an Array of Net::DNS::RR objects
+
+You can access each section by calling the attribute with the same name on a Packet object:
+
+```ruby
+packet = Net::DNS::Resolver.start("google.com")
+
+header = packet.header
+answer = packet.answer
+
+puts "The packet is #{packet.data.size} bytes"
+puts "It contains #{header.anCount} answer entries"
+
+answer.any? {|ans| p ans}
+```
+
+The output is 
+
+```
+The packet is 378 bytes
+It contains 3 answer entries
+google.com.             244     IN      A       74.125.45.100
+google.com.             244     IN      A       74.125.67.100
+google.com.             244     IN      A       209.85.171.100
+```
+
+A better way to handle the answer section is to use the iterators directly on a Packet object:
+
+```ruby
+packet.each_address do |ip|
+  puts "#{ip} is alive" if Ping.pingecho(ip.to_s, 10, 80)
+end
+```
+
+Gives:
+
+```
+74.125.45.100 is alive
+74.125.67.100 is alive
+209.85.171.100 is alive
+```
+
+
+## License
+
+Net::DNS is distributed under the same license Ruby is.
+
+
+## Authors
+
+- Marco Ceresa (@bluemonk)
+- Simone Carletti (@weppos)

data/Rakefile

@@ -0,0 +1,38 @@
+require "bundler/gem_tasks"
+
+# Run test by default.
+task default: :test
+task test: %i[testunit spec]
+
+require 'rake/testtask'
+
+Rake::TestTask.new(:testunit) do |t|
+  t.libs = %w[lib test]
+  t.pattern = "test/**/*_test.rb"
+  t.verbose = !ENV["VERBOSE"].nil?
+  t.warning = !ENV["WARNING"].nil?
+end
+
+require "rubocop/rake_task"
+
+RuboCop::RakeTask.new
+
+require 'rspec/core/rake_task'
+begin
+  require 'fuubar'
+rescue LoadError
+end
+
+RSpec::Core::RakeTask.new do |t|
+  t.verbose = !!ENV["VERBOSE"]
+  t.rspec_opts = []
+  t.rspec_opts << ['--format', 'Fuubar'] if defined?(Fuubar)
+end
+
+require 'yard/rake/yardoc_task'
+
+YARD::Rake::YardocTask.new(:yardoc) do |y|
+  y.options = ["--output-dir", "yardoc"]
+end
+
+CLOBBER.include "yardoc"

data/THANKS.rdoc

@@ -0,0 +1,24 @@
+Many thanks to these wonderful people:
+
+- Paul Barry for his excellent article on May07 issue of LinuxJournal, for the kind words and for bug reports
+- Dan Janowski (and his SRV RR)
+- Joshua Abraham
+- Ben April
+- Gene Rogers
+- Nicholas Veeser
+- Gildas Cherruel
+- Alex Dalitz
+- Cory Wright
+- Nicolas Pugnant
+- Andrea Peltrin
+- Giovanni Corriga
+- Luca Russo
+- Pierguido Lambri
+- Andrea Pampuri
+- _koo_
+- Oyku Gencay
+- Eric Liedtke
+- Justin Mercier
+- Daniel Berger
+and all #ruby-lang people
+

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "net/dns"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require "irb"
+IRB.start