Attribute code samples. Mention in README whether there are additional examples of use available in crates repos or not.

README.md

@@ -2,7 +2,10 @@
 
 Testing different job scheduling and job parsing crates.
 
-## apalis
+## Apalis
+
+In addition to the below, a lot of other `apalis` examples can be found at
+<https://github.com/geofmureithi/apalis/tree/main/examples>.
 
 ### PostgreSQL
 
@@ -34,6 +37,10 @@ Run sample program.
 cargo run --release --bin using-crate-clokwerk
 ```
 
+The `clokwerk` repo contains only this single example
+in its readme and does *not* contain any other
+direct examples of use at the time of writing this.
+
 ## Cron
 
 Run sample program.
@@ -42,14 +49,22 @@ Run sample program.
 cargo run --release --bin using-crate-cron
 ```
 
-## Cron\_job
+The `cron` repo contains only this single example
+in its readme and does *not* contain any other
+direct examples of use at the time of writing this.
+
+## Cron-job
 
 Run sample program.
 
 ```zsh
-cargo run --release --bin using-crate-cron_job
+cargo run --release --bin using-crate-cron-job
 ```
 
+The `cron-job` repo contains a couple of other
+direct examples of use in the readme, but nothing
+beyond that at the time of writing this.
+
 ## Cron\_tab
 
 Run sample programs.
@@ -62,6 +77,12 @@ cargo run --release --bin using-crate-cron_tab-sync
 cargo run --release --bin using-crate-cron_tab-async
 ```
 
+The `cron_tab` repo contains only these two examples
+in its readme, and a copy of the two same sample programs
+at <https://github.com/tuyentv96/rust-crontab/tree/master/examples>,
+and does *not* contain any other direct examples of use
+at the time of writing this.
+
 ## Croner
 
 Run sample program.
@@ -70,6 +91,8 @@ Run sample program.
 cargo run --release --bin using-crate-croner
 ```
 
+Additional examples at <https://github.com/Hexagon/croner-rust/tree/main/examples>.
+
 ## Delay\_timer
 
 Run sample programs.
@@ -82,6 +105,8 @@ cargo run --release --bin using-crate-delay_timer-internal
 cargo run --release --bin using-crate-delay_timer-in-async-context
 ```
 
+Additional examples at: <https://github.com/BinChengZhao/delay-timer/tree/master/examples>
+
 ## English-to-cron
 
 Run sample program.
@@ -90,6 +115,12 @@ Run sample program.
 cargo run --release --bin using-crate-english-to-cron
 ```
 
+The `english-to-cron` repo contains only this example
+in its readme, and a copy of the same sample program
+at <https://github.com/kaplanelad/english-to-cron/tree/main/examples>,
+and does *not* contain any other direct examples of use
+at the time of writing this.
+
 ## Tokio-cron-scheduler
 
 Run sample programs.
@@ -105,3 +136,8 @@ cargo run --release --bin using-crate-tokio-cron-scheduler-simple_job
 ```zsh
 cargo run --release --bin using-crate-tokio-cron-scheduler-postgres_job
 ```
+
+One additional example at <https://github.com/mvniekerk/tokio-cron-scheduler/tree/main/examples>
+although that one (`nats_job.rs`) is not buildable for me I assume, as enabling the
+nats related features did not work for me. Enabling nats features in `Cargo.toml`
+for me makes Rust unable to build anything.

src/apalis_email_service.rs

@@ -1,3 +1,5 @@
+//! Code from <https://github.com/geofmureithi/apalis/blob/060a7d260cc66714afe9ddc20012a569b00103a2/examples/email-service/src/lib.rs>
+
 use std::{str::FromStr, sync::Arc};
 
 use apalis::prelude::*;

src/bin/using-crate-apalis-postgres.rs

@@ -1,3 +1,5 @@
+//! Code from <https://github.com/geofmureithi/apalis/blob/060a7d260cc66714afe9ddc20012a569b00103a2/examples/postgres/src/main.rs>
+
 use anyhow::Result;
 use apalis::layers::retry::RetryPolicy;
 use apalis::prelude::*;

