stupidedi 1.1.0

data/spec/fixtures/X224-HC837/4-good.txt

@@ -0,0 +1,40 @@
+Example 4 - Orthodontic Treatment Plan 
+
+Orthodontic treatment plan, patient is not the subscriber. The payer is a commercial payer. Billing provider submits claim directly to the payer.
+
+ISA*00*..........*01*SECRET....*ZZ*SUBMITTERS.ID..*ZZ*RECEIVERS.ID...*030101*1253*^*00501*000000905*1*T*:~
+GS*HC*SENDER CODE*RECEIVER CODE*19991231*0802*1*X*005010X224A1~
+ST*837*0322*005010X224A1~
+BHT*0019*00*0123*20061123*1023*CH~
+NM1*41*2*JOHN DOE*****46*940001~
+PER*IC*SALLY*TE*7175555555~
+NM1*40*2*KEY INSURANCE COMPANY*****46*999996666~
+HL*1**20*1~
+PRV*BI*PXC*1223G0001X~
+NM1*85*1*JOHN*DOE****XX*2345678900~
+N3*123 TOOTH DRIVE~
+N4*MIAMI*FL*334111234~
+REF*EI*587654321~
+HL*2*1*22*1~
+SBR*P********CI~
+NM1*IL*1*SMITH*JANE****MI*111223333~
+N3*1234 A AVENUE~
+N4*MIAMI*FL*33411~
+NM1*PR*2*KEY INSURANCE COMPANY*****PI*999996666~
+N4*MIAMI*FL*33111~
+HL*3*2*23*0~
+PAT*19~
+NM1*QC*1*SMITH*TED~
+N3*236 N MAIN ST~
+N4*MIAMI*FL*33413~
+DMG*D8*19911029*M~
+CLM*SMITH788*4000***11:B:1*Y*A*Y*Y~
+DTP*452*D8*20061115~
+DN1*36~
+LX*1~
+SV3*AD:D8080*4000****1~
+DTP*472*D8*20061115~
+REF*6R*001~
+SE*32*0322~
+GE*1*1~
+IEA*1*000000905~

data/spec/fixtures/X230-FA997/1-bad.txt

@@ -0,0 +1,19 @@
+The following example describes a 997 transaction set that is responding to a functional group that was received containing two 837 transaction sets. The first transaction set conformed fully with the X12 standard, while the second contained errors.
+
+Errors Found in File 997 5010X230
+* W10009:Padding, spaces or control characters detected after segment terminator.
+
+ISA*00*          *00*          *ZZ*123456789      *ZZ*987654321      *041117*1024*^*00501*000000286*0*P*:~
+GS*FA*RCVR*SNDR*20041117*1024*287*X*005010X230~
+ST*997*2870001*005010X230~
+AK1*HC*17456*005010~
+AK2*837*0001~
+AK5*A~
+AK2*837*0002~
+AK3*CLM*22**8~
+AK4*1*1028*1~
+AK5*R*5~
+AK9*P*2*2*1~
+SE*10*2870001~
+GE*1*287~
+IEA*1*000000286~

data/spec/fixtures/X230-FA997/1-good.txt

@@ -0,0 +1,16 @@
+The following example describes a 997 transaction set that is responding to a functional group that was received containing two 837 transaction sets. The first transaction set conformed fully with the X12 standard, while the second contained errors.
+
+ISA*00*          *00*          *ZZ*123456789      *ZZ*987654321      *041117*1024*^*00501*000000286*0*P*:~
+GS*FA*RCVR*SNDR*20041117*1024*287*X*005010X230~
+ST*997*2870001*005010X230~
+AK1*HC*17456*005010~
+AK2*837*0001~
+AK5*A~
+AK2*837*0002~
+AK3*CLM*22**8~
+AK4*1*1028*1~
+AK5*R*5~
+AK9*P*2*2*1~
+SE*10*2870001~
+GE*1*287~
+IEA*1*000000286~

data/spec/fixtures/X231-FA999/1-bad.txt

