asrake 0.8.0

data/lib/asrake/base_compiler_task.rb

@@ -0,0 +1,74 @@
+require 'rake/tasklib'
+
+require 'asrake/base_compiler_args'
+
+module ASRake
+class BaseCompilerTask < Rake::TaskLib
+	include BaseCompilerArguments_Module
+
+	def initialize(name, args)
+		super()
+
+		self.merge_in args if args != nil
+
+		yield self if block_given?
+
+		@name = name
+		
+		# create named task first so it gets the desc if one is added
+		Rake::Task.define_task @name
+
+		# if the task name is a hash (ie, has dependencies defined) make sure we pull out the task name from it
+		@name, _ = name.first if name.is_a? Hash
+
+	end
+
+	protected
+
+	def build
+		fail "build must be defined in subclass"
+	end
+
+	private
+
+	# Try to include helpful information about specific errors
+	def generate_error_message_tips(line)
+		advice = []
+		if((target_player == nil || Float(target_player) < 11) && line.include?("Error: Access of undefined property JSON"))
+			advice << "Be sure you are compiling with 'target_player' set to 11.0 or higher"
+			advice << "to have access to the native JSON parser. It is currently set to #{target_player}"
+		elsif line.include?("Error: The definition of base class Object was not found")
+			advice << "If you have removed the default flex-config by setting 'load_config' to"
+			advice << "an empty or alternate value (i.e., not appended to it) you must be sure to"
+			advice << "still reference the necessary core Flash files, especially playerglobal.swc"
+		end
+
+		if !advice.empty?
+			puts "*********************************"
+			puts "ASRake Note: " + advice.join("\n")
+			puts "*********************************"
+		end
+	end
+
+end
+end
+
+##fill config with the default flex_config options
+#if use_default_flex_config
+#	#initialize with default values from flex-config
+#	flex_config = Nokogiri::XML(File.read(FlexSDK::flex_config))
+#
+#	target_player = flex_config.css('target-player').children.to_s
+#	swf_version = flex_config.css('swf-version').children.to_s
+#	
+#	flex_config.css('compiler external-library-path path-element').each { |ext|
+#		puts ext.children
+#	}
+#end
+
+#http://fpdownload.macromedia.com/get/flashplayer/updaters/11/playerglobal11_2.swc
+#frameworks\libs\player
+
+#-dump-config compiler_config.xml
+#-link-report compiler_linkreport.xml
+#-size-report compiler_sizereport.xml

data/lib/asrake/clean_task.rb

@@ -0,0 +1,34 @@
+require 'rake/tasklib'
+
+module ASRake
+class CleanTask < Rake::TaskLib
+
+	attr_accessor :clean_list
+	attr_accessor :clobber_list
+
+	def initialize(*args)
+
+		self.clean_list = FileList.new
+		self.clobber_list = FileList.new
+
+		args.each do |configArgs|
+			clean_list.include(File.join(configArgs.output_dir, "*"))
+			clean_list.exclude(configArgs.output)
+
+			clobber_list.include(File.join(configArgs.output_dir, "*"))
+		end
+
+		desc "Remove package results & build artifacts"
+		task :clean do
+			clean_list.each { |f| rm_r f rescue nil }
+		end
+
+		desc "Remove all build & package results"
+		# adding clean as a dependency in case anything is added to the clean task later
+		task :clobber => [:clean] do
+			clobber_list.each { |f| rm_r f rescue nil }
+		end
+	end
+
+end
+end

data/lib/asrake/compc_args.rb

@@ -0,0 +1,38 @@
+require 'asrake/flexsdk'
+require 'asrake/base_compiler_args'
+
+module ASRake
+
+module CompcArguments_Module
+	include BaseCompilerArguments_Module
+
+	def generate_args
+		compc = super
+		
+		#compc << " -include-sources=#{cf source_path.join(',')}" if !source_path.empty?
+		self.source_path.each do |path|
+			compc << " -include-classes #{get_classes(path).join(' ')}"
+		end
+
+		return compc
+	end
+
+	def get_classes(path)
+		arr = []
+		Dir.chdir(path) do
+			FileList["**/*.as"].pathmap('%X').each do |file|
+				name = file.gsub(/^\.[\/\\]/, "").gsub(/[\/\\]/, ".")
+				yield name if block_given?
+				arr << name
+			end
+		end
+		return arr
+	end
+
+end
+
+class CompcArguments
+	include CompcArguments_Module
+end
+
+end

data/lib/asrake/compc_task.rb

@@ -0,0 +1,52 @@
+require 'rake/tasklib'
+
+require 'asrake/host'
+require 'asrake/base_compiler_task'
+require 'asrake/compc_args'
+
+module ASRake
+class CompcTask < BaseCompilerTask
+	include CompcArguments_Module
+
+	# Create a swc compilation task with the given name.
+	def initialize(name = :build, args = nil)
+		super
+
+		# create directory task for output
+		directory self.output_dir
+
+		# create file task for output
+		file self.output => self.output_dir do
+			self.build
+		end
+
+		# set dependencies on all .as and .mxml files in the source paths
+		dependencies = FileList.new
+		source_path.each do |path|
+			path = cf path
+			dependencies.include(File.join(path, "*.as"))
+			dependencies.include(File.join(path, "*.mxml"))
+			dependencies.include(File.join(path, "**", "*.as"))
+			dependencies.include(File.join(path, "**", "*.mxml"))
+		end
+		file(self.output => dependencies) if !dependencies.empty?
+
+		# add output file task as a dependency to the named task created
+		task @name => self.output do
+			result = c self.output
+			result << " (#{File.size(output)} bytes)" unless self.output_is_dir?
+			puts result
+		end
+
+	end
+
+	protected
+
+	def build
+		run "#{FlexSDK::compc}#{generate_args}" do |line|
+			generate_error_message_tips(line)
+		end
+	end
+
+end
+end

data/lib/asrake/copy_task.rb

@@ -0,0 +1,87 @@
+require 'rake/tasklib'
+
+module ASRake
+class CopyTask < Rake::TaskLib
+
+	attr_accessor :copy_list
+
+	def initialize(name = :copy)
+		self.copy_list = Hash.new
+
+		yield self if block_given?
+
+		#define named task first so if desc was called it will be attached to it instead of the file task
+		Rake::Task.define_task name do
+			# use longest source path to space the output. yup, seriously that OCD
+			len = self.copy_list.keys.group_by(&:size).max.last[0].length
+			self.copy_list.each do |from, to|
+				copy_files from, to
+				puts "Files copied. %#{len}s => %s" % [from, to]
+			end
+		end
+	end
+
+	def copy(from_path, to_path=nil)
+		if from_path == nil
+			fail puts "Cannot copy files. No source provided."
+		end
+
+		# special case getting a hash as an argument
+		if from_path.is_a? Hash
+			from_path.each {|from, to| copy from, to}
+			return
+		end
+
+		if to_path == nil
+			fail puts "Cannot copy files from #{from_path}. No destination provided."
+		end
+
+		self.copy_list[from_path] = to_path
+	end
+	alias_method :add, :copy
+
+	private
+
+	def copy_files(from_path, to_path, times=0)
+		from = FileList[from_path]
+		unless from.length == 0
+			from.each do |from|
+				if File.directory?(from)
+					#recurse the "from" dir tree, appending the path to to_path
+					Dir.foreach(from) do |fr|
+						if fr != ".." && fr != "."
+							#puts fr + "|" + File.join(from, fr) + "|" + File.join(to_path, fr)
+							copy_files(File.join(from, fr), File.join(to_path, fr), times+1)
+						end
+					end
+				else
+					# if this is the first iteration, we haven't gotten to join the "to" path in the directory loop above, so
+					# append it to the file here if either the to or from path are a directory
+					if times == 0 && (File.directory?(to_path) || File.directory?(from_path) || from_path =~ /\*/)
+						to = File.join(to_path, File.basename(from)) 
+					else
+						to = to_path
+					end
+
+					if !File.exists?(to) || (File.mtime(to.to_s) < File.mtime(from.to_s))
+						begin
+							dir = File.dirname(to)
+							mkdir_p(dir, :verbose => false) if !File.exist?(dir)
+						rescue
+							fail "Error copying #{from} to #{to}. Cannot create directory. #{$!}"
+						end
+						begin
+							cp_r from, to#, :verbose => false
+						rescue
+							fail "Error copying #{from} to #{to}. #{$!}"
+						end
+					end
+				end
+			end
+		else
+			puts "Error copying to #{to_path}. No files exist at source #{from_path}."
+		end
+	end
+
+end
+end

data/lib/asrake/flexsdk.rb

@@ -0,0 +1,81 @@
+require 'asrake/host'
+
+class FlexSDK
+	SDK_PATHS = []
+	
+	class << self
+
+		@@initialized = false
+		
+		@@executables = %w[adt adl asdoc mxmlc compc]
+		@@configs = %w[flex-config air-config]
+		
+		def root
+			init()
+			return @root
+		end
+
+		@@configs.each do |name|
+			method = name.gsub('-','_')
+			define_method method do
+				init()
+				instance_variable_get "@#{method}"
+			end
+		end
+
+		@@executables.each do |name|
+			define_method name do
+				init()
+				instance_variable_get "@#{name}"
+			end
+		end
+
+		private
+
+		def init()
+			if !@@initialized
+				@@root = nil
+				
+				# Find where the flex sdk is installed
+				SDK_PATHS.each do |path|
+					#remove /bin/ fom the end of the path if it exists
+					path.sub!(/[\/\\]bin[\/\\]?$/,'')
+					if File.exists?(path)
+						allValid = true
+
+						@@configs.each do |name|
+							config = c File.join(path, 'frameworks', "#{name}.xml")
+							allValid = false if !File.exists?(config)
+							instance_variable_set "@#{name.gsub('-','_')}", config
+						end
+
+						@@executables.each do |name|
+							exec = c File.join(path, 'bin', name)
+							allValid = false if !File.exists?(exec)
+							instance_variable_set "@#{name}", exec
+						end
+						
+						if allValid
+							@@root = path
+							break
+						end
+					end
+				end
+
+				if @@root == nil
+					str = ""
+					if !SDK_PATHS.empty?
+						str << "Could not find a valid Flex SDK at any of the paths in FlexSDK::SDK_PATHS\n=> "
+						str << SDK_PATHS.join("\n=> ")
+						str << "\n"
+					end
+					str << "Append a valid SDK path in your rakefile, e.g.:\nFlexSDK::SDK_PATHS << 'C:\\develop\\sdk\\flex_sdk_4.6.0.23201'"
+					str << "\nFor more information, see: http://adobe.com/go/flex_sdk/"
+					fail str
+				end
+			end
+			@@initialized = true
+		end
+	end
+
+end

data/lib/asrake/host.rb

@@ -0,0 +1,46 @@
+module OS
+	def OS.is_mac?
+		RUBY_PLATFORM.downcase.include?("darwin")
+	end
+
+	def OS.is_windows?
+		require 'rbconfig'
+		RbConfig::CONFIG['host_os'] =~ /mswin|mingw/
+	end
+
+	def OS.is_linux?
+		RUBY_PLATFORM.downcase.include?("linux")
+	end
+end
+
+def run(command, abort_on_failure = true)
+	command.strip!
+
+	puts "> #{command}"
+	IO.popen("#{command} 2>&1") do |proc|
+		while !proc.closed? && (line = proc.gets)
+			puts ">    #{line}"
+			yield line if block_given?
+		end
+	end
+
+	if $?.exitstatus != 0
+		msg = "Operation exited with status #{$?.exitstatus}"
+		fail msg if abort_on_failure
+		puts msg
+	end
+
+	return $?
+end
+
+def c(str)
+	OS::is_windows? ? cb(str) : cf(str)
+end
+
+def cb(str)
+	str.gsub("/", "\\")
+end
+
+def cf(str)
+	str.gsub("\\", "/")
+end

data/lib/asrake/mxmlc_args.rb

@@ -0,0 +1,14 @@
+require 'asrake/flexsdk'
+require 'asrake/base_compiler_args'
+
+module ASRake
+
+module MxmlcArguments_Module
+	include BaseCompilerArguments_Module
+end
+
+class MxmlcArguments
+	include MxmlcArguments_Module
+end
+
+end

data/lib/asrake/mxmlc_task.rb

@@ -0,0 +1,37 @@
+require 'rake/tasklib'
+
+require 'asrake/host'
+require 'asrake/base_compiler_task'
+require 'asrake/mxmlc_args'
+
+module ASRake
+class MxmlcTask < BaseCompilerTask
+	include MxmlcArguments_Module
+
+	# Create a swc compilation task with the given name.
+	def initialize(name = :build, args = nil)
+		super
+
+		# create directory task for output
+		directory self.output_dir
+
+		# always build until we can properly grab dependencies
+		task @name => self.output_dir do
+			self.build
+			result = c self.output
+			result << " (#{File.size(output)} bytes)" unless self.output_is_dir?
+			puts result
+		end
+
+	end
+
+	protected
+
+	def build
+		run "#{FlexSDK::mxmlc}#{generate_args}" do |line|
+			generate_error_message_tips(line)
+		end
+	end
+
+end
+end