sprout 0.7.246 → 1.0.0.pre

data/lib/sprout/version.rb

@@ -1,12 +1,17 @@
+
 module Sprout
+  NAME = 'sprout'
+
   if(!defined? Sprout::VERSION)
     module VERSION #:nodoc:
-      MAJOR = 0
-      MINOR = 7
-      TINY  = 246
+      MAJOR = 1
+      MINOR = 0
+      TINY  = 0
+      RELEASE = 'pre'
 
-      STRING = [MAJOR, MINOR, TINY].join('.')
+      STRING = [MAJOR, MINOR, TINY, RELEASE].join('.')
       MAJOR_MINOR = [MAJOR, MINOR].join('.')
     end
   end
 end
+

data/rakefile.rb

@@ -1,163 +1,104 @@
 require 'rubygems'
+require 'bundler'
+
+Bundler.setup
+
 require 'rake'
 require 'rake/clean'
 require 'rake/testtask'
-require 'rake/packagetask'
-require 'rake/gempackagetask'
 require 'rake/rdoctask'
-require 'rake/contrib/rubyforgepublisher'
-require 'fileutils'
-require File.dirname(__FILE__) + '/lib/sprout'
-require File.dirname(__FILE__) + '/lib/sprout/version'
-
-PROJECT                 = "sprout"
-NAME                    = "sprout"
-SUMMARY                 = "Sprout is an open-source, cross-platform project generation, configuration and build tool, that currently suports ActionScript 2, ActionScript 3, Flex and AIR development."
-GEM_VERSION             = Sprout::VERSION::STRING
-AUTHOR                  = "Luke Bayes"
-EMAIL                   = "projectsprouts@googlegroups.com"
-HOMEPAGE                = "http://www.projectsprouts.org"
-DESCRIPTION             =<<EOF
-Sprout is a modular set of tools that take the tedium and frustration out of creating and managing programming projects by automatically installing and configuring external tools, libraries, commands and build tasks. Bundles are currently available to support ActionScript 2, ActionScript 3, Flex and AIR development.
-EOF
-HOMEPATH                = "http://#{PROJECT}.rubyforge.org"
-RELEASE_TYPES           = ["gem"]
-PKG_LIST                = FileList['[a-zA-Z]*',
-                                  'samples/**/*',
-                                  'bin/**/*',
-                                  'lib/**/*',
-                                  'doc/*'
-                                  ]
-PKG_LIST.exclude('.svn')
-PKG_LIST.exclude('artifacts')
-PKG_LIST.each do |file|
-  task :package => file
-end
-
-def apply_shared_spec(s)
-    s.summary             = SUMMARY
-    s.description         = DESCRIPTION
-    s.name                = NAME
-    s.version             = GEM_VERSION
-    s.author              = AUTHOR
-    s.email               = EMAIL
-    s.homepage            = HOMEPAGE
-    s.rubyforge_project   = PROJECT
-    s.require_path        = 'lib'
-    s.bindir              = 'bin'
-    s.has_rdoc            = true
-    s.rdoc_options        << '--title' << 'Project Sprouts -- Core Documentation'
-    s.rdoc_options        << '--main' << 'Sprout::Sprout'
-    s.rdoc_options        << '--line-numbers' << '--inline-source'
-    s.rdoc_options        << '--charset' << 'utf-8'
-    s.rdoc_options        << '-i' << '.'
-    s.files               = PKG_LIST.to_a
-    s.executables         = ['sprout']
-    s.default_executable  = 'sprout'
-
-    s.add_dependency('rubyzip', '>= 0.9.1')
-    s.add_dependency('archive-tar-minitar', '>= 0.5.1')
-    s.add_dependency('rubigen', '1.5.4')
-    s.add_dependency('net-sftp', '>= 2.0.4')
-    s.add_dependency('net-ssh', '>= 2.0.19')
-    s.add_dependency('rake')
-end
-
-osx_spec = Gem::Specification.new do |s|
-  apply_shared_spec(s)
-  s.platform = 'darwin'
-  # Add osx-specific dependencies here
-
-  # Can't really depend on rb-appscript b/c this requires OS X dev-tool disk
-  #s.add_dependency('rb-appscript', '>= 0.5.0')
-  s.add_dependency('open4', '>= 0.9.6')
-end
-
-osx_snow_leopard_spec = Gem::Specification.new do |s|
-  apply_shared_spec(s)
-  s.platform = 'x86-darwin-10'
-  # Add snow-leopard-specific dependencies here
-
-  # Can't really depend on rb-appscript b/c this requires OS X dev-tool disk
-  #s.add_dependency('rb-appscript', '>= 0.5.0')
-  s.add_dependency('open4', '>= 0.9.6')
-end
-
-nix_spec = Gem::Specification.new do |s|
-  apply_shared_spec(s)
-  s.platform = 'x86-linux'
-  # Add nix-specific dependencies here
-  s.add_dependency('open4', '>= 0.9.6')
-end
-
-win_spec = Gem::Specification.new do |s|
-  apply_shared_spec(s)
-  s.platform = 'mswin32'
-  # Add win-specific dependencies here
-  s.add_dependency('win32-open3', '0.2.5')
-  # Added again here b/c win users report
-  # having to install these manually:
-  s.add_dependency('net-sftp', '>= 2.0.4')
-  s.add_dependency('net-ssh', '>= 2.0.19')
-end
-
-ruby_spec = Gem::Specification.new do |s|
-  apply_shared_spec(s)
-  s.platform = Gem::Platform::RUBY
-  s.add_dependency('open4', '>= 0.9.6')
-end
 