@@ -0,0 +1,20 @@
+ISA*00* *00* *ZZ*123456789 *ZZ*987654321 *041117*1024*^*00501*000000286*0*P*:~
+GS*FA*RCVR*SNDR*20041117*1024*287*X*005010X231~
+ST*999*2870001*005010X231~
+AK1*HC*17456*004010X098A1~
+AK2*837*0001~
+IK5*A~
+AK2*837*0002~
+IK3*CLM*22**8~
+CTX*CLM01:123456789~
+IK4*2*782*1~
+IK5*R*5~
+AK2*837*0003~
+IK3*REF*57**3~
+CTX*SITUATIONAL TRIGGER*CLM*43**5:3*C023:1325~
+CTX*CLM01:987654321~
+IK5*R*5~
+AK9*P*3*3*1~
+SE*16*2870001~
+GE*1*287~
+IEA*1*000000286~

data/spec/fixtures/X231-FA999/1-good.txt

@@ -0,0 +1,20 @@
+ISA*00* *00* *ZZ*123456789 *ZZ*987654321 *041117*1024*^*00501*000000286*0*P*:~
+GS*FA*RCVR*SNDR*20041117*1024*287*X*005010X231A1~
+ST*999*2870001*005010X231~
+AK1*HC*17456*004010X098A1~
+AK2*837*0001~
+IK5*A~
+AK2*837*0002~
+IK3*CLM*22**8~
+CTX*CLM01:123456789~
+IK4*2*782*1~
+IK5*R*5~
+AK2*837*0003~
+IK3*REF*57**3~
+CTX*SITUATIONAL TRIGGER*CLM*43**5:3~
+CTX*CLM01:987654321~
+IK5*R*5~
+AK9*P*3*3*1~
+SE*16*2870001~
+GE*1*287~
+IEA*1*000000286~

data/spec/fixtures/X279-HB271/1-bad.txt

@@ -0,0 +1,36 @@
+Example 1 - Subscriber Found Response
+
+Response to a generic request by a clinic for the patient's, who is the subscriber, eligibility. This response illustrates the required components outlined in Section 1.4.7 - Implementation-Compliant Use of the 270/271 Transaction Set. The payer has indicated the patient has active coverage for the health plan, the beginning date for their coverage with the plan, active coverage for all the benefits outlined in Section 1.4.7 - Implementation-Compliant Use of the 270/271 Transaction Set and they have a Primary Care Physician.
+
+Errors Found in File 271 5010X29-1
+* W10009:Padding, spaces or control characters detected after segment terminator.
+* H10203:Functional Group ID 'XX' mismatch - Transaction Set is type 'HB'
+* H11204:Code Value 'XX' not used for element 'GS01'
+* H21084:Invalid qualifier 'SV' found in '2120C NM108'. Only 'XX' is valid because the National Provider Identifier (NPI) is now mandated for use.
+
+ISA*00*..........*01*SECRET....*ZZ*SUBMITTERS.ID..*ZZ*RECEIVERS.ID...*030101*1253*^*00501*000000905*1*T*:~
+GS*XX*SENDER CODE*RECEIVER CODE*19991231*0802*1*X*005010X279~
+ST*271*4321*005010X279~
+BHT*0022*11*10001234*20060501*1319~
+HL*1**20*1~
+NM1*PR*2*ABC COMPANY*****PI*842610001~
+HL*2*1*21*1~
+NM1*1P*2*BONE AND JOINT CLINIC*****SV*2000035~
+HL*3*2*22*0~
+TRN*2*93175-012547*9877281234~
+NM1*IL*1*SMITH*JOHN****MI*123456789~
+N3*15197 BROADWAY AVENUE*APT 215~
+N4*KANSAS CITY*MO*64108~
+DMG*D8*19630519*M~
+DTP*346*D8*20060101~
+EB*1**30**GOLD 123 PLAN~
+EB*L~
+LS*2120~
+NM1*P3*1*JONES*MARCUS****SV*0202034~
+LE*2120~
+EB*1**1^33^35^47^86^88^98^AL^MH^UC~
+EB*B**1^33^35^47^86^88^98^AL^MH^UC*HM*GOLD 123 PLAN*27*10*****Y~
+EB*B**1^33^35^47^86^88^98^AL^MH^UC*HM*GOLD 123 PLAN*27*30*****N~
+SE*22*4321~
+GE*1*1~
+IEA*1*000000905~

data/spec/fixtures/X279-HB271/1-good.txt

@@ -0,0 +1,30 @@
+Example 1 - Subscriber Found Response
+
+Response to a generic request by a clinic for the patient's, who is the subscriber, eligibility. This response illustrates the required components outlined in Section 1.4.7 - Implementation-Compliant Use of the 270/271 Transaction Set. The payer has indicated the patient has active coverage for the health plan, the beginning date for their coverage with the plan, active coverage for all the benefits outlined in Section 1.4.7 - Implementation-Compliant Use of the 270/271 Transaction Set and they have a Primary Care Physician.
+
+ISA*00*..........*01*SECRET....*ZZ*SUBMITTERS.ID..*ZZ*RECEIVERS.ID...*030101*1253*^*00501*000000905*1*T*:~
+GS*HB*SENDER CODE*RECEIVER CODE*19991231*0802*1*X*005010X279~
+ST*271*4321*005010X279~
+BHT*0022*11*10001234*20060501*1319~
+HL*1**20*1~
+NM1*PR*2*ABC COMPANY*****PI*842610001~
+HL*2*1*21*1~
+NM1*1P*2*BONE AND JOINT CLINIC*****SV*2000035~
+HL*3*2*22*0~
+TRN*2*93175-012547*9877281234~
+NM1*IL*1*SMITH*JOHN****MI*123456789~
+N3*15197 BROADWAY AVENUE*APT 215~
+N4*KANSAS CITY*MO*64108~
+DMG*D8*19630519*M~
+DTP*346*D8*20060101~
+EB*1**30**GOLD 123 PLAN~
+EB*L~
+LS*2120~
+NM1*P3*1*JONES*MARCUS****XX*1232343560~
+LE*2120~
+EB*1**1^33^35^47^86^88^98^AL^MH^UC~
+EB*B**1^33^35^47^86^88^98^AL^MH^UC*HM*GOLD 123 PLAN*27*10*****Y~
+EB*B**1^33^35^47^86^88^98^AL^MH^UC*HM*GOLD 123 PLAN*27*30*****N~
+SE*22*4321~
+GE*1*1~
+IEA*1*000000905~

data/spec/fixtures/X279-HB271/2-bad.txt

@@ -0,0 +1,22 @@
+Example 1 � Error Response
+
+The request validation segment is used in this example to indicate that the provider is not eligible for inquiries.
+
+Errors Found in File 271 5010X279-2
+* W10009:Padding, spaces or control characters detected after segment terminator.
+* H10203:Functional Group ID 'XX' mismatch - Transaction Set is type 'HB'
+* H11204:Code Value 'XX' not used for element 'GS01'
+* H11402:HL segment marked as having children but in fact has none','HL segment n marked as having children but in fact has none
+
+ISA*00*..........*01*SECRET....*ZZ*SUBMITTERS.ID..*ZZ*RECEIVERS.ID...*030101*1253*^*00501*000000905*1*T*:~
+GS*XX*SENDER CODE*RECEIVER CODE*19991231*0802*1*X*005010X279~
+ST*271*4323*005010X279~
+BHT*0022*11*10001234*20060501*1319~
+HL*1**20*1~
+NM1*PR*2*ABC COMPANY*****PI*842610001~
+HL*2*1*21*1~
+NM1*1P*2*BONE AND JOINT CLINIC*****SV*2000035~
+AAA*Y**50*N~
+SE*8*4323~
+GE*1*1~
+IEA*1*000000905~

data/spec/fixtures/X279-HB271/2-good.txt

@@ -0,0 +1,16 @@
+Example 1 � Error Response
+
+The request validation segment is used in this example to indicate that the provider is not eligible for inquiries.
+
+ISA*00*..........*01*SECRET....*ZZ*SUBMITTERS.ID..*ZZ*RECEIVERS.ID...*030101*1253*^*00501*000000905*1*T*:~
+GS*HB*SENDER CODE*RECEIVER CODE*19991231*0802*1*X*005010X279~
+ST*271*4323*005010X279~
+BHT*0022*11*10001234*20060501*1319~
+HL*1**20*1~
+NM1*PR*2*ABC COMPANY*****PI*842610001~
+HL*2*1*21*0~
+NM1*1P*2*BONE AND JOINT CLINIC*****SV*2000035~
+AAA*Y**50*N~
+SE*8*4323~
+GE*1*1~
+IEA*1*000000905~

data/spec/fixtures/X279-HB271/3-bad.txt

