+{-# LANGUAGE DeriveGeneric #-}
{-# LANGUAGE DeriveDataTypeable #-}
{-# LANGUAGE FlexibleInstances #-}
{-# LANGUAGE GADTs #-}
{-# LANGUAGE QuasiQuotes #-}
{-# LANGUAGE RecordWildCards #-}
-{-# LANGUAGE StandaloneDeriving #-}
{-# LANGUAGE TemplateHaskell #-}
{-# LANGUAGE TypeFamilies #-}
-- time_stamp.
--
module TSN.XML.Injuries (
+ dtd,
pickle_message,
-- * Tests
injuries_tests,
where
-- System imports.
-import Control.Monad ( forM_ )
import Data.Data ( Data )
import Data.Time ( UTCTime )
import Data.Typeable ( Typeable )
-import Database.Groundhog ( insert_, migrate )
+import qualified Data.Vector.HFixed as H ( HVector, cons, convert )
+import Database.Groundhog (
+ countAll,
+ deleteAll,
+ migrate )
import Database.Groundhog.Core ( DefaultKey )
+import Database.Groundhog.Generic ( runDbConn, runMigrationSilent )
import Database.Groundhog.TH (
groundhog,
mkPersist )
+import qualified GHC.Generics as GHC ( Generic )
+import Database.Groundhog.Sqlite ( withSqliteConn )
import Data.Tuple.Curry ( uncurryN )
import Test.Tasty ( TestTree, testGroup )
import Test.Tasty.HUnit ( (@?=), testCase )
import TSN.Codegen ( tsn_codegen_config )
import TSN.DbImport ( DbImport(..), ImportResult(..), run_dbmigrate )
import TSN.Picklers ( xp_time_stamp )
-import TSN.XmlImport ( XmlImport(..) )
-import Xml ( FromXml(..), FromXmlFk(..), pickle_unpickle, unpickleable )
+import TSN.XmlImport ( XmlImport(..), XmlImportFk(..) )
+import Xml (
+ Child(..),
+ FromXml(..),
+ FromXmlFk(..),
+ ToDb(..),
+ pickle_unpickle,
+ unpickleable,
+ unsafe_unpickle )
+
+
+
+-- | The DTD to which this module corresponds. Used to invoke dbimport.
+--
+dtd :: String
+dtd = "injuriesxml.dtd"
+
+--
+-- DB/XML Data types
+--
+
+-- * InjuriesTeam
-- | XML/Database representation of a team as they appear in the
-- injuries documents.
deriving (Data, Eq, Show, Typeable)
--- | XML/Database representation of the injury listings.
+-- * InjuriesListing/InjuriesListingXml
+
+-- | XML representation of the injury listings. The leading
+-- underscores prevent unused field warnings.
--
data InjuriesListingXml =
InjuriesListingXml {
- xml_team :: InjuriesTeam,
- xml_teamno :: Maybe Int,
- xml_injuries :: String,
- xml_updated :: Maybe Bool }
- deriving (Eq, Show)
+ _xml_team :: InjuriesTeam,
+ _xml_teamno :: Maybe String, -- ^ Can contain non-numerics, e.g. \"ZR2\"
+ _xml_injuries :: String,
+ _xml_updated :: Maybe Bool }
+ deriving (Eq, GHC.Generic, Show)
+
+
+-- | For 'H.convert'.
+--
+instance H.HVector InjuriesListingXml
+
-- | Database representation of a 'InjuriesListing'. It possesses a
--- foreign key to an 'Injuries' object so that we can easily delete
--- 'InjuriesListing's based on the parent message's time_stamp.
+-- foreign key to an 'Injuries' object so that we can easily delete
+-- 'InjuriesListing's based on the parent message's time_stamp.
+-- The leading underscores prevent unused field warnings.
--
data InjuriesListing =
InjuriesListing {
- db_injuries_id :: DefaultKey Injuries,
- db_team :: InjuriesTeam,
- db_teamno :: Maybe Int,
- db_injuries :: String,
- db_updated :: Maybe Bool }
-
+ _db_injuries_id :: DefaultKey Injuries,
+ _db_team :: InjuriesTeam,
+ _db_teamno :: Maybe String, -- ^ Can contain non-numerics, e.g. \"ZR2\"
+ _db_injuries :: String,
+ _db_updated :: Maybe Bool }
+ deriving ( GHC.Generic )
+
+-- | For 'H.cons'.
+--
+instance H.HVector InjuriesListing
-instance FromXmlFk InjuriesListingXml where
+instance ToDb InjuriesListingXml where
-- | The DB analogue of a 'InjuriesListingXml' is a 'InjuriesListing'
- type DbFk InjuriesListingXml = InjuriesListing
+ type Db InjuriesListingXml = InjuriesListing
+instance Child InjuriesListingXml where
-- | Our foreign key points to an 'Injuries'.
type Parent InjuriesListingXml = Injuries
+instance FromXmlFk InjuriesListingXml where
-- | To convert between a 'InjuriesListingXml' and a
-- 'InjuriesListing', we simply append the foreign key.
- from_xml_fk InjuriesListingXml{..} fk =
- InjuriesListing {
- db_injuries_id = fk,
- db_team = xml_team,
- db_teamno = xml_teamno,
- db_injuries = xml_injuries,
- db_updated = xml_updated }
+ from_xml_fk = H.cons
+-- | This allows us to insert the XML representation
+-- 'InjuriesListingXml' directly.
+--
+instance XmlImportFk InjuriesListingXml
+
+
+-- * Injuries/Message
-- | XML representation of an injuriesxml \<message\>.
--
xml_sport :: String,
xml_listings :: [InjuriesListingXml],
xml_time_stamp :: UTCTime }
- deriving (Eq, Show)
+ deriving (Eq, GHC.Generic, Show)
--- | Database representation of a 'Message'. We really only care about
--- the time stamp.
+
+-- | For 'H.HVector'.
+--
+instance H.HVector Message
+
+
+-- | Database representation of a 'Message'.
--
data Injuries =
Injuries {
+ db_xml_file_id :: Int,
db_sport :: String,
db_time_stamp :: UTCTime }
-instance FromXml Message where
+instance ToDb Message where
-- | The database analogue of a 'Message' is an 'Injuries'.
type Db Message = Injuries
+instance FromXml Message where
-- | To convert from XML to DB, we simply drop the fields we don't
-- care about.
--
from_xml Message{..} =
Injuries {
+ db_xml_file_id = xml_xml_file_id,
db_sport = xml_sport,
db_time_stamp = xml_time_stamp }
+-- | This allows us to insert the XML representation 'Message'
+-- directly.
+--
instance XmlImport Message
+--
+-- Database code
+--
+
instance DbImport Message where
dbmigrate _ =
run_dbmigrate $ do
migrate (undefined :: Injuries)
migrate (undefined :: InjuriesListing)
- -- | We import a 'Message' by inserting all of its 'listings'.
+ -- | We import a 'Message' by inserting all of its 'listings', but
+ -- the listings require a foreign key to the parent 'Message'.
--
dbimport msg = do
msg_id <- insert_xml msg
- forM_ (xml_listings msg) $ \listing ->
- -- Convert the XML listing to a DB one using the message id and
- -- insert it (disregarding the result).
- insert_ $ from_xml_fk listing msg_id
+ -- Convert each XML listing to a DB one using the message id and
+ -- insert it (disregarding the result).
+ mapM_ (insert_xml_fk_ msg_id) (xml_listings msg)
return ImportSucceeded
mkPersist tsn_codegen_config [groundhog|
- entity: Injuries
+ constructors:
+ - name: Injuries
+ uniques:
+ - name: unique_injuries
+ type: constraint
+ # Prevent multiple imports of the same message.
+ fields: [db_xml_file_id]
- entity: InjuriesListing
dbName: injuries_listings
constructors:
- name: InjuriesListing
fields:
- - name: db_team
+ - name: _db_team
embeddedType:
- {name: team_name, dbName: team_name}
- {name: team_league, dbName: team_league}
- - name: db_injuries_id
+ - name: _db_injuries_id
reference:
onDelete: cascade
|]
+--
+-- XML Picklers
+--
+
+
-- | A pickler for 'InjuriesTeam's that can convert them to/from XML.
--
pickle_injuries_team :: PU InjuriesTeam
pickle_injuries_team =
xpElem "team" $
- xpWrap (from_tuple, to_tuple) $
+ xpWrap (from_tuple, to_tuple') $
xpPair xpText (xpAttrImplied "league" xpText)
where
from_tuple = uncurryN InjuriesTeam
- to_tuple m = (db_team_name m, db_team_league m)
+ -- Pointless, but silences two unused field warnings.
+ to_tuple' InjuriesTeam{..} = (db_team_name, db_team_league)
--- | A pickler for 'InjuriesListingXml's that can convert them to/from XML.
+-- | A pickler for 'InjuriesListingXml's that can convert them to/from
+-- XML.
--
pickle_listing :: PU InjuriesListingXml
pickle_listing =
xpElem "listing" $
- xpWrap (from_tuple, to_tuple) $
+ xpWrap (from_tuple, H.convert) $
xp4Tuple pickle_injuries_team
- (xpOption $ xpElem "teamno" xpInt)
+ (xpOption $ xpElem "teamno" xpText)
(xpElem "injuries" xpText)
(xpOption $ xpElem "updated" xpPrim)
where
from_tuple = uncurryN InjuriesListingXml
- to_tuple l = (xml_team l, xml_teamno l, xml_injuries l, xml_updated l)
+
-- | A pickler for 'Message's that can convert them to/from XML.
pickle_message :: PU Message
pickle_message =
xpElem "message" $
- xpWrap (from_tuple, to_tuple) $
+ xpWrap (from_tuple, H.convert) $
xp6Tuple (xpElem "XML_File_ID" xpInt)
(xpElem "heading" xpText)
(xpElem "category" xpText)
(xpElem "time_stamp" xp_time_stamp)
where
from_tuple = uncurryN Message
- to_tuple m = (xml_xml_file_id m,
- xml_heading m,
- xml_category m,
- xml_sport m,
- xml_listings m,
- xml_time_stamp m)
--
injuries_tests =
testGroup
"Injuries tests"
- [ test_pickle_of_unpickle_is_identity,
+ [ test_on_delete_cascade,
+ test_pickle_of_unpickle_is_identity,
test_unpickle_succeeds ]
test_unpickle_succeeds :: TestTree
test_unpickle_succeeds =
testCase "unpickling succeeds" $ do
- let path = "test/xml/injuriesxml.xml"
- actual <- unpickleable path pickle_message
- let expected = True
- actual @?= expected
+ let path = "test/xml/injuriesxml.xml"
+ actual <- unpickleable path pickle_message
+ let expected = True
+ actual @?= expected
+
+
+-- | Make sure everything gets deleted when we delete the top-level
+-- record.
+--
+test_on_delete_cascade :: TestTree
+test_on_delete_cascade =
+ testCase "deleting an injuries deletes its children" $ do
+ let path = "test/xml/injuriesxml.xml"
+ inj <- unsafe_unpickle path pickle_message
+ let a = undefined :: Injuries
+ let b = undefined :: InjuriesListing
+ actual <- withSqliteConn ":memory:" $ runDbConn $ do
+ runMigrationSilent $ do
+ migrate a
+ migrate b
+ _ <- dbimport inj
+ deleteAll a
+ count_a <- countAll a
+ count_b <- countAll b
+ return $ count_a + count_b
+ let expected = 0
+ actual @?= expected