tracelogger 0.0.1

data/.gitignore

@@ -0,0 +1,7 @@
+*.gem
+.bundle
+Gemfile.lock
+pkg/*
+doc
+rdoc
+.yardoc

data/Gemfile

@@ -0,0 +1,4 @@
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in dumb_tracer.gemspec
+gemspec

data/README.md

@@ -0,0 +1,39 @@
+# Tracelogger
+
+A silly simple little dumb traceroute logger.
+
+## Usage
+
+    tracelogger name.com
+
+## What does it do?
+
+1. Finds `traceroute` on your system
+2. Runs `traceroute name.com 2>&1`
+3. Passes the above's output to localhost syslog's `LOG_DAEMON` facility.
+
+That's all.
+
+## License
+
+    The MIT License
+    
+    Copyright (c) 2011 Pavel Argentov, <http://argentoff.net>
+    
+    Permission is hereby granted, free of charge, to any person obtaining a copy
+    of this software and associated documentation files (the "Software"), to deal
+    in the Software without restriction, including without limitation the rights
+    to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+    copies of the Software, and to permit persons to whom the Software is
+    furnished to do so, subject to the following conditions:
+    
+    The above copyright notice and this permission notice shall be included in
+    all copies or substantial portions of the Software.
+    
+    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+    IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+    FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+    AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+    LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+    OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+    THE SOFTWARE.

data/README.rdoc

@@ -0,0 +1,39 @@
+= Tracelogger
+
+A silly simple little dumb traceroute logger.
+
+== Usage
+
+    tracelogger name.com
+
+== What does it do?
+
+1. Finds `traceroute` on your system
+2. Runs `traceroute name.com 2>&1`
+3. Passes the above's output to localhost syslog's `LOG_DAEMON` facility.
+
+That's all.
+
+== License
+
+    The MIT License
+    
+    Copyright (c) 2011 Pavel Argentov, <http://argentoff.net>
+    
+    Permission is hereby granted, free of charge, to any person obtaining a copy
+    of this software and associated documentation files (the "Software"), to deal
+    in the Software without restriction, including without limitation the rights
+    to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+    copies of the Software, and to permit persons to whom the Software is
+    furnished to do so, subject to the following conditions:
+    
+    The above copyright notice and this permission notice shall be included in
+    all copies or substantial portions of the Software.
+    
+    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+    IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+    FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+    AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+    LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+    OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+    THE SOFTWARE.

data/Rakefile

@@ -0,0 +1,21 @@
+require "bundler/setup"
+require "bundler/gem_tasks"
+
+require "yard"
+
+require 'rdoc/task'
+Rake::RDocTask.new do |rdoc|
+  version = File.exist?('VERSION') ? File.read('VERSION') : ""
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "Tracelogger #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end
+
+YARD::Rake::YardocTask.new
+
+desc "Clean up the development-only stuff"
+task :clean do
+  system "git clean -fd"
+end

data/bin/tracelogger

@@ -0,0 +1,11 @@
+#!/usr/bin/env ruby
+
+# for development purposes
+$:.unshift(File.join(File.dirname(__FILE__), "..", "lib"))
+
+require "rubygems"
+require "tracelogger"
+
+# The main application running script.
+
+Tracelogger::App.new.run

data/lib/tracelogger/version.rb

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

data/lib/tracelogger.rb

@@ -0,0 +1,104 @@
+require "tracelogger/version"
+require "optparse"
+require 'log4r'
+require 'log4r/outputter/syslogoutputter'
+
+# Author:: Pavel Argentov (mailto:argentoff@gmail.com)
+# License:: MIT (See README)
+#
+# This module contains all the classes needed by Tracelogger.
+module Tracelogger
+
+  # Tracelogger's Configuration: used when running the app.
+  class Configuration
+    attr_accessor :options, :host
+  end
+
+  # This class wraps Log4r's Syslog logic.
+  # == Usage
+  #   mylog = Log.new
+  #   mylog.info "Some Message"
+  class Log
+
+    # @private
+    def initialize # :nodoc:
+      @log = Log4r::Logger.new "main"
+      @log.outputters = Log4r::SyslogOutputter.new("tracelogger", :facility => "LOG_DAEMON")
+    end
+
+    # @private
+    def method_missing(meth, *args, &block) # :nodoc:
+      @log.send meth, *args, &block
+    end
+  end
+
+  # Wraps `traceroute` run.
+  class Traceroute
+
+    # Finds the system's traceroute executable.
+    def initialize
+      @command = `which traceroute`.chomp
+    end
+
+    # Runs the found traceroute with the specified address and returns the
+    # result.
+    def trace host
+      `env #{@command} #{host} 2>&1`
+    end
+  end
+
+  # Application run scenario.
+  class App
+
+    # Initializes the app's settings and parses the CLI options.
+    def initialize
+      @config = Configuration.new
+      options = {}
+      OptionParser.new do |opts|
+        opts.banner = "Usage: dumb_tracer [options] host\n" +
+          "  Traces the route to destination host and sends\n" +
+          "  the traceroute result to SYSLOG's 'daemon' facility"
+
+        opts.separator ""
+        opts.separator "Optional parameters:"
+
+        opts.on_tail "-h", "--help", "Show this message" do
+          puts opts.help
+        end
+
+      end.parse!
+
+      @config.options = options
+      @config.host    = ARGV.first
+
+      @log = Log.new
+    end
+
+    # Logs the message.
+    def log message # :nodoc:
+      @log.info message
+    end
+
+    # Executed right after the start.
+    def start # :nodoc:
+      log "Starting"
+    end
+
+    # Executed right before the end.
+    def wrapup # :nodoc:
+      log "Finishing"
+    end
+
+    # Logs the underlying traceroute's result.
+    def trace # :nodoc:
+      log Traceroute.new.trace @config.host
+    end
+
+    # Runs the app scenario.
+    def run
+      start
+      trace
+      wrapup
+    end
+  end
+end

data/tracelogger.gemspec

@@ -0,0 +1,26 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "tracelogger/version"
+
+Gem::Specification.new do |s|
+  s.name        = "tracelogger"
+  s.version     = Tracelogger::VERSION
+  s.authors     = ["Pavel Argentov"]
+  s.email       = ["argentoff@gmail.com"]
+  s.homepage    = "https://github.com/argent-smith/tracelogger"
+  s.summary     = %q{Simple traceroute logger}
+  s.description = %q{"tracelogger host" sends the results of `traceroute #{host}` to syslog.}
+
+  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.extra_rdoc_files = ['README.rdoc']
+
+  # specify any dependencies here; for example:
+  s.add_development_dependency "yard"
+  s.add_development_dependency "rdoc"
+  s.add_development_dependency "redcarpet"
+  s.add_development_dependency "rake"
+  s.add_runtime_dependency "log4r"
+end

metadata

@@ -0,0 +1,144 @@
+--- !ruby/object:Gem::Specification 
+name: tracelogger
+version: !ruby/object:Gem::Version 
+  hash: 29
+  prerelease: 
+  segments: 
+  - 0
+  - 0
+  - 1
+  version: 0.0.1
+platform: ruby
+authors: 
+- Pavel Argentov
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-12-22 00:00:00 Z
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  type: :development
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  prerelease: false
+  name: yard
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  type: :development
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  prerelease: false
+  name: rdoc
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  type: :development
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  prerelease: false
+  name: redcarpet
+  version_requirements: *id003
+- !ruby/object:Gem::Dependency 
+  type: :development
+  requirement: &id004 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  prerelease: false
+  name: rake
+  version_requirements: *id004
+- !ruby/object:Gem::Dependency 
+  type: :runtime
+  requirement: &id005 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  prerelease: false
+  name: log4r
+  version_requirements: *id005
+description: "\"tracelogger host\" sends the results of `traceroute #{host}` to syslog."
+email: 
+- argentoff@gmail.com
+executables: 
+- tracelogger
+extensions: []
+
+extra_rdoc_files: 
+- README.rdoc
+files: 
+- .gitignore
+- Gemfile
+- README.md
+- README.rdoc
+- Rakefile
+- bin/tracelogger
+- lib/tracelogger.rb
+- lib/tracelogger/version.rb
+- tracelogger.gemspec
+homepage: https://github.com/argent-smith/tracelogger
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.8.12
+signing_key: 
+specification_version: 3
+summary: Simple traceroute logger
+test_files: []
+
+has_rdoc: