Struct Kernel 

pub struct Kernel { /* private fields */ }

A booted application: its router, database, queue and maintenance commands.

Implementations

impl Kernel

pub async fn call( &self, name: &str, args: impl IntoIterator<Item = impl Into<String>>, ) -> Result

Runs the app command name (see App::command), e.g. from a test.

pub async fn run_scheduled(&self, name: &str) -> Result

Runs the scheduled task name now, with its hooks (what schedule:run does). In a test, TestApp::run_scheduled does the same at the time TestApp::travel moved the clock to.

pub fn router(&self) -> Router

The assembled router, e.g. to drive with tower::ServiceExt::oneshot.

pub fn routes(&self) -> &[RouteInfo]

Every route, sorted by path, as route:list prints them.

pub fn state(&self) -> &AppState

What handlers get as State<AppState>.

pub fn db(&self) -> &Db

The database connection pool.

pub fn mailer(&self) -> &Mailer

The mailer; with MAIL_MAILER=memory, mailer().sent() lists what was sent.

pub fn worker(&self, queues: Vec<String>) -> Worker

A worker for the given queues (all queues when empty).

pub async fn run_jobs(&self) -> Result<usize>

Runs every job that is available now, e.g. in tests; returns how many ran.

pub async fn serve(self) -> Result

Serves HTTP with queue workers and the scheduler in the same process, until Ctrl-C or SIGTERM; then lets running jobs finish.

pub async fn migrate(&self) -> Result<Vec<String>>

Runs pending migrations; returns their names.

pub async fn rollback(&self, batches: u32) -> Result<Vec<String>>

Undoes the last batches batches of migrations; returns their names.

pub async fn fresh(&self) -> Result<Vec<String>>

Drops every table and runs all migrations.

pub async fn migration_status(&self) -> Result<Vec<MigrationStatus>>

Every migration and whether it has run, as migrate:status prints them.

pub async fn seed(&self) -> Result

Runs every seeder in registration order.