barron 0.1.0

data/Gemfile

@@ -0,0 +1,2 @@
+source :rubygems
+gemspec

data/Rakefile

@@ -0,0 +1,151 @@
+require 'rubygems'
+require 'rake'
+require 'rdoc'
+require 'date'
+
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), *%w[lib]))
+
+#############################################################################
+#
+# Helper functions
+#
+#############################################################################
+
+def name
+  @name ||= Dir['*.gemspec'].first.split('.').first
+end
+
+def version
+  line = File.read("lib/#{name}.rb")[/^\s*VERSION\s*=\s*.*/]
+  line.match(/.*VERSION\s*=\s*['"](.*)['"]/)[1]
+end
+
+def date
+  Date.today.to_s
+end
+
+def rubyforge_project
+  name
+end
+
+def gemspec_file
+  "#{name}.gemspec"
+end
+
+def gem_file
+  "#{name}-#{version}.gem"
+end
+
+def replace_header(head, header_name)
+  head.sub!(/(\.#{header_name}\s*= ').*'/) { "#{$1}#{send(header_name)}'"}
+end
+
+#############################################################################
+#
+# Standard tasks
+#
+#############################################################################
+
+task :default => [:test, :features]
+
+require 'rake/testtask'
+Rake::TestTask.new(:test) do |test|
+  if `which pygmentize` == ''
+    puts "You must have Pygments installed to run the tests."
+    exit 1
+  end
+  test.libs << 'lib' << 'test'
+  test.pattern = 'test/**/test_*.rb'
+  test.verbose = true
+end
+
+desc "Generate RCov test coverage and open in your browser"
+task :coverage do
+  require 'rcov'
+  sh "rm -fr coverage"
+  sh "rcov test/test_*.rb"
+  sh "open coverage/index.html"
+end
+
+require 'rdoc/task'
+Rake::RDocTask.new do |rdoc|
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "#{name} #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end
+
+desc "Open an irb session preloaded with this library"
+task :console do
+  sh "irb -rubygems -r ./lib/#{name}.rb"
+end
+
+#############################################################################
+#
+# Custom tasks (add your own tasks here)
+#
+#############################################################################
+
+begin
+  require 'cucumber/rake/task'
+  Cucumber::Rake::Task.new(:features) do |t|
+    t.cucumber_opts = "--format progress"
+  end
+rescue LoadError
+  desc 'Cucumber rake task not available'
+  task :features do
+    abort 'Cucumber rake task is not available. Be sure to install cucumber as a gem or plugin'
+  end
+end
+
+#############################################################################
+#
+# Packaging tasks
+#
+#############################################################################
+
+task :release => :build do
+  unless `git branch` =~ /^\* master$/
+    puts "You must be on the master branch to release!"
+    exit!
+  end
+  sh "git commit --allow-empty -m 'Release #{version}'"
+  sh "git tag v#{version}"
+  sh "git push origin master"
+  sh "git push origin v#{version}"
+  sh "gem push pkg/#{name}-#{version}.gem"
+end
+
+task :build => :gemspec do
+  sh "mkdir -p pkg"
+  sh "gem build #{gemspec_file}"
+  sh "mv #{gem_file} pkg"
+end
+
+task :gemspec do
+  # read spec file and split out manifest section
+  spec = File.read(gemspec_file)
+  head, manifest, tail = spec.split("  # = MANIFEST =\n")
+
+  # replace name version and date
+  replace_header(head, :name)
+  replace_header(head, :version)
+  replace_header(head, :date)
+  #comment this out if your rubyforge_project has a different name
+  # replace_header(head, :rubyforge_project)
+
+  # determine file list from git ls-files
+  files = `git ls-files`.
+    split("\n").
+    sort.
+    reject { |file| file =~ /^\./ }.
+    reject { |file| file =~ /^(rdoc|pkg|coverage)/ }.
+    map { |file| "    #{file}" }.
+    join("\n")
+
+  # piece file back together and write
+  manifest = "  s.files = %w[\n#{files}\n  ]\n"
+  spec = [head, manifest, tail].join("  # = MANIFEST =\n")
+  File.open(gemspec_file, 'w') { |io| io.write(spec) }
+  puts "Updated #{gemspec_file}"
+end

data/barron.gemspec

@@ -0,0 +1,39 @@
+Gem::Specification.new do |s|
+  s.specification_version = 2 if s.respond_to? :specification_version=
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.rubygems_version = '1.3.5'
+
+  s.name              = 'barron'
+  s.version           = '0.1.0'
+  s.date              = '2012-01-04'
+
+  s.summary     = "Barron helps you with locking"
+  s.description = "Barron uses file-system locks, but eventually configurable backends would be nice. Robert Barron patented a double-acting tumbler lock in 1778."
+
+  s.authors  = ["Matthew Beale"]
+  s.email    = 'matt.beale@madhatted.com'
+  s.homepage = 'http://github.com/mixonic/barron'
+
+  s.require_paths = %w[lib]
+
+  s.executables = ["barron"]
+
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.extra_rdoc_files = %w[]
+
+  s.add_development_dependency('rake', "~> 0.9")
+  s.add_development_dependency('rdoc', "~> 3.11")
+  
+  # = MANIFEST =
+  s.files = %w[
+    Gemfile
+    Rakefile
+    barron.gemspec
+    bin/barron
+    lib/barron.rb
+    lib/barron/tmpfile.rb
+  ]
+  # = MANIFEST =
+
+  s.test_files = s.files.select { |path| path =~ /^test\/test_.*\.rb/ }
+end

data/bin/barron

@@ -0,0 +1,67 @@
+#!/usr/bin/env ruby
+
+$:.unshift File.join(File.dirname(__FILE__), *%w[.. lib])
+
+help = <<HELP
+Barron uses filesystem locks, but provides an identical
+backend across a Ruby process (via gem) and the command-line.
+
+Basic Command Line Usage:
+  # Return success if available, error if not
+  barron "locked-resource"
+  # Block until the resource is free
+  barron "locked-resource" --block
+  
+  Other options follow:
+
+HELP
+
+require 'optparse'
+require 'barron'
+
+resource = nil
+options = {
+  :block => false
+}
+opts = OptionParser.new do |opts|
+  opts.banner = help
+
+  opts.on("--tmpdir [DIRECTORY]", "Where to write the lockfiles") do |directory|
+    options[:tmpdir] = directory unless directory.nil?
+  end
+
+  opts.on("--block", "If barron should block until the lock is released") do
+    options[:block] = true
+  end
+
+  opts.on("--version", "Display current version") do
+    puts "Spinto " + Spinto::VERSION
+    exit 0
+  end
+end
+
+# Read command line options into `options` hash
+opts.parse!
+
+
+# Get source and destintation from command line
+case ARGV.size
+  when 1
+    resource = ARGV[0]
+  else
+    puts "Invalid options. Run `barron --help` for assistance."
+    exit(1)
+end
+
+# Fire the lock, return success if it is free,
+# or hang until it is free.
+Barron.lock resource, options do
+  $stdout.puts "Requested resource is free."
+  exit(0)
+end
+
+# Unless barron was told to hang, we will pass
+# through to here when barron cannot get a lock.
+# So return failue.
+$stderr.puts "Requested resource is being used."
+exit(1)

data/lib/barron.rb

@@ -0,0 +1,18 @@
+module Barron
+  require 'barron/tmpfile'
+
+  VERSION = '0.1.0'
+
+  def lock *args, &block
+    Barron.lock *args, &block
+  end
+
+  class << self
+
+    def lock *args, &block
+      Barron::Tmpfile.lock *args, &block
+    end
+
+  end
+
+end

data/lib/barron/tmpfile.rb

@@ -0,0 +1,30 @@
+module Barron::Tmpfile
+
+  require 'digest/md5'
+
+  class << self
+
+    def lock name, options={}
+      options = {
+        :block => true,
+        :tmpdir => '/tmp'
+      }.merge(options)
+      value = nil
+      open("#{options[:tmpdir]}/barron-#{Digest::MD5.hexdigest("#{name}")}", File::RDWR|File::CREAT, 0666) do |f|
+        begin
+          if options[:block]
+            f.flock(File::LOCK_EX)
+            value = yield f
+          elsif f.flock(File::LOCK_EX|File::LOCK_NB)
+            value = yield f
+          end
+        ensure
+          f.flock(File::LOCK_UN)
+        end
+      end
+      value
+    end
+
+  end
+
+end

metadata

@@ -0,0 +1,99 @@
+--- !ruby/object:Gem::Specification 
+name: barron
+version: !ruby/object:Gem::Version 
+  hash: 27
+  prerelease: 
+  segments: 
+  - 0
+  - 1
+  - 0
+  version: 0.1.0
+platform: ruby
+authors: 
+- Matthew Beale
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2012-01-04 00:00:00 Z
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  prerelease: false
+  version_requirements: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 25
+        segments: 
+        - 0
+        - 9
+        version: "0.9"
+  type: :development
+  requirement: *id001
+  name: rake
+- !ruby/object:Gem::Dependency 
+  prerelease: false
+  version_requirements: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 17
+        segments: 
+        - 3
+        - 11
+        version: "3.11"
+  type: :development
+  requirement: *id002
+  name: rdoc
+description: Barron uses file-system locks, but eventually configurable backends would be nice. Robert Barron patented a double-acting tumbler lock in 1778.
+email: matt.beale@madhatted.com
+executables: 
+- barron
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- Gemfile
+- Rakefile
+- barron.gemspec
+- bin/barron
+- lib/barron.rb
+- lib/barron/tmpfile.rb
+homepage: http://github.com/mixonic/barron
+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.8.13
+signing_key: 
+specification_version: 2
+summary: Barron helps you with locking
+test_files: []
+