#agent #state #tokio #abstraction #around #thread #task

tokio-agent

Agents are a simple abstraction around state, inspired by Elixir's Agent

1 unstable release

0.1.0 May 19, 2022

#1355 in Asynchronous

MIT license

26KB
281 lines

"Agents are a simple abstraction around state."

This crate is inspired by Elixir's Agent.

In Rust however, an Agent holds your State in either a tokio task, or a thread, and allows you to interact with that state, while having the state remain within the task or thread.

An agent managing state in a thread for examplue could be used to manage and interact with a resource which would cause blocking on the tokio runtime (for example, sqlite database).

An agent managing state in a task could be used to manage and interact with a resource in a lock-free way.


lib.rs:

"Agents are a simple abstraction around state."

This crate is inspired by Elixir's Agent.

In Rust however, an Agent holds your State in either a tokio task, or a thread, and allows you to interact with that state, while having the state remain within the task or thread.

An agent managing state in a thread for examplue could be used to manage and interact with a resource which would cause blocking on the tokio runtime (for example, sqlite database).

An agent managing state in a task could be used to manage and interact with a resource in a lock-free way.

Dependencies

~2–3MB
~46K SLoC