citrus_test 0.1.1

data/README.md

@@ -0,0 +1,35 @@
+citrus_test
+===========
+
+citrus_test makes it easier to test Citrus grammars.
+
+Quick Start
+-----------
+
+	require 'citrus_test'
+
+	# citrus_test expects all your Citrus grammars to be located in grammar_dir.
+	# The path grammar_dir is set to is relative to the directory that the source
+	# file that set it is in. (If you're using irb, use an absolute path.)
+	GrammarTest.grammar_dir = "../grammars/"
+
+	# What you name your class is important. For example, this class will use the
+	# grammar located at ../grammars/nahuatal_language.citrus. The name of your
+	# class *must* end in Test.
+	class NahuatalLanguageTest < GrammarTest
+		def test_possession
+			# The parse() method returns the .value of the result of parsing.
+			possessed_house = parse(:possession, "no-kal")
+			assert_equal('house', possessed_house)
+
+			# This asserts that:
+			# _ = parse(:possession, "no-kal")
+			# _ # => "house"
+			# _.possessor # => "me"
+			assert_parses(:possession, "no-kal", "house", possessor: "me")
+
+			# deny_parses() does the opposite.
+			deny_parses(:possession, "kal-li")
+		end
+	end
+

data/UNLICENSE

@@ -0,0 +1,24 @@
+This is free and unencumbered software released into the public domain.
+
+Anyone is free to copy, modify, publish, use, compile, sell, or
+distribute this software, either in source code form or as a compiled
+binary, for any purpose, commercial or non-commercial, and by any
+means.
+
+In jurisdictions that recognize copyright laws, the author or authors
+of this software dedicate any and all copyright interest in the
+software to the public domain. We make this dedication for the benefit
+of the public at large and to the detriment of our heirs and
+successors. We intend this dedication to be an overt act of
+relinquishment in perpetuity of all present and future rights to this
+software under copyright law.
+
+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 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.
+
+For more information, please refer to <http://unlicense.org/>

data/lib/citrus_test.rb

