highlander 0.1.0

data/CHANGES

@@ -0,0 +1,2 @@
+= 0.1.0: 12-Dec-2010
+* Initial release

data/MANIFEST

@@ -0,0 +1,7 @@
+* CHANGES
+* README
+* MANIFEST
+* Rakefile
+* highlander.gemspec
+* lib/highlander.rb
+* test/test_highlander.rb

data/README

@@ -0,0 +1,45 @@
+= Description
+  A gem that ensures only one instance of your main script is running.
+  In short, there can be only one.
+
+= Installation
+  gem install highlander
+
+= Synopsis
+  require 'highlander'
+  # Your code here
+
+  # Meanwhile, back on the command line...
+
+  # First attempt, works. Assume it's running in the background.
+  ruby your_script.rb
+
+  # Second attempt while the first instance is still running, fails.
+  ruby your_script.rb # => RuntimeError 
+
+= Notes
+  Simply requiring the highlander gem ensures that only one instance
+  of that script cannot be started again. If you try to start it again
+  it will raise a RuntimeError.
+
+= Known Issues
+  If you start your program, modify it while its running, and run it again
+  then this library will not work.
+
+= Acknowledgements
+  Ara Howard for ideas.
+
+= License
+  Artistic 2.0
+
+= Copyright
+  (C) 2010 Daniel J. Berger
+  All Rights Reserved.
+
+== Warranty
+  This package is provided "as is" and without any express or
+  implied warranties, including, without limitation, the implied
+  warranties of merchantability and fitness for a particular purpose.
+
+= Author
+  Daniel Berger

data/Rakefile

@@ -0,0 +1,26 @@
+require 'rake'
+require 'rake/clean'
+require 'rake/testtask'
+
+CLEAN.include("**/*.gem", "**/*.rbc")
+
+namespace 'gem' do
+  desc 'Create the highlander gem'
+  task :create => [:clean] do
+    spec = eval(IO.read('highlander.gemspec'))
+    Gem::Builder.new(spec).build
+  end
+
+  desc 'Install the highlander gem'
+  task :install => [:create] do
+    file = Dir["*.gem"].first
+    sh "gem install #{file}"
+  end
+end
+
+Rake::TestTask.new do |t|
+  t.verbose = true
+  t.warning = true
+end
+
+task :default => :test

data/highlander.gemspec

@@ -0,0 +1,25 @@
+require 'rubygems'
+
+Gem::Specification.new do |gem|
+  gem.name       = 'highlander'
+  gem.version    = '0.1.0'
+  gem.license    = 'Artistic 2.0'
+  gem.author     = 'Daniel J. Berger'
+  gem.email      = 'djberg96@gmail.com'
+  gem.homepage   = 'http://www.rubyforge.org/projects/shards'
+  gem.summary    = 'There can be only one! Process, that is.'
+  gem.test_files = Dir['test/test*']
+  gem.has_rdoc   = true
+  gem.files      = Dir['**/*'].reject{ |f| f.include?('git') }
+
+  gem.rubyforge_project = 'shards'
+  gem.extra_rdoc_files  = ['README', 'CHANGES', 'MANIFEST']
+
+  gem.description = <<-EOF
+    The highlander gem ensures that only once instance of the current
+    process is running. If you try to run the same Ruby program again
+    it will raise a RuntimeError instead.
+  EOF
+
+  gem.add_development_dependency('test-unit', '>= 2.1.1')
+end

data/lib/highlander.rb

@@ -0,0 +1,19 @@
+module Highlander
+  # The version of the highlander library
+  VERSION = '0.1.0'
+
+  BEGIN{
+    unless $0 == 'irb'
+      program = File.expand_path($0)
+      DATA = File.open(program) unless defined?(DATA)
+      status = DATA.flock(File::LOCK_EX | File::LOCK_NB)
+
+      if status != 0
+        raise RuntimeError, "Program '#{program}' already running"
+        exit! # In case of rescue, forcibly bail
+      end
+    end
+  }
+end
+
+include Highlander

data/test/test_highlander.rb

@@ -0,0 +1,19 @@
+#######################################################################
+# test_highlander.rb
+#
+# Test suite for the highlander gem.
+#######################################################################
+require 'test/unit'
+require 'highlander'
+
+class TC_Highlander < Test::Unit::TestCase
+  def setup
+  end
+
+  def test_version
+    assert_equal("0.1.0", Highlander::VERSION)
+  end
+
+  def teardown
+  end
+end

metadata

@@ -0,0 +1,90 @@
+--- !ruby/object:Gem::Specification 
+name: highlander
+version: !ruby/object:Gem::Version 
+  hash: 27
+  prerelease: false
+  segments: 
+  - 0
+  - 1
+  - 0
+  version: 0.1.0
+platform: ruby
+authors: 
+- Daniel J. Berger
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-12-12 00:00:00 -07:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: test-unit
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 9
+        segments: 
+        - 2
+        - 1
+        - 1
+        version: 2.1.1
+  type: :development
+  version_requirements: *id001
+description: "    The highlander gem ensures that only once instance of the current\n    process is running. If you try to run the same Ruby program again\n    it will raise a RuntimeError instead.\n"
+email: djberg96@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README
+- CHANGES
+- MANIFEST
+files: 
+- CHANGES
+- highlander.gemspec
+- lib/highlander.rb
+- MANIFEST
+- Rakefile
+- README
+- test/test_highlander.rb
+has_rdoc: true
+homepage: http://www.rubyforge.org/projects/shards
+licenses: 
+- Artistic 2.0
+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: shards
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: There can be only one! Process, that is.
+test_files: 
+- test/test_highlander.rb