matchd 0.1.0

data/lib/matchd/rule/invalid.rb

@@ -0,0 +1,24 @@
+# Placeholder class for marking keeping invalid Rules around for later
+# inspection.
+# It overwrited the entire public interface of {Matchd::Rule} to no-operations
+class Matchd::Rule::Invalid < Matchd::Rule
+  def initialize(options)
+    @raw = options
+  end
+  attr_reader :raw
+
+  # Noop
+  # @return [FalseClass] Always returns `false` indecating that processing
+  #   shall not stop.
+  def visit(*); false end
+
+  # Noop
+  # @return [FalseClass] Always returns `false` indecating that this rule
+  #   shall not be executed.
+  def matches?(*); false end
+
+  # Noop
+  # @return [FalseClass] Always returns `false` indecating that processing
+  #   shall not stop.
+  def call(*); false end
+end

data/lib/matchd/rule/passthrough.rb

@@ -0,0 +1,50 @@
+require "async/dns"
+require "async/dns/system"
+
+class Matchd::Rule::Passthrough < Matchd::Rule
+  # @param [Hash] options
+  # @option options [Array<Array>|Array<Hash>|Async::DNS::Resolver] "resolver" List of passthrough DNS servers. See `Matchd::Glue::AsyncEndpoint` for more formats.
+  def initialize(options)
+    super
+    opts = options.fetch("passthrough")
+
+    if opts.is_a?(Hash) && opts.key?("resolver")
+      @resolver = opts["resolver"]
+      @passthrough_options = Matchd::Helpers.extract_options(%w(force name), opts)
+    else
+      @resolver = opts
+      @passthrough_options = {}
+    end
+  end
+
+  attr_reader :resolver, :passthrough_options
+
+  def visit!(server, _name, _resource_class, transaction)
+    transaction.passthrough!(passthrough_resolver, passthrough_options) do |response|
+      server.logger.debug ";; Passthrough to upstream resolver"
+      server.logger.debug ";; Question"
+      server.logger.debug(*response.question.map { |q, r| "#{q}\t#{r}" })
+      server.logger.debug ";; Answer"
+      if response.answer.any?
+        response.answer.each do |name_in_answer, ttl, record|
+          server.logger.debug "#{name_in_answer}\t#{ttl}\t#{record.class}\t#{record.address if record.respond_to?(:address)}"
+        end
+      else
+        server.logger.debug ";; Empty"
+      end
+    end
+  end
+
+  # @private
+  # Lazy convert the {resolver} into somethinge we can pass to {Async::DNS::Transaction#passthrough!}
+  def passthrough_resolver
+    case resolver
+    when Async::DNS::Resolver
+      resolver
+    when "system", :system, nil
+      Async::DNS::Resolver.new(Async::DNS::System.nameservers)
+    else
+      Async::DNS::Resolver.new(Matchd::Glue::AsyncEndpoint.parse(resolver))
+    end
+  end
+end

data/lib/matchd/rule/respond.rb

@@ -0,0 +1,16 @@
+class Matchd::Rule::Respond < Matchd::Rule
+  def initialize(options)
+    super
+    @responses = options.fetch("respond")
+  end
+
+  attr_reader :responses
+
+  def visit!(_server, _name, _resource_class, transaction)
+    # Using the original Rule's resource_classes definition as a fallback, if
+    # the response doesn't configure one.
+    Matchd.Response(responses, @resource_classes).each do |resp|
+      resp.call(transaction)
+    end
+  end
+end

data/lib/matchd/server.rb

@@ -0,0 +1,44 @@
+require "async/dns"
+
+module Matchd
+  # Specific implementation of the {Async::DNS::Server} using a list of rules to determine it's response
+  #
+  # Rules will get {#call}'ed in order until the first one matches (returns truthy).
+  # If none matches, a default {Matchd::Rule::Passthrough} will get executed forwarding the query to the resolver
+  # defined via the `:resolver` option.
+  class Server < Async::DNS::Server
+    # @param rules [Matchd::Registry|Array<Matchd.Rule>] A rules registry
+    # @param listen [Array] On which interfaces to listen (`[[<protocol>, <ip>, <port>], ...]`). See `Matchd::Glue::AsyncEndpoint` for more formats.
+    # @param [Hash] options
+    # @option options [Array|Async::DNS::Resolver] :resolver The upstream resolvers (`[[<protocol>, <ip>, <port>], ...]`). See `Matchd::Glue::AsyncEndpoint` for more formats. (default: `Async::DNS::System.nameservers`)
+    # @option options [TrueClass|FalseClass] :forced_passthtough The default Passthrough rule's `force` option
+    def initialize(rules, listen, options = {})
+      @rules = rules
+      @resolver = options.delete(:resolver)
+      @forced_passthtough = options.delete(:forced_passthtough) { true }
+
+      listen = Matchd::Glue::AsyncEndpoint.parse(listen)
+
+      super(listen, *options)
+    end
+
+    attr_reader :rules, :resolver
+
+    def process(name, resource_class, transaction)
+      found = rules.any? do |rule|
+        rule.call(self, name, resource_class, transaction)
+      end
+
+      passthrough!(name, resource_class, transaction) unless found
+    end
+
+    def passthrough!(name, resource_class, transaction)
+      Matchd::Rule::Passthrough.new(
+        "passthrough" => resolver,
+        "match" => name,
+        "resource_class" => resource_class,
+        "force" => @forced_passthtough
+      ).visit!(self, name, resource_class, transaction)
+    end
+  end
+end

