{-# LANGUAGE OverloadedStrings #-} -------------------------------------------------------------------------------- -- See end of this file for licence information. -------------------------------------------------------------------------------- -- | -- Module : TurtleTest -- Copyright : (c) 2013 Douglas Burke -- License : GPL V2 -- -- Maintainer : Douglas Burke -- Stability : experimental -- Portability : OverloadedStrings -- -- This Module contains test cases for the module -- "Swish.RDF.Parser.Turtle" and "Swish.RDF.Formatter.Turtle" based -- on the examples given in -- . -- -------------------------------------------------------------------------------- module Main where import qualified Data.Set as S import qualified Data.Text as T import qualified Data.Text.Lazy as L import qualified Test.Framework as TF import qualified Test.Framework.Providers.HUnit as TF import Data.Char (chr) import Data.Maybe (fromMaybe) import Network.URI (URI, parseURIReference) import Swish.RDF.Graph ( RDFGraph , RDFLabel (..) , RDFTriple , ToRDFLabel -- , getArcs , toRDFGraph , toRDFTriple ) import Swish.RDF.Formatter.Turtle (formatGraphAsText) import Swish.RDF.Parser.Turtle (parseTurtle) import Swish.RDF.Vocabulary.DublinCore (dcelemtitle) import Swish.RDF.Vocabulary.FOAF (foafgivenName, foafknows, foafmbox, foafname, foafPerson) import Swish.RDF.Vocabulary.RDF (rdfType, rdfFirst, rdfRest, rdfNil, rdfsLabel) import Swish.RDF.Vocabulary.XSD (xsdDecimal, xsdDouble, xsdString) import Test.HUnit (Assertion, (@=?), assertFailure) triple :: (ToRDFLabel s, ToRDFLabel p, ToRDFLabel o) => s -> p -> o -> RDFTriple triple = toRDFTriple toURI :: String -> URI toURI s = fromMaybe (error ("Internal error: invalid uri=" ++ s)) (parseURIReference s) toGraph :: T.Text -> Either String RDFGraph toGraph = flip parseTurtle Nothing . L.fromStrict parseFail :: String -- ^ error from parse -> T.Text -- ^ original Turtle graph -> Assertion parseFail emsg gr = assertFailure $ concat ["Unable to parse:\n", emsg, "\n*** Turtle=\n", T.unpack gr] -- | Compare a Turtle format graph with its expected -- contents. There is also a 'round trip' check, that -- the contents, written out in Turtle format, then -- read back in, match the original contents (this -- only uses the list of triples, not the input Turtle -- version). -- -- It is quicker to just check the statements when we -- know that the graph can not contain a blank node -- - i.e. compare getArcs gr to S.fromList o - but -- stick with graph equality checks, for now. compareExample :: String -- ^ label -> T.Text -- ^ Turtle representation -> [RDFTriple] -- ^ Corresponding triples -> TF.Test compareExample l t o = let expectedGraph = toRDFGraph oset egr = toGraph t oset = S.fromList o lbl = "example: " ++ l compareTriples = case egr of Left e -> parseFail e t Right gr -> expectedGraph @=? gr compareRoundTrip = let ttl = formatGraphAsText expectedGraph tgr = toGraph ttl in case tgr of Left e -> parseFail e ttl Right gr -> expectedGraph @=? gr in TF.testGroup lbl [ TF.testCase "base case" compareTriples , TF.testCase "round-trip example" compareRoundTrip ] -- | Check that both graphs (in Turtle format) are -- the same, once parsed. -- compareGraphs :: String -> T.Text -> T.Text -> TF.Test compareGraphs l t1 t2 = let ans = case (toGraph t1, toGraph t2) of (Left e1, _) -> parseFail e1 t1 -- "graph 1 of " ++ l (_, Left e2) -> parseFail e2 t2 -- "graph 2 of " ++ l (Right gr1, Right gr2) -> gr1 @=? gr2 in TF.testCase ("example: " ++ l) ans -- | Check that the list of triples creates the output -- graph. It is intended for very-small graphs. -- checkFormat :: String -> [RDFTriple] -> T.Text -> TF.Test checkFormat lbl ts egr = let gr = toRDFGraph $ S.fromList ts ogr = formatGraphAsText gr in TF.testCase ("format: " ++ lbl) $ egr @=? ogr -- ********************************************* -- Examples from Turtle specification -- ********************************************* -- would be nice to read these in from external files -- | From . example1 :: T.Text example1 = T.unlines [ "@base ." , "@prefix rdf: ." , "@prefix rdfs: ." , "@prefix foaf: ." , "@prefix rel: ." , "" , "<#green-goblin>" , " rel:enemyOf <#spiderman> ;" , " a foaf:Person ; # in the context of the Marvel universe" , " foaf:name \"Green Goblin\" ." , "" , "<#spiderman>" , " rel:enemyOf <#green-goblin> ;" , " a foaf:Person ;" , " foaf:name \"Spiderman\", \"Человек-паук\"@ru ." ] result1 :: [RDFTriple] result1 = let greengoblin = toURI "http://example.org/#green-goblin" spiderman = toURI "http://example.org/#spiderman" enemyOf = toURI "http://www.perceive.net/schemas/relationship/enemyOf" ruName = LangLit "Человек-паук" "ru" in [ triple greengoblin enemyOf spiderman , triple greengoblin rdfType foafPerson , triple greengoblin foafname ("Green Goblin"::String) , triple spiderman enemyOf greengoblin , triple spiderman rdfType foafPerson , triple spiderman foafname ("Spiderman"::String) , triple spiderman foafname ruName ] -- | From . -- -- Unfortunately we do not support IRIs at this time. example2_4 :: T.Text example2_4 = T.unlines [ "# A triple with all absolute IRIs" , " ." , "" , "@base ." , " . # relative IRIs, e.g. http://one.example/subject2" , "" , "@prefix p: ." , "p:subject3 p:predicate3 p:object3 . # prefixed name, e.g. http://two.example/subject3" , "" , "@prefix p: . # prefix p: now stands for http://one.example/path/" , "p:subject4 p:predicate4 p:object4 . # prefixed name, e.g. http://one.example/path/subject4" , "" , "@prefix : . # empty prefix" , ":subject5 :predicate5 :object5 . # prefixed name, e.g. http://another.example/subject5" , "" , ":subject6 a :subject7 . # same as :subject6 :subject7 ." , "" , "# a :subject8 . # a multi-script subject IRI ." ] result2_4 :: [RDFTriple] result2_4 = let s1 = toURI "http://one.example/subject1" p1 = toURI "http://one.example/predicate1" o1 = toURI "http://one.example/object1" s2 = toURI "http://one.example/subject2" p2 = toURI "http://one.example/predicate2" o2 = toURI "http://one.example/object2" s3 = toURI "http://two.example/subject3" p3 = toURI "http://two.example/predicate3" o3 = toURI "http://two.example/object3" s4 = toURI "http://one.example/path/subject4" p4 = toURI "http://one.example/path/predicate4" o4 = toURI "http://one.example/path/object4" s5 = toURI "http://another.example/subject5" p5 = toURI "http://another.example/predicate5" o5 = toURI "http://another.example/object5" s6 = toURI "http://another.example/subject6" s7 = toURI "http://another.example/subject7" -- Replace once we support IRIs -- utf8 = toURI "http://伝言.example/?user=أكرم&channel=R%26D" -- s8 = toURI "http://another.example/subject8" in [ triple s1 p1 o1 , triple s2 p2 o2 , triple s3 p3 o3 , triple s4 p4 o4 , triple s5 p5 o5 , triple s6 rdfType s7 -- , triple utf8 rdfType s8 ] -- | From . -- -- *NOTE*: at present we do not match the document since untyped strings are -- *not* mapped to xsd:string. -- example2_5_1 :: T.Text example2_5_1 = T.unlines [ "@prefix rdfs: ." , "@prefix show: ." , "@prefix xsd: ." -- added to example , "" , "show:218 rdfs:label \"That Seventies Show\"^^xsd:string . # literal with XML Schema string datatype" , "show:218 rdfs:label \"That Seventies Show\"^^ . # same as above" , "show:218 rdfs:label \"That Seventies Show\" . # same again" , "show:218 show:localName \"That Seventies Show\"@en . # literal with a language tag" , "show:218 show:localName 'Cette Série des Années Soixante-dix'@fr . # literal delimited by single quote" , "show:218 show:localName \"Cette Série des Années Septante\"@fr-be . # literal with a region subtag" , "show:218 show:blurb '''This is a multi-line # literal with embedded new lines and quotes" , "literal with many quotes (\"\"\"\"\")" , "and up to two sequential apostrophes ('').''' ." ] result2_5_1 :: [RDFTriple] result2_5_1 = let show218 = toURI "http://example.org/vocab/show/218" localName = toURI "http://example.org/vocab/show/localName" blurb = toURI "http://example.org/vocab/show/blurb" -- Should be TypedLit v xsdString; once this happens then nameLit -- is not needed name = "That Seventies Show" nameLit = Lit name blurbLit = Lit "This is a multi-line # literal with embedded new lines and quotes\nliteral with many quotes (\"\"\"\"\")\nand up to two sequential apostrophes ('')." in [ triple show218 rdfsLabel (TypedLit name xsdString) , triple show218 rdfsLabel nameLit , triple show218 localName (LangLit name "en") , triple show218 localName (LangLit "Cette Série des Années Soixante-dix" "fr") , triple show218 localName (LangLit "Cette Série des Années Septante" "fr-be") , triple show218 blurb blurbLit ] -- | From . example2_5_2 :: T.Text example2_5_2 = T.unlines [ "@prefix : ." , " " , " :atomicNumber 2 ; # xsd:integer " , " :atomicMass 4.002602 ; # xsd:decimal " , " :specificGravity 1.663E-4 . # xsd:double" ] result2_5_2 :: [RDFTriple] result2_5_2 = let helium = toURI "http://en.wikipedia.org/wiki/Helium" aNum = toURI "http://example.org/elementsatomicNumber" aMass = toURI "http://example.org/elementsatomicMass" sGrav = toURI "http://example.org/elementsspecificGravity" in [ triple helium aNum (2::Int) , triple helium aMass (TypedLit "4.002602" xsdDecimal) -- , triple helium sGrav (1.663e-4::Double) , triple helium sGrav (TypedLit "1.663E-4" xsdDouble) ] -- | From . example2_5_3 :: T.Text example2_5_3 = T.unlines [ "@prefix : ." , "" , " :isLandlocked false . # xsd:boolean" ] result2_5_3 :: [RDFTriple] result2_5_3 = [ triple (toURI "http://somecountry.example/census2007") (toURI "http://example.org/statsisLandlocked") False ] -- | From . example2_6 :: T.Text example2_6 = T.unlines [ "@prefix foaf: ." , "" , "_:alice foaf:knows _:bob ." , "_:bob foaf:knows _:alice . " ] result2_6 :: [RDFTriple] result2_6 = let alice = Blank "one" bob = Blank "two" in [ triple alice foafknows bob , triple bob foafknows alice ] {- If you write out result2_6 you get @prefix foaf: . [ foaf:knows [ foaf:knows [] ] ] . which is :_a foaf:knows :_b :_b foaf:knows :_c which is obviously wrong -} -- | From . example2_7_a :: T.Text example2_7_a = T.unlines [ "@prefix foaf: ." , "" , "# Someone knows someone else, who has the name \"Bob\"." , "[] foaf:knows [ foaf:name \"Bob\" ] ." ] result2_7_a :: [RDFTriple] result2_7_a = let someone = Blank "p" bob = Blank "23" in [ triple someone foafknows bob , triple bob foafname (Lit "Bob") -- TODO: change to TypedLit ] {- ### Failure in: 0:6:1:"example: 2.7 a" expected: Graph, formulae: arcs: (_:23,foaf:name,"Bob") (_:p,foaf:knows,_:23) but got: Graph, formulae: arcs: (_:1,foaf:name,"Bob") (_:2,foaf:knows,_:3) Writing out as N3 and Turtle give different results, but not convinced round-tripping is sensible here, since reading back in the N3 version generates the invalid results above. % ./dist/build/Swish/Swish -i=delme2.ttl -n3 -o Swish 0.9.0.4 @prefix : <#> . @prefix foaf: . [ foaf:knows [ foaf:name "Bob" ] ] . % ./dist/build/Swish/Swish -i=delme2.ttl -ttl -o Swish 0.9.0.4 @prefix : <#> . @prefix foaf: . [] foaf:knows [ foaf:name "Bob" ] . Need to look at this to see what the difference is. -} -- | From . example2_7_b1 :: T.Text example2_7_b1 = T.unlines [ "@prefix foaf: ." , "" , "[ foaf:name \"Alice\" ] foaf:knows [" , " foaf:name \"Bob\" ;" , " foaf:knows [" , " foaf:name \"Eve\" ] ;" , " foaf:mbox ] ." ] -- | From . example2_7_b2 :: T.Text example2_7_b2 = T.unlines [ "_:a \"Alice\" ." , "_:a _:b ." , "_:b \"Bob\" ." , "_:b _:c ." , "_:c \"Eve\" ." , "_:b ." ] -- | From . example2_8 :: T.Text example2_8 = T.unlines [ "@prefix : ." , "# the object of this triple is the RDF collection blank node" , ":subject :predicate ( :a :b :c ) ." , "" , "# an empty collection value - rdf:nil" , ":subject :predicate2 () ." ] result2_8 :: [RDFTriple] result2_8 = let s = toURI "http://example.org/foosubject" p = toURI "http://example.org/foopredicate" p2 = toURI "http://example.org/foopredicate2" a = toURI "http://example.org/fooa" b = toURI "http://example.org/foob" c = toURI "http://example.org/fooc" l1 = Blank "l1" l2 = Blank "l2" l3 = Blank "l3" in [ triple s p l1 , triple l1 rdfFirst a , triple l1 rdfRest l2 , triple l2 rdfFirst b , triple l2 rdfRest l3 , triple l3 rdfFirst c , triple l3 rdfRest rdfNil , triple s p2 rdfNil ] -- | From . example3_a :: T.Text example3_a = T.unlines [ "@prefix rdf: ." , "@prefix dc: ." , "@prefix ex: ." , "" , "" , " dc:title \"RDF/XML Syntax Specification (Revised)\" ;" , " ex:editor [" , " ex:fullname \"Dave Beckett\";" , " ex:homePage " , " ] ." ] result3_a :: [RDFTriple] result3_a = let g = toURI "http://www.w3.org/TR/rdf-syntax-grammar" exEditor = toURI "http://example.org/stuff/1.0/editor" exFullName = toURI "http://example.org/stuff/1.0/fullname" exHomePage = toURI "http://example.org/stuff/1.0/homePage" bn = Blank "foo" -- "$123_" in [ triple g dcelemtitle (Lit "RDF/XML Syntax Specification (Revised)") , triple g exEditor bn , triple bn exFullName (Lit "Dave Beckett") , triple bn exHomePage (toURI "http://purl.org/net/dajobe/") ] -- | From . example3_b1 :: T.Text example3_b1 = T.unlines [ "@prefix : ." , ":a :b ( \"apple\" \"banana\" ) ." ] example3_b2 :: T.Text example3_b2 = T.unlines [ "@prefix : ." , "@prefix rdf: ." , ":a :b" , " [ rdf:first \"apple\";" , " rdf:rest [ rdf:first \"banana\";" , " rdf:rest rdf:nil ]" , " ] . " ] -- | From . example3_c1 :: T.Text example3_c1 = T.unlines [ "@prefix : ." , "" , ":a :b \"The first line\\nThe second line\\n more\" ." ] example3_c2 :: T.Text example3_c2 = T.unlines [ "@prefix : ." , "" -- line feeds using U+000A , ":a :b \"\"\"The first line" , "The second line" , " more\"\"\" ." ] -- | From . example3_d1 :: T.Text example3_d1 = T.unlines [ "@prefix : ." , "(1 2.0 3E1) :p \"w\" ." ] example3_d2 :: T.Text example3_d2 = T.unlines [ "@prefix rdf: ." , "@prefix : ." , "_:b0 rdf:first 1 ;" , " rdf:rest _:b1 ." , "_:b1 rdf:first 2.0 ;" , " rdf:rest _:b2 ." , "_:b2 rdf:first 3E1 ;" , " rdf:rest rdf:nil ." , "_:b0 :p \"w\" . " ] {- I do not see how this representation is valid, and rapper version 2.0.9 does not parse it (well, it reports the triples and then fails) so I am skipping this test. Am I mis-reading the test? See the discussion at http://lists.w3.org/Archives/Public/public-rdf-comments/2013May/0043.html which suggests that this is indeed invalid. -- | From . -- example3_e1 :: T.Text example3_e1 = T.unlines [ "@prefix : ." , "(1 [:p :q] ( 2 ) ) ." ] example3_e2 :: T.Text example3_e2 = T.unlines [ "@prefix rdf: ." , "@prefix : ." , " _:b0 rdf:first 1 ;" , " rdf:rest _:b1 ." , " _:b1 rdf:first _:b2 ." , " _:b2 :p :q ." , " _:b1 rdf:rest _:b3 ." , " _:b3 rdf:first _:b4 ." , " _:b4 rdf:first 2 ;" , " rdf:rest rdf:nil ." , " _:b3 rdf:rest rdf:nil ." ] -} -- | From . example7_4 :: T.Text example7_4 = T.unlines [ "@prefix ericFoaf: ." , "@prefix : ." , "ericFoaf:ericP :givenName \"Eric\" ;" , " :knows ," , " [ :mbox ] ," , " ." ] result7_4 :: [RDFTriple] result7_4 = let ericP = toURI "http://www.w3.org/People/Eric/ericP-foaf.rdf#ericP" db = toURI "http://norman.walsh.name/knows/who/dan-brickley" timbl = toURI "mailto:timbl@w3.org" amyvdh = toURI "http://getopenid.com/amyvdh" timbn = Blank "node" in [ triple ericP foafgivenName (Lit "Eric") , triple ericP foafknows db , triple ericP foafknows timbn , triple ericP foafknows amyvdh , triple timbn foafmbox timbl ] -- ********************************************* -- Set up test suites -- ********************************************* initialTestSuite :: TF.Test initialTestSuite = TF.testGroup "initial" [ compareExample "1" example1 result1 , compareExample "2.4" example2_4 result2_4 , compareExample "2.5.1" example2_5_1 result2_5_1 , compareExample "2.5.2" example2_5_2 result2_5_2 , compareExample "2.5.3" example2_5_3 result2_5_3 , compareExample "2.6" example2_6 result2_6 , compareExample "2.7 a" example2_7_a result2_7_a , compareGraphs "2.7 b" example2_7_b1 example2_7_b2 , compareExample "2.8" example2_8 result2_8 , compareExample "3 a" example3_a result3_a , compareGraphs "3 b" example3_b1 example3_b2 , compareGraphs "3 c" example3_c1 example3_c2 , compareGraphs "3 d" example3_d1 example3_d2 -- , compareGraphs "3 e" example3_e1 example3_e2 -- at present _e1 does not parse , compareExample "7.4" example7_4 result7_4 ] -- Cases to try and improve the test coverage urnA, urnB :: URI urnA = toURI "urn:a" urnB = toURI "urn:b" trips :: T.Text -> [RDFTriple] trips t = [triple urnA urnB (Lit t)] coverageCases :: TF.Test coverageCases = TF.testGroup "coverage" [ -- This was actually more a problem with output rather than input. compareExample "cov1" " \"' -D RT @madeupname: \\\"Foo \\u0024 Zone\\\" \\U0000007e:\\\"\\\"\\\"D\" ." (trips "' -D RT @madeupname: \"Foo $ Zone\" ~:\"\"\"D") , compareExample "cov2" " \"\"\"\"Bob \\\"\\uF481\"\"\"." (trips (T.snoc "\"Bob \"" (chr 0xf481))) {- rapper will parse this but I do not think it matches the Turtle grammar , compareExample "cov2-option" " \"\"\"\"Bob \"\\U0001F481\"\"\"" (trips "\"Bob \"\\U0001F481") -} , compareExample "cov3-1" " \"\"\"\\\"A quoted string.\\\"\"\"\"." (trips "\"A quoted string.\"") , compareExample "cov3-2" " \"\"\"\\\"\\\"A quoted string.\\\"\"\"\"." (trips "\"\"A quoted string.\"") , compareExample "cov3-3" " \"\"\"\\\"A quoted string.\\\"\\\"\"\"\"." (trips "\"A quoted string.\"\"") , compareExample "cov4" " \"3\\\\8\\\\11\" ." (trips "3\\8\\11") , checkFormat "\\f" (trips "A\ffB") "@prefix : .\n \"A\\u000CfB\" .\n" ] -- Extracted from failures seen when using the W3C test suite -- at . lt1T :: T.Text lt1T = " \"\"\"A long string. \"\"\"@en-UK ." lt1A :: [RDFTriple] lt1A = [ triple (toURI "urn:a") (toURI "urn:b") (LangLit "A long string. " "en-UK") ] le1T :: T.Text le1T = "@prefix : . :c\\~d." le1A :: [RDFTriple] le1A = [ triple (toURI "urn:a") (toURI "urn:b:") (toURI "urn:example/c~d") ] w3cCases :: TF.Test w3cCases = TF.testGroup "w3c" [ compareExample "lang-tag1" lt1T lt1A , compareExample "localEscapes" le1T le1A ] -- allTests :: [TF.Test] allTests = [ initialTestSuite , coverageCases , w3cCases ] main :: IO () main = TF.defaultMain allTests -------------------------------------------------------------------------------- -- -- Copyright (c) 2013 Douglas Burke -- All rights reserved. -- -- This file is part of Swish. -- -- Swish is free software; you can redistribute it and/or modify -- it under the terms of the GNU General Public License as published by -- the Free Software Foundation; either version 2 of the License, or -- (at your option) any later version. -- -- Swish is distributed in the hope that it will be useful, -- but WITHOUT ANY WARRANTY; without even the implied warranty of -- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the -- GNU General Public License for more details. -- -- You should have received a copy of the GNU General Public License -- along with Swish; if not, write to: -- The Free Software Foundation, Inc., -- 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA -- --------------------------------------------------------------------------------