src/bin/using-crate-apalis-sqlite.rs

@@ -1,3 +1,7 @@
+//! Code from:
+//! - <https://github.com/geofmureithi/apalis/blob/060a7d260cc66714afe9ddc20012a569b00103a2/examples/sqlite/src/job.rs>
+//! - <https://github.com/geofmureithi/apalis/blob/060a7d260cc66714afe9ddc20012a569b00103a2/examples/sqlite/src/main.rs>
+
 use anyhow::Result;
 use apalis::prelude::*;
 use apalis_sql::sqlite::SqliteStorage;

src/bin/using-crate-clokwerk.rs

@@ -1,3 +1,5 @@
+//! Code from <https://github.com/mdsherry/clokwerk/blob/f8180dfe64a98d39a5cded998998a3df8809b92c/README.md>
+
 // Scheduler, and trait for .seconds(), .minutes(), etc.
 use clokwerk::{Job, Scheduler, TimeUnits};
 // Import week days and WeekDay

src/bin/using-crate-cron-job.rs

@@ -1,3 +1,5 @@
+//! Based on code from <https://github.com/nambrosini/cron-job/blob/e51067cb2395994cb8643204152a1e7dfc161aa5/README.md>
+
 use cron_job::{CronJob, Job};
 
 fn main() {
@@ -12,7 +14,7 @@ fn main() {
     // Say hello every second
     cron.new_job("* * * * * *", hello_job);
     // Start jobs
-    cron.start().expect("Failed start jobs.");
+    cron.start().expect("Failed to start jobs");
 }
 // The function to be executed every second.
 fn run_every_second() {

src/bin/using-crate-cron.rs

@@ -1,3 +1,5 @@
+//! Code from <https://github.com/zslayton/cron/blob/956beaf3cfe32091dc7a0b371340b59ae5e1a860/README.md>
+
 use chrono::Utc;
 use cron::Schedule;
 use std::str::FromStr;

src/bin/using-crate-cron_tab-async.rs

@@ -1,3 +1,5 @@
+//! Based on code from <https://github.com/tuyentv96/rust-crontab/blob/01a266e8e1c7f6ee86b3d1010b8818ffc4db6518/README.md>
+
 use std::sync::Arc;
 
 use chrono::{FixedOffset, Local, TimeZone};

src/bin/using-crate-cron_tab-sync.rs

@@ -1,3 +1,5 @@
+//! Based on code from <https://github.com/tuyentv96/rust-crontab/blob/01a266e8e1c7f6ee86b3d1010b8818ffc4db6518/README.md>
+
 use chrono::{FixedOffset, Local, TimeZone};
 use cron_tab;
 

src/bin/using-crate-croner.rs

@@ -1,18 +1,22 @@
-use chrono::Utc;
+//! Code from <https://github.com/Hexagon/croner-rust/blob/4da136d3363ff7d99f9bdb211f7c8c852449de6d/README.md>
+
+use chrono::Local;
 use croner::Cron;
 
 fn main() {
-    // Parse a cron expression to find the next occurrence at 00:00 on Friday
+    // Parse cron expression for Fridays in December
-    let cron = Cron::new("0 0 * * FRI")
+    let cron = Cron::new("0 0 0 31 12 FRI")
+        // Include seconds in pattern
+        .with_seconds_optional()
+        // Ensure both day of month and day of week conditions are met
+        .with_dom_and_dow()
         .parse()
-        .expect("Successful parsing");
+        .expect("Couldn't parse cron string");
 
-    // Get the next occurrence from the current time, excluding the current time
+    let time = Local::now();
-    let next = cron.find_next_occurrence(&Utc::now(), false).unwrap();
 
-    println!(
+    println!("Finding the next 5 New Year's Eves on a Friday:");
-        "Pattern \"{}\" will match next at {}",
+    for time in cron.iter_from(time).take(5) {
-        cron.pattern.to_string(),
+        println!("{}", time);
-        next
+    }
-    );
 }

src/bin/using-crate-delay_timer-in-async-context.rs

@@ -1,3 +1,5 @@
+//! Based on code from <https://github.com/BinChengZhao/delay-timer/blob/560c92f9b12c56a6729bc46cdaab52c9557a84e7/README.md>
+
 use delay_timer::prelude::*;
 
 use anyhow::Result;
@@ -42,7 +44,7 @@ fn build_task_async_print() -> Result<Task, TaskError> {
 
     task_builder
         .set_task_id(1)
-        .set_frequency_repeated_by_seconds(6)
+        .set_frequency_repeated_by_cron_str("@secondly")
         .set_maximum_parallel_runnable_num(2)
         .spawn_async_routine(body)
 }

src/bin/using-crate-delay_timer-internal.rs

@@ -1,10 +1,12 @@
+//! Code from <https://github.com/BinChengZhao/delay-timer/blob/560c92f9b12c56a6729bc46cdaab52c9557a84e7/README.md>
+
 use anyhow::Result;
 use delay_timer::prelude::*;
 use smol::Timer;
 use std::time::Duration;
 
 fn main() -> Result<()> {
-    // Build an DelayTimer that uses the default configuration of the `smol` runtime internally.
+    // Build an DelayTimer that uses the default configuration of the Smol runtime internally.
     let delay_timer = DelayTimerBuilder::default().build();
 
     // Develop a print job that runs in an asynchronous cycle.
@@ -39,7 +41,7 @@ fn build_task_async_print() -> Result<Task, TaskError> {
 
     task_builder
         .set_task_id(1)
-        .set_frequency_repeated_by_seconds(1)
+        .set_frequency_repeated_by_cron_str("@secondly")
         .set_maximum_parallel_runnable_num(2)
         .spawn_async_routine(body)
 }

src/bin/using-crate-english-to-cron.rs

@@ -1,3 +1,5 @@
+//! Code from <https://github.com/kaplanelad/english-to-cron/blob/90fe66631e51e9ad7fb631cd55434b7ab8f990f7/examples/run.rs>
+
 fn main() {
     let texts = vec![
         "every 15 seconds",

src/bin/using-crate-tokio-cron-scheduler-postgres_job.rs

@@ -1,3 +1,5 @@
+//! Code based on <https://github.com/mvniekerk/tokio-cron-scheduler/blob/6c568541022317cc07905ffd25305f0e6e2cfc74/examples/postgres_job.rs>
+
 use jobs::tcs_helpers::{run_example, stop_example};
 use tokio_cron_scheduler::{
     JobScheduler, PostgresMetadataStore, PostgresNotificationStore, SimpleJobCode,

src/bin/using-crate-tokio-cron-scheduler-simple_job.rs

@@ -1,3 +1,5 @@
+//! Code based on <https://github.com/mvniekerk/tokio-cron-scheduler/blob/6c568541022317cc07905ffd25305f0e6e2cfc74/examples/simple_job.rs>
+
 use jobs::tcs_helpers::{run_example, stop_example};
 use tokio_cron_scheduler::JobScheduler;
 use tracing::Level;

src/bin/using-crate-tokio-cron-scheduler-simple_job_tokio_in_a_thread.rs

@@ -1,3 +1,5 @@
+//! Code based on <https://github.com/mvniekerk/tokio-cron-scheduler/blob/6c568541022317cc07905ffd25305f0e6e2cfc74/examples/simple_job_tokio_in_a_thread.rs>
+
 use jobs::tcs_helpers::{run_example, stop_example};
 use std::error::Error;
 use tokio_cron_scheduler::JobScheduler;

src/tcs_helpers.rs

@@ -1,3 +1,5 @@
+//! Code from <https://github.com/mvniekerk/tokio-cron-scheduler/blob/6c568541022317cc07905ffd25305f0e6e2cfc74/examples/lib.rs>
+
 use chrono::Utc;
 use std::time::Duration;
 use tokio_cron_scheduler::{Job, JobBuilder, JobScheduler, JobSchedulerError};