baby-bro 0.0.1

data/.gitignore

@@ -0,0 +1 @@
+pkg

data/History.txt

@@ -0,0 +1,4 @@
+=== 0.0.1 2010-12-03
+
+* 1 major enhancement:
+  * Initial release

data/Manifest.txt

@@ -0,0 +1,26 @@
+History.txt
+Manifest.txt
+PostInstall.txt
+README.rdoc
+Rakefile
+baby-bro.gemspec
+bin/bro
+config/babybrorc.example
+lib/baby-bro.rb
+lib/baby-bro/base_config.rb
+lib/baby-bro/exec.rb
+lib/baby-bro/files.rb
+lib/baby-bro/hash_object.rb
+lib/baby-bro/monitor.rb
+lib/baby-bro/monitor_config.rb
+lib/baby-bro/project.rb
+lib/baby-bro/reporter.rb
+lib/baby-bro/session.rb
+lib/extensions/fixnum.rb
+script/console
+script/destroy
+script/generate
+spec/baby-bro_spec.rb
+spec/spec.opts
+spec/spec_helper.rb
+tasks/rspec.rake

data/PostInstall.txt

@@ -0,0 +1,5 @@
+
+For more information on baby-bro, see https://github.com/capitalthought/baby-bro
+
+
+

data/README.rdoc

@@ -0,0 +1,100 @@
+= baby-bro
+
+* http://github.com/capitalthought/baby-bro
+
+== DESCRIPTION:
+
+Baby Bro monitors timestamp changes in configured project directories and automatically tracks active development time for those projects.  The name is a play on "Big Brother", which came up in a conversation with a colleague when discussing the idea for this utility.  As in, if your employer were running this utility on your workstation with you knowing it, "Big Brother" would be watching you.  
+
+Baby Bro isn't meant to be used like that, however.  It's meant to be used by anyone who wants to automatically keep track of the amount of time they spend actively working on files in a particular project's directory.
+
+== SYNOPSIS:
+
+When working on source code, a developer is typically modifying files in a particular directory and saving them periodically.  By monitoring the timestamps of files in a project directory and detecting when a file has been updated, one could theoretically measure a developer's time spent changing code by logging timestamp changes and grouping them in to sessions of continuous activity.  This is how Baby Bro works. 
+
+== REQUIREMENTS:
+
+
+
+== INSTALL:
+
+Baby Bro is installed as a Ruby gem.  
+
+  sudo gem install baby-bro
+
+Create a configuration file.  By default baby-bro will look in your home directory for .babybrorc.
+
+The config file is YAML.  In addition to configuring options for the monitor, you must configure at least one project to monitor before baby-bro will do anything.
+
+An example config file:
+
+  ---
+  :data_directory: ~/.babybro
+  :polling_interval: 1 minute
+  :idle_interval: 5 minutes
+  :projects:
+  - :name: Baby Bro
+    :directory: ~/src/capitalthought/baby-bro
+  - :name: Some Other Project
+    :directory: ~/src/capitalthought/sop
+  
+This configuration tells baby-bro to monitor activity sessions in the "Baby Bro" project directory ~/src/capitalthought/baby-bro and also in some other project's directory.  The monitor will poll every "1 minute" for updated files in the directories and record "sessions" or stretches of continuous activity.  A session is considered to be active as long as updates to files in the directory occur at least every "5 minutes".  
+
+If activity is suspended for more than the idle interval, a new session is started and recorded.  Activity is detected when any file in a project's directory has its mtime changed.
+
+== MONITORING ACTIVITY:
+
+All baby-bro functionality is accessed through one executable: 'bro', which is installed in your gem's executable path.
+
+To start baby-bro:
+
+  baby-bro start -t
+  
+This will start baby-bro's monitor in the background.  The -t flag causes the monitor to output status to standard output and is useful to see what the monitor is detecting.  Omit this flag to keep baby-bro quiet.
+
+To stop baby-bro:
+
+  baby-bro stop
+  
+To re-read the config file:
+
+  baby-bro restart
+  
+== REPORTING:
+
+To view a report of activity sessions recorded by baby-bro:
+
+  baby-bro report
+  
+To view the help message and see other options:
+
+  baby-bro --help
+
+That's it.  You can add as many projects to your config as you like.  They will all get monitored by baby-bro.
+
+== TODO:
+
+* Enable reporting of specific date ranges
+* Default reports to the current day
+* Enable option to export reports in .csv, .json and .yaml file formats.
+* Add some tests.
+
+== CONTRIBUTING:
+
+Contributions to Baby Bro are welcome.  All pull requests will be considered.  Feel free to e-mail me first about ideas or suggestions:  billdoughty AT capitalthought DOT com.
+
+== LICENSE:
+
+  Copyright 2010 Capital Thought, LLC
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use any part of this software or its source code except 
+  in compliance with the License.  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.

data/Rakefile

@@ -0,0 +1,55 @@
+require 'rubygems'
+# gem 'hoe', '>= 2.1.0'
+# require 'hoe'
+require 'fileutils'
+require './lib/baby-bro'
+
+# Hoe.plugin :newgem
+# # Hoe.plugin :website
+# # Hoe.plugin :cucumberfeatures
+# 
+# # Generate all the Rake tasks
+# # Run 'rake -T' to see list of generated tasks (from gem root directory)
+# $hoe = Hoe.spec 'baby-bro' do
+#   self.developer 'Bill Doughty', 'billdoughty@capitalthought.com'
+#   self.post_install_message = 'PostInstall.txt' # TODO remove  post-install message not required
+#   self.rubyforge_name       = self.name # TODO this is default value
+#   self.summary = %Q{File activity monitor for automatic time tracking.}
+#   self.description = %Q{Baby Bro monitors the timestamps changes for files in directories on your filesystem and records time spent actively working in those directories.}
+#   # self.extra_deps         = [['activesupport','>= 2.0.2']]
+# 
+# end
+# 
+# require 'newgem/tasks'
+# Dir['tasks/**/*.rake'].each { |t| load t }
+# 
+# TODO - want other tests/tasks run by default? Add them to the list
+# remove_task :default
+# task :default => [:spec, :features]
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name = "baby-bro"
+    gem.summary = %Q{File activity monitor for time tracking.}
+    gem.description = %Q{Baby Bro monitors the timestamps changes for files in directories on your filesystem and records activity and estimates time spent actively working in those directories.}
+    gem.email = "billdoughty@capitalthought.com"
+    gem.homepage = "http://github.com/capitalthought/baby-bro"
+    gem.authors = ["Bill Doughty"]
+    gem.add_development_dependency "rspec", ">= 1.3.1"
+    # gem is a Gem::Specification... see http://www.rubygems.org/read/chapter/20 for additional settings
+  end
+  Jeweler::GemcutterTasks.new
+rescue LoadError
+  puts "Jeweler (or a dependency) not available. Install it with: gem install jeweler"
+end
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  version = File.exist?('VERSION') ? File.read('VERSION') : ""
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "baby-bro #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end                                                                                            

data/VERSION

@@ -0,0 +1 @@
+0.0.1

data/baby-bro.gemspec

@@ -0,0 +1,73 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run the gemspec command
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{baby-bro}
+  s.version = "0.0.1"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Bill Doughty"]
+  s.date = %q{2010-12-07}
+  s.default_executable = %q{bro}
+  s.description = %q{Baby Bro monitors the timestamps changes for files in directories on your filesystem and records activity and estimates time spent actively working in those directories.}
+  s.email = %q{billdoughty@capitalthought.com}
+  s.executables = ["bro"]
+  s.extra_rdoc_files = [
+    "README.rdoc"
+  ]
+  s.files = [
+    ".gitignore",
+     "History.txt",
+     "Manifest.txt",
+     "PostInstall.txt",
+     "README.rdoc",
+     "Rakefile",
+     "VERSION",
+     "baby-bro.gemspec",
+     "bin/bro",
+     "config/babybrorc.example",
+     "lib/baby-bro.rb",
+     "lib/baby-bro/base_config.rb",
+     "lib/baby-bro/exec.rb",
+     "lib/baby-bro/files.rb",
+     "lib/baby-bro/hash_object.rb",
+     "lib/baby-bro/monitor.rb",
+     "lib/baby-bro/monitor_config.rb",
+     "lib/baby-bro/project.rb",
+     "lib/baby-bro/reporter.rb",
+     "lib/baby-bro/session.rb",
+     "lib/extensions/fixnum.rb",
+     "script/console",
+     "script/destroy",
+     "script/generate",
+     "spec/baby-bro_spec.rb",
+     "spec/spec.opts",
+     "spec/spec_helper.rb",
+     "tasks/rspec.rake"
+  ]
+  s.homepage = %q{http://github.com/capitalthought/baby-bro}
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.7}
+  s.summary = %q{File activity monitor for time tracking.}
+  s.test_files = [
+    "spec/baby-bro_spec.rb",
+     "spec/spec_helper.rb"
+  ]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_development_dependency(%q<rspec>, [">= 1.3.1"])
+    else
+      s.add_dependency(%q<rspec>, [">= 1.3.1"])
+    end
+  else
+    s.add_dependency(%q<rspec>, [">= 1.3.1"])
+  end
+end
+

data/bin/bro

@@ -0,0 +1,9 @@
+#!/usr/bin/env ruby
+# The command line Haml parser.
+
+$LOAD_PATH.unshift File.dirname(__FILE__) + '/../lib'
+require 'baby-bro'
+require 'baby-bro/exec'
+
+opts = BabyBroExec::Exec::Bro.new(ARGV)
+opts.parse!

data/config/babybrorc.example

@@ -0,0 +1,10 @@
+# Baby Bro Config
+---
+:data_directory: ~/.babybro
+:polling_interval: 1 minute
+:idle_interval: 5 minutes
+:projects:
+- :name: Baby Bro
+  :directory: ~/src/capitalthought/baby-bro
+- :name: Some Other Project
+  :directory: ~/src/capitalthought/sop

data/lib/baby-bro.rb

@@ -0,0 +1,11 @@
+$:.unshift(File.dirname(__FILE__)) unless $:.include?(File.dirname(__FILE__)) || $:.include?(File.expand_path(File.dirname(__FILE__)))
+$:.unshift(File.join(File.dirname(__FILE__), 'baby-bro')) unless $:.include?( $:.unshift(File.join(File.dirname(__FILE__), 'baby-bro')) )
+
+module BabyBro
+  VERSION = '0.0.1'
+end
+
+require 'extensions/fixnum'
+require 'baby-bro/hash_object'
+require 'baby-bro/monitor'
+require 'baby-bro/reporter'

data/lib/baby-bro/base_config.rb

@@ -0,0 +1,64 @@
+module BabyBro
+  module BaseConfig
+    def self.included( base )
+      base.send(:include, Files)
+    end
+    
+    def process_base_config( options )
+      @config_file = options[:config_file]
+      config = YAML.load( File.open( @config_file ) )
+      @last_config_update = file_timestamp( @config_file )
+      @projects = config[:projects]
+      @data_directory = config[:data][:directory]
+      raise "Data directory not specified" unless @data_directory
+      @data_directory.gsub!('~', ENV["HOME"])
+      # puts "Data Directory: #{@data_directory}"
+      config[:data][:pid_file] = File.join(@data_directory, ".pid")
+      raise "No projects specified" unless @projects
+      validate_projects( @projects )
+      puts "Config file #{@config_file} loaded."
+      options.merge(config)
+    end
+    
+    
+    def validate_projects( projects )
+      projects.each_with_index do |project, i|
+        raise "No name given for project #{i}" unless project[:name]
+        raise "No directory given for project #{project[:name]}" unless project[:directory]
+        project[:directory].gsub!('~', ENV["HOME"])
+        begin
+          Dir.entries( project[:directory] )
+        rescue
+          raise "Invalid directory #{project[:directory]} for project #{project[:name]}"
+        end
+      end
+      project_names = projects.map{|p| p[:name]}
+      project_dirs = projects.map{|p| p[:directory]}
+      dup_names = project_names - project_names.uniq
+      dup_dirs = project_dirs - project_dirs.uniq
+      raise "ERROR: Duplicate project name(s) not allowed: #{dup_names.join(", ")}" if dup_names.any?
+      raise "ERROR: Duplicate project directories(s) allowed: #{dup_dirs.join(", ")}" if dup_dirs.any?
+    end    
+    
+    def initialize_database
+      FileUtils.mkdir_p( @data_directory )
+      version_file = File.join(@data_directory, '.version')
+      unless File.exist?(version_file)
+        File.open(version_file, 'w') do |f|
+          f.write(::BabyBro::VERSION.to_s)
+        end
+      end
+      @projects.map!{|p| Project.new(p, @config)}
+    end
+    
+    def base_config_changed
+      if @last_config_update > file_timestamp( @config_file )
+        puts "config new"
+        return true
+      else
+        return false
+      end
+    end
+    
+  end
+end

data/lib/baby-bro/exec.rb

@@ -0,0 +1,208 @@
+require 'optparse'
+require 'fileutils'
+require 'pp'
+require 'yaml'
+
+module BabyBroExec
+  # This module handles the various BabyBro executables (`baby-bro`, etc).
+  module Exec
+    class Generic
+      # @param args [Array<String>] The command-line arguments
+      def initialize(args)
+        @args = args
+        @options = {}
+      end
+
+      # Parses the command-line arguments and runs the executable.
+      # Calls `Kernel#exit` at the end, so it never returns.
+      #
+      # @see #parse
+      def parse!
+        begin
+          parse
+        rescue Exception => e
+          raise e if @options[:tron] || e.is_a?(SystemExit) || true
+
+          $stderr.print "#{e.class}: " unless e.class == RuntimeError
+          $stderr.puts "#{e.message}"
+          $stderr.puts "  Use --tron for stacktrace."
+          exit 1
+        end
+        exit 0
+      end
+
+      # Parses the command-line arguments and runs the executable.
+      # This does not handle exceptions or exit the program.
+      #
+      # @see #parse!
+      def parse
+        @opts = OptionParser.new(&method(:set_opts))
+        @opts.parse!(@args)
+
+        process_result
+
+        @options
+      end
+
+      # @return [String] A description of the executable
+      def to_s
+        @opts.to_s
+      end
+
+      protected
+
+      # Finds the line of the source template
+      # on which an exception was raised.
+      #
+      # @param exception [Exception] The exception
+      # @return [String] The line number
+      def get_line(exception)
+        # SyntaxErrors have weird line reporting
+        # when there's trailing whitespace,
+        # which there is for BabyBro documents.
+        return (exception.message.scan(/:(\d+)/).first || ["??"]).first if exception.is_a?(::SyntaxError)
+        (exception.backtrace[0].scan(/:(\d+)/).first || ["??"]).first
+      end
+
+      # Tells optparse how to parse the arguments
+      # available for all executables.
+      #
+      # This is meant to be overridden by subclasses
+      # so they can add their own options.
+      #
+      # @param opts [OptionParser]
+      def set_opts(opts)
+        opts.banner = <<END
+Usage: bro [options] [command] [date]
+
+Command is one of the following:
+
+  start - starts the monitor process in the background
+  stop - stops the monitor process
+  status - prints the status of the monitor process
+  restart - restarts the monitor process (forces re-reading of config file)
+  report - prints out time tracking reports
+  
+The date argument is optional and only used for the report command.  
+It must be a valid date string.  When passed, the date argument will 
+cause reports to be printed for only that date.
+
+END
+
+        @options[:config_file] = "#{ENV["HOME"]}/.babybrorc"
+        @options[:tron] = false
+        opts.on('-c', '--config FILE', "Use this config file.  default is #{@options[:config_file]}") do |config_file|
+          @options[:config_file] = config_file
+        end
+
+        opts.on('-t', '--tron', :NONE, 'Trace on.  Show debug output and a full stack trace on error') do
+          @options[:tron] = true
+        end
+
+        opts.on('-f', '--force', :NONE, 'Force starting of monitor when PID file is stale.') do
+          @options[:force_start] = true
+        end
+
+        opts.on_tail("-?", "-h", "--help", "Show this message") do
+          puts opts
+          exit
+        end
+
+        opts.on_tail("-v", "--version", "Print version") do
+          puts("BabyBro #{::BabyBro::VERSION}")
+          exit
+        end
+      end
+
+      # Processes the options set by the command-line arguments.
+      #
+      # This is meant to be overridden by subclasses
+      # so they can run their respective programs.
+      def process_result
+      end
+
+      COLORS = { :red => 31, :green => 32, :yellow => 33 }
+
+      # Prints a status message about performing the given action,
+      # colored using the given color (via terminal escapes) if possible.
+      #
+      # @param name [#to_s] A short name for the action being performed.
+      #   Shouldn't be longer than 11 characters.
+      # @param color [Symbol] The name of the color to use for this action.
+      #   Can be `:red`, `:green`, or `:yellow`.
+      def puts_action(name, color, arg)
+        printf color(color, "%11s %s\n"), name, arg
+      end
+
+      # Wraps the given string in terminal escapes
+      # causing it to have the given color.
+      # If terminal esapes aren't supported on this platform,
+      # just returns the string instead.
+      #
+      # @param color [Symbol] The name of the color to use.
+      #   Can be `:red`, `:green`, or `:yellow`.
+      # @param str [String] The string to wrap in the given color.
+      # @return [String] The wrapped string.
+      def color(color, str)
+        raise "[BUG] Unrecognized color #{color}" unless COLORS[color]
+
+        # Almost any real Unix terminal will support color,
+        # so we just filter for Windows terms (which don't set TERM)
+        # and not-real terminals, which aren't ttys.
+        return str if ENV["TERM"].nil? || ENV["TERM"].empty? || !STDOUT.tty?
+        return "\e[#{COLORS[color]}m#{str}\e[0m"
+      end
+
+      private
+
+      def open_file(filename, flag = 'r')
+        return if filename.nil?
+        flag = 'wb' if @options[:unix_newlines] && flag == 'w'
+        File.open(filename, flag)
+      end
+
+      def handle_load_error(err)
+        dep = err.message[/^no such file to load -- (.*)/, 1]
+        raise err if @options[:tron] || dep.nil? || dep.empty?
+        $stderr.puts <<MESSAGE
+Required dependency #{dep} not found!
+    Run "gem install #{dep}" to get it.
+  Use --tron for stacktrace.
+MESSAGE
+        exit 1
+      end
+    end
+    
+    class Bro < Generic
+      # Processes the options set by the command-line arguments.
+      #
+      # This is meant to be overridden by subclasses
+      # so they can run their respective programs.
+      def process_result
+        args = @args.dup
+        command = args.shift
+        case command
+        when 'start', nil
+          monitor = ::BabyBro::Monitor.new( @options )
+          monitor.start
+        when 'stop'
+          monitor = ::BabyBro::Monitor.new( @options )
+          monitor.stop
+        when 'status'
+          monitor = ::BabyBro::Monitor.new( @options )
+          monitor.status
+        when 'restart'
+          monitor = ::BabyBro::Monitor.new( @options )
+          monitor.stop && monitor.start
+        when 'report'
+          reporter = ::BabyBro::Reporter.new( @options, args )
+          reporter.run
+        else
+          puts "Unknown command: #{command}"
+        end
+      end
+
+    end
+
+  end
+end

data/lib/baby-bro/files.rb

@@ -0,0 +1,31 @@
+module BabyBro
+  module Files
+
+    def file_timestamp( filename )
+      file = File.new(filename)
+      mtime = file.mtime
+      file.close
+      mtime
+    end
+    
+    def touch_file( filename, time )
+      `touch -t #{time.strftime("%Y%m%d%H%M.%S")} #{filename}`
+    end
+    
+    # returns files in the specified directory
+    def find_files( directory, pattern='*')
+     `find #{directory} -name "#{pattern}"`.split("\n").reject{|f| f==directory}
+    end
+
+    # returns files in the specified directory that are newer than the specified file
+    def find_files_newer_than_file( directory, filename )
+     `find #{directory} -newer #{filename}`.split("\n")
+    end
+
+    # returns files in the specified directory that are newer than the time expression
+    # time_interval_expression is in english, eg.  "15 minutes"
+    def find_recent_files( directory, time_interval_expression )
+     `find '#{directory}' -newermt "#{time_interval_expression} ago"`.split("\n")
+    end
+  end
+end