-Rake::GemPackageTask.new(osx_spec) do |pkg|
-end
-
-Rake::GemPackageTask.new(osx_snow_leopard_spec) do |pkg|
-end
-
-Rake::GemPackageTask.new(nix_spec) do |pkg|
-end
-
-Rake::GemPackageTask.new(win_spec) do |pkg|
-end
-
-Rake::GemPackageTask.new(ruby_spec) do |pkg|
-end
+require File.dirname(__FILE__) + '/lib/sprout/version'
 
-Rake::RDocTask.new do |t|
-  t.rdoc_files.include(['doc/*', 'lib/*.rb', 'lib/**/*.rb', 'MIT-LICENSE'])
-  t.title    = "Project Sprouts -- Core Documentation"
-  t.rdoc_dir = 'rdoc'
-  t.main     = 'Sprout::Sprout'
-  t.options << '--line-numbers' << '--inline-source'
-  t.options << '--charset' << 'utf-8'
-  t.options    << '-i .'
+Rake::RDocTask.new do |rdoc|
+  rdoc.title = "Project Sprouts v.#{Sprout::VERSION::STRING}"
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.main = "Sprout::Sprout"
+  rdoc.rdoc_files.include("README.textile", "lib/**/*.rb")
 end
 
 CLEAN.add('rdoc')
 
+namespace :test do
+  Rake::TestTask.new(:units) do |t|
+    t.libs << "test/unit"
+    t.test_files = FileList["test/unit/*_test.rb"]
+    t.verbose = true
+  end
 
-require File.dirname(__FILE__) + '/script/build_helpers'
-
-def fix_x86_mswin
-  files = Dir.glob('pkg/*x86-mswin*')
-  files.each do |name|
-    new_name = name.gsub('-x86', '')
-    puts "Renaming x86-mswin gem from #{name} to #{new_name}"
-    FileUtils.mv(name, new_name)
+  namespace :coverage do
+    desc "Delete aggregate coverage data."
+    task(:clean) { rm_f "coverage.data" }
   end
-end
 
-task :package do
-  fix_x86_mswin
-end
+  # Apparently, rcov does not work on Windows.
+  # Hide these tasks so that we can at least
+  # run the others...
+  if(!(RUBY_PLATFORM =~ /mingw/i) && !(RUBY_PLATFORM =~/mswin/i))
+    require 'rcov/rcovtask'
+
+    namespace :coverage do
+      desc "Delete aggregate coverage data."
+      task(:clean) { rm_f "coverage.data" }
+    end
+  
+    desc "Aggregate code coverage for unit, functional and integration tests"
+    task :coverage => "test:coverage:clean"
+  
+    # Hold collection in case we need it:
+    #%w[unit functional integration].each do |target|
+    %w[unit].each do |target|
+      namespace :coverage do
+        Rcov::RcovTask.new(target) do |t|
+          t.libs = ["lib", "test"]
+          t.test_files = FileList["test/#{target}/**/*_test.rb"]
+          t.output_dir = ".coverage/#{target}"
+          t.verbose = true
+          t.rcov_opts << "--aggregate coverage.data --exclude .bundle"
+        end
+      end
+      task :coverage => "test:coverage:#{target}"
+    end
+  end
 
-desc "Release to GemCutter"
-task :release_to_gemcutter do
-  files = FileList.new('pkg/*.gem')
-  files.each do |file|
-    sh "gem push #{file}"
+  namespace :torture do
+    desc "Flog the Sprouts"
+    task :flog do
+      puts "--------------------------"
+      puts "Flog Report:"
+      message =<<EOM
+According to Jake Scruggs at: http://bit.ly/3QrvW
+
+Score of    Means
+0-10        Awesome
+11-20       Good enough
+21-40       Might need refactoring
+41-60       Possible to justify
+61-100      Danger
+100-200     Whoop, whoop, whoop
+200 +       Someone please think of the children
+EOM
+      puts message
+      puts ""
+
+      sh "find lib -name '*.rb' | xargs flog"
+    end
+
+    desc "Flay the Sprouts"
+    task :flay do
+      puts "--------------------------"
+      puts "Flay Report:"
+      sh "flay lib/**/*.rb"
+    end
   end
+
+  desc "Run all tortuous reports"
+  task :torture => ['torture:flog', 'torture:flay']
+
 end
 
-desc 'Clean, Package and Release gems to Gemcutter'
-task :release => [:clean, :package, :release_to_gemcutter]
+task :test => 'test:units'
+
+desc "Run all tests and reports"
+task :cruise => [:test, 'test:coverage', 'test:torture']
 

data/script/console

@@ -0,0 +1,10 @@
+#!/usr/bin/env ruby
+# File: script/console
+irb = RUBY_PLATFORM =~ /(:?mswin|mingw)/ ? 'irb.bat' : 'irb'
+
+libs =  " -r irb/completion"
+# Perhaps use a console_lib to store any extra methods I may want available in the cosole
+# libs << " -r #{File.dirname(__FILE__) + '/../lib/console_lib/console_logger.rb'}"
+libs <<  " -r #{File.dirname(__FILE__) + '/../lib/as3.rb'}"
+puts "Loading as3 gem"
+exec "#{irb} #{libs} --simple-prompt"

data/script/destroy

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+APP_ROOT = File.expand_path(File.join(File.dirname(__FILE__), '..'))
+
+begin
+  require 'rubigen'
+rescue LoadError
+  require 'rubygems'
+  require 'rubigen'
+end
+require 'rubigen/scripts/destroy'
+
+ARGV.shift if ['--help', '-h'].include?(ARGV[0])
+RubiGen::Base.use_component_sources! [:rubygems, :newgem, :newgem_theme, :test_unit]
+RubiGen::Scripts::Destroy.new.run(ARGV)

data/script/generate

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+APP_ROOT = File.expand_path(File.join(File.dirname(__FILE__), '..'))
+
+begin
+  require 'rubigen'
+rescue LoadError
+  require 'rubygems'
+  require 'rubigen'
+end
+require 'rubigen/scripts/generate'
+
+ARGV.shift if ['--help', '-h'].include?(ARGV[0])
+RubiGen::Base.use_component_sources! [:rubygems, :newgem, :newgem_theme, :test_unit]
+RubiGen::Scripts::Generate.new.run(ARGV)

data/sprout.gemspec