@@ -0,0 +1,89 @@
+#!/usr/bin/env ruby
+require 'citrus'
+require 'test/unit'
+
+class GrammarTest < Test::Unit::TestCase
+	# This is not a test!
+	@@test_suites[GrammarTest] = false # Yes, this is undocumented. :x
+
+	class << self
+		attr_reader :grammar_dir
+		# gd is considered relative to the directory of the caller's SOURCE CODE.
+		def grammar_dir=(gd)
+			caller_dir = File.dirname(/\A(.*?):\d+:in `.*'\z/.match(caller[0])[1])
+			class_variable_set(:@@grammar_dir, File.absolute_path(gd, caller_dir))
+		end
+	end
+
+	# Set the name of the grammar our subclass uses on the basis of its mangled
+	# name.
+	def self.inherited(subclass) # :nodoc:
+		if subclass.name =~ /\ATest([A-Z_][A-Za-z_]*)\z/
+			class_variable_set(:@@grammar, $1)
+
+			super
+		else
+			raise SyntaxError.new("give your class a proper name")
+		end
+	end
+
+	# Convert a camel-cased string to an underscored one. (e.g.
+	# "SatanSatanLendMeADollar" becomes "satan_satan_lend_me_a_dollar")
+	def mangle_class_name(name) # :nodoc:
+		unless name =~ /\A[A-Z_][A-Za-z_]*\z/
+			raise "#{name} doesn't look like a valid class name"
+		end
+
+		name.scan(/[A-Z_][a-z_]*/).map(&:downcase).join("_")
+	end
+
+	# Load the grammar file ../grammars/{@@grammar}.citrus
+	def setup
+		grammar_file = "#{mangle_class_name(@@grammar)}.citrus"
+		Citrus.load( File.join(@@grammar_dir, grammar_file) )
+	end
+
+	# Get a specific rule from the grammar.
+	def rule(name)
+		@rules ||= {}
+		@rules[@@grammar] ||= self.class.const_get(@@grammar).rule(name)
+	end
+
+	# Parse input according to rule.
+	def parse(rule, input)
+		rule(rule).parse(input).value
+	end
+
+	# Assert that rule parses str into val, returning val (actually, the return
+	# value of parse(rule, str)) if the assertion passed. Additionally, assert
+	# that value has every attribute specified in attributes, and that they have
+	# the value specified.
+	def assert_parses(rule, str, val, attributes={})
+		msg ||= "#{@@grammar}.#{rule} failed to parse #{str.inspect} properly"
+
+		ret = nil
+		assert_nothing_raised(msg) do
+			ret = parse(rule, str)
+			assert_equal(ret, val, msg)
+		end
+
+		attributes.each do |attr, expected_val|
+			assert(ret.respond_to?(attr), "#{attr} doesn't exist")
+			_ = "An exception was raised when fetching the #{attr} attribute"
+			assert_nothing_raised(_) do
+				_ = "#{attr} attribute has an unexpected value"
+				assert_equal(expected_val, ret.send(attr), _)
+			end
+		end
+
+		ret
+	end
+
+	# Assert that rule raises Citrus::ParseError. (By default, msg is
+	# "#{@@grammar}.#{rule} parsed #{str.inspect} when it shouldn't have.")
+	def deny_parses(rule, str, msg=nil)
+		msg ||= "#{@@grammar}.#{rule} parsed #{str.inspect} when it shouldn't have"
+		assert_raises(Citrus::ParseError, msg){ rule(rule).parse(str) }
+	end
+end
+

metadata

@@ -0,0 +1,114 @@
+--- !ruby/object:Gem::Specification 
+name: citrus_test
+version: !ruby/object:Gem::Version 
+  prerelease: false
+  segments: 
+  - 0
+  - 1
+  - 1
+  version: 0.1.1
+platform: ruby
+authors: 
+- katmagic
+autorequire: 
+bindir: bin
+cert_chain: 
+- |
+  -----BEGIN CERTIFICATE-----
+  MIIDQDCCAiigAwIBAgIBADANBgkqhkiG9w0BAQUFADBGMRgwFgYDVQQDDA90aGUu
+  bWFnaWNhbC5rYXQxFTATBgoJkiaJk/IsZAEZFgVnbWFpbDETMBEGCgmSJomT8ixk
+  ARkWA2NvbTAeFw0xMTA4MjEyMjMyMDFaFw0xMjA4MjAyMjMyMDFaMEYxGDAWBgNV
+  BAMMD3RoZS5tYWdpY2FsLmthdDEVMBMGCgmSJomT8ixkARkWBWdtYWlsMRMwEQYK
+  CZImiZPyLGQBGRYDY29tMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA
+  pBt20nwjs5W03djpRN6FAbpiio286NHMTk6HhmjV6GZKOi5ZUX5onTnKUg2Vc35z
+  /nK+aIPReyRfBgIcfSjhoXh1A1Dp+2laNgTtU/3eMupruatgORAPCSaG9Ns+HSyR
+  vySbz1QUrwvlvF0qkhhApNQ6dsLl2LMOV3QcluY+Y3CVccOWOSHdQcnAbPuzM9Hf
+  4ChI4OGL7+DwLA5OK2S5uewRAa2iLkJSN0WugnQlJqMT59GRaqTDOtnYQpiyKEBy
+  QjVPO4LNk7iDsJP22YBrveIzm8/YYRBTU4LTHMEMOyCszrYqD2S1Lwp2rtCJzQCl
+  BA0LtBKrZl5mwZm7qyj+TwIDAQABozkwNzAJBgNVHRMEAjAAMB0GA1UdDgQWBBSm
+  s5arhjp61kmGl6wsmLYkqerdqDALBgNVHQ8EBAMCBLAwDQYJKoZIhvcNAQEFBQAD
+  ggEBAA6cQNQMOPRy4yrj7Nh5Mb9qq8t/8ho/JQvjzVof9qRd+kfKrOoOhXfEO+Rm
+  sWcaOnBCVC4DnZuNDSLygVhCDtMnHjg/JsfO/GBF/QlNTJOO1jkoQiS6w0KARlBm
+  cpXaWg/oMtXJ2PaUga6WkNeXYf9Mad36P4yuGQScjs+WkUUy7DNZvTGReIcCWOR8
+  jteSvvCMobQKGr2DfFOU9Jiddh2FPpz/KOM2ijzwsVNUMUr7R58LoCnQZrZ/YaRW
+  ob6QnVgwqu5SUAKQxlFJ/aKlPMj735z8EogaZC1ZHgg3vkgGGyu57N/8BDDG0TzC
+  Zn3u2leVae/fJ03zYGArhuJKPgc=
+  -----END CERTIFICATE-----
+
+date: 2011-08-22 00:00:00 -04:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rake
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: citrus
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        version: "0"
+  type: :runtime
+  version_requirements: *id002
+description: citrus_test makes it easier to test Citrus grammars.
+email: the.magical.kat@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- lib/citrus_test.rb
+- UNLICENSE
+- README.md
+has_rdoc: true
+homepage: https://github.com/katmagic/citrus_test
+licenses: 
+- Public Domain
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 1
+      - 9
+      - 2
+      version: 1.9.2
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: citrus_test
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: citrus_test makes it easier to test Citrus grammars.
+test_files: []
+

metadata.gz.sig

@@ -0,0 +1,3 @@
+o�~ē�_y�hw�"=�L����N<ɠ\�Y
+,���x���̿��#�8#y�H�b���a�t�8�c�$�m������66q��C(!��W��`��~�+���r�$��r9e�|��/b�I�ң�
+�=Cy&�詇8˔W1c���돂8��#���/�ҷn���)�!
u	�7�|Vvgq�8G>�'v��z�T��!����Z޹9�[������U�iȇ��v1�����l