ahoward-helene 0.0.3

data/Rakefile

@@ -0,0 +1,274 @@
+This.rubyforge_project = 'codeforpeople'
+This.author = "Ara T. Howard"
+This.email = "ara.t.howard@gmail.com"
+This.homepage = "http://github.com/ahoward/#{ This.lib }/tree/master"
+
+
+task :default do
+  puts(Rake::Task.tasks.map{|task| task.name} - ['default'])
+end
+
+task :gemspec do
+  ignore_extensions = 'git', 'svn', 'tmp', /sw./, 'bak', 'gem'
+  ignore_directories = 'pkg'
+  ignore_files = 'test/log'
+
+  shiteless = 
+    lambda do |list|
+      list.delete_if do |entry|
+        next unless test(?e, entry)
+        extension = File.basename(entry).split(%r/[.]/).last
+        ignore_extensions.any?{|ext| ext === extension}
+      end
+      list.delete_if do |entry|
+        next unless test(?d, entry)
+        dirname = File.expand_path(entry)
+        ignore_directories.any?{|dir| File.expand_path(dir) == dirname}
+      end
+      list.delete_if do |entry|
+        next unless test(?f, entry)
+        filename = File.expand_path(entry)
+        ignore_files.any?{|file| File.expand_path(file) == filename}
+      end
+    end
+
+  lib         = This.lib
+  version     = This.version
+  files       = shiteless[Dir::glob("**/**")]
+  executables = shiteless[Dir::glob("bin/*")].map{|exe| File.basename(exe)}
+  has_rdoc    = true #File.exist?('doc')
+  test_files  = "test/#{ lib }.rb" if File.file?("test/#{ lib }.rb")
+
+  extensions = This.extensions
+  if extensions.nil?
+    %w( Makefile configure extconf.rb ).each do |ext|
+      extensions << ext if File.exists?(ext)
+    end
+  end
+  extensions = [extensions].flatten.compact
+
+  template = 
+    if test(?e, 'gemspec.erb')
+      Template{ IO.read('gemspec.erb') }
+    else
+      Template {
+        <<-__
+          ## #{ lib }.gemspec
+          #
+
+          Gem::Specification::new do |spec|
+            spec.name = #{ lib.inspect }
+            spec.version = #{ version.inspect }
+            spec.platform = Gem::Platform::RUBY
+            spec.summary = #{ lib.inspect }
+
+            spec.files = #{ files.inspect }
+            spec.executables = #{ executables.inspect }
+            
+            spec.require_path = "lib"
+
+            spec.has_rdoc = #{ has_rdoc.inspect }
+            spec.test_files = #{ test_files.inspect }
+            #spec.add_dependency 'lib', '>= version'
+            #spec.add_dependency 'fattr'
+
+            spec.extensions.push(*#{ extensions.inspect })
+
+            spec.rubyforge_project = #{ This.rubyforge_project.inspect }
+            spec.author = #{ This.author.inspect }
+            spec.email = #{ This.email.inspect }
+            spec.homepage = #{ This.homepage.inspect }
+          end
+        __
+      }
+    end
+
+  open("#{ lib }.gemspec", "w"){|fd| fd.puts template}
+  This.gemspec = "#{ lib }.gemspec"
+end
+
+task :gem => [:clean, :gemspec] do
+  Fu.mkdir_p This.pkgdir
+  before = Dir['*.gem']
+  cmd = "gem build #{ This.gemspec }"
+  `#{ cmd }`
+  after = Dir['*.gem']
+  gem = ((after - before).first || after.first) or abort('no gem!')
+  Fu.mv gem, This.pkgdir
+  This.gem = File.basename(gem)
+end
+
+task :readme do
+  samples = ''
+  prompt = '~ > '
+  lib = This.lib
+  version = This.version
+
+  Dir['sample*/*'].sort.each do |sample|
+    samples << "\n" << "  <========< #{ sample } >========>" << "\n\n"
+
+    cmd = "cat #{ sample }"
+    samples << Util.indent(prompt + cmd, 2) << "\n\n"
+    samples << Util.indent(`#{ cmd }`, 4) << "\n"
+
+    cmd = "ruby #{ sample }"
+    samples << Util.indent(prompt + cmd, 2) << "\n\n"
+
+    cmd = "ruby -e'STDOUT.sync=true; exec %(ruby -Ilib #{ sample })'"
+    samples << Util.indent(`#{ cmd } 2>&1`, 4) << "\n"
+  end
+
+  template = 
+    if test(?e, 'readme.erb')
+      Template{ IO.read('readme.erb') }
+    else
+      Template {
+        <<-__
+          NAME
+            #{ lib }
+
+          DESCRIPTION
+
+          INSTALL
+            gem install #{ lib }
+
+          SAMPLES
+            #{ samples }
+        __
+      }
+    end
+
+  open("README", "w"){|fd| fd.puts template}
+end
+
+task :clean do
+  Dir[File.join(This.pkgdir, '**/**')].each{|entry| Fu.rm_rf(entry)}
+end
+
+task :release => [:clean, :gemspec, :gem] do
+  gems = Dir[File.join(This.pkgdir, '*.gem')].flatten
+  raise "which one? : #{ gems.inspect }" if gems.size > 1
+  raise "no gems?" if gems.size < 1
+  cmd = "rubyforge login && rubyforge add_release #{ This.rubyforge_project } #{ This.lib } #{ This.version } #{ This.pkgdir }/#{ This.gem }"
+  puts cmd
+  system cmd
+end
+
+namespace 'test' do
+  def test_files(prefix=nil, &block)
+    files = [ENV['FILES'], ENV['FILE']].flatten.compact
+    if files.empty?
+      files = Dir.glob("#{ prefix }/**/*.rb")
+    else
+      files.map!{|file| Dir.glob(file)}.flatten.compact
+    end
+    files = files.join(' ').strip.split(%r/\s+/)
+    files.delete_if{|file| file =~ /(begin|ensure|setup|teardown).rb$/}
+    files.delete_if{|file| !test(?s, file) or !test(?f, file)}
+    files.delete_if{|file| !file[%r/#{ prefix }/]}
+    block ? files.each{|file| block.call(file)} : files
+  end
+
+  desc 'run all tests'
+  task 'all' => %w[ unit integration ] do
+  end
+
+  desc 'run unit tests'
+  task 'unit' do
+    test_files('test/unit/') do |file|
+      test_loader file
+    end
+  end
+
+  desc 'run integration tests'
+  task 'integration' do
+    test_files('test/integration/') do |file|
+      test_loader file, :require_auth => true
+    end
+  end
+
+  namespace 'integration' do
+    task 'setup' do
+      test_loader 'test/integration/setup.rb', :require_auth => true
+    end
+    task 'teardown' do
+      test_loader 'test/integration/teardown.rb', :require_auth => true
+    end
+  end
+end
+task('test' => 'test:all'){}
+
+
+BEGIN {
+  $VERBOSE = nil
+
+  require 'ostruct'
+  require 'erb'
+  require 'fileutils'
+
+  Fu = FileUtils
+
+  This = OpenStruct.new
+
+  This.file = File.expand_path(__FILE__)
+  This.dir = File.dirname(This.file)
+  This.pkgdir = File.join(This.dir, 'pkg')
+
+  lib = ENV['LIB']
+  unless lib
+    lib = File.basename(Dir.pwd)
+  end
+  This.lib = lib
+
+  version = ENV['VERSION']
+  unless version
+    name = lib.capitalize
+    require "./lib/#{ lib }"
+    version = eval(name).send(:version)
+  end
+  This.version = version
+
+  abort('no lib') unless This.lib
+  abort('no version') unless This.version
+
+  module Util
+    def indent(s, n = 2)
+      s = unindent(s)
+      ws = ' ' * n
+      s.gsub(%r/^/, ws)
+    end
+
+    def unindent(s)
+      indent = nil
+      s.each do |line|
+      next if line =~ %r/^\s*$/
+      indent = line[%r/^\s*/] and break
+    end
+    indent ? s.gsub(%r/^#{ indent }/, "") : s
+  end
+    extend self
+  end
+
+  class Template
+    def initialize(&block)
+      @block = block
+      @template = block.call.to_s
+    end
+    def expand(b=nil)
+      ERB.new(Util.unindent(@template)).result(b||@block)
+    end
+    alias_method 'to_s', 'expand'
+  end
+  def Template(*args, &block) Template.new(*args, &block) end
+
+  Dir.chdir(This.dir)
+
+  def test_loader basename, options = {}
+    tests = ENV['TESTS']||ENV['TEST']
+    tests = " -- -n #{ tests.inspect }" if tests
+    auth = '-r test/auth.rb ' if options[:require_auth]
+    command = "ruby -r test/loader.rb #{ auth }#{ basename }#{ tests }"
+    STDERR.print "\n==== TEST ====\n  #{ command }\n\n==============\n"
+    system command or abort("#{ command } # FAILED WITH #{ $?.inspect }")
+  end
+}

data/helene.gemspec

@@ -0,0 +1,26 @@
+## helene.gemspec
+#
+
+Gem::Specification::new do |spec|
+  spec.name = "helene"
+  spec.version = "0.0.3"
+  spec.platform = Gem::Platform::RUBY
+  spec.summary = "helene"
+
+  spec.files = ["helene.gemspec", "lib", "lib/helene", "lib/helene/attempt.rb", "lib/helene/aws.rb", "lib/helene/config.rb", "lib/helene/content_type.rb", "lib/helene/content_type.yml", "lib/helene/error.rb", "lib/helene/logging.rb", "lib/helene/objectpool.rb", "lib/helene/rails.rb", "lib/helene/rightscale", "lib/helene/rightscale/acf", "lib/helene/rightscale/acf/right_acf_interface.rb", "lib/helene/rightscale/awsbase", "lib/helene/rightscale/awsbase/benchmark_fix.rb", "lib/helene/rightscale/awsbase/right_awsbase.rb", "lib/helene/rightscale/awsbase/support.rb", "lib/helene/rightscale/ec2", "lib/helene/rightscale/ec2/right_ec2.rb", "lib/helene/rightscale/net_fix.rb", "lib/helene/rightscale/right_aws.rb", "lib/helene/rightscale/right_http_connection.rb", "lib/helene/rightscale/s3", "lib/helene/rightscale/s3/right_s3.rb", "lib/helene/rightscale/s3/right_s3_interface.rb", "lib/helene/rightscale/sdb", "lib/helene/rightscale/sdb/active_sdb.rb", "lib/helene/rightscale/sdb/right_sdb_interface.rb", "lib/helene/rightscale/sqs", "lib/helene/rightscale/sqs/right_sqs.rb", "lib/helene/rightscale/sqs/right_sqs_gen2.rb", "lib/helene/rightscale/sqs/right_sqs_gen2_interface.rb", "lib/helene/rightscale/sqs/right_sqs_interface.rb", "lib/helene/s3", "lib/helene/s3/bucket.rb", "lib/helene/s3/grantee.rb", "lib/helene/s3/key.rb", "lib/helene/s3/owner.rb", "lib/helene/s3.rb", "lib/helene/sdb", "lib/helene/sdb/base", "lib/helene/sdb/base/associations.rb", "lib/helene/sdb/base/attributes.rb", "lib/helene/sdb/base/connection.rb", "lib/helene/sdb/base/error.rb", "lib/helene/sdb/base/hooks.rb", "lib/helene/sdb/base/literal.rb", "lib/helene/sdb/base/logging.rb", "lib/helene/sdb/base/transactions.rb", "lib/helene/sdb/base/type.rb", "lib/helene/sdb/base/types.rb", "lib/helene/sdb/base/validations.rb", "lib/helene/sdb/base.rb", "lib/helene/sdb/cast.rb", "lib/helene/sdb/connection.rb", "lib/helene/sdb/error.rb", "lib/helene/sdb/interface.rb", "lib/helene/sdb/sentinel.rb", "lib/helene/sdb.rb", "lib/helene/sleepcycle.rb", "lib/helene/superhash.rb", "lib/helene/util.rb", "lib/helene.rb", "Rakefile", "test", "test/auth.rb", "test/helper.rb", "test/integration", "test/integration/begin.rb", "test/integration/ensure.rb", "test/integration/s3", "test/integration/s3/bucket.rb", "test/integration/sdb", "test/integration/sdb/associations.rb", "test/integration/sdb/creating.rb", "test/integration/sdb/emptiness.rb", "test/integration/sdb/hooks.rb", "test/integration/sdb/limits.rb", "test/integration/sdb/saving.rb", "test/integration/sdb/selecting.rb", "test/integration/sdb/types.rb", "test/integration/sdb/validations.rb", "test/integration/setup.rb", "test/integration/teardown.rb", "test/loader.rb"]
+  spec.executables = []
+  
+  spec.require_path = "lib"
+
+  spec.has_rdoc = true
+  spec.test_files = nil
+  #spec.add_dependency 'lib', '>= version'
+  #spec.add_dependency 'fattr'
+
+  spec.extensions.push(*[])
+
+  spec.rubyforge_project = "codeforpeople"
+  spec.author = "Ara T. Howard"
+  spec.email = "ara.t.howard@gmail.com"
+  spec.homepage = "http://github.com/ahoward/helene/tree/master"
+end

data/lib/helene.rb

@@ -0,0 +1,113 @@
+module Helene
+# version
+#
+  Helene::VERSION = '0.0.3' unless defined?(Helene::VERSION)
+  def Helene.version() Helene::VERSION end
+
+# ruby built-ins
+#
+  require 'ostruct'
+  require 'logger'
+  require 'pathname'
+
+# rubygems
+#
+  begin
+    require 'rubygems'
+  rescue LoadError
+    nil
+  end
+
+# gems
+#
+  require 'active_support' unless defined?(ActiveSupport)
+  require 'uuidtools'
+  gem 'arrayfields', '~> 4.7'
+  require 'arrayfields'
+  gem 'threadify', '~> 1.1'
+  require 'threadify'
+
+# helene load support
+#
+  def Helene.lib
+    @lib = Pathname.new(__FILE__).realpath.to_s
+  end
+
+  def Helene.libdir(*args)
+    @libdir ||= File.dirname(lib)
+    if args.empty?
+      @libdir
+    else
+      File.join(@libdir, *args.flatten.compact.map{|arg| arg.to_s})
+    end
+  end
+
+  def Helene.reload!
+    Kernel.load lib
+  end
+
+  def Helene.load_path(&block)
+    $LOAD_PATH.unshift(Helene.libdir)
+    $LOAD_PATH.unshift(Helene.libdir('helene'))
+    begin
+      block.call
+    ensure
+      $LOAD_PATH.shift
+      $LOAD_PATH.shift
+    end
+  end
+
+  def Helene.rightscale_load_path(&block)
+    $LOAD_PATH.unshift(Helene.libdir('helene', 'rightscale'))
+    begin
+      block.call
+    ensure
+      $LOAD_PATH.shift
+    end
+  end
+
+  def Helene.rails?
+    defined?(Rails)
+  end
+
+  def Helene.rails_root(*args)
+    if rails?
+      File.join(RAILS_ROOT, *args.flatten.map{|arg| arg.to_s})
+    end
+  end
+
+  def Helene.uuid
+    UUID.timestamp_create().to_s
+  end
+
+# helene
+#
+  Helene.load_path do
+    Helene.rightscale_load_path do
+      load 'right_http_connection.rb'
+      load 'right_aws.rb'
+    end
+    load 'error.rb'
+    load 'util.rb'
+    load 'sleepcycle.rb'
+    load 'superhash.rb'
+    load 'objectpool.rb'
+    load 'attempt.rb'
+    load 'content_type.rb'
+    load 'logging.rb'
+    load 'config.rb'
+    load 'aws.rb'
+    load 'sdb.rb'
+    load 's3.rb'
+    load 'rails.rb' if defined?(Rails)
+  end
+
+# mega-hacks
+#
+  ca_file =
+    ENV['CA_FILE'] ||
+    ENV['AMAZON_CA_FILE'] ||
+    (defined?(AMAZON_CA_FILE) and AMAZON_CA_FILE) ||
+    (defined?(CA_FILE) and CA_FILE)
+  Rightscale::HttpConnection.params[:ca_file] = ca_file if ca_file
+end

data/lib/helene/attempt.rb

@@ -0,0 +1,46 @@
+module Helene
+  module Attempt
+    class TooMany < StandardError; end
+
+    def attempt(*args, &block)
+      options = args.extract_options!.to_options!
+
+      retries = Integer(args.shift || options[:retries] || 42)
+      label = String(args.shift || options[:label] || caller.first(1))
+      exceptions = [options[:rescue] || StandardError].flatten
+      result = nil
+      attempts = 0
+      sleepcycle = options[:sleepcycle] || options[:backoff] || SleepCycle.new
+      Thread.current[:attempt_label] = label
+
+      loop do
+        caught =
+          begin
+            catch(label) do
+              result = yield(attempts += 1)
+            end
+          rescue *exceptions => e
+            #STDERR.puts Util.emsg(e)
+            raise if options[:rescue]==false
+            sleep(sleepcycle.next)
+            :try_again
+          end
+
+        break unless caught == :try_again
+        raise TooMany, "#{ retries } (#{ label })" if attempts >= retries
+      end
+
+      result
+    end 
+
+    def try_again! label = Thread.current[:attempt_label]
+      throw label, :try_again
+    end
+
+    def give_up! label = Thread.current[:attempt_label]
+      throw label, :give_up
+    end
+
+    extend self
+  end
+end