hoopla_salesforce 0.0.3 → 0.0.4

data/README.md

@@ -0,0 +1,114 @@
+hoopla_salesforce
+=================
+
+A nitfy bundle of dev and deployment tools for working on the (Sales)force.com platform.
+
+Features
+========
+
+1. Generates new empty projects
+2. Deploys your project with Rake
+3. Generates *-meta.xml for any files that are missing it
+4. Runs tests on deploy and prints results in ANSI color
+5. Auto-packages folders in src/resource as staticresources
+6. Undeploys your project (destructiveChanges.xml is auto-generated)
+7. Pre-processes any VisualForce or Apex files with ERB
+8. Generates static test pages from VisualForce pages
+9. Runs tests via the Web UI (as results often differ from deploy tests)
+10. Makes pancakes (pending)
+
+Usage
+=====
+
+Install it with:
+
+    (sudo) gem install hoopla_salesforce
+
+There are a lot of features in here, so the rest of this document will go over how they work.
+
+Generating new projects
+-----------------------
+
+Just run:
+
+    hoopla_salesforce init myproject
+
+This will create an folder called myproject that looks like this:
+
+    - myproject 
+    |- Rakefile
+    |- lib/
+    \- src/
+     |- applications/
+     |- classes/
+     |- objects/
+     |- pages/
+     |- resources/
+     |- tabs/
+     |- triggers/
+     \- package.xml 
+
+Once this is done, drop the enterprise.xml and metadata.xml for your org into `lib/` and update the `Rakefile` to reflect your username, password and security token. Now your project is ready to deploy. Run `rake -T` to show the available rake tasks.
+
+Deploy your projects with rake
+------------------------------
+
+Deploy your project using `rake hsf:deploy:development`. Or if you change the environment name of your DeployTask, use whatever you specified in place of 'development'.
+
+If you need to see the full deployment output run it with `FULL_OUTPUT=true`. Currently coverage information is only available in the full output. The default output will include colorized information about what's been added, updated, tests run, any failures or compilation problems.
+
+Generating meta.xml files
+-------------------------
+
+During deployment, we'll generate any missing meta.xml files for your assets. This currently supports generation for classes, pages, documents, static resources, and triggers. If you already have meta.xml files for your resources, the gem will skip those and include your files for deployment.
+
+Autopackaging of static resources
+---------------------------------
+
+As part of deployment, any folders in src/resources will get zipped up as static resources. So for example if you had a folder `src/resources/Performance` the contents of this folder will get zipped into `src/static/resources/Performance.resource`. This makes dealing with zipped CSS/JavaScript much easier.
+
+Undeploying your project
+------------------------
+
+To undeploy your project run `rake hsf:undeploy:development`. This will scan your src folder and generate the appropriate destructiveChanges.xml file used by Salesforce to undeploy your code.
+
+Note that undeployed fields are still left in the "deleted fields" section of the site. Once you have two copies of a deleted field, you can't re-deploy that field without first cleaning up the deleted fields via the WebUI. Automatic erasing of fields is a planned feature to avoid this headache.
+
+Pre-processing with ERB
+-----------------------
+
+If you append `.erb` to any file in your project, it will get processed through Erubis prior to deployment. This makes it possible to DRY up a lot of your XML, abstract common patterns and even write simple Apex macros.
+
+Just before the templates are run, the deployer will look for `lib/template_helper.rb` and load that. In this file you can mix your own methods into the template processors. The following example allows you to use `<%= name 'MyObject' %>` in an object definition to avoid writing the XML boilerplate that's required by salesforce.
+
+    module GenericHelper
+      def object(&block)
+        code = <<-XML.margin
+          <?xml version="1.0" encoding="UTF-8"?>
+          <CustomObject xmlns="http://soap.sforce.com/2006/04/metadata">
+            <deploymentStatus>Deployed</deploymentStatus>
+            <sharingModel>ReadWrite</sharingModel>
+            #{capture &block}
+          </CustomObject>
+        XML
+      end
+    end
+    HooplaSalesforce::TemplateProcessor::Generic.send(:include, GenericHelper)
+
+Note that you must currently mix your module into the processors at the bottom of the file. The currently available processors are:
+
+* `HooplaSalesforce::TemplateProcessor::VisualForce` - used for processing page files
+* `HooplaSalesforce::TemplateProcessor::TestPage` - used for generating static test pages
+* `HooplaSalesforce::TemplateProcessor::Generic` - used for any other files
+
+Generating Static Test Pages
+----------------------------
+
+(documentation pending)
+
+Running tests
+-------------
+
+Use WEB_TEST=true to run via web ui. Default will run during deployment. Use TEST_NAMES=Test1,Test2,etc to run specific tests (or TEST_NAMES="" to skip tests).
+
+(more documentation pending)

data/bin/hoopla_salesforce

@@ -0,0 +1,8 @@
+#!/usr/bin/env ruby
+
+begin
+  require 'hoopla_salesforce/commands'
+rescue LoadError
+  require 'rubygems'
+  require 'hoopla_salesforce/commands'
+end

data/lib/hoopla_salesforce/commands.rb

@@ -0,0 +1,21 @@
+require 'hoopla_salesforce/info'
+require 'commander/import'
+require 'hoopla_salesforce/ext/commander'
+
+program :name,        HooplaSalesforce.name
+program :version,     HooplaSalesforce.version
+program :description, HooplaSalesforce.summary
+
+default_command :help
+
+command "init" do |c|
+  c.syntax      = '[options] <directory>'
+  c.summary     = 'Creates a skeleton app.'
+  c.description = 'Creates a skeleton Salesforce.com app in the specified directory.'
+
+  c.action do |args, options|
+    directory = args.first or raise "Directory name required."
+    require 'hoopla_salesforce/skeleton'
+    HooplaSalesforce::Skeleton.new(directory).create
+  end
+end

data/lib/hoopla_salesforce/deployer.rb

@@ -45,7 +45,7 @@ module HooplaSalesforce
       @header = { "wsdl:SessionHeader" => { "wsdl:sessionId" => response[:session_id] } }
     end
 
-    def deploy(zipfile, options)
+    def deploy(zipfile, options = {})
       login
 
       data = Base64.encode64(File.read(zipfile))

data/lib/hoopla_salesforce/eruby.rb

@@ -0,0 +1,54 @@
+require 'erubis'
+
+module HooplaSalesforce
+  class OutputBuffer < String
+    alias :append=           :<<
+    alias :safe_concat       :<<
+  end
+
+  module CaptureHelper
+    def capture
+      @output_buffer, original_buffer = HooplaSalesforce::OutputBuffer.new, @output_buffer
+      yield
+      @output_buffer, buffer = original_buffer, @output_buffer
+      buffer
+    end
+  end
+
+  class Eruby < Erubis::Eruby
+    def add_preamble(src)
+      src << "@output_buffer = HooplaSalesforce::OutputBuffer.new;"
+    end
+
+    def add_text(src, text)
+      return if text.empty?
+      src << "@output_buffer.safe_concat('" << escape_text(text) << "');"
+    end
+
+    BLOCK_EXPR = /\s+(do|\{)(\s*\|[^|]*\|)?\s*\Z/
+
+    def add_expr_literal(src, code)
+      if code =~ BLOCK_EXPR
+        src << '@output_buffer.append= ' << code
+      else
+        src << '@output_buffer.append= (' << code << ');'
+      end
+    end
+
+    def add_stmt(src, code)
+      if code =~ BLOCK_EXPR
+        src << code
+      else
+        super
+      end
+    end
+
+    def add_expr_escaped(src, code)
+      src << '@output_buffer.append= ' << escaped_expr(code) << ';'
+    end
+
+    def add_postamble(src)
+      src << '@output_buffer.to_s'
+    end
+  end
+end

data/lib/hoopla_salesforce/ext/commander.rb

@@ -0,0 +1,7 @@
+# Automatically include the executable and command name
+# in the syntax statment
+class Commander::Command
+  def syntax=(syntax)
+    @syntax = "#{HooplaSalesforce.name} #{@name} #{syntax}"
+  end
+end

data/lib/hoopla_salesforce/ext/string.rb

@@ -0,0 +1,14 @@
+class String
+  def margin
+    spaces = match(/^\s*/)
+    gsub(/^#{spaces[0]}/, '')
+  end
+
+  def camelize(first_letter_in_uppercase = true)
+    if first_letter_in_uppercase
+      gsub(/\/(.?)/) { "::#{$1.upcase}" }.gsub(/(?:^|_)(.)/) { $1.upcase }
+    else
+      first.downcase + camelize(lower_case_and_underscored_word)[1..-1]
+    end
+  end
+end

data/lib/hoopla_salesforce/info.rb

@@ -0,0 +1,19 @@
+module HooplaSalesforce
+  class << self
+    def name
+      "hoopla_salesforce"
+    end
+
+    def summary
+      "Helpers for building Salesforce.com projects"
+    end
+
+    def description
+      summary
+    end
+
+    def version
+      "0.0.4"
+    end
+  end
+end

data/lib/hoopla_salesforce/package_generator.rb

@@ -0,0 +1,130 @@
+require 'hoopla_salesforce/utils'
+require 'nokogiri'
+
+module HooplaSalesforce
+  class PackageGenerator
+    include Utils
+
+    attr_reader :processed_src
+    attr_reader :api_version
+
+    # Right now this only works with making a destructiveChanges.xml
+    # Need to add support namespace, etc before using to generate package.xml
+    def initialize(processed_src, api_version)
+      @processed_src = processed_src
+      @api_version = api_version
+    end
+
+    def supported_types
+      %w(apex_class apex_page custom_tab custom_application apex_trigger custom_field
+         static_resource)
+    end
+
+    def map_files(glob, &block)
+      Dir["#{processed_src}/#{glob}"].map(&block)
+    end
+
+    def members_for_apex_class
+      map_files("classes/*.cls") do |klass|
+        data = File.read(klass)
+        extract_class_name(data)
+      end
+    end 
+
+    def members_for_apex_trigger
+      map_files("triggers/*.trigger") do |trigger|
+        data = File.read(trigger)
+        extract_trigger_name(data)
+      end
+    end
+
+    def members_for_apex_page
+      map_files("pages/*.page") do |page|
+        File.basename(page, '.page')
+      end
+    end
+
+    def members_for_custom_tab
+      map_files("tabs/*.tab") do |tab|
+        File.basename(tab, '.tab')
+      end
+    end
+
+    def members_for_custom_application
+      map_files("applications/*.app") do |app|
+        File.read(app).match(/<fullName>([^<]*)<\/fullName>/)[1]
+      end
+    end
+
+    def members_for_custom_field
+      map_files("objects/*.object") do |object|
+        obj_name = File.basename(object, ".object")
+        data = File.read(object)
+        xml_doc = Nokogiri::XML(data)
+        xml_doc.search("fullName").map { |f| [obj_name, f.text].join('.') }
+      end.flatten
+    end
+
+    def members_for_static_resource
+      map_files("staticresources/*.resource") do |resource|
+        File.basename(resource, ".resource")
+      end
+    end
+
+    def empty_package_xml
+      <<-EOS.margin
+        <?xml version="1.0" encoding="UTF-8"?>
+        <Package xmlns="http://soap.sforce.com/2006/04/metadata">
+          <version>#{api_version}</version>
+        </Package>
+      EOS
+    end
+
+    def destructive_changes_xml
+      <<-EOS.margin
+        <?xml version="1.0" encoding="UTF-8"?>
+        <Package xmlns="http://soap.sforce.com/2006/04/metadata">
+          #{package_types}
+          <version>#{api_version}</version>
+        </Package>
+      EOS
+    end
+
+    def package_types
+      supported_types.map do |type|
+        members = send("members_for_#{type}")
+        unless members.empty?
+          members_xml = members.map { |m| "<members>#{m}</members>" }.join("\n")
+          <<-EOS.margin
+            <types>
+              #{members_xml}
+              <name>#{type.camelize}</name>
+            </types>
+          EOS
+        end
+      end.join("\n")
+    end
+
+    def generate_destructive_changes
+      write_xml "package.xml",            empty_package_xml
+      write_xml "destructiveChanges.xml", destructive_changes_xml
+      remove_processed_files_for_undeploy
+    end
+
+    def write_xml(file, data)
+      File.open("#{processed_src}/#{file}", 'w') do |pkg|
+        pkg.print data
+      end
+    end
+
+    def protected_files_for_destruction
+      %W(#{processed_src}/package.xml #{processed_src}/destructiveChanges.xml)
+    end
+
+    def remove_processed_files_for_undeploy
+      Dir["#{processed_src}/*"].each do |file|
+        FileUtils.rm_rf(file) unless protected_files_for_destruction.include?(file)
+      end 
+    end
+  end
+end

data/lib/hoopla_salesforce/rake/deploy_task.rb

@@ -1,4 +1,7 @@
 require 'hoopla_salesforce/rake/base_task'
+require 'hoopla_salesforce/ext/string'
+require 'hoopla_salesforce/template_processor'
+require 'hoopla_salesforce/utils'
 
 module HooplaSalesforce
   module Rake
@@ -11,6 +14,8 @@ module HooplaSalesforce
     #   - Zips up any folders found in src/resources as src/staticresources/#{folder}.resource.
     #     This allows you to only keep the raw assets in your project
     class DeployTask < BaseTask
+      include Utils
+
       # Your project root. Defaults to 'src'
       attr_accessor :src
 
@@ -23,50 +28,195 @@ module HooplaSalesforce
       # the namespaced package) and a dev org (that does not have one).
       #
       # default - nil
-      attr_accessor :namespace
+      attr_accessor :package_namespace
 
       # The directory in which to store processed source files.
       # Defaults to #{src}-processed
       attr_accessor :processed_src
 
-      def initialize(name=:deploy)
-        @deploy_file = "deploy.zip"
-        @src = 'src'
-        @namespace = nil
+      # Which file to load before processing templates. Default: lib/template_helper.rb
+      # To have this file inject methods into the HooplaSalesforce::TemplateProcessor,
+      # be sure to include your module in HooplaSalesforce::TemplateProcessor::VisualForce or 
+      # HooplaSalesforce::TemplateProcessor::TestPage at the bottom of your template_helper
+      # file.
+      attr_accessor :template_helper
+
+      def initialize(name=:production)
+        @deploy_file       = "deploy.zip"
+        @src               = 'src'
+        @package_namespace = nil
+        @template_helper   = 'lib/template_helper.rb'
         super
-        @namespace += "__" if @namespace
-        @processed_src ||= "#{src}-processed" 
+        @package_namespace  += "__" if @package_namespace
+        @processed_src     ||= "#{src}-processed" 
+      end
+
+      def clean_namespace
+        package_namespace.sub(/__$/, '') if package_namespace
       end
 
       def define
-        desc "Deploy to salesforce"
-        task name do
-          process_source
-          make_resources
-          make_zipfile
-          require 'hoopla_salesforce/deployer'
-          HooplaSalesforce::Deployer.new(username, password, token, enterprise_wsdl, metadata_wsdl).deploy(deploy_file, deploy_options)
+        if name.is_a? Hash
+          task_name = name.keys.first
+          dependencies = name[task_name]
+        else
+          task_name = name
+          dependencies = []
+        end
+
+        namespace :hsf do
+          namespace :undeploy do
+            desc "Undeploy all components in #{src} from salesforce"
+            task task_name => dependencies do
+              process_source
+              require 'hoopla_salesforce/package_generator'
+              PackageGenerator.new(processed_src, api_version).generate_destructive_changes
+              make_zipfile
+              deploy_zipfile
+            end
+          end
+
+          namespace :deploy do
+            desc "Deploy to salesforce"
+            task task_name => dependencies do
+              process_source
+              make_meta_xmls
+              make_zipfile
+              deploy_zipfile
+            end
+          end
+
+          desc "Renders any page templates as test pages in #{processed_src}/pages-test"
+          task :testpages => dependencies do
+            mkdir_p "#{src}/pages-test"
+            make_pages do |template|
+              HooplaSalesforce::TemplateProcessor::TestPage.new(src, template)
+            end
+          end
         end
       end
 
-      def deploy_options
-        testNames = Dir["#{src}/classes/*.cls"].inject([]) do |names, f|
-          body = File.read(f)
-          if body =~ /(testMethod|@isTest)/ && match = body.match(/\bclass\s+(\w+)\s*\{\s*/)
-            names << match[1]
-          else
-            names
+      def test_names
+        if ENV['TEST_NAMES']
+          ENV['TEST_NAMES'].split(',')
+        else
+          Dir["#{processed_src}/classes/*.cls"].inject([]) do |names, f|
+            body = File.read(f)
+            if body =~ /(testMethod|@isTest)/ && name = extract_class_name(body)
+              names << name
+            else
+              names
+            end
           end
         end
+      end
 
-        if testNames.empty?
+      def test_options
+        if test_names.empty?
           { "wsdl:runAllTests" => true }
         else
-          testNames.map! { |n| namespace.sub(/__$/, '.') + n } if namespace
+          test_names.map! { |n| "#{clean_namespace}.#{n}" } if package_namespace
           { "wsdl:runTests" => testNames }
         end
       end
 
+      def api_version
+        return @api_version if @api_version
+        File.read("#{src}/package.xml") =~ /<version>(.*)<\/version>/i
+        @api_version = $1
+      end
+
+      def make_pages
+        require template_helper if File.exist?(template_helper)
+
+        Dir["#{src}/pages/*.page.erb"].each do |template|
+          yield template
+        end
+      end
+
+      def preprocess_files
+        require template_helper if File.exist?(template_helper)
+
+        Dir["#{processed_src}/**/*.erb"].each do |template|
+          yield template
+        end
+      end
+
+      def make_meta(glob)
+        Dir["#{processed_src}/#{glob}"].each do |file|
+          meta = "#{file}-meta.xml"
+          next if file =~ /-meta\.xml$/ || File.exist?(meta)
+          File.open(meta, 'w') do |f|
+            f.print yield(file)
+          end
+        end
+      end
+
+      def make_meta_xmls
+        make_meta "classes/*.cls" do |klass|
+          <<-EOS.margin
+            <?xml version="1.0" encoding="UTF-8"?>
+            <ApexClass xmlns="http://soap.sforce.com/2006/04/metadata">
+              <apiVersion>#{api_version}</apiVersion>
+            </ApexClass>
+          EOS
+        end
+
+        make_meta "pages/*.page" do |page|
+          <<-EOS.margin
+            <?xml version="1.0" encoding="UTF-8"?>
+            <ApexClass xmlns="http://soap.sforce.com/2006/04/metadata">
+              <apiVersion>#{api_version}</apiVersion>
+              <label>#{File.basename(page, '.page')}</label>
+            </ApexClass>
+          EOS
+        end
+
+        make_meta "documents/**/*" do |doc|
+          if File.directory?(doc)
+            m = <<-EOS.margin
+              <?xml version="1.0" encoding="UTF-8"?>
+              <DocumentFolder xmlns="http://soap.sforce.com/2006/04/metadata">
+                <name>#{File.basename(doc)}</name>
+                <accessType>Public</accessType>
+                <publicFolderAccess>ReadOnly</publicFolderAccess>
+              </DocumentFolder>
+            EOS
+          else
+            <<-EOS.margin
+              <?xml version="1.0" encoding="UTF-8"?>
+              <Document xmlns="http://soap.sforce.com/2006/04/metadata">
+                <internalUseOnly>false</internalUseOnly>
+                <name>#{File.basename(doc)}</name>
+                <public>true</public>
+                <description>A document</description>
+              </Document>
+            EOS
+          end
+        end
+
+        make_meta "staticresources/*.resource" do |resource|
+          <<-EOS.margin
+            <?xml version="1.0" encoding="UTF-8"?>
+            <StaticResource xmlns="http://soap.sforce.com/2006/04/metadata">
+              <cacheControl>Private</cacheControl>
+              <contentType>application/zip</contentType>
+              <description>A static resource</description>
+            </StaticResource>
+          EOS
+        end
+
+        make_meta "triggers/*.trigger" do |trigger|
+          <<-EOS.margin
+            <?xml version="1.0" encoding="UTF-8"?>
+            <ApexTrigger xmlns="http://soap.sforce.com/2006/04/metadata">
+                <apiVersion>#{api_version}</apiVersion>
+                <status>Active</status>
+            </ApexTrigger>
+          EOS
+        end
+      end
+
       def make_resources
         require 'zip/zip'
 
@@ -83,7 +233,8 @@ module HooplaSalesforce
             end
           end
 
-          cp "#{f}.resource-meta.xml", "#{resourcefile}-meta.xml"
+          source_meta = "#{f}.resource-meta.xml"
+          cp source_meta, "#{resourcefile}-meta.xml" if File.exist?(source_meta)
         end
       end
 
@@ -97,17 +248,39 @@ module HooplaSalesforce
         end
       end
 
+      def deploy_zipfile
+        require 'hoopla_salesforce/deployer'
+        deployer = HooplaSalesforce::Deployer.new(username, password, token, enterprise_wsdl, metadata_wsdl)
+        if ENV['WEB_TESTS']
+          require 'hoopla_salesforce/web_agent'
+          deployer.deploy(deploy_file)
+          WebAgent.new(username, password).run_tests(test_names, clean_namespace)
+        else
+          deployer.deploy(deploy_file, test_options)
+        end
+      end
+
       def process_source
         rm_rf processed_src
         cp_r src, processed_src
         Dir["#{processed_src}/**/*"].each do |f|
           next if File.directory?(f)
-          system %Q|ruby -i -n -e 'print $_.gsub("__NAMESPACE__", "#{namespace}")' "#{f}"|
+          system %Q|ruby -i -n -e 'print $_.gsub("__NAMESPACE__", "#{package_namespace}")' "#{f}"|
+        end
+
+        if package_namespace
+          system %Q|ruby -i -n -e 'print $_.gsub("#{package_namespace}", "#{clean_namespace}")' "#{processed_src}/package.xml"|
+        end
+
+        make_resources
+        make_pages do |template|
+          HooplaSalesforce::TemplateProcessor::VisualForce.new(processed_src, template)
+          rm template.sub(src, processed_src)
         end
 
-        if namespace
-          clean_namespace = namespace.sub(/__$/, '')
-          system %Q|ruby -i -n -e 'print $_.gsub("#{namespace}", "#{clean_namespace}")' "#{processed_src}/package.xml"|
+        preprocess_files do |template|
+          HooplaSalesforce::TemplateProcessor::Generic.new(processed_src, template)
+          rm template
         end
       end
     end

data/lib/hoopla_salesforce/rake/retrieve_task.rb

@@ -20,10 +20,12 @@ module HooplaSalesforce
       end
 
       def define
-        desc "Retrieve all apex classes from salesforce.com"
-        task name do
-          require 'hoopla_salesforce/deployer'
-          HooplaSalesforce::Deployer.new(username, password, token, enterprise_wsdl, metadata_wsdl).retrieve(request)
+        namespace :hsf do
+          desc "Retrieve all apex classes from salesforce.com"
+          task name do
+            require 'hoopla_salesforce/deployer'
+            HooplaSalesforce::Deployer.new(username, password, token, enterprise_wsdl, metadata_wsdl).retrieve(request)
+          end
         end
       end
     end

data/lib/hoopla_salesforce/skeleton.rb

@@ -0,0 +1,121 @@
+require 'fileutils'
+require 'hoopla_salesforce/ext/string'
+
+module HooplaSalesforce
+  class Skeleton
+    include FileUtils
+
+    attr_reader :directory
+
+    def initialize(directory)
+      @directory = directory
+    end
+
+    def mkdir_p(dir='')
+      super directory + dir
+    end
+
+    def create
+      puts "Creating a skeleton in #{directory}"
+      %w(applications classes objects pages resources tabs triggers).each do |dir|
+        mkdir_p "/src/#{dir}"
+      end
+      mkdir_p '/lib'
+      make_package_xml
+      make_rakefile
+      make_gitignore
+      followup_instructions
+    end
+
+    def make_package_xml
+      File.open("#{directory}/src/package.xml", 'w') do |pkg|
+        pkg.print <<-EOS.margin
+          <?xml version="1.0" encoding="UTF-8"?>
+          <Package xmlns="http://soap.sforce.com/2006/04/metadata">
+            <fullName></fullName>
+            <apiAccessLevel>Unrestricted</apiAccessLevel>
+            <description></description>
+            <namespacePrefix>__NAMESPACE__</namespacePrefix>
+            <types>
+              <members>*</members>
+              <name>ApexClass</name>
+            </types>
+            <types>
+              <members>*</members>
+              <name>ApexPage</name>
+            </types>
+            <types>
+              <members>*</members>
+              <name>ApexTrigger</name>
+            </types>
+            <types>
+              <members>*</members>
+              <name>CustomApplication</name>
+            </types>
+            <types>
+              <members>*</members>
+              <name>CustomObject</name>
+            </types>
+            <types>
+              <members>*</members>
+              <name>CustomField</name>
+            </types>
+            <types>
+              <members>*</members>
+              <name>ValidationRule</name>
+            </types>
+            <types>
+              <members>*</members>
+              <name>CustomTab</name>
+            </types>
+            <types>
+              <members>*</members>
+              <name>StaticResource</name>
+            </types>
+            <version>18.0</version>
+          </Package>
+        EOS
+      end
+    end
+
+    def make_rakefile
+      File.open("#{directory}/Rakefile", 'w') do |rakefile|
+        rakefile.print <<-EOS.margin
+          require 'hoopla_salesforce/rake'
+          
+          HooplaSalesforce.enterprise_wsdl = "lib/enterprise.xml"
+          HooplaSalesforce.metadata_wsdl   = "lib/metadata.xml"
+          
+          namespace :deploy do
+            HooplaSalesforce::Rake::DeployTask.new(:development) do |t|
+              t.username  = "you@development.org"
+              t.password  = "yourpassword"
+              t.token     = "your security token"
+              t.namespace = "" 
+            end
+          end
+        EOS
+      end
+    end
+
+    def make_gitignore
+      File.open("#{directory}/.gitignore", 'w') do |gitignore|
+        gitignore.print <<-EOS.margin
+          src-processed
+          deploy.zip
+        EOS
+      end
+    end
+
+    def followup_instructions
+      puts
+      puts "-" * 80
+      puts " All done. Now you need to download your WSDL files into your project:"
+      puts
+      puts "   Enterprise WSDL: #{directory}/lib/enterprise.xml"
+      puts "   Metadata WSDL:   #{directory}/lib/metadata.xml"
+      puts
+      puts "-" * 80
+    end
+  end
+end

data/lib/hoopla_salesforce/template_processor.rb

@@ -0,0 +1,120 @@
+require 'hoopla_salesforce/eruby'
+
+module HooplaSalesforce
+  class TemplateProcessor
+    class Base
+      include HooplaSalesforce::CaptureHelper
+
+      attr_reader :src, :base, :file
+      def initialize(src, file)
+        @src     = src
+        @base    = File.basename(file, '.erb')
+        @file    = file
+        template = Eruby.new(File.read(file))
+
+        File.open(output_file, 'w') do |f|
+          f.print template.result(binding)
+        end
+      end
+
+      def each_resource_file(files, extension)
+        files.map do |file|
+          file += ".#{extension}" unless extension =~ /\.#{extension}$/
+          yield file
+        end.join("\n")
+      end
+    end
+
+    class Generic < Base
+      def output_file
+        file.sub(/\.erb$/, '')
+      end
+    end
+
+    class VisualForce < Base
+      def page(opts={})
+        params = opts.map { |key, val| %Q|#{key}="#{val}"| }.join(" ")
+        "<apex:page #{params}>"
+      end
+
+      def end_page
+        "</apex:page>"
+      end
+
+      def resource_url(file)
+        resource, file = file.split('/', 2)
+        "{!URLFOR($Resource.#{resource}, '/#{file}')}"
+      end
+
+      def stylesheet_include_tag(*files)
+        each_resource_file(files, "css") do |file|
+          %Q|<apex:stylesheet value="#{resource_url(file)}" />|
+        end
+      end
+
+      def javascript_include_tag(*files)
+        each_resource_file(files, "js") do |file|
+          %Q|<script type="text/javascript" src="#{resource_url(file)}"></script>|
+        end
+      end
+
+      def as_json_array(collection, var)
+        <<-EOS.margin
+          [<apex:repeat value="{!#{collection}}" var="#{var}" rows="1">
+            #{send("#{var}_json")}
+          </apex:repeat>
+          <apex:repeat value="{!#{collection}}" var="#{var}" first="1">
+            ,#{send("#{var}_json")}
+          </apex:repeat>]
+        EOS
+      end
+
+      def output_file
+        "#{src}/pages/#{base}"
+      end
+    end
+
+    class TestPage < Base
+      def page(opts={})
+        <<-EOS.margin
+          <html>
+            <head>
+              <title>Test Page: #{opts[:controller]}</title>
+            </head>
+            <body>
+        EOS
+      end
+
+      def end_page
+        <<-EOS.margin
+          </body>
+          </html>
+        EOS
+      end
+
+      def resource_url(file)
+        "../resources/#{file}"
+      end
+
+      def stylesheet_include_tag(*files)
+        each_resource_file(files, "css") do |file|
+          %Q|<link rel="stylesheet" type="text/css" href="#{resource_url(file)}" />|
+        end
+      end
+
+      def javascript_include_tag(*files)
+        each_resource_file(files, "js") do |file|
+          %Q|<script type="text/javascript" src="#{resource_url(file)}"></script>|
+        end
+      end
+
+      def as_json_array(collection, var)
+        send("#{var}_json")
+      end
+
+      def output_file
+        "#{src}/pages-test/#{base}.html"
+      end
+    end
+  end
+end

data/lib/hoopla_salesforce/text_reporter.rb

@@ -33,7 +33,7 @@ module HooplaSalesforce
       test_failures     = []
       coverage_warnings = []
 
-      result[:messages].each do |message|
+      sanitize(result[:messages]).each do |message|
         if message[:success]
           status = " "
           status = "U" if message[:changed]
@@ -65,6 +65,7 @@ module HooplaSalesforce
       test_result = result[:run_test_result]
       failures    = test_result[:num_failures].to_i
       passes      = test_result[:num_tests_run].to_i - failures
+      passes      = 0 if passes < 0
       print "#{indent}Passes: #{green}#{passes}#{end_color} "
       print "Failures: #{red}#{failures}#{end_color} "
       puts  "Duration: #{test_result[:total_time]}"
@@ -73,7 +74,7 @@ module HooplaSalesforce
       # :failures is only an array if we have more than 1. Fun...
       sanitize(test_result[:failures]).each do |failure|
         message = "#{indent}#{red}#{failure[:name]}.#{failure[:method_name]}: #{failure[:message]}\n"
-        message += failure[:stack_trace].split("\n").map{ |l| indent * 2 + l }.join("\n")
+        message += failure[:stack_trace].split("\n").map{ |l| indent * 2 + l }.join("\n") if failure[:stack_trace]
         message += end_color
         test_failures << message
       end

data/lib/hoopla_salesforce/utils.rb

@@ -0,0 +1,11 @@
+module HooplaSalesforce
+  module Utils
+    def extract_class_name(body)
+      (match = body.match(/\bclass\s+(\w+)\s*\{\s*/)) && match[1]
+    end
+
+    def extract_trigger_name(body)
+      (match = body.match(/\btrigger\s+(\w+)\s/)) && match[1]
+    end
+  end
+end

data/lib/hoopla_salesforce/web_agent.rb

@@ -0,0 +1,71 @@
+require 'mechanize'
+require 'cgi'
+
+module HooplaSalesforce
+  class WebAgent
+    LOGIN_URL   = 'https://login.salesforce.com'
+    MAX_CLASSES = 10_000
+
+    attr_reader :username, :password, :agent
+
+    def initialize(username, password)
+      @username = username
+      @password = password
+      @agent = Mechanize.new
+      login
+    end
+
+    def login
+      agent.get(LOGIN_URL).form_with(:name => 'login') do |login|
+        login.un = username
+        login.pw = password
+      end.submit
+    end
+
+    def test_run_url(test, namespace)
+      "/setup/build/runApexTest.apexp?class_id=#{test[:id]}&class_name=#{test[:name]}&ns_prefix=#{namespace}"
+    end
+
+    def test_results_dir
+      "test-results"
+    end
+
+    def test_results_file(test_name)
+      "#{test_results_dir}/#{test_name}.html"
+    end
+
+    def get_all_test_links
+      page = agent.get('/01p')
+
+      if page.search('.next') 
+        expand_link = page.search('.fewerMore a').first['href']
+        enough_rows = expand_link.sub(/rowsperpage=\d+/, "rowsperpage=#{MAX_CLASSES}")
+        page = agent.get(enough_rows)
+      end
+
+      page.search('.dataCell[scope="row"] a')
+    end
+
+    # Runs the given tests from the Web UI
+    # namespace is the package namespace without the __
+    def run_tests(test_names, namespace = '')
+      test_links = get_all_test_links
+
+      tests = test_names.map do |test_name|
+        { :id   => test_links.detect{ |a| a.text == test_name }['href'][1..-1],
+          :name => test_name }
+      end
+
+      mkdir_p test_results_dir
+      tests.each do |test|
+        results_page = agent.get(test_run_url(test, namespace))
+        results_table = results_page.search('.outer table td').first
+        File.open(test_results_file(test[:name]), 'w') do |f|
+          f.print results_table.inner_html
+        end
+    
+        puts "#{test[:name]} complete, results in #{test_results_file(test[:name])}."
+      end
+    end
+  end
+end

metadata

@@ -5,8 +5,8 @@ version: !ruby/object:Gem::Version
   segments: 
   - 0
   - 0
-  - 3
-  version: 0.0.3
+  - 4
+  version: 0.0.4
 platform: ruby
 authors: 
 - Trotter Cashion
@@ -15,7 +15,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-08-11 00:00:00 -04:00
+date: 2010-08-27 00:00:00 -04:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -46,21 +46,74 @@ dependencies:
         version: 0.9.4
   type: :runtime
   version_requirements: *id002
-description: No really, these helpers are awesome
+- !ruby/object:Gem::Dependency 
+  name: commander
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 4
+        - 0
+        - 3
+        version: 4.0.3
+  type: :runtime
+  version_requirements: *id003
+- !ruby/object:Gem::Dependency 
+  name: erubis
+  prerelease: false
+  requirement: &id004 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 2
+        - 6
+        - 6
+        version: 2.6.6
+  type: :runtime
+  version_requirements: *id004
+- !ruby/object:Gem::Dependency 
+  name: mechanize
+  prerelease: false
+  requirement: &id005 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 1
+        - 0
+        - 0
+        version: 1.0.0
+  type: :runtime
+  version_requirements: *id005
+description: Helpers for building Salesforce.com projects
 email: dev@hoopla.net
-executables: []
-
+executables: 
+- hoopla_salesforce
 extensions: []
 
 extra_rdoc_files: []
 
 files: 
+- README.md
+- bin/hoopla_salesforce
 - lib/hoopla_salesforce/rake.rb
 - lib/hoopla_salesforce/rake/base_task.rb
 - lib/hoopla_salesforce/rake/deploy_task.rb
 - lib/hoopla_salesforce/rake/retrieve_task.rb
-- lib/hoopla_salesforce/version.rb
+- lib/hoopla_salesforce/eruby.rb
+- lib/hoopla_salesforce/web_agent.rb
+- lib/hoopla_salesforce/utils.rb
 - lib/hoopla_salesforce/text_reporter.rb
+- lib/hoopla_salesforce/skeleton.rb
+- lib/hoopla_salesforce/template_processor.rb
+- lib/hoopla_salesforce/package_generator.rb
+- lib/hoopla_salesforce/commands.rb
+- lib/hoopla_salesforce/info.rb
+- lib/hoopla_salesforce/ext/string.rb
+- lib/hoopla_salesforce/ext/commander.rb
 - lib/hoopla_salesforce/deployer.rb
 - lib/hoopla_salesforce.rb
 has_rdoc: true
@@ -92,6 +145,6 @@ rubyforge_project: nowarning
 rubygems_version: 1.3.6
 signing_key: 
 specification_version: 3
-summary: Some awesome helpers for the salesforce API
+summary: Helpers for building Salesforce.com projects
 test_files: []
 

data/lib/hoopla_salesforce/version.rb

@@ -1,3 +0,0 @@
-module HooplaSalesforce
-  VERSION = "0.0.3"
-end