buzzware-buzzcore 0.2.2

data/.document

@@ -0,0 +1,5 @@
+README.rdoc
+lib/**/*.rb
+bin/*
+features/**/*.feature
+LICENSE

data/.gitignore

@@ -0,0 +1,5 @@
+*.sw?
+.DS_Store
+coverage
+rdoc
+pkg

data/LICENSE

@@ -0,0 +1,23 @@
+Copyright (c) 2008-2009 Gary McGhee - Buzzware Solutions, Western Australia - gary@buzzware.com.au
+
+MIT Licence
+
+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/README.rdoc

@@ -0,0 +1,46 @@
+= buzzcore
+
+* Author : http://www.buzzware.com.au
+
+== DESCRIPTION:
+
+Core library of Buzzware Solutions
+
+== FEATURES/PROBLEMS:
+
+* something
+
+== REQUIREMENTS:
+
+* tested on MacOS and Linux
+
+== INSTALL:
+
+ sudo gem sources -a http://gems.github.com
+ sudo gem install buzzware-buzzcore
+
+== LICENSE:
+
+(The MIT License)
+
+Copyright (c) 2009 Gary McGhee, Buzzware Solutions
+
+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,63 @@
+require 'rubygems'
+require 'rake'
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name = "buzzcore"
+    gem.summary = %Q{buzzcore is the ruby core library developed and used by Buzzware Solutions.}
+    gem.description = %Q{buzzcore is the ruby core library developed and used by Buzzware Solutions.}
+    gem.email = "contact@buzzware.com.au"
+    gem.homepage = "http://github.com/buzzware/buzzcore"
+    gem.authors = ["buzzware"]
+    #gem.rubyforge_project = "buzzware"
+    gem.add_development_dependency "thoughtbot-shoulda"
+		gem.files.include %w(
+			lib/buzzcore.rb
+		)
+    # gem is a Gem::Specification... see http://www.rubygems.org/read/chapter/20 for additional settings
+  end
+  Jeweler::RubyforgeTasks.new do |rubyforge|
+    rubyforge.doc_task = "rdoc"
+  end
+rescue LoadError
+  puts "Jeweler (or a dependency) not available. Install it with: sudo gem install jeweler"
+end
+
+require 'rake/testtask'
+Rake::TestTask.new(:test) do |test|
+  test.libs << 'lib' << 'test'
+  test.pattern = 'test/**/*_test.rb'
+  test.verbose = true
+end
+
+begin
+  require 'rcov/rcovtask'
+  Rcov::RcovTask.new do |test|
+    test.libs << 'test'
+    test.pattern = 'test/**/*_test.rb'
+    test.verbose = true
+  end
+rescue LoadError
+  task :rcov do
+    abort "RCov is not available. In order to run rcov, you must: sudo gem install spicycode-rcov"
+  end
+end
+
+task :test => :check_dependencies
+
+task :default => :test
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  if File.exist?('VERSION')
+    version = File.read('VERSION')
+  else
+    version = ""
+  end
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "buzzcore #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/VERSION

@@ -0,0 +1 @@
+0.2.2

data/buzzcore.gemspec