data/lib/baby-bro/hash_object.rb

@@ -0,0 +1,41 @@
+class HashObject
+  def initialize hash_obj, no_exception_on_missing_key = false
+    @hash_obj = hash_obj
+    @no_exception_on_missing_key = no_exception_on_missing_key
+  end    
+  
+  def [] key
+    @hash_obj[key]
+  end
+  
+  def keys
+    return @hash_obj.keys
+  end
+  
+  def merge hash
+    HashObject.new(@hash_obj.merge( hash ))
+  end
+  
+  def merge! hash
+    @hash_obj.merge!( hash )
+    self
+  end
+
+  def method_missing method, *args
+    key = method.to_s
+    if @hash_obj.keys.include? key
+      obj = @hash_obj[key]
+      obj = HashObject.new(obj) if obj.is_a? Hash
+      return obj
+    elsif @hash_obj.keys.include? key.to_sym
+      obj = @hash_obj[key.to_sym]
+      obj = HashObject.new(obj) if obj.is_a? Hash
+      return obj
+    elsif matches = key.match( /(\w*)=/ )
+      key = matches[1].to_sym
+      @hash_obj[key]=*args
+    else
+      raise "No field in Hash object: #{key}" unless @no_exception_on_missing_key
+    end
+  end
+end

data/lib/baby-bro/monitor.rb

@@ -0,0 +1,140 @@
+%w(project base_config monitor_config).each do |file|
+  require File.join(File.dirname(__FILE__),file)
+end
+
+module BabyBro
+  class Monitor
+    include BaseConfig
+    include MonitorConfig
+    attr_accessor :data_directory, :projects, :config
+
+    def initialize( options )
+      load_config( options )
+    end
+    
+    def start
+      if pid = active_pid && !( @config.force_start )
+        puts "ERROR: PID file detected.  Cannot start baby-bro."
+        puts "Check if process #{pid} is running."
+        puts "If it is not, delete #{pid_file} and try starting baby-bro again."
+        return false
+      end
+      @continue = true
+      @previous_SIGINT_handler = Kernel.trap( "SIGINT" ) {}
+      Kernel.trap( "SIGINT" ) do
+        print "Baby Bro monitor is shutting down..."
+        $stdout.flush
+        @continue = false; 
+        if @previous_SIGINT_handler != "DEFAULT" && @previous_SIGINT_handler != "IGNORE"
+          Kernel.trap( "SIGINT" ) { @previous_SIGINT_handler.call }
+        end
+      end
+      pid = Process.fork
+      if pid.nil? then
+        # In child
+        main
+      else
+        # In parent
+        Process.detach(pid)
+        create_pid_file( pid )
+        puts "Baby Bro monitor started."
+      end
+      return true
+    end
+    
+    def stop
+      unless pid = active_pid
+        puts "ERROR: No pid file found for Baby Bro (#{pid_file})."
+        puts "If Baby Bro monitor is running, you need to kill it manually."
+        return false
+      end
+      begin
+        puts "Sending SIGINT to Baby Bro monitor process #{pid}."
+        Process.kill( "SIGINT", pid )
+      rescue Errno::ESRCH
+        puts "No Baby Bro monitor process found with PID #{pid}."
+        puts "Removing PID file #{pid_file}."
+        remove_pid_file
+      end
+      sleep_time = 10.0
+      while( true )
+        begin
+          Process.kill( 0, pid ) # check if the process is still alive, raises Errno::ESRCH if not
+          sleep 0.1
+          sleep_time -= 0.1
+          if sleep_time == 0
+            Process.kill( "SIGKILL", pid ) 
+            puts "Baby Bro monitor process #{pid} not responding to SIGINT."
+            puts "Sending SIGKILL to Baby Bro monitor process #{pid}."
+          end
+        rescue Errno::ESRCH
+          break
+        end
+      end
+      puts "Baby Bro monitor terminated."
+      return true
+    end
+
+    def status
+      if pid = active_pid
+        begin
+          Process.kill( 0, pid ) # check if the process is still alive, raises Errno::ESRCH if not
+          puts "Baby Bro monitor process is running with PID #{pid}."
+        rescue Errno::ESRCH
+          puts "PID file #{pidfile} found, but no Baby Bro monitor process is running with PID #{pid}."
+          remove_pid_file
+          puts "PID file removed."
+        end
+      else
+        puts "Baby Bro monitor process is not running."
+      end
+    end
+    
+    private
+      def main
+        while( @continue )
+          load_config( @config ) if base_config_changed
+          self.projects.each do |project|
+            # tron "Polling #{project.name}: #{project.directory}"
+            project.log_activity
+          end
+          sleep @polling_interval
+        end
+        sleep 5
+        remove_pid_file
+        puts "complete."
+      end
+      
+      def active_pid
+        File.exist?( pid_file ) && File.read(pid_file).to_i
+      end
+      
+      def pid_file
+        self.config.data.pid_file
+      end
+      
+      def remove_pid_file
+        File.delete( pid_file )
+      end
+      
+      def create_pid_file( pid )
+        File.open( pid_file, 'w' ) do |f|
+          f.write( pid.to_s )
+        end
+      end
+      
+      def load_config( options )
+        @config = HashObject.new( process_base_config( options ), true )
+        process_monitor_config( @config )
+        initialize_database
+      end
+
+      def tron string
+        $stdout.puts if @config && @config.tron
+      end
+
+      def tron string
+        $stdout.puts if @config && @config.tron
+      end
+  end
+end

