tail_from_sentinel 0.0.1

data/.gitignore

@@ -0,0 +1 @@
+*.gem

data/Gemfile

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

data/README

@@ -0,0 +1,41 @@
+TailFromSentinel
+
+Parses a file, looking for a sentinel line that satisfies a block, and returns
+all lines from there until the end of the file (including the sentinel itself).
+
+This can be handy when you are looking for information in a log file only after
+a certain condition (eg. a date) has been met.
+
+You can either use it on it's own, or subclass it to build your own custom
+tail-like classes.
+
+Standalone:
+  File.open('/var/log/messages', 'r') do |file|
+    tfs=TailFromSentinel::Base.new(file) { |line| line =~ /Dec 20 11:2\d+/ }
+  end
+  tfs.data # => [ 'Dec 20 11:20:00 ...', 'Dec 20 11:21:00 ...', ... ]
+
+Subclassed:
+  class TailMyFile < TailFromSentinel::Base
+    DATA_ROOT="/path/to/data/"
+
+    def initialize(data_file)
+      file=File.open(File.join(DATA_ROOT, data_file), 'r') do |file|
+        super(file, &select_sentinel_criteria(data_file))
+      end
+    end
+
+    def select_sentinel_criteria(data_file)
+      case data_file
+        when ''production.log'
+          Proc.new { |line| line =~ /pattern/ }
+        when 'development.log'
+          Proc.new { |line| line =~ /another pattern/ }
+        else
+          raise "Unhandled file: #{data_file}"
+      end
+    end
+  end
+
+  t=TailMyFile.new('production.log')
+  t.data # => [ 'Started GET "/pattern ...", "  Processing ... ", ... ]

data/Rakefile

@@ -0,0 +1,2 @@
+require 'bundler'
+Bundler::GemHelper.install_tasks

data/lib/tail_from_sentinel.rb

@@ -0,0 +1,36 @@
+module TailFromSentinel
+  # Parses a file, looking for a sentinel line that satisfies a block, and returns all lines from there
+  # until the end of the file (including the sentinel itself)
+  #
+  # This can be handy when you are looking for information in a log file only after a certain condition (eg. a date)
+  # has been seen.
+  class Base
+    attr_reader :file, :data
+
+    # Parameters:
+    #   file: File IO object
+    #   &sentinel: Block, taking one parameter. Should return true when the sentinel is found.
+    def initialize(file, &sentinel)
+      @file=file
+      @sentinel=sentinel
+      load_data
+      self
+    end
+
+  private
+    # Read all the lines of the file, but don't store them until we find one that satisfies sentinel
+    # Pushes them into @data
+    def load_data
+      @data=[]
+      marker_found=false
+      @file.rewind
+      @file.each_line do |line|
+        if !marker_found && @sentinel.call(line) then
+          marker_found=true
+        end
+
+        @data << line if marker_found
+      end
+    end
+  end
+end

data/lib/tail_from_sentinel/version.rb

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

data/tail_from_sentinel.gemspec

@@ -0,0 +1,22 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "tail_from_sentinel/version"
+
+Gem::Specification.new do |s|
+  s.name        = "tail_from_sentinel"
+  s.version     = TailFromSentinel::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ["Jason Stirk"]
+  s.email       = ["jstirk@oobleyboo.com"]
+  s.homepage    = ""
+  s.homepage    = "http://github.com/jstirk/tail_from_sentinel"
+  s.summary     = "Reads a file, but only return content once a marker (sentinel) has been found."
+  s.description = "Reads a file, but only return content once a marker (sentinel) has been found."
+
+  s.rubyforge_project = "tail_from_sentinel"
+
+  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"]
+end

metadata

@@ -0,0 +1,74 @@
+--- !ruby/object:Gem::Specification 
+name: tail_from_sentinel
+version: !ruby/object:Gem::Version 
+  hash: 29
+  prerelease: false
+  segments: 
+  - 0
+  - 0
+  - 1
+  version: 0.0.1
+platform: ruby
+authors: 
+- Jason Stirk
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-01-08 00:00:00 +11:00
+default_executable: 
+dependencies: []
+
+description: Reads a file, but only return content once a marker (sentinel) has been found.
+email: 
+- jstirk@oobleyboo.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .gitignore
+- Gemfile
+- README
+- Rakefile
+- lib/tail_from_sentinel.rb
+- lib/tail_from_sentinel/version.rb
+- tail_from_sentinel.gemspec
+has_rdoc: true
+homepage: http://github.com/jstirk/tail_from_sentinel
+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: tail_from_sentinel
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: Reads a file, but only return content once a marker (sentinel) has been found.
+test_files: []
+