@@ -0,0 +1,77 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE
+# Instead, edit Jeweler::Tasks in Rakefile, and run `rake gemspec`
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{buzzcore}
+  s.version = "0.2.2"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["buzzware"]
+  s.date = %q{2009-09-10}
+  s.description = %q{buzzcore is the ruby core library developed and used by Buzzware Solutions.}
+  s.email = %q{contact@buzzware.com.au}
+  s.extra_rdoc_files = [
+    "LICENSE",
+     "README.rdoc"
+  ]
+  s.files = [
+    ".document",
+     ".gitignore",
+     "LICENSE",
+     "README.rdoc",
+     "Rakefile",
+     "VERSION",
+     "buzzcore.gemspec",
+     "buzzcore.vpj",
+     "buzzcore.vpw",
+     "lib/buzzcore.rb",
+     "lib/buzzcore.rb",
+     "lib/buzzcore/cap_utils.rb",
+     "lib/buzzcore/config.rb",
+     "lib/buzzcore/database_utils.rb",
+     "lib/buzzcore/enum.rb",
+     "lib/buzzcore/extend_base_classes.rb",
+     "lib/buzzcore/ftp_extra.rb",
+     "lib/buzzcore/logging.rb",
+     "lib/buzzcore/misc_utils.rb",
+     "lib/buzzcore/require_paths.rb",
+     "lib/buzzcore/shell_extras.rb",
+     "lib/buzzcore/string_utils.rb",
+     "lib/buzzcore/text_doc.rb",
+     "lib/buzzcore/thread_utils.rb",
+     "lib/buzzcore/xml_utils.rb",
+     "test/buzzcore_test.rb",
+     "test/config_test.rb",
+     "test/credentials_test.rb",
+     "test/shell_test.rb",
+     "test/test_helper.rb"
+  ]
+  s.has_rdoc = true
+  s.homepage = %q{http://github.com/buzzware/buzzcore}
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.1}
+  s.summary = %q{buzzcore is the ruby core library developed and used by Buzzware Solutions.}
+  s.test_files = [
+    "test/buzzcore_test.rb",
+     "test/config_test.rb",
+     "test/credentials_test.rb",
+     "test/shell_test.rb",
+     "test/test_helper.rb"
+  ]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 2
+
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+      s.add_development_dependency(%q<thoughtbot-shoulda>, [">= 0"])
+    else
+      s.add_dependency(%q<thoughtbot-shoulda>, [">= 0"])
+    end
+  else
+    s.add_dependency(%q<thoughtbot-shoulda>, [">= 0"])
+  end
+end

data/buzzcore.vpj

@@ -0,0 +1,93 @@
+<!DOCTYPE Project SYSTEM "http://www.slickedit.com/dtd/vse/10.0/vpj.dtd">
+<Project
+	Version="10.0"
+	VendorName="SlickEdit"
+	WorkingDir=".">
+	<Config
+		Name="Release"
+		OutputFile=""
+		CompilerConfigName="Latest Version">
+		<Menu>
+			<Target
+				Name="Compile"
+				MenuCaption="&amp;Compile"
+				CaptureOutputWith="ProcessBuffer"
+				SaveOption="SaveCurrent"
+				RunFromDir="%rw">
+				<Exec/>
+			</Target>
+			<Target
+				Name="Build"
+				MenuCaption="&amp;Build"
+				CaptureOutputWith="ProcessBuffer"
+				SaveOption="SaveWorkspaceFiles"
+				RunFromDir="%rw">
+				<Exec/>
+			</Target>
+			<Target
+				Name="Rebuild"
+				MenuCaption="&amp;Rebuild"
+				CaptureOutputWith="ProcessBuffer"
+				SaveOption="SaveWorkspaceFiles"
+				RunFromDir="%rw">
+				<Exec/>
+			</Target>
+			<Target
+				Name="Debug"
+				MenuCaption="&amp;Debug"
+				SaveOption="SaveNone"
+				RunFromDir="%rw">
+				<Exec/>
+			</Target>
+			<Target
+				Name="Execute"
+				MenuCaption="E&amp;xecute"
+				SaveOption="SaveNone"
+				RunFromDir="%rw"
+				CaptureOutputWith="ProcessBuffer"
+				ClearProcessBuffer="1">
+				<Exec CmdLine="source actions.sh execute"/>
+			</Target>
+		</Menu>
+	</Config>
+	<CustomFolders>
+		<Folder
+			Name="Source Files"
+			Filters="*.c;*.C;*.cc;*.cpp;*.cp;*.cxx;*.c++;*.prg;*.pas;*.dpr;*.asm;*.s;*.bas;*.java;*.cs;*.sc;*.e;*.cob;*.html;*.rc;*.tcl;*.py;*.pl"/>
+		<Folder
+			Name="Header Files"
+			Filters="*.h;*.H;*.hh;*.hpp;*.hxx;*.inc;*.sh;*.cpy;*.if"/>
+		<Folder
+			Name="Resource Files"
+			Filters="*.ico;*.cur;*.dlg"/>
+		<Folder
+			Name="Bitmaps"
+			Filters="*.bmp"/>
+		<Folder
+			Name="Other Files"
+			Filters="">
+		</Folder>
+	</CustomFolders>
+	<Files AutoFolders="DirectoryView">
+		<Folder Name="lib">
+			<F
+				N="lib/*"
+				Recurse="1"
+				Refilter="0"
+				Excludes=""/>
+		</Folder>
+		<Folder Name="test">
+			<F
+				N="test/*"
+				Recurse="0"
+				Refilter="0"
+				Excludes=".svn/"/>
+		</Folder>
+		<F N="buzzcore.gemspec"/>
+		<F N="History.txt"/>
+		<F N="Manifest.txt"/>
+		<F N="PostInstall.txt"/>
+		<F N="Rakefile"/>
+		<F N="README.rdoc"/>
+	</Files>
+</Project>