data/lib/baby-bro/monitor_config.rb

@@ -0,0 +1,31 @@
+module BabyBro
+  module MonitorConfig
+    def process_monitor_config( config )
+      @polling_interval = eval(config[:monitor][:polling_interval].gsub(/\s/, '.')) || 5
+    end
+    
+    def validate_projects( projects )
+      projects.each_with_index do |project, i|
+        raise "No name given for project #{i}" unless project[:name]
+        raise "No directory given for project #{project[:name]}" unless project[:directory]
+        project[:directory].gsub!('~', ENV["HOME"])
+        begin
+          Dir.entries( project[:directory] )
+        rescue
+          raise "Invalid directory #{project[:directory]} for project #{project[:name]}"
+        end
+      end
+      project_names = projects.map{|p| p[:name]}
+      project_dirs = projects.map{|p| p[:directory]}
+      dup_names = project_names - project_names.uniq
+      dup_dirs = project_dirs - project_dirs.uniq
+      raise "ERROR: Duplicate project name(s) not allowed: #{dup_names.join(", ")}" if dup_names.any?
+      raise "ERROR: Duplicate project directories(s) allowed: #{dup_dirs.join(", ")}" if dup_dirs.any?
+    end    
+    
+    def initialize_databases
+      @projects.map!{|p| Project.new(p, config)}
+    end
+    
+  end
+end

data/lib/baby-bro/project.rb

@@ -0,0 +1,85 @@
+%w(files session).each do |file|
+  require File.join(File.dirname(__FILE__),file)
+end
+
+module BabyBro
+  class Project < HashObject
+    attr_accessor :config
+    include Files
+    
+    def initialize( hash, config )
+      super hash
+      @config = config
+      self.data_dir = File.join( config.data.directory, self.name.gsub(' ', '_') )
+      FileUtils.mkdir_p( self.data_dir )
+      self.last_checked_file = File.join( self.data_dir, "last_checked" )
+      FileUtils.touch( self.last_checked_file ) unless File.exist?( self.last_checked_file )
+      self.monitor_start_file = File.join( self.data_dir, "monitor_start" )
+      FileUtils.touch( self.monitor_start_file ) unless File.exist?( self.monitor_start_file )
+      self.reports_dir = File.join( self.data_dir, "reports" )
+      FileUtils.mkdir_p( self.reports_dir )
+      self.sessions_dir = File.join( self.data_dir, "sessions" )
+      FileUtils.mkdir_p( self.sessions_dir )
+    end
+    
+    def last_checked
+      file_timestamp self.last_checked_file
+    end
+    
+    def update_last_checked ( time=Time.now )
+      touch_file( self.last_checked_file, time )
+    end
+    
+    def get_updated_files
+      files = find_files_newer_than_file(self.directory, self.last_checked_file)
+      files
+    end
+    
+    def find_active_session
+      session_files = find_recent_files(self.sessions_dir, self.config.monitor.idle_interval)
+      session_files = session_files.reject{|e| e.strip!;e.nil? || e=="" || e == self.sessions_dir}
+      if session_files.length > 1
+        session_files.sort!
+      end
+      Session.load_session(session_files.last) if session_files.any?
+    end
+
+    def sessions
+      session_files = find_files( self.sessions_dir )
+      session_files.sort.map{|f| Session.load_session(f)}
+    end
+    
+    def log_activity
+      check_time = Time.now
+      updated_files = self.get_updated_files
+      updated_files.each do |file|
+        tron file
+      end
+      if updated_files.any?
+        process_activity( check_time )
+      end
+      update_last_checked( check_time-1 )
+    end
+    
+    def process_activity( check_time )
+      if session = find_active_session
+        session.update_activity( check_time )        
+        if session.start_date < Date.today # start a new session for today
+          session = Session.create_session( check_time, self.sessions_dir )
+        end
+      else
+        session = Session.create_session( check_time, self.sessions_dir )
+      end
+      tron "#{self.name} Session Activity: "
+      tron "  start_time: #{session.start_time}"
+      tron "  duration: #{session.duration_in_english}"
+    end
+    
+    private
+     def tron string
+       if config.tron
+         $stdout.puts string 
+       end
+     end
+  end
+end

data/lib/baby-bro/reporter.rb

