blastr 0.0.11 → 0.0.12

data/History.txt

@@ -1,3 +1,10 @@
+== 0.0.12 2009-01-19
+
+* Removed extra_dev_deps from newgem configuration (should fix the implicit
+  dependencies not being found during "sudo gem install").
+* The software version and a copyright statement is now printed out when
+  starting Blastr.
+
 == 0.0.11 2009-01-19
 
 * Fix for the 0.0.10 release, which is broken thanks to my still being new

data/README.rdoc

@@ -1,13 +1,18 @@
-= DESCRIPTION:
+= Blastr, the audible commit radiator
+
+== DESCRIPTION:
 
 Blastr observes a version control repository for commits and makes audible 
-announcements out of the commit messages. It currently supports Subversion 
-and Git on Linux and OS X, possibly on other UNIX-like operating systems as well.
+announcements out of the commit messages. It currently supports Subversion, 
+Git, and Mercurial on Linux and OS X, possibly on other UNIX-like operating 
+systems as well.
 
-== FEATURES:
+=== FEATURES:
 
-Blastr watches for incoming commits to a source repository and voices the commit 
-messages out loud.
+Blastr can observe a single "branch" (identified by a URL) by polling the
+repository for a commit log. Any new commits will be announced. When 
+starting Blastr, it can be told to start observing from a given revision
+or let it figure out the latest revision and start from that.
 
 The supported version control systems include:
 
@@ -20,7 +25,7 @@ The supported operating systems (for running Blastr) include:
 * Mac OS X
 * Linux (requires the eSpeak[http://espeak.sourceforge.net/] or Festival[http://www.cstr.ed.ac.uk/projects/festival/] text-to-speech utility)
 
-== SYNOPSIS:
+=== SYNOPSIS:
 
 Subversion:
 
@@ -40,11 +45,11 @@ Mercurial:
 
   blastr hg:http://hg.serpentine.com/tutorial/hello 2
 
-== REQUIREMENTS:
+=== REQUIREMENTS:
 
 Blastr depends on the git[http://git.rubyforge.org/] gem (>= 1.0.5).
 This dependency should be installed automatically when you install
-Blastr with <tt>gem install blastr</tt>.
+Blastr.
 
 Blastr also depends on the standard command line client for the source 
 repository in question being in the user's PATH. For example, in order 
@@ -52,27 +57,65 @@ to observe a Subversion repository the "svn" executable needs to be in
 PATH. For Git, the "git" executable needs to be in PATH. For Mercurial, 
 "hg" needs to be in PATH.
 
-== INSTALL:
+Furthermore, Blastr needs a text-to-speech utility for making those 
+commit messages audible. On Mac OS X Blastr uses the built-in "say" 
+utility so Mac users don't need to worry about this. On Linux, Blastr
+can utilize Festival[http://www.cstr.ed.ac.uk/projects/festival/] and 
+eSpeak[http://espeak.sourceforge.net/].
+
+=== INSTALL:
+
+First, install Blastr and its gem dependencies:
 
   sudo gem install blastr
 
-== KNOWN PROBLEMS AND GOTCHAS:
+Then, download and install your chosen version control system's toolset
+and make sure it's on your PATH when running Blastr.
+
+Then, if applicable, download and install a text-to-speech utility for
+your platform.
 
-Blastr doesn't treat non-ASCII characters in commit messages too well. 
+=== KNOWN PROBLEMS AND GOTCHAS:
+
+* Blastr currently does a full clone operation on every poll for 
+source repositories that don't support a purely remote operation (like
+"svn log [URL]"). This may take a while if your repository is big.
+* Blastr doesn't treat non-ASCII characters in commit messages too well. 
 In other words, the developers make no promises whatsoever regarding 
 Blastr's behavior when encountering weird Norwegian scribble.
+* Some folks might want to monitor multiple repositories or multiple 
+paths or branches within a repository at the same time. Currently,
+this is technically possible by running to instances of Blastr in
+parallel but every now and then those two instances will speak over
+each other (i.e. all you can hear is cacophony).
 
-== LICENSE:
+=== LICENSE:
 
 (The BSD License)
 
 Copyright (c) 2009, Lasse Koskela
 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.
-* Neither the name of this software nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.
-
-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 OWNER 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.
+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.
+* Neither the name of this software nor the names of its contributors may 
+  be used to endorse or promote products derived from this software without 
+  specific prior written permission.
+
+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 OWNER 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/Rakefile

@@ -11,9 +11,9 @@ $hoe = Hoe.new('blastr', Blastr::VERSION) do |p|
   p.extra_deps         = [
     ['git','>= 1.0.5'],
   ]
-  p.extra_dev_deps = [
-    ['newgem', ">= #{::Newgem::VERSION}"]
-  ]
+  #p.extra_dev_deps = [
+  #  ['newgem', ">= #{::Newgem::VERSION}"]
+  #]
   p.clean_globs |= %w[**/.DS_Store tmp *.log]
   path = (p.rubyforge_name == p.name) ? p.rubyforge_name : "\#{p.rubyforge_name}/\#{p.name}"
   #p.remote_rdoc_dir = File.join(path.gsub(/^#{p.rubyforge_name}\/?/,''), 'rdoc')

data/lib/blastr.rb

@@ -6,8 +6,24 @@ module Blastr
   require 'tts/tts.rb'
   require 'people/people.rb'
 
-  VERSION = '0.0.11'
+  VERSION = '0.0.12'
+  COPYRIGHT = 'Copyright (c) 2009, Lasse Koskela. All Rights Reserved.'
+  puts "Blastr #{VERSION}\n#{COPYRIGHT}\n"
   
+  def self.trap_and_exit(signal)
+    trap(signal) {
+      puts ""
+      exit 0
+    }
+  end
+  
+  def self.delete_at_exit(file_or_directory)
+    at_exit do
+      puts "Cleaning up leftovers: #{temp_dir}" if File.directory?(temp_dir) if $DEBUG
+      FileUtils.remove_dir(temp_dir, :force => true)
+    end
+  end
+
   class UsageError < ArgumentError
     
     USAGE_TEXT = <<EOS
@@ -39,13 +55,14 @@ EOS
 
   class Process
     def initialize(args)
+      Blastr::trap_and_exit("INT")
       validate(args)
       scm_url = args[0]
       @scm = Blastr::SourceControl.implementation_for(scm_url)
       @since_revision = @scm.as_revision(args[1]) if args.size > 1
       @since_revision = @scm.latest_revision unless args.size > 1
     end
-
+    
     def run
       puts "Polling #{@scm.name} commits since revision #{@since_revision}..."
       while true

data/lib/scm/git.rb

@@ -45,10 +45,12 @@ module Blastr::SourceControl
     def as_revision(arg)
       raise "Invalid revision: #{arg}" unless arg =~ /^(HEAD(~\d+)?)|([\d\w:-]+)$/
       obj = nil
+      revision = nil
       with_clone do |clone|
         obj = clone.object(arg.to_s)
+        revision = GitRevision.new(obj.sha, obj.date)
       end
-      GitRevision.new(obj.sha, obj.date)
+      revision
     end
   
     def latest_revision
@@ -69,11 +71,16 @@ module Blastr::SourceControl
     
     private
     def with_clone
-      clone = ::Git.clone(@git_url, Blastr::temp_dir)
-      clone.chdir do
-        yield clone
+      temp_dir = Blastr::temp_dir
+      Blastr::delete_at_exit(temp_dir)
+      begin
+        clone = ::Git.clone(@git_url, temp_dir)
+        clone.chdir do
+          yield clone
+        end
+      ensure
+        FileUtils.rm_rf(temp_dir, :secure => true)
       end
-      FileUtils.remove_dir(clone.dir, :force => true)
     end
   end
 

data/lib/scm/hg.rb

@@ -73,8 +73,10 @@ module Blastr::SourceControl
       end
     end
     
+    private
     def with_clone
       clone_dir = Blastr::temp_dir
+      Blastr::delete_at_exit(clone_dir)
       %x[hg clone #{@repo_url} #{clone_dir}]
       current_dir = Dir.pwd
       Dir.chdir(clone_dir)

data/lib/scm/svn.rb

@@ -58,11 +58,11 @@ module Blastr::SourceControl
     private
     def svn_log(since_revision = as_revision("1"))
       temp_file = Tempfile.new("svn.log").path
+      Blastr::delete_at_exit(temp_file)
       begin
         revision = "#{since_revision}:#{as_revision('HEAD')}"
         revision = as_revision("HEAD") if since_revision.to_s == as_revision("HEAD").to_s
-        cmd = "svn log #{@svn_url} -r #{revision} > #{temp_file}"
-        system(cmd)
+        %x[svn log #{@svn_url} -r #{revision} > #{temp_file}]
         return content_of(temp_file)
       ensure
         FileUtils.remove_file(temp_file)

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: blastr
 version: !ruby/object:Gem::Version 
-  version: 0.0.11
+  version: 0.0.12
 platform: ruby
 authors: 
 - Lasse Koskela
@@ -9,7 +9,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2009-01-18 00:00:00 +02:00
+date: 2009-01-19 00:00:00 +02:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -22,16 +22,6 @@ dependencies:
       - !ruby/object:Gem::Version 
         version: 1.0.5
     version: 
-- !ruby/object:Gem::Dependency 
-  name: newgem
-  type: :development
-  version_requirement: 
-  version_requirements: !ruby/object:Gem::Requirement 
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
-        version: 1.2.3
-    version: 
 - !ruby/object:Gem::Dependency 
   name: hoe
   type: :development
@@ -42,7 +32,7 @@ dependencies:
       - !ruby/object:Gem::Version 
         version: 1.8.0
     version: 
-description: Blastr observes a version control repository for commits and makes audible  announcements out of the commit messages. It currently supports Subversion  and Git on Linux and OS X, possibly on other UNIX-like operating systems as well.
+description: Blastr observes a version control repository for commits and makes audible  announcements out of the commit messages. It currently supports Subversion,  Git, and Mercurial on Linux and OS X, possibly on other UNIX-like operating  systems as well.
 email: 
 - lasse.koskela@gmail.com
 executables: 
@@ -82,7 +72,7 @@ files:
 - test/test_tts.rb
 - website/index.html
 has_rdoc: true
-homepage: "Blastr observes a version control repository for commits and makes audible "
+homepage: 
 post_install_message: 
 rdoc_options: 
 - --main