data/buzzcore.vpw

@@ -0,0 +1,6 @@
+<!DOCTYPE Workspace SYSTEM "http://www.slickedit.com/dtd/vse/10.0/vpw.dtd">
+<Workspace Version="10.0" VendorName="SlickEdit">
+	<Projects>
+		<Project File="buzzcore.vpj" />
+	</Projects>
+</Workspace>

data/lib/buzzcore.rb

@@ -0,0 +1,2 @@
+Dir.chdir(File.dirname(__FILE__)) { Dir['buzzcore/*'] }.each {|f| require f }
+

data/lib/buzzcore/cap_utils.rb

@@ -0,0 +1,181 @@
+# use "extend CapUtils" inside a task to use this
+require 'buzzcore/misc_utils'
+require 'buzzcore/string_utils'
+require 'buzzcore/xml_utils'
+require 'buzzcore/shell_extras'
+require 'net/ssh'
+require 'net/sftp'
+
+module CapUtils
+
+	# upload the given local file to the remote server and set the given mode.
+	# 0644 is the default mode
+	#
+	# Unix file modes :
+	# 4: read
+	# 2: write
+	# 1: execute
+	# 0[owner][group][other]
+	def upload_file(aLocalFilePath,aRemoteFilePath,aMode = 0644)
+		puts "* uploading #{aLocalFilePath} to #{aRemoteFilePath}"
+		s = nil
+		File.open(aLocalFilePath, "rb") { |f| s = f.read }
+		put(s,aRemoteFilePath,:mode => aMode)
+	end
+	
+	def render_template_file(aTemplateFile,aXmlConfig,aOutputFile,aMoreConfig=nil)
+		template = MiscUtils.string_from_file(aTemplateFile)
+		values = XmlUtils.read_config_values(aXmlConfig)
+		values = values ? values.merge(aMoreConfig || {}) : aMoreConfig
+		result = StringUtils.render_template(template, values)
+		MiscUtils.string_to_file(result, aOutputFile)
+  end
+
+	def get_ip
+		run "ifconfig eth0 |grep \"inet addr\"" do |channel,stream,data|
+			return data.scan(/inet addr:([0-9.]+)/).flatten.pop
+		end
+	end
+
+	# check if file exists. Relies on remote ruby
+	def remote_file_exists?(aPath)
+		remote_ruby("puts File.exists?('#{aPath}').to_s")=="true\n"
+	end
+
+	def remote_ruby(aRubyString)
+		run 'ruby -e "'+aRubyString+'"' do |channel,stream,data|
+			return data
+		end
+	end
+
+	def sudo_run(aString)
+# 		as = fetch(:runner, "app")
+# 		via = fetch(:run_method, :sudo)
+# 		invoke_command(aString, :via => via, :as => as)
+# 		if aUseSudo
+# 			run "sudo "+aString
+# 		else
+			run aString
+# 		end
+	end
+
+	def upload_file_anywhere(aSourceFile,aDestHost,aDestUser,aDestPassword,aDestFile,aDestPort=22)
+		Net::SSH.start(aDestHost, aDestUser, {:port => aDestPort, :password => aDestPassword, :verbose =>Logger::DEBUG}) do |ssh|
+			File.open(aSourceFile, "rb") { |f| ssh.sftp.upload!(f, aDestFile) }
+		end
+	end
+
+	def branch_name_from_svn_url(aURL)
+		prot_domain = (aURL.scan(/[^:]+:\/\/[^\/]+\//)).first
+		without_domain = aURL[prot_domain.length..-1]
+		return 'trunk' if without_domain =~ /^trunk\//
+		return (without_domain.scan(/branches\/(.+?)(\/|$)/)).flatten.first
+	end
+	
+	# give block with |aText,aStream,aState| that returns response or nil
+	def run_respond(aCommand)
+		run(aCommand) do |ch,stream,text|
+			ch[:state] ||= { :channel => ch }
+			output = yield(text,stream,ch[:state])
+			ch.send_data(output) if output
+		end
+	end
+
+	# pass prompt to user, and return their response
+	def run_prompt(aCommand)
+		run_respond aCommand do |text,stream,state|
+			Capistrano::CLI.password_prompt(text)+"\n"
+		end
+	end
+	
+	def ensure_link(aTo,aFrom,aDir=nil,aUserGroup=nil)
+		cmd = []
+		cmd << "cd #{aDir}" if aDir
+		cmd << "#{sudo} rm -f #{aFrom}"
+		cmd << "#{sudo} ln -sf #{aTo} #{aFrom}"
+		cmd << "#{sudo} chown -h #{aUserGroup} #{aFrom}" if aUserGroup
+		run cmd.join(' && ')
+	end
+	
+
+	def file_exists?(path)
+		begin
+			run "ls #{path}"
+			return true
+		rescue Exception => e
+			return false
+		end
+	end
+	
+	# Used in deployment to maintain folder contents between deployments.
+	# Normally the shared path exists and will be linked into the release.
+	# If it doesn't exist and the release path does, it will be moved into the shared path
+	# aFolder eg. "vendor/extensions/design"
+	# aSharedFolder eg. "design" 
+	def preserve_folder(aReleaseFolder,aSharedFolder)	
+		aReleaseFolder = File.join(release_path,aReleaseFolder)
+		aSharedFolder = File.join(shared_path,aSharedFolder)
+		release_exists = file_exists?(aReleaseFolder)
+		shared_exists = file_exists?(aSharedFolder)
+		if shared_exists
+			run "rm -rf #{aReleaseFolder}" if release_exists
+		else
+			run "mv #{aReleaseFolder} #{aSharedFolder}" if release_exists
+		end
+		ensure_link("#{aSharedFolder}","#{aReleaseFolder}",nil,"#{user}:#{apache_user}")
+	end
+
+	def select_target_file(aFile)
+		ext = MiscUtils.file_extension(aFile,false)
+		no_ext = MiscUtils.file_no_extension(aFile,false)
+		dir = File.dirname(aFile)
+		run "#{sudo} mv -f #{no_ext}.#{target}.#{ext} #{aFile}"
+		run "#{sudo} rm -f #{no_ext}.*.#{ext}"
+	end
+	
+	def shell(aCommandline,&aBlock)
+		result = block_given? ? POpen4::shell(aCommandline,nil,nil,&aBlock) : POpen4::shell(aCommandline)
+		return result[:stdout]
+	end
+
+	def run_local(aString)
+		`#{aString}`
+	end
+
+
+	def run_for_all(aCommand,aPath,aFilesOrDirs,aPattern=nil,aInvertPattern=false,aSudo=true)
+		#run "#{sudo} find . -wholename '*/.svn' -prune -o -type d -print0 |xargs -0 #{sudo} chmod 750"
+		#sudo find . -type f -exec echo {} \;
+		cmd = []
+		cmd << "sudo" if aSudo
+		cmd << "find #{aPath}"
+		cmd << "-wholename '#{aPattern}'" if aPattern
+		cmd << "-prune -o" if aInvertPattern
+		cmd << case aFilesOrDirs.to_s[0,1]
+			when 'f' then '-type f'
+			when 'd' then '-type d'
+			else ''
+		end
+		cmd << "-exec"		
+		cmd << aCommand
+		cmd << '{} \;'		
+		cmd = cmd.join(' ')
+		run cmd
+	end
+	
+	# if aGroup is given, that will be the users only group
+	def adduser(aNewUser,aPassword,aGroup=nil)
+		run "#{sudo} adduser --gecos '' #{aGroup ? '--ingroup '+aGroup : ''} #{aNewUser}" do |ch, stream, out|
+			ch.send_data aPassword+"\n" if out =~ /UNIX password:/
+		end
+	end
+	
+	def add_user_to_group(aUser,aGroup)
+		run "#{sudo} usermod -a -G #{aGroup} #{aUser}"
+	end
+
+end
+
+class CapUtilsClass
+	self.extend CapUtils
+end