@@ -0,0 +1,26 @@
+# -*- encoding: utf-8 -*-
+lib = File.expand_path File.join(File.dirname(__FILE__), 'lib')
+$:.unshift lib unless $:.include?(lib)
+
+require 'bundler'
+require 'rake'
+require 'sprout/version'
+
+Gem::Specification.new do |s|
+  s.name                      = 'sprout'
+  s.version                   = Sprout::VERSION::STRING
+  s.platform                  = Gem::Platform::RUBY
+  s.authors                   = ["Luke Bayes"]
+  s.email                     = "projectsprouts@googlegroups.com"
+  s.homepage                  = "http://projectsprouts.org"
+  s.summary                   = "Software development - evolved"
+  s.description               = "Project Sprouts gives you access to beautiful generators and easily customized templates, automated build scripts, distributed libraries and simple system configuration"
+  s.post_install_message      = File.read 'POSTINSTALL.rdoc'
+  s.required_rubygems_version = ">= 1.3.6"
+  s.rubyforge_project         = "sprout" 
+  s.require_path              = ['lib']
+  s.files                     = FileList['**/**/*'].exclude /.git|.svn|.DS_Store/
+  s.executables               = ['sprout', 'sprout-library', 'sprout-tool', 'sprout-generator']
+  s.add_bundler_dependencies
+end
+

data/test/fixtures/examples/app_generator.rb

@@ -0,0 +1,127 @@
+##
+# This is an example of how I think generators ought to look.
+#
+# The current interface to Rubigen is unacceptable because
+# of it's dependence on duplicate boilerplate, and global 
+# state.
+#
+# should also be a generator helper that allows you 
+# to reference an existing directory on disk, and will 
+# emit a new generator (gem?) that would recreate those files:
+#
+#     sprout-generator-importer ~/Projects/SomeProject
+#
+class AppGenerator
+  include Sprout::Generator
+
+  ##
+  # The path where classes should usually be created.
+  add_param :src, String, { :default => 'src' }
+
+  ##
+  # The path where test cases should be created.
+  add_param :test, String, { :default => 'test' }
+
+  ##
+  # The path where libraries should be added.
+  add_param :lib, String, { :default => 'lib' }
+
+  ##
+  # The path where binaries should be created.
+  add_param :bin, String, { :default => 'bin' }
+
+  ##
+  # The path where all assets should be created.
+  add_param :assets, String, { :default => 'assets' }
+
+  ##
+  # The path where skins should be created.
+  add_param :skins, String, { :default => 'skins' }
+
+  ##
+  # The path where scripts are created.
+  add_param :script, String, { :default => 'script' }
+
+  ##
+  # The name of the project that should be created.
+  add_param :input, String, { :reader => :get_input }
+
+  ##
+  # Prevent the creation of a lib directory.
+  add_param :no_lib, Boolean
+
+  ##
+  # Prevent the creation of an assets directory.
+  add_param :no_assets, Boolean
+
+  def manifest
+    directory input do
+      file 'rakefile.rb.erb', 'rakefile.rb'
+      file 'Gemfile.erb', 'Gemfile'
+
+      directory src do
+        file 'Class.as.erb', "#{input}.as"
+      end
+
+      directory File.join(assets, skins) do
+        file 'ProjectSprouts.png', 'ProjectSprouts.png'
+      end unless no_assets
+
+      directory lib unless no_lib
+      directory bin
+
+      default_project_files
+    end
+  end
+
+  private
+
+  def get_input
+    @input.camel_case
+  end
+  
+end
+
+
+##
+# Defined in the imaginary base class:
+def default_project_files
+  directory script do
+    file 'generate', 'generate'
+    file 'destroy', 'destroy'
+    file 'console', 'console'
+  end
+end
+
+##
+# These directives ought to also be very easy to test.
+#
+class AppGeneratorTest
+  include Sprout::GeneratorTestHelper
+
+  context "a new generator" do
+
+    setup do
+      @fixture = File.join fixtures, 'generators'
+      @generator = ProjectGenerator.new 
+      @generator.path = @fixture
+      @generator.name = 'SomeProject'
+      @generator.execute
+    end
+
+    should_create_directory File.join(@fixture, 'SomeProject') do
+      with_file 'rakefile.rb' do |content|
+        assert_matches /SomeProject.as/, content
+        assert_matches /SomeProjectRunner.as/, content
+        assert_matches /SomeProject.swf/, content
+      end
+      should_create_directory 'script' do
+        with_file 'generate'
+        with_file 'destroy'
+        with_file 'console'
+      end
+    end
+  end
+
+end
+