@@ -0,0 +1,44 @@
+Example 2 � Response
+
+Response to a generic request by a physician for the patient's, who is not the subscriber, eligibility. The payer has indicated the patient has active coverage for the health plan, the beginning date for their coverage with the plan, active coverage for all the benefits outlined in Section 1.4.7 - Implementation-Compliant Use of the 270/271 Transaction Set and they have a Primary Care Physician.
+
+Errors Found in File 271 5010X279-3
+* W10009:Padding, spaces or control characters detected after segment terminator.
+* H10203:Functional Group ID 'XX' mismatch - Transaction Set is type 'HB'
+* H11204:Code Value 'XX' not used for element 'GS01'
+* H11402:HL segment marked as having children but in fact has none','HL segment n marked as having children but in fact has none
+* H20204:Code Value '1' at element 'HL04' is valid in the X12 standard, but not in this HIPAA implementation
+* H21084:Invalid qualifier 'SV' found in '2120D NM108'. Only 'XX' is valid because the National Provider Identifier (NPI) is now mandated for use.
+
+ISA*00*..........*01*SECRET....*ZZ*SUBMITTERS.ID..*ZZ*RECEIVERS.ID...*030101*1253*^*00501*000000905*1*T*:~
+GS*XX*SENDER CODE*RECEIVER CODE*19991231*0802*1*X*005010X279~
+ST*271*4322*005010X279~
+BHT*0022*11*10001235*20060501*1319~
+HL*1**20*1~
+NM1*PR*2*ABC COMPANY*****PI*842610001~
+HL*2*1*21*1~
+NM1*1P*2*BONE AND JOINT CLINIC*****SV*2000035~
+HL*3*2*22*1~
+NM1*IL*1*SMITH*JOHN****MI*123456789~
+N3*15197 BROADWAY AVENUE*APT 215~
+N4*KANSAS CITY*MO*64108~
+DMG*D8*19630519*M~
+HL*4*3*23*1~
+TRN*2*93175-012547*9877281234~
+NM1*03*1*SMITH*MARY~
+N3*15197 BROADWAY AVENUE*APT 215~
+N4*KANSAS CITY*MO*64108~
+DMG*D8*19981014*F~
+INS*N*19~
+DTP*346*D8*20060101~
+EB*1**30**GOLD 123 PLAN~
+EB*L~
+LS*2120~
+NM1*P3*1*JONES*MARCUS****SV*0202034~
+LE*2120~
+EB*1**1^33^35^47^86^88^98^AL^MH^UC~
+EB*B**1^33^35^47^86^88^98^AL^MH^UC*HM*GOLD 123 PLAN*27*10*****Y~
+EB*B**1^33^35^47^86^88^98^AL^MH^UC*HM*GOLD 123 PLAN*27*30*****N~
+SE*28*4322~
+GE*1*1~
+IEA*1*000000905~

data/spec/fixtures/X279-HB271/3-good.txt

@@ -0,0 +1,36 @@
+Example 2 � Response
+
+Response to a generic request by a physician for the patient's, who is not the subscriber, eligibility. The payer has indicated the patient has active coverage for the health plan, the beginning date for their coverage with the plan, active coverage for all the benefits outlined in Section 1.4.7 - Implementation-Compliant Use of the 270/271 Transaction Set and they have a Primary Care Physician.
+
+ISA*00*..........*01*SECRET....*ZZ*SUBMITTERS.ID..*ZZ*RECEIVERS.ID...*030101*1253*^*00501*000000905*1*T*:~
+GS*HB*SENDER CODE*RECEIVER CODE*19991231*0802*1*X*005010X279~
+ST*271*4322*005010X279~
+BHT*0022*11*10001235*20060501*1319~
+HL*1**20*1~
+NM1*PR*2*ABC COMPANY*****PI*842610001~
+HL*2*1*21*1~
+NM1*1P*2*BONE AND JOINT CLINIC*****SV*2000035~
+HL*3*2*22*1~
+NM1*IL*1*SMITH*JOHN****MI*123456789~
+N3*15197 BROADWAY AVENUE*APT 215~
+N4*KANSAS CITY*MO*64108~
+DMG*D8*19630519*M~
+HL*4*3*23*0~
+TRN*2*93175-012547*9877281234~
+NM1*03*1*SMITH*MARY~
+N3*15197 BROADWAY AVENUE*APT 215~
+N4*KANSAS CITY*MO*64108~
+DMG*D8*19981014*F~
+INS*N*19~
+DTP*346*D8*20060101~
+EB*1**30**GOLD 123 PLAN~
+EB*L~
+LS*2120~
+NM1*P3*1*JONES*MARCUS****XX*1020203497~
+LE*2120~
+EB*1**1^33^35^47^86^88^98^AL^MH^UC~
+EB*B**1^33^35^47^86^88^98^AL^MH^UC*HM*GOLD 123 PLAN*27*10*****Y~
+EB*B**1^33^35^47^86^88^98^AL^MH^UC*HM*GOLD 123 PLAN*27*30*****N~
+SE*28*4322~
+GE*1*1~
+IEA*1*000000905~

