as3signals 0.7.0

data/CHANGELOG.textile

@@ -0,0 +1,51 @@
+h2. AS3 Signals Changelog:
+
+h3. v0.7 - Bubblap - 2010-05-27
+
+h4. API Changes
+* Added NativeMappedSignal class from "Brian Heylin":http://github.com/brianheylin, with great "test coverage":http://github.com/brianheylin/as3-signals/tree/master/tests/org/osflash/signals/natives/.
+** Addresses "#16 - Add ability to map native events to signals":http://github.com/robertpenner/as3-signals/issues/closed#issue/16
+* DeluxeSignal has a simpler way to continue bubbling without re-dispatching the event.
+** IBubbleEventHandler.onEventBubbled() now returns true/false to continue/cancel bubbling.
+** Thanks to "secoif":http://github.com/secoif for the original code and "dehash":http://www.dehash.com/?p=241h for helping with the merge.
+* ISignal and IDeluxeSignal: add(), addOnce() and remove() now return the listener.
+** Thanks to "sammyt":http://github.com/sammyt for the contribution with unit tests.
+
+h4. Fixes
+* Improved error message for Signal.dispatch() with too few arguments.
+
+h4. Test Changes
+* The test suite is migrated to a newer version of AsUnit 4.
+** Tests now receive an IAsync using [Inject]. No more Asyncleton!
+** The migration pattern can be seen in "commit f6878.":http://github.com/robertpenner/as3-signals/commit/f6878dbbff95e0bd7832cc2d1cc2e7d55fb18098
+** AllTestsRunner uses a "new composition pattern":http://github.com/robertpenner/as3-signals/commit/866a99570152b7399aa34839fd5c30789db67f3c instead of inheritance.
+** Many thanks to "Luke Bayes":http://github.com/lukebayes and the "Bay Area Computer Club":http://github.com/bayareacomputerclub.
+* Added more tests for argument dispatching and consolidated in SignalDispatchArgsTest.
+
+h3. v0.6 - GreenDay - 2010-03-17
+
+h4. API Changes
+* "#15 - IDeluxeSignal and NativeSignal now have valueClasses property":http://github.com/robertpenner/as3-signals/issues/closed#issue/15
+
+h4. Fixes
+* "#14 - NativeSignal.addOnce() can't be reused after native event dispatched":http://github.com/robertpenner/as3-signals/issues/closed#issue/14
+
+h4. Implementation Changes
+* Optimized listeners array cloning to use slice(), which is faster than concat().
+* Optimized dispatch() by moving the cloning of listeners to add(), addOnce(), and remove().
+* Signal.removeAll() now uses remove() on every listener, instead of fast array clearing. This is intended to avoid possible issues with subclass overrides (as happened before with NativeRelaySignal.remove()).
+* Renamed createListenerRelationship() to registerListener().
+* Consolidated add() and addOnce() logic in registerListener().
+* Removed onceListeners Dictionary from DeluxeSignal and NativeSignal.
+* DeluxeSignal and NativeSignal are now more unified in their "once listeners" internal implementations.
+* Removed an extra semicolon which made FDT cry (thanks "vitch":http://github.com/vitch).
+
+h4. Test Changes
+* Removed async [Test] metadata because AsUnit 4 no longer uses it.
+* Updated the AsUnit 4 SWC to newer version which avoids slowdown of Timers in Flash Player 10.1.
+* Added tests for ambiguous relationships in Signal.
+* Added tests for adding a listener during a dispatch().
+
+h3. v0.5 - GlassHalfFull - 2010-02-08
+
+* Added versioning to the Ant build, starting at 0.5.

data/Gemfile

@@ -0,0 +1,6 @@
+source "http://rubygems.org"
+
+gemspec
+
+gem 'sprout', '>= 1.0.26.pre'
+gem 'asunit4'

data/MIT-LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2009 Robert Penner
+
+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.textile

@@ -0,0 +1,43 @@
+
+h1. The AS3-Signals Sprout Gem
+
+h4. requires sprout, v >= 1.0.26.pre
+
+	Robert Penner's AS3-Signals ActionScript 3 source wrapped in a Sprout::Specification for implementation into a sprout project and Gem::Specification for distribution as a gem.
+	
+	This sprout gem includes the AS3-Signals source code forked from github.com/robertpenner/as3-signals. As a sprout, the source code will be copied to lib/as3-signals of your sprout project.
+	
+h3. Installation
+
+Intended for use with a project using Project Sprouts. 
+
+See information concerning Project Sprouts here: 
+* "http://github.com/lukebayes/project-sprouts" http://github.com/lukebayes/project-sprouts
+* "http://github.com/lukebayes/sprout-flashsdk" http://github.com/lukebayes/sprout-flashsdk
+
+Add the AS3-Signals gem to your Gemfile:
+
+	<pre><code>gem "as3signals"</code></pre>
+
+Add the AS3-Signals library dependency to your Rakefile:
+
+	<pre><code>library :as3signals</code></pre>
+
+Enter this shell command to resolve gem dependency: 
+
+	<pre><code>bundle install</code></pre>
+
+h3. Ruby Gem
+
+The gem can be installed independently of a project entering this command:
+
+<pre><code>gem install as3signals</code></pre>
+
+h3. Additional links
+
+* "AS3-Signals on GitHub":http://github.com/robertpenner/as3signals
+* "Sprouts Site":http://projectsprouts.org
+* "Sprouts on Github":http://github.com/lukebayes/project-sprouts
+* "flashsdk sprout on Github":http://github.com/lukebayes/sprout-flashsdk
+* "Sprouts Community":http://groups.google.com/group/projectsprouts
+

data/Rakefile

@@ -0,0 +1,52 @@
+require 'bundler'
+require 'lib/as3signals'
+Bundler::GemHelper.install_tasks
+
+# testing disabled for now. do actual as3 testing in the origin
+
+# library :asunit4
+# 
+# asunit_home = ENV['ASUNIT_HOME'] || File.dirname(__FILE__) + '/../AsUnit-bacc/asunit-4.0'
+# 
+# def apply_as3_meta_data_args(t)
+#   [
+#     "After",
+#     "AfterClass",
+#     "Before",
+#     "BeforeClass",
+#     "Ignore",
+#     "Inject",
+#     "RunWith",
+#     "Suite",
+#     "Test"
+#   ].each do |arg|
+#     t.keep_as3_metadata << arg
+#   end
+# end
+# 
+# mxmlc "bin/AS3SignalsRunner.swf" do |t|
+#   t.default_size = '1000 500'
+#   t.input = 'tests/org/osflash/signals/AllTestsRunner.as'
+#   #t.allow_source_path_overlap = true
+#   t.source_path << 'src'
+#   t.source_path << 'tests'
+#   t.library_path << 'libs/asunit4-alpha.swc'
+#   t.gem_version = '3.3.1'
+# end
+# 
+# mxmlc "bin/AS3SignalsAsUnitRunner.swf" do |t|
+#   t.default_size = '1000 500'
+#   t.input = 'tests/org/osflash/signals/AllTestsRunner.as'
+#   t.source_path << 'src'
+#   t.library_path << "#{asunit_home}/lib/Reflection.swc"
+#   t.source_path << "#{asunit_home}/src"
+#   t.gem_version = '3.3.1'
+#   apply_as3_meta_data_args(t)
+# end
+# 
+# desc "Run the Test Harness"
+# flashplayer :test => 'bin/AS3SignalsRunner.swf'
+# 
+# desc "Run the Test Harness against AsUnit source"
+# flashplayer :test_asunit => 'bin/AS3SignalsAsUnitRunner.swf'
+# 

data/as3-signals.as3proj

@@ -0,0 +1,87 @@
+<?xml version="1.0" encoding="utf-8"?>
+<project>
+  <!-- Output SWF options -->
+  <output>
+    <movie disabled="False" />
+    <movie input="" />
+    <movie path="bin\AllTestsRunner.swf" />
+    <movie fps="30" />
+    <movie width="1000" />
+    <movie height="600" />
+    <movie version="10" />
+    <movie background="#FFFFFF" />
+  </output>
+  <!-- Other classes to be compiled into your SWF -->
+  <classpaths>
+    <class path="src" />
+    <class path="tests" />
+  </classpaths>
+  <!-- Build options -->
+  <build>
+    <option accessible="False" />
+    <option allowSourcePathOverlap="False" />
+    <option benchmark="False" />
+    <option es="False" />
+    <option locale="" />
+    <option loadConfig="" />
+    <option optimize="False" />
+    <option showActionScriptWarnings="True" />
+    <option showBindingWarnings="True" />
+    <option showDeprecationWarnings="True" />
+    <option showUnusedTypeSelectorWarnings="True" />
+    <option strict="True" />
+    <option useNetwork="True" />
+    <option useResourceBundleMetadata="True" />
+    <option warnings="True" />
+    <option verboseStackTraces="False" />
+    <option linkReport="" />
+    <option loadExterns="" />
+    <option staticLinkRSL="True" />
+    <option additional="" />
+    <option compilerConstants="" />
+    <option customSDK="" />
+  </build>
+  <!-- SWC Include Libraries -->
+  <includeLibraries>
+    <!-- example: <element path="..." /> -->
+  </includeLibraries>
+  <!-- SWC Libraries -->
+  <libraryPaths>
+    <element path="libs" />
+  </libraryPaths>
+  <!-- External Libraries -->
+  <externalLibraryPaths>
+    <!-- example: <element path="..." /> -->
+  </externalLibraryPaths>
+  <!-- Runtime Shared Libraries -->
+  <rslPaths>
+    <!-- example: <element path="..." /> -->
+  </rslPaths>
+  <!-- Intrinsic Libraries -->
+  <intrinsics>
+    <!-- example: <element path="..." /> -->
+  </intrinsics>
+  <!-- Assets to embed into the output SWF -->
+  <library>
+    <!-- example: <asset path="..." id="..." update="..." glyphs="..." mode="..." place="..." sharepoint="..." /> -->
+  </library>
+  <!-- Class files to compile (other referenced classes will automatically be included) -->
+  <compileTargets>
+    <compile path="tests\org\osflash\signals\AllTestsRunner.as" />
+  </compileTargets>
+  <!-- Paths to exclude from the Project Explorer tree -->
+  <hiddenPaths>
+    <hidden path=".git" />
+    <hidden path="bin" />
+    <hidden path="libs" />
+  </hiddenPaths>
+  <!-- Executed before build -->
+  <preBuildCommand />
+  <!-- Executed after build -->
+  <postBuildCommand alwaysRun="False" />
+  <!-- Other project options -->
+  <options>
+    <option showHiddenPaths="True" />
+    <option testMovie="NewTab" />
+  </options>
+</project>

data/as3-signals.docproj

@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="utf-8"?>
+<docProject xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
+  <pageTitle>as3-signals</pageTitle>
+  <classPaths>src</classPaths>
+  <sourcesList />
+  <outputDirectory>docs</outputDirectory>
+  <activeCompiler>1</activeCompiler>
+  <extraOptions>--library-path libs/</extraOptions>
+</docProject>

data/as3signals.gemspec

@@ -0,0 +1,24 @@
+# -*- encoding: utf-8 -*-
+require 'lib/as3signals'
+
+Gem::Specification.new do |s|
+  s.name        = AS3Signals::NAME
+  s.version     = AS3Signals::VERSION
+  # s.platform    = Gem::Platform::RUBY
+  # s.authors     = ["TODO: Write your name"]
+  s.email       = ["amoslanka@gmail.com"]
+  s.homepage    = "http://www.github.com/amoslanka/sprout-as3-signals"
+  s.summary     = %q{AS3-Signals ActionScript 3 source wrapped in a Sprout::Specification for implementation into a sprout project and Gem::Specification for distribution as a gem.}
+  # s.description = %q{TODO: Write a gem description}
+
+  # s.files         = `git ls-files`.split("\n")
+  # s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  # s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+  
+  s.files = FileList['lib/**/*.rb', 'bin/*', 'build/*', 'examples/**/*', 'src/**/*', '[A-Za-z0-9]*', 'tests/**/*'].to_a
+
+  s.add_dependency 'sprout', '>= 1.0.26.pre'
+  s.add_development_dependency 'asunit4'
+
+end

data/build-asunit.properties

@@ -0,0 +1,7 @@
+tests.output=${output.dir}/${ant.project.name}-tests.swf
+test.lib=${libs.dir}/asunit4-alpha.swc
+test.main=${tests.dir}/${package.dir}/AllTestsRunner.as
+
+flex.config=${FLEX_HOME}/frameworks/flex-config.xml
+flex.lib=${FLEX_HOME}/frameworks/libs
+flextask.jar=${FLEX_HOME}/ant/lib/flexTasks.jar

data/build-asunit.xml

@@ -0,0 +1,34 @@
+<project name="as3-signals" basedir="." default="test">
+
+	<!-- Set up a prefix for all environment variables. -->
+	<property environment="env."/>
+	<fail unless="env.FLEX_HOME" message="FLEX_HOME needs to be defined as an environment variable or in the Ant build." />
+	<!-- Copy Flex SDK location from environment variable. This can be set manually instead. -->
+	<property name="FLEX_HOME" value="${env.FLEX_HOME}" />
+	<property file="build.properties"/>
+	<property file="build-asunit.properties"/>
+	
+	<target name="test">
+
+		<taskdef resource="flexTasks.tasks" classpath="${flextask.jar}" />
+
+		<mxmlc file="${test.main}" output="${tests.output}"
+			incremental="true" debug="false"
+			static-link-runtime-shared-libraries="true">
+			<source-path path-element="${src.dir}" />
+			<source-path path-element="${tests.dir}"/>
+			<load-config filename="${flex.config}" />
+			<library-path dir="${flex.lib}" append="true">
+				<include name="flex.swc" />
+			</library-path>
+			<library-path dir="${libs.dir}" append="true">
+				<include name="*.swc" />
+			</library-path>
+		</mxmlc>
+
+		<exec executable="open" os="Mac OS X">
+			<arg line='-a "flash player" ${tests.output}' />
+		</exec>
+
+	</target>
+</project>

data/build.properties

@@ -0,0 +1,20 @@
+# Properties file for build.xml
+project.name=as3-signals
+project.title=AS3 Signals
+
+# Version number for current releases
+ver.num=v0.7
+project.name.versioned=${project.name}-${ver.num}
+
+# Build locations
+src.dir=${basedir}/src
+package.dir=org/osflash/signals
+tests.dir=${basedir}/tests
+libs.dir=${basedir}/libs
+output.dir=${basedir}/bin
+docs.dir=${basedir}/docs
+output.swc=${output.dir}/${project.name.versioned}.swc
+
+# Project links
+as3signals.project.link=http://github.com/robertpenner/as3-signals
+

data/build.xml

@@ -0,0 +1,53 @@
+<project name="as3-signals" basedir="." default="swc">
+
+	<!-- Set up a prefix for all environment variables. -->
+	<property environment="env."/>
+	<fail unless="env.FLEX_HOME" message="FLEX_HOME needs to be defined as an environment variable or in the Ant build." />
+	<!-- Copy Flex SDK location from environment variable. This can be set manually instead. -->
+	<property name="FLEX_HOME" value="${env.FLEX_HOME}" />
+	<property file="build.properties"/>
+
+	<target name="swc" depends="" description="Compile AS3 code into a SWC">
+		<echo>Using Flex SDK at: ${FLEX_HOME}</echo>
+			
+		<java jar="${FLEX_HOME}/lib/compc.jar" dir="." fork="true" failonerror="true">
+			<arg value="+flexlib=${FLEX_HOME}/frameworks" />
+			<arg value="-incremental=true" />
+				
+			<arg value="-source-path+=${src.dir}" />
+			
+			<!-- Include all classes in this path. -->
+			<arg value="-include-sources=${src.dir}/${package.dir}" />
+			
+			<!-- Link in classes from swc library (only those used). -->
+			<!--<arg value="-library-path+=${libs.dir}" />-->
+			
+			<arg value="-output=${output.swc}" />
+		</java>
+			
+	</target>
+	
+	<target name="clean-asdoc">
+		<delete dir="${docs.dir}" failOnError="false" includeEmptyDirs="true"/>
+		<mkdir dir="${docs.dir}"/>
+	</target>
+	
+	<!-- Build Documentation -->
+	<target name="asdoc" depends="swc,clean-asdoc" description="Create API docs for ${project.title}">
+		<echo>Generating ASDOC documentation...</echo>
+		<tstamp>
+			<format property="docgen.time" pattern="MM/dd/yyyy hh:mm aa" unit="hour"/>
+		</tstamp>
+		<java jar="${FLEX_HOME}/lib/asdoc.jar" dir="${FLEX_HOME}/frameworks" fork="true" failonerror="true">
+			<!--<arg line="-external-library-path ${libs.dir}"/>-->
+			<arg line="-doc-sources ${src.dir}/${package.dir}"/>
+			<arg line="-source-path ${src.dir}"/>
+			<arg line="-output ${docs.dir}"/>
+			<arg line="-window-title '${project.title} ${ver.num}'"/>
+			<arg line="-main-title '${project.title} ${ver.num}'"/>
+			<arg line="-footer '${project.title} - Documentation generated at: ${docgen.time}'"/>
+		</java>
+		<echo>ASDOC documentation generated successfully</echo>
+	</target>
+	
+</project>

data/lib/as3signals.rb

@@ -0,0 +1,15 @@
+require 'sprout'
+
+module AS3Signals
+  NAME = "as3signals"
+  VERSION = "0.7.0"
+end
+
+Sprout::Specification.new do |s|
+   s.name    = AS3Signals::NAME
+   s.version = AS3Signals::VERSION
+   s.add_file_target do |t|
+     t.platform = :universal
+     t.add_library :src, "../src"
+   end
+end