data/lib/matchd/version.rb

@@ -0,0 +1,3 @@
+module Matchd
+  VERSION = "0.1.0".freeze
+end

data/matchd.gemspec

@@ -0,0 +1,31 @@
+require File.expand_path('lib/matchd/version', __dir__)
+
+Gem::Specification.new do |spec|
+  spec.name          = "matchd"
+  spec.version       = Matchd::VERSION
+  spec.authors       = ["Robert Schulze"]
+  spec.email         = ["robert@dotless.de"]
+  spec.license       = "MLP-2.0"
+
+  spec.summary       = 'A Async::DNS daemon with expanded yaml configuration.'
+  spec.description   = <<-DESC
+    Let's you use Async::DNS as a server daemon and configure it using yaml files. No writing ruby code required.
+  DESC
+  spec.homepage      = "https://github.com/fnordfish/matchd"
+
+  spec.files         = `git ls-files -z`.split("\x0").reject do |f|
+    f.match(%r{^(test|spec|features)/})
+  end
+  spec.bindir        = "exe"
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.add_runtime_dependency "async-dns", "~> 1.2.0"
+  spec.add_runtime_dependency "daemons"
+  spec.add_runtime_dependency "dry-configurable", "~> 0.7.0"
+  spec.add_runtime_dependency "thor", "~> 0.20.0"
+
+  spec.add_development_dependency "bundler", "~> 1.16"
+  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency "rspec", "~> 3.0"
+end

metadata

@@ -0,0 +1,191 @@
+--- !ruby/object:Gem::Specification
+name: matchd
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Robert Schulze
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2018-08-17 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: async-dns
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.2.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.2.0
+- !ruby/object:Gem::Dependency
+  name: daemons
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: dry-configurable
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.7.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.7.0
+- !ruby/object:Gem::Dependency
+  name: thor
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.20.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.20.0
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.16'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.16'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+description: "    Let's you use Async::DNS as a server daemon and configure it using
+  yaml files. No writing ruby code required.\n"
+email:
+- robert@dotless.de
+executables:
+- matchd
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- ".rubocop-https---relaxed-ruby-style-rubocop-yml"
+- ".rubocop.yml"
+- ".travis.yml"
+- DEVELOPMENT.md
+- Gemfile
+- License.txt
+- README.md
+- Rakefile
+- bin/console
+- bin/matchd
+- bin/rake
+- bin/rspec
+- bin/setup
+- examples/registry.yml
+- exe/matchd
+- lib/matchd.rb
+- lib/matchd/cli.rb
+- lib/matchd/cli/config.rb
+- lib/matchd/cli/config_file_option.rb
+- lib/matchd/cli/main.rb
+- lib/matchd/config.rb
+- lib/matchd/control.rb
+- lib/matchd/glue.rb
+- lib/matchd/glue/async_endpoint.rb
+- lib/matchd/helpers.rb
+- lib/matchd/registry.rb
+- lib/matchd/response.rb
+- lib/matchd/response/a.rb
+- lib/matchd/response/aaaa.rb
+- lib/matchd/response/cname.rb
+- lib/matchd/response/mx.rb
+- lib/matchd/response/ns.rb
+- lib/matchd/response/ptr.rb
+- lib/matchd/response/soa.rb
+- lib/matchd/response/srv.rb
+- lib/matchd/response/txt.rb
+- lib/matchd/rule.rb
+- lib/matchd/rule/append.rb
+- lib/matchd/rule/fail.rb
+- lib/matchd/rule/invalid.rb
+- lib/matchd/rule/passthrough.rb
+- lib/matchd/rule/respond.rb
+- lib/matchd/server.rb
+- lib/matchd/version.rb
+- matchd.gemspec
+homepage: https://github.com/fnordfish/matchd
+licenses:
+- MLP-2.0
+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.7.6
+signing_key: 
+specification_version: 4
+summary: A Async::DNS daemon with expanded yaml configuration.
+test_files: []