Struct TaskConfig 

pub struct TaskConfig {
    pub task_name: String,
    pub priority: i32,
    pub pool: String,
    pub retry_policy: RetryPolicy,
    pub rate_limit_policy: RateLimitPolicy,
    pub idempotency_mode: Option<IdempotencyMode>,
    pub updated_at: DateTime<Utc>,
}

Per-task config persisted for admin UI and enqueue defaults.

Seeded from task macro attributes on first enqueue; admins can later upsert via QueueBackend::upsert_task_config or the axum /tasks/{name}/config route. On enqueue, Boson merges descriptor defaults with any stored config to set Job priority, pool, and policies.

Getting started: define tasks.

Example — macro attrs become the initial config

use boson::task;

#[task(
    name = "notify",
    priority = 10,
    pool = "alerts",
    max_attempts = 5,
    max_in_flight = 20
)]
async fn notify(ctx: Box<dyn boson::ExecutionContext>, message: String) -> boson_core::Result<()> {
    let _ = (ctx, message);
    Ok(())
}
// First Notify::send_with(...) persists a TaskConfig shaped like those attributes.

Fields

task_name: String

Task name (unique key).

priority: i32

Override priority (lower = higher priority).

pool: String

Override pool name.

retry_policy: RetryPolicy

Retry policy override.

rate_limit_policy: RateLimitPolicy

Enqueue rate limits (optional).

idempotency_mode: Option<IdempotencyMode>

Per-task idempotency override (None = inherit runtime / builder default).

updated_at: DateTime<Utc>

When created/updated.

Implementations

impl TaskConfig

pub fn default_for(task_name: &str) -> Self

Create default config for a task name.

Examples

use boson_core::TaskConfig;

let config = TaskConfig::default_for("notify");
assert_eq!(config.task_name, "notify");
assert_eq!(config.pool, "global");
assert_eq!(config.priority, 1);

pub fn resolved_idempotency_mode( &self, runtime_default: IdempotencyMode, ) -> IdempotencyMode

Resolve effective idempotency mode (task override, else runtime_default).

pub fn from_policy_defaults( task_name: &str, priority: i32, pool: impl Into<String>, retry_policy: RetryPolicy, rate_limit_policy: RateLimitPolicy, idempotency_mode: Option<IdempotencyMode>, ) -> Self

Build config from explicit policy defaults (typically from a task descriptor).

pub const fn with_runtime_idempotency_fallback( self, runtime_default: IdempotencyMode, ) -> Self

Fill idempotency_mode from the runtime default when unset.

Trait Implementations

impl Clone for TaskConfig

fn clone(&self) -> TaskConfig

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for TaskConfig

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for TaskConfig

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for TaskConfig

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.