capistrano-ext-set-helpers 0.1.0

data/.autotest

@@ -0,0 +1,23 @@
+# -*- ruby -*-
+
+require 'autotest/restart'
+
+# Autotest.add_hook :initialize do |at|
+#   at.extra_files << "../some/external/dependency.rb"
+#
+#   at.libs << ":../some/external"
+#
+#   at.add_exception 'vendor'
+#
+#   at.add_mapping(/dependency.rb/) do |f, _|
+#     at.files_matching(/test_.*rb$/)
+#   end
+#
+#   %w(TestA TestB).each do |klass|
+#     at.extra_class_map[klass] = "test/test_misc.rb"
+#   end
+# end
+
+# Autotest.add_hook :run_command do |at|
+#   system "rake build"
+# end

data/History.txt

@@ -0,0 +1,6 @@
+=== 1.0.0 / 2011-09-05
+
+* 1 major enhancement
+
+  * Birthday!
+

data/Manifest.txt

@@ -0,0 +1,7 @@
+.autotest
+History.txt
+Manifest.txt
+README.rdoc
+Rakefile
+lib/capistrano/ext/set/helpers.rb
+examples/Capfile

data/README.rdoc

@@ -0,0 +1,65 @@
+= capistrano-ext-set-helpers
+
+* url: https://github.com/andynu/capistrano-ext-set-helpers
+
+== DESCRIPTION:
+
+Set helpers allow easier parsing of environment options,
+and top level helpers for the Highline ask/menu methods.
+
+== FEATURES/PROBLEMS:
+
+* PROBLEM: Unreleased
+
+== SYNOPSIS:
+
+  env_or_menu(variable, options, default=nil)
+  env_or_ask(variable, question, default=nil)
+  env_or_set(variable, value=nil, &block)
+  env_set_optional(variable)
+  set_ask_menu(variable, options, default=nil)
+  set_ask(variable, question, default=nil)
+
+  include:
+
+== REQUIREMENTS:
+
+* Unkown
+
+== INSTALL:
+
+* gem install 'capistrano-ext-set-helpers'
+
+== DEVELOPERS:
+
+After checking out the source, run:
+
+  $ rake newb
+
+This task will install any missing dependencies, run the tests/specs,
+and generate the RDoc.
+
+== LICENSE:
+
+(The MIT License)
+
+Copyright (c) 2011 FIX
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+'Software'), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/Rakefile

@@ -0,0 +1,23 @@
+# -*- ruby -*-
+
+require 'rubygems'
+require 'hoe'
+
+# Hoe.plugin :compiler
+# Hoe.plugin :gem_prelude_sucks
+# Hoe.plugin :inline
+# Hoe.plugin :racc
+# Hoe.plugin :rubyforge
+Hoe.plugin :gemcutter
+
+Hoe.spec 'capistrano-ext-set-helpers' do
+  # HEY! If you fill these out in ~/.hoe_template/Rakefile.erb then
+  # you'll never have to touch them again!
+  # (delete this comment too, of course)
+
+  developer('Andrew Nutter-Upham', 'andy@ansible.net')
+
+  # self.rubyforge_name = 'capistrano-ext-set-helpersx' # if different than 'capistrano-ext-set-helpers'
+end
+
+# vim: syntax=ruby

data/examples/Capfile

@@ -0,0 +1,30 @@
+require 'capistrano/ext/set/helpers'
+
+desc "show variables"
+task :show do
+
+  env_or_set(:user,:default_user_name)
+  puts "user = #{user}"
+
+  ENV['a'] = '1'
+  a_from_env = env_or_ask(:a, "What is your user name?")
+  b_from_ask = env_or_ask(:b, "How many letters into the alphabet is the letter B")
+  set(:a, a_from_env)
+  set(:b, b_from_ask)
+
+  ENV['d'] = '4'
+  set_ask(:c, "How many letters into the alphabet is the letter C?")
+  set_ask(:d, "How many letters into the alphabet is the letter D?")
+  set_ask(:e, "How many letters into the alphabet is the letter E?","5")
+
+  ENV['f'] = '6'
+  set_ask_menu(:f, "How many letters into the alphabet is the letter F?")
+  set_ask_menu(:g, %w[7 8 9])
+  set_ask_menu(:h, %w[8 9 10], "8")
+
+  [:a,:b,:c,:d,:e,:f,:g,:h].each do |l|
+    puts "#{l} = #{fetch(l)}"
+  end
+end
+
+# vim: ft=ruby