@@ -0,0 +1,49 @@
+%w(project base_config).each do |file|
+  require File.join(File.dirname(__FILE__),file)
+end
+
+module BabyBro
+  class Reporter
+    include BaseConfig
+    attr_accessor :data_directory, :projects, :config
+
+    def initialize( options, args )
+      @config = HashObject.new( process_base_config( options ) )
+      process_reporting_config( @config )
+      initialize_database
+    end
+    
+    def run
+      @projects.each do |project|
+        print_project_report( project )
+      end
+    end
+    
+    private
+      def process_reporting_config( config )
+      end
+      
+      def print_project_report( project, date=nil )
+        $stdout.puts
+        $stdout.puts "#{project.name}"
+        $stdout.puts "="*project.name.size
+        cumulative_time = 0
+        sessions = project.sessions
+        if sessions.any?
+          sessions_by_date = sessions.group_by(&:start_date)
+          sessions_by_date.keys.sort.each do |date|
+            sessions = sessions_by_date[date].sort
+            $stdout.puts "  #{date.strftime("%Y-%m-%d")}"
+            sessions.each do |session|
+              $stdout.puts "      #{session.start_time.strftime("%I:%M %p")} - #{session.duration_in_english}"
+              cumulative_time += session.duration
+            end
+            $stdout.puts "    Total:  #{Session.duration_in_english(sessions.inject(0){|sum,n| sum = sum+n.duration})}"
+          end
+          $stdout.puts "Grand Total: #{Session.duration_in_english(cumulative_time)}"
+        else
+          $stdout.puts "  No sessions for this project."
+        end
+      end
+  end
+end

data/lib/baby-bro/session.rb

@@ -0,0 +1,93 @@
+module BabyBro
+  class Session
+    include Files
+    attr_accessor :start_time, :start_date
+    
+    def self.create_session( time, dirname )
+      session = Session.new( time, dirname )
+    end
+    
+    def self.load_session( session_filename )
+      Session.new( session_filename )
+    end
+    
+    def update_activity( time )
+      touch_file( self.filename, time )
+    end
+    
+    def filename
+      basename = @start_time.strftime("%Y-%m-%d_%H:%M:%S")
+      File.join(@dirname, basename)
+    end
+    
+    def last_activity
+      file_timestamp(self.filename)
+    end
+    
+    def destroy
+      File.delete( self.filename )
+    end
+    
+    def duration
+      duration = last_activity - @start_time
+      duration < 0 ? 0 : duration
+    end
+
+    def duration_in_english
+      Session.duration_in_english( self.duration )
+    end
+    
+    def self.duration_in_english( duration )
+      time = []
+      time_duration = duration
+      days = hours = minutes = seconds = 0
+      if time_duration > 1.day
+        days = (time_duration / 1.day).to_i
+        time_duration -= days.days
+        time << "#{days}d" if days != 0
+      end
+      if time_duration > 1.hour
+        hours = (time_duration / 1.hour).to_i
+        time_duration -= hours.hours
+        time << "#{hours}h" if hours != 0
+      end
+      if time_duration > 1.minute
+        minutes = (time_duration / 1.minute).to_i
+        time_duration -= minutes.minutes
+        time << "#{minutes}m"
+      end
+      time << "#{time_duration.to_i}s"
+      breakdown = time.join(' ')
+      output = "#{"%05.2f" % (duration/1.hour)} hours or #{breakdown}"
+    end
+    
+    def <=> b
+      self.start_date <=> b.start_date
+    end
+    
+    private 
+    def initialize( time_or_session_filename, dirname=nil )
+      if time_or_session_filename.is_a? Time
+        @start_time = time_or_session_filename
+        @start_date = Date.civil( @start_time.year, @start_time.month, @start_time.day )
+        @dirname = dirname
+        self.update_activity( @start_time )
+      elsif time_or_session_filename.is_a? String
+        date_string = File.basename( time_or_session_filename )
+        @dirname = File.dirname( time_or_session_filename )
+        date_parts, time_parts = date_string.split('_')
+        hour, minutes, seconds = time_parts.split(':').map(&:to_i)
+        year, month, day = date_parts.split('-').map(&:to_i)
+        @start_time = Time.local( year, month, day, hour, minutes, seconds )
+        @start_date = Date.civil( year, month, day )
+        unless self.filename == time_or_session_filename
+          puts "filename: #{self.filename}"
+          puts "time_or_session_filename: #{time_or_session_filename}"
+          raise "bad filename for time" 
+        end
+      else
+        raise "Unknown Session initializer"
+      end
+    end
+  end
+end

data/lib/extensions/fixnum.rb

@@ -0,0 +1,18 @@
+class Fixnum
+  def seconds
+    self
+  end
+  alias :second :seconds
+  def minutes
+    self * 60
+  end
+  alias :minute :minutes
+  def hours
+    self * 60 * 60
+  end
+  alias :hour :hours
+  def days
+    self * 60 * 60 * 24
+  end
+  alias :day :days
+end

data/script/console

@@ -0,0 +1,10 @@
+#!/usr/bin/env ruby
+# File: script/console
+irb = RUBY_PLATFORM =~ /(:?mswin|mingw)/ ? 'irb.bat' : 'irb'
+
+libs =  " -r irb/completion"
+# Perhaps use a console_lib to store any extra methods I may want available in the cosole
+# libs << " -r #{File.dirname(__FILE__) + '/../lib/console_lib/console_logger.rb'}"
+libs <<  " -r #{File.dirname(__FILE__) + '/../lib/baby-bro.rb'}"
+puts "Loading baby-bro gem"
+exec "#{irb} #{libs} --simple-prompt"

