Module documentation for 0.7.0
Cron data structure and Attoparsec parser for Haskell. The idea is to embed it in larger systems which want to roll their own scheduled tasks in a format that people are used to.
System.Cron is where all the interesting datatypes live. You will also find
scheduleMatches, which you can use to compare a time against a
to see if an action needs to be performed. System.Cron.Parser is where you will
find the parsers
cronTab. To parse
individual schedules up to full crontab files. System.Cron.Describe is where
you will find the
describe function for creating human-readable strings from
cron schedules, as well as any options to control how the description is created.
To do anything, you’ll need to install cabal-dev with cabal.
To build, run:
To run tests, run:
If you have inotify-tools, run this to run tests continuously.
To generate docs:
Cron offers a scheduling monad which can be found in
System.Cron.Schedule. This monad transform allows you to declare a set of jobs (of the type
IO ()) that will be executed at intervals defined by cron strings.
main :: IO () main = do ... tids <- execSchedule $ do addJob job1 "* * * * *" addJob job2 "0 * * * *" print tids ... job1 :: IO () job1 = putStrLn "Job 1" job2 :: IO () job2 = putStrLn "Job 2"
main :: IO () main = do let Right cs1 = parseCronSchedule "*/2 * 3 * 4,5,6" print $ describe defaultOpts cs1 let Right cs2 = parseCronSchedule "*/2 12 3 * 4,5,6" print $ describe (twentyFourHourFormat <> verbose) cs2