-- feed.
--
module TSN.Picklers (
+ pickler_tests,
+ xp_ambiguous_time,
xp_date,
xp_date_padded,
+ xp_datetime,
xp_earnings,
xp_gamedate,
- xp_racedate,
xp_tba_time,
xp_time,
+ xp_time_dots,
xp_time_stamp )
where
import Data.String.Utils ( replace )
import Data.Time.Clock ( NominalDiffTime, UTCTime, addUTCTime )
import Data.Time.Format ( formatTime, parseTime )
+import Data.Tree.NTree.TypeDefs ( NTree(..) )
import System.Locale ( defaultTimeLocale )
+import Test.Tasty ( TestTree, testGroup )
+import Test.Tasty.HUnit ( (@?=), testCase )
import Text.XML.HXT.Arrow.Pickle (
xpText,
xpWrap,
xpWrapMaybe )
import Text.XML.HXT.Arrow.Pickle.Xml ( PU )
+import Text.XML.HXT.Core (
+ XmlTree,
+ XNode( XTag, XText ),
+ mkName,
+ pickleDoc,
+ unpickleDoc )
-- Local imports.
import TSN.Parse (
-- | The format string for a base date in m/d/yyyy format. The
-- day/month are not padded at all. This will match for example,
--
--- * 2/15/1983
--- * 1/1/0000
+-- * 2\/15\/1983
+--
+-- * 1\/1\/0000
--
date_format :: String
date_format = "%-m/%-d/%Y"
-- day/month are padded to two characters with zeros. This will
-- match for example,
--
--- * 02/15/1983
--- * 01/01/0000
+-- * 02\/15\/1983
+--
+-- * 01\/01\/0000
--
date_format_padded :: String
date_format_padded = "%0m/%0d/%Y"
-- | Parse \<Earnings\> from an 'AutoRaceResultsListing'. These are
-- essentially 'Int's, but they look like,
--
--- * <Earnings>336,826</Earnings>
--- * <Earnings>1,000,191</Earnings>
--- * <Earnings>TBA</Earnings>
+-- * \<Earnings\>336,826\</Earnings\>
+--
+-- * \<Earnings\>1,000,191\</Earnings\>
+--
+-- * \<Earnings\>TBA\</Earnings\>
--
xp_earnings :: PU (Maybe Int)
xp_earnings =
to_earnings :: String -> Maybe Int
to_earnings s
| s == "TBA" = Nothing
- | otherwise = (read . strip_commas . show) s
+ | otherwise = Just $ (read . strip_commas) s
from_earnings :: Maybe Int -> String
from_earnings Nothing = "TBA"
from_earnings (Just i) = format_commas i
--- | (Un)pickle a 'UTCTime' from a \<RaceDate\> element in an
--- 'AutoRaceResults' message.
+-- | (Un)pickle an unpadded 'UTCTime'. Used for example on the
+-- \<RaceDate\> elements in an 'AutoRaceResults' message.
--
--- Example:
+-- Examples:
+--
+-- * \<RaceDate\>6/1/2014 1:00:00 PM\</RaceDate\>
--
--- <RaceDate>6/1/2014 1:00:00 PM</RaceDate>
--- <RaceDate>5/24/2014 2:45:00 PM</RaceDate>
+-- * \<RaceDate\>5/24/2014 2:45:00 PM\</RaceDate\>
--
-xp_racedate :: PU UTCTime
-xp_racedate =
- (to_racedate, from_racedate) `xpWrapMaybe` xpText
+xp_datetime :: PU UTCTime
+xp_datetime =
+ (to_datetime, from_datetime) `xpWrapMaybe` xpText
where
format = date_format ++ " " ++ "%-I:%M:%S %p"
- to_racedate :: String -> Maybe UTCTime
- to_racedate = parseTime defaultTimeLocale format
+ to_datetime :: String -> Maybe UTCTime
+ to_datetime = parseTime defaultTimeLocale format
- from_racedate :: UTCTime -> String
- from_racedate = formatTime defaultTimeLocale format
+ from_datetime :: UTCTime -> String
+ from_datetime = formatTime defaultTimeLocale format
-- | (Un)pickle a UTCTime from a weather forecast's gamedate. Example
from_time = formatTime defaultTimeLocale time_format
+-- | (Un)pickle a UTCTime without the date portion. This differs from
+-- 'xp_time' in that it uses periods in the AM/PM part, i.e. \"A.M.\"
+-- and \"P.M.\" It also doesn't use padding for the \"hours\" part.
+--
+-- Examples:
+--
+-- * \<CurrentTimeStamp\>11:30 A.M.\</CurrentTimeStamp\>
+--
+xp_time_dots :: PU UTCTime
+xp_time_dots =
+ (to_time, from_time) `xpWrapMaybe` xpText
+ where
+ -- | The hours arent padded with zeros.
+ nopad_time_format :: String
+ nopad_time_format = "%-I:%M %p"
+
+ to_time :: String -> Maybe UTCTime
+ to_time = (parseTime defaultTimeLocale nopad_time_format) . (replace "." "")
+
+ from_time :: UTCTime -> String
+ from_time t =
+ replace "AM" "A.M." (replace "PM" "P.M." s)
+ where
+ s = formatTime defaultTimeLocale nopad_time_format t
+
+
-- | (Un)pickle a UTCTime without the date portion, allowing for a
-- value of \"TBA\" (which gets translated to 'Nothing').
--
+-- /Examples/:
+--
+-- A failed parse will return 'Nothing':
+--
+-- >>> let tn = text_node "YO"
+-- >>> unpickleDoc xp_tba_time tn
+-- Just Nothing
+--
+-- And so will parsing a \"TBA\":
+--
+-- >>> let tn = text_node "TBA"
+-- >>> unpickleDoc xp_tba_time tn
+-- Just Nothing
+--
+-- But re-pickling 'Nothing' gives only \"TBA\":
+--
+-- >>> pickleDoc xp_tba_time Nothing
+-- NTree (XTag "/" []) [NTree (XText "TBA") []]
+--
+-- A normal time is also parsed successfully, of course:
+--
+-- >>> let tn = text_node "08:10 PM"
+-- >>> unpickleDoc xp_tba_time tn
+-- Just (Just 1970-01-01 20:10:00 UTC)
+--
xp_tba_time :: PU (Maybe UTCTime)
xp_tba_time =
(to_time, from_time) `xpWrap` xpText
| otherwise = parseTime defaultTimeLocale time_format s
from_time :: Maybe UTCTime -> String
- from_time Nothing = ""
+ from_time Nothing = "TBA"
from_time (Just t) = formatTime defaultTimeLocale time_format t
-- | (Un)pickle the \<time_stamp\> element format to/from a 'UTCTime'.
+-- The time_stamp elements look something like,
--
--- Example: \<time_stamp\> January 6, 2014, at 10:11 PM ET \</time_stamp\>
+-- \<time_stamp\> January 6, 2014, at 10:11 PM ET \</time_stamp\>
--
-- TSN doesn't provide a proper time zone name, so we assume that
-- it's always Eastern Standard Time. EST is UTC-5, so we
-- add/subtract 5 hours to convert to/from UTC.
--
+-- Examples:
+--
+-- >>> let tn = text_node " January 6, 2014, at 10:11 PM ET "
+-- >>> unpickleDoc xp_time_stamp tn
+-- Just 2014-01-07 03:11:00 UTC
+--
xp_time_stamp :: PU UTCTime
xp_time_stamp =
(parse_time_stamp, from_time_stamp) `xpWrapMaybe` xpText
from_time_stamp :: UTCTime -> String
from_time_stamp =
formatTime defaultTimeLocale time_stamp_format . subtract_five
+
+
+-- | (Un)pickle an ambiguous 12-hour AM/PM time, which is ambiguous
+-- because it's missing the AM/PM part.
+--
+-- Examples:
+--
+-- >>> let tn = text_node "8:00"
+-- >>> unpickleDoc xp_ambiguous_time tn
+-- Just 1970-01-01 08:00:00 UTC
+--
+xp_ambiguous_time :: PU UTCTime
+xp_ambiguous_time =
+ (to_time, from_time) `xpWrapMaybe` xpText
+ where
+ ambiguous_time_format :: String
+ ambiguous_time_format = "%-I:%M"
+
+ to_time :: String -> Maybe UTCTime
+ to_time = parseTime defaultTimeLocale ambiguous_time_format
+
+ from_time :: UTCTime -> String
+ from_time =
+ formatTime defaultTimeLocale ambiguous_time_format
+
+
+-- | Create an 'XmlTree' containing only the given text. This is
+-- useful for testing (un)picklers, where we don't want to have to
+-- bother to create a dummy XML document.
+--
+-- Examples:
+--
+-- >>> text_node "8:00"
+-- NTree (XText "8:00") []
+--
+text_node :: String -> XmlTree
+text_node s = NTree (XText s) []
+
+
+
+--
+-- * Tasty Tests
+--
+
+-- | A list of all tests for this module. This primary exists to
+-- eliminate the unused import/export warnings for 'unpickleDoc' and
+-- 'text_node' which are otherwise only used in the doctests.
+--
+pickler_tests :: TestTree
+pickler_tests =
+ testGroup
+ "Pickler tests"
+ [ test_pickle_of_unpickle_is_identity ]
+
+
+-- | If we unpickle something and then pickle it, we should wind up
+-- with the same thing we started with (plus an additional root
+-- element).
+--
+test_pickle_of_unpickle_is_identity :: TestTree
+test_pickle_of_unpickle_is_identity =
+ testCase "pickle composed with unpickle is (almost) the identity" $ do
+ let tn = text_node "8:00"
+ let (Just utctime) = unpickleDoc xp_ambiguous_time tn
+ let actual = pickleDoc xp_ambiguous_time utctime
+ let expected = NTree (XTag (mkName "/") []) [tn]
+ actual @?= expected