data/script/destroy

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+APP_ROOT = File.expand_path(File.join(File.dirname(__FILE__), '..'))
+
+begin
+  require 'rubigen'
+rescue LoadError
+  require 'rubygems'
+  require 'rubigen'
+end
+require 'rubigen/scripts/destroy'
+
+ARGV.shift if ['--help', '-h'].include?(ARGV[0])
+RubiGen::Base.use_component_sources! [:rubygems, :newgem, :newgem_theme, :test_unit]
+RubiGen::Scripts::Destroy.new.run(ARGV)

data/script/generate

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+APP_ROOT = File.expand_path(File.join(File.dirname(__FILE__), '..'))
+
+begin
+  require 'rubigen'
+rescue LoadError
+  require 'rubygems'
+  require 'rubigen'
+end
+require 'rubigen/scripts/generate'
+
+ARGV.shift if ['--help', '-h'].include?(ARGV[0])
+RubiGen::Base.use_component_sources! [:rubygems, :newgem, :newgem_theme, :test_unit]
+RubiGen::Scripts::Generate.new.run(ARGV)

data/spec/baby-bro_spec.rb

@@ -0,0 +1,11 @@
+require File.dirname(__FILE__) + '/spec_helper.rb'
+
+# Time to add your specs!
+# http://rspec.info/
+describe "Place your specs here" do
+  
+  it "find this spec in spec directory" do
+    # violated "Be sure to write your specs"
+  end
+  
+end

data/spec/spec.opts

@@ -0,0 +1 @@
+--colour

data/spec/spec_helper.rb

@@ -0,0 +1,10 @@
+begin
+  require 'spec'
+rescue LoadError
+  require 'rubygems' unless ENV['NO_RUBYGEMS']
+  gem 'rspec'
+  require 'spec'
+end
+
+$:.unshift(File.dirname(__FILE__) + '/../lib')
+require 'baby-bro'

data/tasks/rspec.rake

@@ -0,0 +1,32 @@
+begin
+  require 'spec'
+rescue LoadError
+  require 'rubygems' unless ENV['NO_RUBYGEMS']
+  require 'spec'
+end
+begin
+  require 'spec/rake/spectask'
+rescue LoadError
+  puts <<-EOS
+To use rspec for testing you must install rspec gem:
+    gem install rspec
+EOS
+  exit(0)
+end
+
+desc "Run the specs under spec/models"
+Spec::Rake::SpecTask.new do |t|
+  t.spec_opts = ['--options', "spec/spec.opts"]
+  t.spec_files = FileList['spec/**/*_spec.rb']
+end
+
+Spec::Rake::SpecTask.new(:rcov) do |spec|
+  spec.libs << 'lib' << 'spec'
+  spec.pattern = 'spec/**/*_spec.rb'
+  spec.rcov = true
+end
+
+task :spec => :check_dependencies
+
+task :default => :spec
+

metadata

@@ -0,0 +1,110 @@
+--- !ruby/object:Gem::Specification 
+name: baby-bro
+version: !ruby/object:Gem::Version 
+  hash: 29
+  prerelease: false
+  segments: 
+  - 0
+  - 0
+  - 1
+  version: 0.0.1
+platform: ruby
+authors: 
+- Bill Doughty
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-12-07 00:00:00 -06:00
+default_executable: bro
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 25
+        segments: 
+        - 1
+        - 3
+        - 1
+        version: 1.3.1
+  type: :development
+  version_requirements: *id001
+description: Baby Bro monitors the timestamps changes for files in directories on your filesystem and records activity and estimates time spent actively working in those directories.
+email: billdoughty@capitalthought.com
+executables: 
+- bro
+extensions: []
+
+extra_rdoc_files: 
+- README.rdoc
+files: 
+- .gitignore
+- History.txt
+- Manifest.txt
+- PostInstall.txt
+- README.rdoc
+- Rakefile
+- VERSION
+- baby-bro.gemspec
+- bin/bro
+- config/babybrorc.example
+- lib/baby-bro.rb
+- lib/baby-bro/base_config.rb
+- lib/baby-bro/exec.rb
+- lib/baby-bro/files.rb
+- lib/baby-bro/hash_object.rb
+- lib/baby-bro/monitor.rb
+- lib/baby-bro/monitor_config.rb
+- lib/baby-bro/project.rb
+- lib/baby-bro/reporter.rb
+- lib/baby-bro/session.rb
+- lib/extensions/fixnum.rb
+- script/console
+- script/destroy
+- script/generate
+- spec/baby-bro_spec.rb
+- spec/spec.opts
+- spec/spec_helper.rb
+- tasks/rspec.rake
+has_rdoc: true
+homepage: http://github.com/capitalthought/baby-bro
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+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.3.7
+signing_key: 
+specification_version: 3
+summary: File activity monitor for time tracking.
+test_files: 
+- spec/baby-bro_spec.rb
+- spec/spec_helper.rb