segua 0.1.0

data/.gitignore

@@ -0,0 +1,3 @@
+doc
+.yardoc
+

data/.yardopts

@@ -0,0 +1,4 @@
+--markup "markdown"
+--title "Segua"
+lib/**/*.rb -
+README.md LICENSE.md

data/LICENSE.md

@@ -0,0 +1,26 @@
+Copyright (c) 2012 by the University of Arizona.
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are
+met:
+
+*   Redistributions of source code must retain the above copyright
+    notice, this list of conditions and the following disclaimer.
+
+*   Redistributions in binary form must reproduce the above copyright
+    notice, this list of conditions and the following disclaimer in
+    the documentation and/or other materials provided with the
+    distribution.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

data/README.md

@@ -0,0 +1,59 @@
+Segua
+=====
+
+Introduction
+------------
+
+Segua is a tool that works similar to `tail -f`. The primary difference is that Segua uses a directory, not a file, as input. It then finds the file with the most recent modification time, and follows that file. After printing a line, Segua will review the directory entries to see if one has a newer modification time, and begin following that one.
+
+Compatibility
+-------------
+
+Segua is tested on the following platforms:
+
+* **ruby-1.9.3** on **Linux**
+
+That is all.
+
+Roadmap
+-------
+
+* Tests :P
+* Do not print the whole file contents at the beginning. Act more like `tail -f`
+* Make the `SEGUA` lines optional.
+* Option for using creation time, instead of modification time
+* Fix: `/home/sam/code/segua/lib/segua.rb:36:in `strip': invalid byte sequence in UTF-8 (ArgumentError)` when latest file is a Vim swap file.
+
+Installation
+------------
+
+    gem install segua
+
+Contributing
+------------
+
+Please do! Contributing is easy. Please read the CONTRIBUTING.md document for more info. ... Whet exists.
+
+Usage
+-----
+
+Segua is meant to be used primarily as the binary script that is provided, `segua`. You can also require the class itself, with
+
+    require 'segua'
+    segua = Segua.new("some/directory")
+
+Versioning
+----------
+
+Segua follows [Semantic Versioning](http://semver.org/) (at least approximately) version 2.0.0-rc1.
+
+Further Reading
+---------------
+
+* [tail man page](http://unixhelp.ed.ac.uk/CGI/man-cgi?tail)
+
+License
+-------
+
+Please see [LICENSE.md|LICENSE.md].
+

data/bin/segua

@@ -0,0 +1,7 @@
+#!/usr/bin/env ruby
+require File.join(File.dirname(File.expand_path(__FILE__)), '..', 'lib', 'segua')
+
+dir = File.expand_path(ARGV.shift)
+
+segua = Segua.new(dir)
+segua.follow

data/lib/segua/version.rb

@@ -0,0 +1,4 @@
+class Segua
+  # Gem version
+  Version = "0.1.0"
+end

data/lib/segua.rb

@@ -0,0 +1,64 @@
+require File.join(File.dirname(File.expand_path(__FILE__)), 'segua', 'version')
+
+# Segua tracks changes in files in `@dir`, always following the most recently changed.
+#
+# It emulates `tail -f`. `tail's` argument, `-f`, stands for "follow." "Segua" is the imperative
+# form of "to follow" in Italian.
+class Segua
+  # Create a new Segua against `dir`.
+  def initialize(dir)
+    @dir = dir
+  end
+
+  # Print a few lines before switching to a new file, indicating the new file.
+  def print_file_update(file_name)
+    puts ""
+    puts "SEGUA: ==================" + ('='*file_name.length)
+    puts "SEGUA: most recent file: #{file_name}"
+    puts "SEGUA: ==================" + ('='*file_name.length)
+    puts ""
+  end
+
+  # Following the file with the most recent modification time, print each line of the file,
+  # indefinitely.
+  def follow
+    file_name = latest_file
+    while file_name.nil?
+      sleep 1
+      file_name = latest_file
+    end
+
+    print_file_update(file_name)
+    handle = File.open file_name
+
+    while true
+      line = handle.gets
+      if line.nil?
+        sleep 0.5
+      else
+        puts line.chomp.strip
+      end
+      new_file_name = latest_file
+      while new_file_name.nil?
+        sleep 1
+        new_file_name = latest_file
+      end
+      if new_file_name != file_name
+        print_file_update(new_file_name)
+        file_name = new_file_name
+        handle.close
+        handle = File.open file_name
+        next
+      end
+    end
+    handle.close
+  end
+
+  # Find, among all of the files located directly inside `dir`, the one with the most recent
+  # modification time. Returns the full file path as a String.
+  def latest_file
+    Dir.entries(@dir).map {|f| File.join(@dir, f) }.reject {|f| File.directory?(f) }.inject do |memo,file|
+    File.mtime(memo) > File.mtime(file) ? memo : file
+    end
+  end
+end

metadata

@@ -0,0 +1,56 @@
+--- !ruby/object:Gem::Specification
+name: segua
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+  prerelease: 
+platform: ruby
+authors:
+- Sam Rawlins
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-03-09 00:00:00.000000000 Z
+dependencies: []
+description: Segua acts like tail -f, except that it accepts a directory as input,
+  not a file. It then constantly evaluates which file is the most recently modified,
+  and follows that file.
+email:
+- katt-core@listserv.arizona.edu
+executables:
+- segua
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .yardopts
+- LICENSE.md
+- README.md
+- bin/segua
+- lib/segua.rb
+- lib/segua/version.rb
+homepage: http://uaz-kf-a09.mosaic.arizona.edu/
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.17
+signing_key: 
+specification_version: 3
+summary: Follow the most recently modified files in a directory.
+test_files: []
+has_rdoc: