jasmine-parser 0.0.1

data/.gitignore

@@ -0,0 +1 @@
+.idea

data/Gemfile

@@ -0,0 +1,37 @@
+# Copyright (c) 2013, Groupon, Inc.
+# All rights reserved. 
+# 
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions
+# are met: 
+# 
+# Redistributions of source code must retain the above copyright notice,
+# this list of conditions and the following disclaimer. 
+# 
+# Redistributions in binary form must reproduce the above copyright
+# notice, this list of conditions and the following disclaimer in the
+# documentation and/or other materials provided with the distribution. 
+# 
+# Neither the name of GROUPON nor the names of its contributors may be
+# used to endorse or promote products derived from this software without
+# specific prior written permission. 
+# 
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS
+# IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
+# TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
+# PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+# HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+# SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED
+# TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
+# PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
+# LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+# NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+# SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+source "http://rubygems.org"
+gemspec
+
+group :development, :test do
+  gem "rspec"
+  gem "rspec_junit_formatter"
+end

data/LICENSE.txt

@@ -0,0 +1,29 @@
+# Copyright (c) 2013, Groupon, Inc.
+# All rights reserved. 
+# 
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions
+# are met: 
+# 
+# Redistributions of source code must retain the above copyright notice,
+# this list of conditions and the following disclaimer. 
+# 
+# Redistributions in binary form must reproduce the above copyright
+# notice, this list of conditions and the following disclaimer in the
+# documentation and/or other materials provided with the distribution. 
+# 
+# Neither the name of GROUPON nor the names of its contributors may be
+# used to endorse or promote products derived from this software without
+# specific prior written permission. 
+# 
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS
+# IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
+# TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
+# PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+# HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+# SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED
+# TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
+# PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
+# LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+# NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+# SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

data/README.md

@@ -0,0 +1,118 @@
+Jasmine-Parser
+==============
+
+### Jasmine-Parser will read through all of the _spec.js files, creating a dependency tree of all the describe/context/it blocks. It will also try to merge any shared examples that are spread through the files, generating a full stack trace for any given test.
+
+
+Problem
+-------
+
+Jasmine is a great tool for testing Javascript. However, outside of Firefox, no browser reliably supports backt races for any given test failures.
+
+This means that, when a test fails on Internet Explorer, all you have is a full test name in the test results. This becomes complicated when a test is using shared examples from other files.
+
+The idea is to drop in this gem into the testing gem and provide the backtrace to all of the tests in the background.
+
+
+### Standard error in console when a test fails
+> 1)
+
+> RuntimeError in 'Some long test Example Name'
+
+> Expected true to be false.
+
+>
+
+> ../jasmine-1.2.1/lib/jasmine/rspec_formatter.rb:41:in `declare_spec'
+
+> ../jasmine-1.2.1/lib/jasmine/rspec_formatter.rb:72:in `report_spec'
+
+> ../jasmine-1.2.1/lib/jasmine/rspec_formatter.rb:42:in `declare_spec'
+
+
+### After jasmine-parser integration
+> 1)
+
+> RuntimeError in 'Some long test Example Name'
+
+> Expected true to be false.
+
+>
+
+> ../project/spec/javascripts/test_spec.js:119:in `Name'
+
+> ../project/spec/javascripts/test_spec.js:104:in `(shared examples)'
+
+> ../project/spec/javascripts/test_spec.js:202:in `Example'
+
+> ../project/spec/javascripts/test_spec.js:201:in `test'
+
+> ../project/spec/javascripts/test_spec.js:99:in `long'
+
+> ../project/spec/javascripts/test_spec.js:1:in `Some'
+
+> ../jasmine-1.2.1/lib/jasmine/rspec_formatter.rb:72:in `report_spec'
+
+> ../jasmine-1.2.1/lib/jasmine/rspec_formatter.rb:42:in `declare_spec'
+
+
+
+Installation
+------------
+
+> gem install jasmine-parser
+
+
+Using
+-----
+
+Declare a suite object
+
+> suite = JasmineParser::JasmineSuite.new
+
+Create a parser instance
+
+> parser = JasmineParser::FileParser.new(suite)
+
+Pass in an Array of files to be parsed
+
+> parser.parse [file1, file2, file3]
+
+After the parsing is complete, the JasmineSuite object has ability to query the test info
+
+> suite.example_count                      #=> Total count of examples discovered
+
+> suite.example_names                      #=> Array of all test names discovered
+
+> suite.find_spec_location("Example name") #=> Array of file:line backtraces in order test files were called
+
+> suite["Example name"]                    #=> An alias of "find_spec_location" method
+
+
+Shared Examples
+---------------
+
+We try to automatically figure out when tests are declaring a block of shared examples, or when calling those in a later location.
+
+Since there is no standard method for doing this, like there is in Rspec, this can get challenging. To cover as many scenarios as possible, we try to support both common ways of dealing with shared examples.
+
+### Function declaration
+
+Any function that is declared in the _spec.js files are treated as a possible container of shared examples. We store this function as such, and during the merging of shared examples stage, try to see if there are any references to that function. If there is, we try to find any "it" nodes inside, and build a backtrace from that.
+
+### Storing shared methods on the window
+In this article, the author recommends to store the shared examples on the window http://robots.thoughtbot.com/post/9611103221/jasmine-and-shared-examples
+
+However, this is not the only way to solve this problem. We have inserted several commonly used shared example method names, but you can add more to the list.
+
+Default shared example declarations: ["sharedExamples", "sharedExamplesFor"]
+To add the names you use
+JasmineParser::Config.shared_behavior_declarations << "Something"
+
+
+Default shared example invocations: ["itShouldBehaveLike", "itBehavesLike"]
+To add the names you use
+JasmineParser::Config.shared_behavior_invocation << "Something"
+
+
+

data/Rakefile

@@ -0,0 +1,43 @@
+# Copyright (c) 2013, Groupon, Inc.
+# All rights reserved. 
+# 
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions
+# are met: 
+# 
+# Redistributions of source code must retain the above copyright notice,
+# this list of conditions and the following disclaimer. 
+# 
+# Redistributions in binary form must reproduce the above copyright
+# notice, this list of conditions and the following disclaimer in the
+# documentation and/or other materials provided with the distribution. 
+# 
+# Neither the name of GROUPON nor the names of its contributors may be
+# used to endorse or promote products derived from this software without
+# specific prior written permission. 
+# 
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS
+# IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
+# TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
+# PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+# HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+# SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED
+# TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
+# PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
+# LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+# NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+# SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+$LOAD_PATH.unshift File.expand_path(File.dirname(__FILE__))
+$LOAD_PATH.unshift File.expand_path("#{File.dirname(__FILE__)}/lib")
+require "bundler"
+Bundler::GemHelper.install_tasks
+
+require 'rspec'
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:spec) do |t|
+  t.pattern = 'spec/**/*_spec.rb'
+end
+
+task :default => :spec

data/jasmine-parser.gemspec

@@ -0,0 +1,50 @@
+# Copyright (c) 2013, Groupon, Inc.
+# All rights reserved. 
+# 
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions
+# are met: 
+# 
+# Redistributions of source code must retain the above copyright notice,
+# this list of conditions and the following disclaimer. 
+# 
+# Redistributions in binary form must reproduce the above copyright
+# notice, this list of conditions and the following disclaimer in the
+# documentation and/or other materials provided with the distribution. 
+# 
+# Neither the name of GROUPON nor the names of its contributors may be
+# used to endorse or promote products derived from this software without
+# specific prior written permission. 
+# 
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS
+# IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
+# TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
+# PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+# HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+# SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED
+# TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
+# PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
+# LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+# NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+# SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+Gem::Specification.new do |s|
+  s.name = "jasmine-parser"
+  s.version = "0.0.1"
+  s.default_executable = "jasmine-parser"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Dima Kovalenko"]
+  s.date = %q{2012-12-03}
+  s.description = %q{Parser for Jasmine Spec Files}
+  s.email = %q{dima.kovalenko@gmail.com}
+  files = `git ls-files`.split("\n") | Dir.glob('jasmine-parser/**/*')
+  files.delete "Gemfile.lock"
+  s.files = files
+  s.test_files = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.homepage = %q{https://github.com/groupon/jasmine-parser}
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.6.2}
+  s.summary = %q{Gem to help to parse all of the jasmine spec files, and create usable stack traces for any given test.}
+  s.add_dependency 'rkelly'
+end

data/lib/jasmine-parser/announcer.rb

@@ -0,0 +1,55 @@
+# Copyright (c) 2013, Groupon, Inc.
+# All rights reserved. 
+# 
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions
+# are met: 
+# 
+# Redistributions of source code must retain the above copyright notice,
+# this list of conditions and the following disclaimer. 
+# 
+# Redistributions in binary form must reproduce the above copyright
+# notice, this list of conditions and the following disclaimer in the
+# documentation and/or other materials provided with the distribution. 
+# 
+# Neither the name of GROUPON nor the names of its contributors may be
+# used to endorse or promote products derived from this software without
+# specific prior written permission. 
+# 
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS
+# IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
+# TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
+# PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+# HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+# SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED
+# TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
+# PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
+# LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+# NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+# SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+module JasmineParser
+
+  class Announcer
+
+    def self.info(message)
+      return nil unless Config.logging.include? :info
+      puts "[INFO] #{message}"
+    end
+
+    def self.warning(message)
+      @warning_count ||= 0
+      @warning_count = @warning_count + 1
+      return nil unless Config.logging.include? :warning
+      puts "[WARNING - #{@warning_count}] #{message}"
+    end
+
+    def self.error(message)
+      @error_count ||= 0
+      @error_count = @error_count + 1
+      return nil unless Config.logging.include? :error
+      puts "[ERROR - #{@error_count}] #{message}"
+    end
+
+  end
+end

data/lib/jasmine-parser/config.rb

@@ -0,0 +1,57 @@
+# Copyright (c) 2013, Groupon, Inc.
+# All rights reserved. 
+# 
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions
+# are met: 
+# 
+# Redistributions of source code must retain the above copyright notice,
+# this list of conditions and the following disclaimer. 
+# 
+# Redistributions in binary form must reproduce the above copyright
+# notice, this list of conditions and the following disclaimer in the
+# documentation and/or other materials provided with the distribution. 
+# 
+# Neither the name of GROUPON nor the names of its contributors may be
+# used to endorse or promote products derived from this software without
+# specific prior written permission. 
+# 
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS
+# IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
+# TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
+# PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+# HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+# SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED
+# TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
+# PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
+# LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+# NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+# SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+module JasmineParser
+  class Config
+
+    #Some common names for shared behavior, add more that apply to your project
+    def self.shared_behavior_declarations
+      @shared_behavior_declarations ||= ["sharedExamples", "sharedExamplesFor"]
+    end
+
+
+    def self.shared_behavior_invocation
+      @shared_behavior_invocation ||= ["itShouldBehaveLike", "itBehavesLike"]
+    end
+
+    def self.reserved_group_example_words
+      ["context", "describe", "it"]
+    end
+
+    def self.logging
+      @logging ||= [:info, :warning, :error]
+    end
+
+    def self.logging=(value)
+      @logging = value
+    end
+    
+  end
+end

data/lib/jasmine-parser/exceptions.rb

@@ -0,0 +1,46 @@
+# Copyright (c) 2013, Groupon, Inc.
+# All rights reserved. 
+# 
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions
+# are met: 
+# 
+# Redistributions of source code must retain the above copyright notice,
+# this list of conditions and the following disclaimer. 
+# 
+# Redistributions in binary form must reproduce the above copyright
+# notice, this list of conditions and the following disclaimer in the
+# documentation and/or other materials provided with the distribution. 
+# 
+# Neither the name of GROUPON nor the names of its contributors may be
+# used to endorse or promote products derived from this software without
+# specific prior written permission. 
+# 
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS
+# IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
+# TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
+# PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+# HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+# SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED
+# TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
+# PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
+# LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+# NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+# SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+module JasmineParser
+
+  class FileParserError < StandardError; end
+  class WrongArgumentTypeForFileParser < FileParserError; end
+  class FileDoesNotExistError < FileParserError; end
+
+  class NodeFactoryError < StandardError; end
+  class NodeTypeCannotBeBlankOrNilError < NodeFactoryError; end
+  class NodeStartLineHasToBeIntegerOrNilError < NodeFactoryError; end
+  class NodeFinalLineHasToBeIntegerOrNilError < NodeFactoryError; end
+
+
+  class NodeError < StandardError; end
+  class UndefinedMethodError < NodeError; end
+  class UnsupportedObjectType < NodeError; end
+end

data/lib/jasmine-parser/file_parser.rb

@@ -0,0 +1,62 @@
+# Copyright (c) 2013, Groupon, Inc.
+# All rights reserved. 
+# 
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions
+# are met: 
+# 
+# Redistributions of source code must retain the above copyright notice,
+# this list of conditions and the following disclaimer. 
+# 
+# Redistributions in binary form must reproduce the above copyright
+# notice, this list of conditions and the following disclaimer in the
+# documentation and/or other materials provided with the distribution. 
+# 
+# Neither the name of GROUPON nor the names of its contributors may be
+# used to endorse or promote products derived from this software without
+# specific prior written permission. 
+# 
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS
+# IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
+# TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
+# PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+# HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+# SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED
+# TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
+# PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
+# LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+# NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+# SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+module JasmineParser
+
+ class FileParser
+
+   attr_accessor :suite
+   def initialize(suite)
+     @suite = suite
+   end
+
+   def parse(files)
+     raise WrongArgumentTypeForFileParser unless files.kind_of? Array
+     Announcer.info "Parsing #{files.size} spec files"
+     files.each do |filename|
+      raise FileDoesNotExistError unless File.exist? filename
+      #TODO: make this parallel if possible
+      #ToDO: think of caching of files for large projects
+      suite.add_spec_file(parse_file(filename))
+     end
+     Announcer.info "#{suite.example_count} examples found"
+   end
+
+
+   private
+
+   def parse_file(filename)
+     NodeFactory.parse_file filename
+   end
+
+ end
+
+
+end

data/lib/jasmine-parser/jasmine_suite.rb

@@ -0,0 +1,69 @@
+# Copyright (c) 2013, Groupon, Inc.
+# All rights reserved. 
+# 
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions
+# are met: 
+# 
+# Redistributions of source code must retain the above copyright notice,
+# this list of conditions and the following disclaimer. 
+# 
+# Redistributions in binary form must reproduce the above copyright
+# notice, this list of conditions and the following disclaimer in the
+# documentation and/or other materials provided with the distribution. 
+# 
+# Neither the name of GROUPON nor the names of its contributors may be
+# used to endorse or promote products derived from this software without
+# specific prior written permission. 
+# 
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS
+# IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
+# TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
+# PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+# HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+# SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED
+# TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
+# PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
+# LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+# NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+# SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+module JasmineParser
+
+  class JasmineSuite
+
+    attr_reader :spec_files
+    def initialize
+      @spec_files = []
+    end
+
+    def add_spec_file(file_object)
+      @spec_files << file_object
+    end
+
+    def find_spec_location(spec_description)
+      spec_description = spec_description.strip
+      return location_finder.all_examples[spec_description] if location_finder.all_examples[spec_description]
+      Announcer.warning("Could not find the location for this example name\n'#{spec_description}'")
+      nil
+    end
+
+    alias :[] :find_spec_location
+
+    def example_count
+      location_finder.example_count
+    end
+
+    def example_names
+      location_finder.test_names
+    end
+
+    private
+
+    def location_finder
+      @location_finder ||= LocationFiner.new(self)
+    end
+    
+  end
+
+end