cron_clock 0.8.0

#![deny(rust_2018_idioms)]
#![allow(clippy::derive_hash_xor_eq)]
#![allow(broken_intra_doc_links)]

//! A cron expression parser and schedule explorer.
//!
//! In addition to the regular expressions, you can also use the following shortcut expressions with Schedule::from_str,
//! such as `@yearly` `@monthly` `@weekly` `@daily` `@hourly` `@minutely` `@secondly`,
//! make cron- Expression Iterator.
//!
//!
//! ## Tips  
//! If you need a periodicized task manager, you may need [`delay-timer`](https://github.com/BinChengZhao/delay-timer)
//! (Time-manager of delayed tasks. Like crontab, but synchronous [`asynchronous`] tasks are possible, and dynamic add/cancel/remove is supported) .
//!
//!
//! # Example
//! ```
//!   use cron_clock::Schedule;
//!   use chrono::Utc;
//!   use std::str::FromStr;
//!
//!   //               sec  min   hour   day of month   month   day of week   year
//!   let expression = "0   30   9,12,15     1,15       May-Aug  Mon,Wed,Fri  2018/2";
//!   let schedule = Schedule::from_str(expression).unwrap();
//!   println!("Upcoming fire times:");
//!   for datetime in schedule.upcoming(Utc).take(10) {
//!     println!("-> {}", datetime);
//!   }
//!
//! /*
//! Upcoming fire times:
//! -> 2018-06-01 09:30:00 UTC
//! -> 2018-06-01 12:30:00 UTC
//! -> 2018-06-01 15:30:00 UTC
//! -> 2018-06-15 09:30:00 UTC
//! -> 2018-06-15 12:30:00 UTC
//! -> 2018-06-15 15:30:00 UTC
//! -> 2018-08-01 09:30:00 UTC
//! -> 2018-08-01 12:30:00 UTC
//! -> 2018-08-01 15:30:00 UTC
//! -> 2018-08-15 09:30:00 UTC
//! */
//! ```
//!
//! # Example `shortcut expressions` & `ScheduleIteratorOwned`
//!
//! ```
//! extern crate chrono;
//! extern crate cron_clock;
//!
//! use cron_clock::Schedule;
//! use chrono::Utc;
//! use std::str::FromStr;
//!
//! fn main() {
//!   // shortcut expressions
//!   let expression = "@hourly";
//!   let schedule = Schedule::from_str(expression).unwrap();
//!   println!("Upcoming fire times:");
//!   // `upcoming_owned` Get iterators with ownership, so you don't have lifetime to worry about.
//!   for datetime in schedule.upcoming_owned(Utc).take(10) {
//!     println!("-> {}", datetime);
//!   }
//! }
//!
//! ```

pub mod error;

pub(crate) mod schedule;
pub(crate) mod time_unit;

mod ordinal;
mod parsing;
mod queries;
mod specifier;

pub use chrono::offset::TimeZone;
pub use chrono::{FixedOffset, Local, Utc};
pub use schedule::{Schedule, ScheduleIterator, ScheduleIteratorOwned};
pub use time_unit::TimeUnitSpec;