data/lib/capistrano/ext/set/helpers.rb

@@ -0,0 +1,110 @@
+#require 'capistrano'
+#require 'capistrano/configuration/variables'
+#include Capistrano::Configuration::Variables
+
+class CapistranoExtSetHelpers
+  VERSION = '0.1.0'
+end
+
+###############################################################################
+#
+# Helpers
+#
+
+# use environment variable if provided
+# otherwise use the passed value
+def env_or_set(variable, value=nil, &block)
+  value = if ENV[variable.to_s].nil?
+    value
+  else
+    if ENV[variable.to_s] == /^:/
+      ENV[variable.to_s].to_sym
+    else
+      ENV[variable.to_s].to_s
+    end
+  end
+  set( variable ) {
+    value = block.call if block_given? && value.nil?
+    value = true if value =~ /true/i
+    value = false if value =~ /false/i
+    value
+  }
+end
+
+# sets variable from environment variable if provided
+# otherwise does nothing.
+def env_set_optional(variable)
+  value = if ENV[variable.to_s] == /^:/
+            ENV[variable.to_s].to_sym
+          else
+            ENV[variable.to_s].to_s
+          end
+  set(variable, value) unless value.empty?
+end
+
+# checks the environment first for a variable,
+# then asks the user to select its value from
+# the provided list of options.
+def env_or_menu(variable, options, default=nil)
+  question = "( ? ) Select #{variable.to_s}"
+  value = if ENV[variable.to_s].nil?
+    Capistrano::CLI.ui.choose do |menu|
+      unless default.nil?
+        menu.default = default
+        menu.prompt = "%s |%s|" % [question,default]
+      else
+        menu.prompt = question
+      end
+      options.each {|c| menu.choice(c)}
+      menu.header = question
+    end
+  else
+    if ENV[variable.to_s] == /^:/
+      ENV[variable.to_s].to_sym
+    else
+      ENV[variable.to_s].to_s
+    end
+  end
+  yield(value) if block_given?
+  return value
+end
+
+# check the environment first for a variable,
+# then asks the user a question to provide
+# the value
+def env_or_ask(variable, question, default=nil)
+  value = if ENV[variable.to_s].nil?
+    Capistrano::CLI.ui.ask(question) do |q|
+      unless default.nil?
+        q.default = default
+      end
+    end
+  else
+    if ENV[variable.to_s] == /^:/
+      ENV[variable.to_s].to_sym
+    else
+      ENV[variable.to_s].to_s
+    end
+  end
+  yield(value) if block_given?
+  return value
+end
+
+# lazy set a variable with env_or_menu
+def set_ask_menu(variable, options, default=nil)
+  set(variable) do
+    env_or_menu(variable,options,default) do |value|
+      yield(value) if block_given?
+    end
+  end
+end
+
+# lazy set a variable with env_or_ask
+def set_ask(variable, question, default=nil)
+  set(variable) do
+    env_or_ask(variable,question,default) do |value|
+      yield(value) if block_given?
+    end
+  end
+end
+

metadata

@@ -0,0 +1,67 @@
+--- !ruby/object:Gem::Specification
+name: capistrano-ext-set-helpers
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+  prerelease: 
+platform: ruby
+authors:
+- Andrew Nutter-Upham
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2011-09-05 00:00:00.000000000Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: hoe
+  requirement: &9685320 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '2.12'
+  type: :development
+  prerelease: false
+  version_requirements: *9685320
+description: ''
+email:
+- andy@ansible.net
+executables: []
+extensions: []
+extra_rdoc_files:
+- History.txt
+- Manifest.txt
+files:
+- .autotest
+- History.txt
+- Manifest.txt
+- README.rdoc
+- Rakefile
+- lib/capistrano/ext/set/helpers.rb
+- examples/Capfile
+homepage: 
+licenses: []
+post_install_message: 
+rdoc_options:
+- --main
+- README.txt
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: capistrano-ext-set-helpers
+rubygems_version: 1.8.10
+signing_key: 
+specification_version: 3
+summary: ''
+test_files: []