data/spec/fixtures/X279-HS270/1-bad.txt

@@ -0,0 +1,29 @@
+Example 1 - Request
+
+The Subscriber is the patient. A generic request by a clinic for the patient's eligibility.
+
+This is an example of an eligibility request from a clinic to a payer processed in Real Time. The clinic is inquiring if the patient has coverage.
+
+Errors Found in File 270 5010X279-1
+* W10009:Padding, spaces or control characters detected after segment terminator.
+* H10203:Functional Group ID 'XX' mismatch - Transaction Set is type 'HS'
+* H11204:Code Value 'XX' not used for element 'GS01'
+* W25219:The value of SV is only to be used if the provider is not a covered health care provider under the NPI mandate.
+
+ISA*00*..........*01*SECRET....*ZZ*SUBMITTERS.ID..*ZZ*RECEIVERS.ID...*030101*1253*^*00501*000000905*1*T*:~
+GS*XX*SENDER CODE*RECEIVER CODE*19991231*0802*1*X*005010X279~
+ST*270*1234*005010X279~
+BHT*0022*13*10001234*20060501*1319~
+HL*1**20*1~
+NM1*PR*2*ABC COMPANY*****PI*842610001~
+HL*2*1*21*1~
+NM1*1P*2*BONE AND JOINT CLINIC*****SV*2000035~
+HL*3*2*22*0~
+TRN*1*93175-012547*9877281234~
+NM1*IL*1*SMITH*ROBERT****MI*11122333301~
+DMG*D8*19430519~
+DTP*291*D8*20060501~
+EQ*30~
+SE*13*1234~
+GE*1*1~
+IEA*1*000000905~

data/spec/fixtures/X279-HS270/1-good.txt

@@ -0,0 +1,23 @@
+Example 1 - Request
+
+The Subscriber is the patient. A generic request by a clinic for the patient's eligibility.
+
+This is an example of an eligibility request from a clinic to a payer processed in Real Time. The clinic is inquiring if the patient has coverage.
+
+ISA*00*..........*01*SECRET....*ZZ*SUBMITTERS.ID..*ZZ*RECEIVERS.ID...*030101*1253*^*00501*000000905*1*T*:~
+GS*HS*SENDER CODE*RECEIVER CODE*19991231*0802*1*X*005010X279~
+ST*270*1234*005010X279~
+BHT*0022*13*10001234*20060501*1319~
+HL*1**20*1~
+NM1*PR*2*ABC COMPANY*****PI*842610001~
+HL*2*1*21*1~
+NM1*1P*2*BONE AND JOINT CLINIC*****XX*1232343560~
+HL*3*2*22*0~
+TRN*1*93175-012547*9877281234~
+NM1*IL*1*SMITH*ROBERT****MI*11122333301~
+DMG*D8*19430519~
+DTP*291*D8*20060501~
+EQ*30~
+SE*13*1234~
+GE*1*1~
+IEA*1*000000905~

data/spec/fixtures/X279-HS270/2-bad.txt

@@ -0,0 +1,32 @@
+Example 2 - Request
+
+The patient is the dependent of a subscriber. 
+
+Generic request by a physician for the patient's eligibility. This is an example of an eligibility request from an individual provider to a payer. The physician is inquiring if the patient has coverage.
+
+Errors Found in File 270 5010X279-2
+* W10009:Padding, spaces or control characters detected after segment terminator.
+* H10203:Functional Group ID 'XX' mismatch - Transaction Set is type 'HS'
+* H11204:Code Value 'XX' not used for element 'GS01'
+* W25219:The value of SV is only to be used if the provider is not a covered health care provider under the NPI mandate.
+* H10913:Transaction Set Control Number '1234' does not match ST02's '1235'.
+
+ISA*00*..........*01*SECRET....*ZZ*SUBMITTERS.ID..*ZZ*RECEIVERS.ID...*030101*1253*^*00501*000000905*1*T*:~
+GS*XX*SENDER CODE*RECEIVER CODE*19991231*0802*1*X*005010X279~
+ST*270*1235*005010X279~
+BHT*0022*13*10001235*20060501*1320~
+HL*1**20*1~
+NM1*PR*2*ABC COMPANY*****PI*842610001~
+HL*2*1*21*1~
+NM1*1P*1*JONES*MARCUS****SV*0202034~
+HL*3*2*22*1~
+NM1*IL*1******MI*11122333301~
+HL*4*3*23*0~
+TRN*1*93175-012547*9877281234~
+NM1*03*1*SMITH*MARY~
+DMG*D8*19781014~
+DTP*291*D8*20060501~
+EQ*30~
+SE*15*1234~
+GE*1*1~
+IEA*1*000000905~

