Add iter_from and iter_after. Documentation.

Author: Hexagon

examples/iter_demo.rs

@@ -0,0 +1,18 @@
+use chrono::Local;
+use croner::Cron;
+
+fn main() {
+    // Parse cron expression
+    let cron: Cron = "* * * * * *".parse().expect("Couldn't parse cron string");
+
+    // Compare to time now
+    let time = Local::now();
+
+    // Get next 5 matches using iter_from
+    // There is also iter_after, which does not match starting time
+    println!("Finding matches of pattern '{}' starting from {}:", cron.pattern.to_string(), time);
+
+    for time in cron.clone().iter_from(time).take(5) {
+        println!("{}", time);
+    }
+}

examples/pattern_demo.rs

@@ -10,7 +10,7 @@ fn main() {
     let matches_all = cron_all.is_time_matching(&time).unwrap();
 
     // Get next match
-    let next = cron_all.find_next_occurrence(&time).unwrap();
+    let next = cron_all.find_next_occurrence(&time, false).unwrap();
 
     // Output results
     println!("Time is: {}", time);

examples/scheduler_demo.rs

@@ -11,7 +11,7 @@ fn main() {
 
     // Find the next occurrence in EST
     let time_est = Local::now().with_timezone(&est_timezone);
-    let next_est = cron.find_next_occurrence(&time_est).unwrap();
+    let next_est = cron.find_next_occurrence(&time_est, false).unwrap();
 
     // Output results for EST
     println!("EST time is: {}", time_est);

examples/simple_demo.rs

@@ -15,7 +15,7 @@ pub const NTH_ALL: u8 = NTH_1ST_BIT | NTH_2ND_BIT | NTH_3RD_BIT | NTH_4TH_BIT |
 // Used for last day of month
 pub const LAST_BIT: u8 = 1 << 6;
 
-#[derive(Debug, Default)]
+#[derive(Debug, Default, Clone)]
 pub struct CronComponent {
     bitfields: Vec<u8>,   // Vector of u8 to act as multiple bitfields
     pub min: u8,          // Minimum value this component can take