metaforce 0.5.3 → 1.0.0a

data/lib/metaforce/metadata/transaction.rb

@@ -1,100 +0,0 @@
-require 'base64'
-
-module Metaforce
-
-  # Convenience class for deployment/retrieval results
-  class Transaction
-    # The Salesforce ID for this task
-    attr_reader :id
-    # The type of transaction (e.g. _:deploy_, _:retrieve_)
-    attr_reader :type
-
-    def initialize(client, id, type=nil)
-      @client = client
-      @id     = id
-      @type   = type
-      wait_until_done if Metaforce.configuration.wait_until_done
-    end
-
-    # Creates a new transaction and sets type to +:deploy+.
-    def self.deployment(client, id)
-      self.new client, id, :deploy
-    end
-
-    # Creates a new transaction and sets type to +:retrieve+.
-    def self.retrieval(client, id)
-      self.new client, id, :retrieve
-    end
-
-    # Wrapper for <tt>Client.status</tt>.
-    def status
-      @status = @client.status(@id)
-    end
-
-    # Wrapper for <tt>Client.done?</tt>.
-    def done?
-      @done = @client.done?(@id) unless @done
-      @done
-    end
-    alias :complete? :done?
-    alias :completed? :done?
-
-    # Returns the decoded content of the returned zip file.
-    def zip_file
-      raise 'Request was not a retrieve.' unless @type == :retrieve
-      Base64.decode64(result[:zip_file])
-    end
-
-    # Unzips the returned zip file to +destination+.
-    def to(destination)
-      zip = zip_file
-      file = Tempfile.new('retrieve')
-      file.write(zip)
-      path = file.path
-      file.close
-
-      Zip::ZipFile.open(path) do |zip|
-        zip.each do |f|
-          path = File.join(destination, f.name)
-          FileUtils.mkdir_p(File.dirname(path))
-          zip.extract(f, path) { true }
-        end
-      end
-      self
-    end
-    
-    # Returns the deploy or retrieve result
-    def result(options={})
-      @result = @client.status(@id, @type) if @result.nil?
-      raise SalesforceError, @result[:message] if @result[:state] == "Error"
-      @result
-    end
-
-    # Enters a loop until .done? returns true
-    def wait_until_done
-      max_wait = 30
-      wait_time = 1
-      until self.done?
-        sleep(wait_time)
-        if wait_time < 30
-          wait_time *= 2
-        else
-          wait_time = max_wait
-        end
-      end
-    end
-
-    BLACK_LIST = [:@client]
-    
-    def to_s
-      public_vars = self.instance_variables.reject { |var|
-        BLACK_LIST.include? var
-      }.map { |var|
-        "#{var}=\"#{instance_variable_get(var)}\""
-      }.join(" ")
-
-      "<##{self.class}:#{self.object_id.to_s(8)} #{public_vars}>"
-    end
-
-  end
-end

data/lib/metaforce/metadata.rb

@@ -1,4 +0,0 @@
-require 'metaforce/metadata/transaction'
-require 'metaforce/metadata/client'
-require 'metaforce/metadata/crud'
-require 'metaforce/metadata/file'

data/lib/metaforce/rake/deploy.rb

@@ -1,35 +0,0 @@
-require 'metaforce'
-require 'term/ansicolor'
-require 'rake'
-require 'rake/tasklib'
-include Term::ANSIColor
-
-module Metaforce
-  module Rake
-
-    class DeployTask < ::Rake::TaskLib
-      attr_accessor :name
-
-      # The directory to deploy
-      attr_accessor :directory
-
-      def initialize(name = 'metaforce:deploy')
-        @name      = name
-        @directory = File.expand_path('src')
-        yield self if block_given?
-        define
-      end
-
-      def define
-        desc "Deploy metadata"
-        task @name do
-          client = Metaforce::Rake.client
-          d = client.deploy(@directory)
-          puts green "Deployed #{@directory} successfully" if d.result[:success]
-        end
-      end
-
-    end
-    
-  end
-end

data/lib/metaforce/rake/retrieve.rb

@@ -1,39 +0,0 @@
-require 'metaforce'
-require 'term/ansicolor'
-require 'rake'
-require 'rake/tasklib'
-include Term::ANSIColor
-
-module Metaforce
-  module Rake
-
-    class RetrieveTask < ::Rake::TaskLib
-      attr_accessor :name
-
-      # Path to the manifest file
-      attr_accessor :manifest
-
-      # The directory to unzip the retrieved files to
-      attr_accessor :directory
-
-      def initialize(name = 'metaforce:retrieve')
-        @name      = name
-        @manifest  = File.expand_path('src/package.xml')
-        @directory = File.expand_path('retrieved')
-        yield self if block_given?
-        define
-      end
-
-      def define
-        desc "Retrieve metadata"
-        task @name do
-          client = Metaforce::Rake.client
-          r = client.retrieve_unpackaged(@manifest).to(@directory)
-          puts green "Files retrieved sucessfully to #{@directory}"
-        end
-      end
-
-    end
-    
-  end
-end

data/lib/metaforce/rake/tests.rb

@@ -1,62 +0,0 @@
-require 'metaforce'
-require 'term/ansicolor'
-require 'rake'
-require 'rake/tasklib'
-include Term::ANSIColor
-
-module Metaforce
-  module Rake
-
-    class TestsTask < ::Rake::TaskLib
-      attr_accessor :name
-
-      # The directory to deploy
-      attr_accessor :directory
-
-      def initialize(name = 'metaforce:tests:ci')
-        @name      = name
-        @directory = File.expand_path('src')
-        yield self if block_given?
-        define
-      end
-
-      def define
-        desc "Deploy metadata, run all tests, then undeploy"
-        task @name do
-          ENV['env'] = ENV['env'] || 'ci'
-          client = Metaforce::Rake.client
-          Metaforce.log = false
-          result = client.deploy(@directory, :options => { :run_all_tests => true }).result
-          failures = result[:run_test_result][:failures]
-
-          if failures
-            failures = [failures] unless failures.is_a?(Array)
-            puts "Failures:"
-            failures.each_with_index do |failure, index|
-              index = index + 1
-              puts
-              puts         "\t#{index}) #{failure[:method_name]}"
-              puts red     "\t   #{failure[:message]}"
-              puts
-              puts magenta "\t   ##{failure[:stack_trace]}"
-              puts
-            end
-          end
-
-          color = failures ? :red : :green
-          puts "Finished in #{Float(result[:run_test_result][:total_time]) / 100} seconds"
-          puts send(color, "#{result[:run_test_result][:num_tests_run]} tests, #{result[:run_test_result][:num_failures]} failures")
-
-          if failures
-            puts "\nFailed tests:\n"
-            failures.each do |failure|
-              puts "#{red failure[:stack_trace]} #{magenta "# #{failure[:method_name]}"}"
-            end
-          end
-
-          abort if failures
-        end
-      end
-    end
-  end
-end

data/lib/metaforce/rake.rb

@@ -1,43 +0,0 @@
-require 'yaml'
-require 'metaforce/rake/deploy'
-require 'metaforce/rake/retrieve'
-require 'metaforce/rake/tests'
-
-module Metaforce
-  module Rake
-
-    class << self
-      CONFIG_FILE = 'metaforce.yml'
-
-      # Loads the config and creates a client
-      def client
-        load_config
-        Metaforce::Metadata::Client.new :username => @username,
-          :password => @password,
-          :security_token => @security_token
-      end
-
-      # Loads configuration settings from metaforce.yml
-      def load_config
-        if File.exists?(CONFIG_FILE)
-          config = YAML.load_file(CONFIG_FILE)
-          env = ENV['env'] || 'default'
-          config = config.has_key?(env) ? config[env] : config
-          @username       = config["username"]
-          @password       = config["password"]
-          @security_token = config["security_token"] || ''
-          @test           = config["test"] || false
-          @log            = config["log"] || true
-          Metaforce.log = @log
-          Metaforce.configuration.test = @test
-        else
-          print "username: "; @username = STDIN.gets.chomp
-          print "password: "; @password = STDIN.gets.chomp
-          print "security token: "; @security_token = STDIN.gets.chomp
-          Metaforce.log = true
-        end
-      end
-
-    end
-  end
-end

data/lib/metaforce/services.rb

@@ -1 +0,0 @@
-require 'metaforce/services/client'

data/lib/metaforce/tasks/README.md

@@ -1,62 +0,0 @@
-# Metaforce Rake Tasks
-These are a set of default rake tasks that can be used for deploying/retrieving
-metadata using Rake and Metaforce. The following rake tasks are provided:
-
-* metaforce:deploy
-* metaforce:retrieve
-* metaforce:tests:ci
-
-You can include the rake tasks by adding the following to your Rakefile:
-
-```ruby
-begin
-  require 'metaforce'
-  load 'metaforce/tasks/metaforce.rake'
-rescue LoadError
-  task :metaforce do
-    puts "Couldn't load metaforce tasks"
-  end
-end
-```
-
-## metaforce.yml
-Include a metaforce.yml file in the root if you'd rather not type in your
-username, password and security token everytime you deploy or retrieve.
-
-With one environment:
-
-```yaml
----
-username: user
-password: password
-security_token: securitytoken
-test: true # defaults to false
-```
-
-With multiple environments:
-
-```yaml
----
-production:
-    username: user
-    password: password
-    security_token: securitytoken
-sandbox:
-    username: user
-    password: password
-    security_token: securitytoken
-    test: true
-```
-
-This would deploy using the `sandbox` environment:
-
-`rake metaforce:deploy env="sandbox"`
-
-## Continuous Integration
-The `metaforce:tests:ci` task is provided to make continuous integration with
-something like [Jenkins](http://jenkins-ci.org) easier.
-
-By default, the `metaforce:tests:ci` task will use the `ci` environment in
-metaforce.yml, so you should set that up before you use this task.
-
-The task will deploy the metadata and run all tests.

data/lib/metaforce/tasks/metaforce.rake

@@ -1,5 +0,0 @@
-require 'metaforce/rake'
-
-Metaforce::Rake::DeployTask.new
-Metaforce::Rake::RetrieveTask.new
-Metaforce::Rake::TestsTask.new

data/lib/metaforce/thor/metaforce.rb

@@ -1,117 +0,0 @@
-require 'thor' #should probably be in say, lib/metaforce.rb, but I don't want to make that decision alone.
-
-class MetaForce < Thor
-	include Thor::Actions
-	require './lib/metaforce/custom_actions'
-	require './lib/metaforce/login_details'
-	require './lib/metaforce'
-	include Thor::Actions::CustomActions
-
-	######## Tasks ############################################################
-	desc "login", "accepts login parameters and completes a soap call to salesforce via the partner api."
-	method_option :reset, :type => :boolean, :aliases => "-r", :required => false, :banner => " Reset stored login information"
-	def login
-		if ((File.exists? LoginDetails::STORAGE_LOCATION) && (options[:reset].nil?))
-			say "Using stored login information"
-			@login_details = LoginDetails.load
-		else
-			login_email 			= ask "Login Email address: "
-			sandbox					= yes? "Is this a sandbox org login: "
-			login_pass  			= masked_ask "Login Password: "
-			login_security_token	= masked_ask "Security Token: "
-			say "If you'd like I can save this login information to this directories .git/config/force.com.config"
-			say "----- PLEASE NOTE, HOWEVER, THAT SAVING THIS INFORMATION IS INSECURE AND IS IN NO WAY ENCRYPTED"
-			save 					= yes? "Should I save this Login information? (y/n) "
-
-			if save
-				@login_details = LoginDetails.new(login_email, login_pass, login_security_token, sandbox)
-				@login_details.save!
-			else
-				@login_details = LoginDetails.new(login_email, login_pass, login_security_token, sandbox)
-			end
-		end
-
-		raise "Failed to find viable login information!" if @login_details.nil?
-		Metaforce.log = @login_details.log
-		Metaforce.configuration.test = @login_details.sandbox
-		@client = Metaforce::Metadata::Client.new :username => @login_details.username,
-		:password => @login_details.password,
-		:security_token => @login_details.security_token
-	end	
-	
-	######## Deploy ###########################################################
-	desc "deploy", "deploys the current working directory's src folder to salesforce"
-	method_option :dir, :type => :string, :aliases => "-d", :required => true, :default => "src", :banner => "Specify the directory to deploy"
-	method_option :reset, :type => :boolean, :aliases => "-r", :required => false, :banner => " Reset stored login information"
-	def deploy
-		login unless @client
-		login unless options[:reset].nil?
-		raise "failed to create connection!" unless @client
-		deploy_results = @client.deploy(options[:dir]).result
-		say "Deploy Successful!", color = Thor::Shell::Color::GREEN if deploy_results[:success]
-	end
-
-	######## RunTests #########################################################
-	desc "test", "runs _all_ salesforce unit tests!"
-	method_option :dir, :type => :string, :aliases => "-d", :required => true, :default => "src", :banner => "Specify the directory to execute tests"
-	method_option :reset, :type => :boolean, :aliases => "-r", :required => false, :banner => " Reset stored login information"
-	def test
-		login unless @client
-		login unless options[:reset].nil?
-		raise "failed to create connection!" unless @client
-		result = spinner {
-			result = @client.deploy(options[:dir], :options => { :run_all_tests => true }).result
-		}
-		failures = result[:run_test_result][:failures]
-		if failures
-			failures = [failures] unless failures.responds_to? :each
-			say "--- FAILURES: ", color = Thor::Shell::Color::RED
-			failures.each_with_index do |f,i|
-				say "#{"-" * 80}", color = Thor::Shell::Color::YELLOW
-				say ""
-				say "\t(#{index +1}) #{failure[:method_name]}"
-				say "\t\t#{failure[:message]}", color = Thor::Shell::Color::RED
-				say ""
-				say "\t\t#{failure[:stack_trace]}", color => Thor::Shell::Color::MAGENTA
-				say ""
-			end
-		end
-
-		color = (failures) ? Thor::Shell::Color::RED : Thor::Shell::Color::GREEN
-		say "Finished in #{Float(result[:run_test_result][:total_time]) / 100} seconds"
-		say "#{result[:run_test_result][:num_tests_run]} tests, #{result[:run_test_result][:num_failures]} failures", color = color
-	end
-
-	######## Pull #############################################################
-	desc "pull", "Pull all MetaData objects specified in the package.xml file"
-	method_option :reset, :type => :boolean, :aliases => "-r", :required => false, :banner => " Reset stored login information"
-	method_option :manifest, :type => :string, :aliases => "-m", :required => true, :banner => " Path to Manifest.xml", :default => "src/package.xml"
-	method_option :dir, :type => :string, :aliases => "-d", :required => false, :banner => " Download to directory", :default => "retrieved"
-	def pull
-		login unless @client
-		login unless options[:reset].nil?
-		raise "failed to create connection!" unless @client
-		result = spinner {
-			@client.retrieve_unpackaged(options[:manifest]).to(options[:dir])
-		}
-        say "Files retrieved sucessfully to #{@directory}", color = Thor::Shell::Color::GREEN
-	end
-
-	######## Clone ############################################################
-	desc "clone", "Pull all MetaData objects from the current org"
-	method_option :reset, :type => :boolean, :aliases => "-r", :required => false, :banner => " Reset stored login information"
-	method_option :dir, :type => :string, :aliases => "-d", :required => true, :banner => " Download to directory", :default => "retrieved"
-	def clone
-		login unless @client
-		login unless options[:reset].nil?
-		raise "failed to create connection!" unless @client
-		result = spinner {
-			metadata_objects = Hash.new
-			@client.metadata_objects.collect { |t| metadata_objects[t[:xml_name].underscore.to_sym] = ["*"] }
-			md = Metaforce::Manifest.new(metadata_objects)
-			@client.retrieve_unpackaged(md).to(options[:dir])
-		}
-    say "Files retrieved sucessfully to #{options[:dir]}", color = Thor::Shell::Color::GREEN
-	end
-
-end