data/spec/fixtures/X279-HS270/2-good.txt

@@ -0,0 +1,25 @@
+Example 2 - Request
+
+The patient is the dependent of a subscriber. 
+
+Generic request by a physician for the patient's eligibility. This is an example of an eligibility request from an individual provider to a payer. The physician is inquiring if the patient has coverage.
+
+ISA*00*..........*01*SECRET....*ZZ*SUBMITTERS.ID..*ZZ*RECEIVERS.ID...*030101*1253*^*00501*000000905*1*T*:~
+GS*HS*SENDER CODE*RECEIVER CODE*19991231*0802*1*X*005010X279~
+ST*270*1235*005010X279~
+BHT*0022*13*10001235*20060501*1320~
+HL*1**20*1~
+NM1*PR*2*ABC COMPANY*****PI*842610001~
+HL*2*1*21*1~
+NM1*1P*1*JONES*MARCUS****XX*1232343560~
+HL*3*2*22*1~
+NM1*IL*1******MI*11122333301~
+HL*4*3*23*0~
+TRN*1*93175-012547*9877281234~
+NM1*03*1*SMITH*MARY~
+DMG*D8*19781014~
+DTP*291*D8*20060501~
+EQ*30~
+SE*15*1235~
+GE*1*1~
+IEA*1*000000905~

data/spec/spec_helper.rb

@@ -0,0 +1,34 @@
+require File.expand_path("../../lib/stupidedi", __FILE__)
+
+begin
+  # RSpec-1: https://github.com/dchelimsky/rspec
+  require "spec"
+rescue LoadError
+  # RSpec-2: https://github.com/rspec/rspec
+  require "rspec"
+end
+
+# Require supporting files with custom matchers and macros
+Pathname.new(File.dirname(__FILE__)).tap do |specdir|
+  Dir["#{specdir}/support/**/*.rb"].each do |file|
+    require Pathname.new(file).relative_path_from(specdir)
+  end
+end
+
+RSpec.configure do |config|
+  config.include(EitherMatchers)
+
+  # rspec -I lib -t random spec
+  # config.filter_run :random => true
+
+  # rspec -I lib -t ~random spec
+  # config.filter_run_excluding :random => true
+
+  # Skip platform-specific examples unless our platform matches
+  config.filter_run_excluding(:ruby => lambda{|n| RUBY_VERSION !~ /^#{n}/ })
+
+# config.filter_run(:random => true)
+# config.filter_run(:focus  => true)
+
+# srand 44182052595481443184625304627718313206
+end

data/spec/support/fixtures.rb

@@ -0,0 +1,26 @@
+Fixtures = Class.new do
+  def initialize(root)
+    @root  = root
+    @files = Hash.new{|h,k| h[k] = parse(k) }
+
+    @config  = Stupidedi::Config.default
+    @machine = Stupidedi::Builder::StateMachine.build(@config)
+  end
+
+  def file(path)
+    @files[path]
+  end
+
+  # @return [StateMachine]
+  def parse(path)
+    path = File.join(@root, path)
+    pair = File.open(path){|io| @machine.read(Stupidedi::Reader.build(io)) }
+
+    machine, result = pair
+    if result.fatal?
+      result.explain{|msg| raise msg }
+    end
+
+    machine
+  end
+end.new(File.expand_path("../../fixtures", __FILE__))

data/spec/support/matchers/either_matchers.rb

@@ -0,0 +1,26 @@
+module EitherMatchers
+
+  def be_defined
+    BeDefined.new
+  end
+
+  class BeDefined
+    def matches?(either)
+      @either = either
+      either.defined?
+    end
+
+    def failure_message_for_should
+      "expected Either.success, got #{@either.inspect}"
+    end
+
+    def failure_message_for_should_not
+      "expected Either.failure, got #{@either.inspect}"
+    end
+
+    def description
+      "be defined"
+    end
+  end
+
+end