1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48
// Licensed under the Apache License, Version 2.0 <LICENSE-APACHE or
// http://www.apache.org/licenses/LICENSE-2.0> or the MIT license
// <LICENSE-MIT or http://opensource.org/licenses/MIT>, at your
// option. This file may not be copied, modified, or distributed
// except according to those terms.
#![warn(missing_docs)]
// XXX(rust-1.66)
#![allow(clippy::uninlined_format_args)]
//! A small library to dispatch job files to relevant handlers.
//!
//! This library implements the core logic of a `Director` which dispatches jobs described in JSON
//! files to a relevant `Handler` and then archives the job based on whether it was accepted or
//! rejected.
//!
//! # Job files
//!
//! Job files are files ending in a `.json` extension in JSON format. Two keys are required:
//!
//! - `kind`: this string value is used to determine which handler will be used to handle the
//! job.
//! - `data`: this value is passed to the handler.
//!
//! Other keys may be used (e.g., a `timestamp` to indicate when the job was created).
//!
//! Job files are treated as read-only by the director.
mod director;
mod handler;
mod handlers;
pub mod utils;
mod watcher;
mod try_fold;
pub use director::Director;
pub use director::DirectorError;
pub use director::Outbox;
pub use director::RunResult;
pub use handler::Handler;
pub use handler::HandlerCore;
pub use handler::JobError;
pub use handler::JobResult;
pub use handlers::DirectorWatchdog;
#[cfg(test)]
mod test;