reql

Struct Command

Source 
pub struct Command { /* private fields */ }
Expand description

The query that will be sent to RethinkDB

Implementations§

Source§

impl<'a> Command

Source

pub fn changes<T>(self, arg: T) -> Self
where T: Arg,

Source

pub fn table_create<T>(self, arg: T) -> Self
where T: Arg,

Create a table

A RethinkDB table is a collection of JSON documents.

§Example

Create a table named “dc_universe” with the default settings.

r.db("heroes").table_create("dc_universe").run(conn)
   {
       "config_changes": [
           {
               "new_val": {
                   "db": "test",
                   "durability":  "hard",
                   "id": "20ea60d4-3b76-4817-8828-98a236df0297",
                   "name": "dc_universe",
                   "primary_key": "id",
                   "shards": [
                       {
                           "primary_replica": "rethinkdb_srv1",
                           "replicas": [
                               "rethinkdb_srv1",
                               "rethinkdb_srv2"
                           ]
                       }
                   ],
                   "write_acks": "majority"
               },
               "old_val": None
           }
       ],
       "tables_created": 1
   }
       ```
Source

pub fn table_drop<T>(self, arg: T) -> Self
where T: Arg,

Source

pub fn table_list(self) -> Self

Source

pub fn table<T>(self, arg: T) -> Self
where T: Arg,

Source

pub fn index_create<T>(self, arg: T) -> Self
where T: Arg,

Source

pub fn index_drop<T>(self, arg: T) -> Self
where T: Arg,

Source

pub fn index_list(self) -> Self

Source

pub fn index_rename<T>(self, arg: T) -> Self
where T: Arg,

Source

pub fn index_status<T>(self, arg: T) -> Self
where T: Arg,

Source

pub fn index_wait<T>(self, arg: T) -> Self
where T: Arg,

Source

pub fn set_write_hook<T>(self, arg: T) -> Self
where T: Arg,

Source

pub fn get_write_hook(self) -> Self

Source

pub fn insert<T>(self, arg: T) -> Self
where T: Arg,

Source

pub fn update<T>(self, arg: T) -> Self
where T: Arg,

Source

pub fn replace<T>(self, arg: T) -> Self
where T: Arg,

Source

pub fn delete<T>(self, arg: T) -> Self
where T: Arg,

Source

pub fn sync(self) -> Self

Source

pub fn get<T>(self, arg: T) -> Self
where T: Arg,

Source

pub fn get_all<T>(self, arg: T) -> Self
where T: Arg,

Source

pub fn between<T>(self, arg: T) -> Self
where T: Arg<'a>,

Source

pub fn filter<T>(self, arg: T) -> Self
where T: Arg,

Source

pub fn inner_join<T>(self, arg: T) -> Self
where T: Arg,

Source

pub fn outer_join<T>(self, arg: T) -> Self
where T: Arg,

Source

pub fn eq_join<T>(self, arg: T) -> Self
where T: Arg,

Source

pub fn zip(self) -> Self

Source

pub fn map<T>(self, arg: T) -> Self
where T: Arg,

Source

pub fn with_fields<T>(self, arg: T) -> Self
where T: Arg,

Source

pub fn concat_map<T>(self, arg: T) -> Self
where T: Arg,

Source

pub fn order_by<T>(self, arg: T) -> Self
where T: Arg,

Orders the result based on the given column.

Argument can either be a string, r.asc("column") for ascending or r.desc("column") for descending. If the given argument is a string, the direction will default to ascending.

§Example

Sort the result in descending order based on the created_at column.

r.db("database").table("users").order_by(r.desc("created_at")).run(conn)
Source

pub fn skip<T>(self, arg: T) -> Self
where T: Arg,

Source

pub fn limit<T>(self, arg: T) -> Self
where T: Arg,

Limits the result set to the given amount.

Argument can be an isize.

§Example

Get 5 records.

r.db("database").table("users").limit(5).run(conn)
Source

pub fn slice<T>(self, arg: T) -> Self
where T: Arg,

Source

pub fn nth<T>(self, arg: T) -> Self
where T: Arg,

Source

pub fn offsets_of<T>(self, arg: T) -> Self
where T: Arg,

Source

pub fn is_empty(self) -> Self

Source

pub fn union<T>(self, arg: T) -> Self
where T: Arg,

Source

pub fn sample<T>(self, arg: T) -> Self
where T: Arg,

Source

pub fn group<T>(self, arg: T) -> Self
where T: Arg,

Source

pub fn ungroup(self) -> Self

Source

pub fn reduce<T>(self, arg: T) -> Self
where T: Arg,

Source

pub fn fold<T>(self, arg: T) -> Self
where T: Arg,

Source

pub fn count<T>(self, arg: T) -> Self
where T: Arg,

Source

pub fn sum<T>(self, arg: T) -> Self
where T: Arg,

Source

pub fn avg<T>(self, arg: T) -> Self
where T: Arg,

Source

pub fn min<T>(self, arg: T) -> Self
where T: Arg,

Source

pub fn max<T>(self, arg: T) -> Self
where T: Arg,

Source

pub fn distinct<T>(self, arg: T) -> Self
where T: Arg,

Source

pub fn contains<T>(self, arg: T) -> Self
where T: Arg,

Source

pub fn pluck<T>(self, arg: T) -> Self
where T: Arg,

Source

pub fn without<T>(self, arg: T) -> Self
where T: Arg,

Source

pub fn merge<T>(self, arg: T) -> Self
where T: Arg,

Source

pub fn append<T>(self, arg: T) -> Self
where T: Arg,

Source

pub fn prepend<T>(self, arg: T) -> Self
where T: Arg,

Source

pub fn difference<T>(self, arg: T) -> Self
where T: Arg,

Source

pub fn set_insert<T>(self, arg: T) -> Self
where T: Arg,

Source

pub fn set_union<T>(self, arg: T) -> Self
where T: Arg,

Source

pub fn set_intersection<T>(self, arg: T) -> Self
where T: Arg,

Source

pub fn set_difference<T>(self, arg: T) -> Self
where T: Arg,

Source

pub fn bracket<T>(self, arg: T) -> Self
where T: Arg,

Source

pub fn get_field<T>(self, arg: T) -> Self
where T: Arg,

Source

pub fn has_fields<T>(self, arg: T) -> Self
where T: Arg,

Source

pub fn insert_at<T>(self, arg: T) -> Self
where T: Arg,

Source

pub fn splice_at<T>(self, arg: T) -> Self
where T: Arg,

Source

pub fn delete_at<T>(self, arg: T) -> Self
where T: Arg,

Source

pub fn change_at<T>(self, arg: T) -> Self
where T: Arg,

Source

pub fn keys(self) -> Self

Source

pub fn values(self) -> Self

Source

pub fn match_<T>(self, arg: T) -> Self
where T: Arg,

Source

pub fn split<T>(self, arg: T) -> Self
where T: Arg,

Source

pub fn upcase(self) -> Self

Source

pub fn downcase(self) -> Self

Source

pub fn and<T>(self, arg: T) -> Self
where T: Arg,

Source

pub fn or<T>(self, arg: T) -> Self
where T: Arg,

Source

pub fn eq<T>(self, arg: T) -> Self
where T: Arg,

Source

pub fn ne<T>(self, arg: T) -> Self
where T: Arg,

Source

pub fn gt<T>(self, arg: T) -> Self
where T: Arg,

Source

pub fn ge<T>(self, arg: T) -> Self
where T: Arg,

Source

pub fn lt<T>(self, arg: T) -> Self
where T: Arg,

Source

pub fn le<T>(self, arg: T) -> Self
where T: Arg,

Source

pub fn not<T>(self, arg: T) -> Self
where T: Arg,

Source

pub fn bit_and<T>(self, arg: T) -> Self
where T: Arg,

Source

pub fn bit_or<T>(self, arg: T) -> Self
where T: Arg,

Source

pub fn bit_xor<T>(self, arg: T) -> Self
where T: Arg,

Source

pub fn bit_not(self) -> Self

Source

pub fn bit_sal<T>(self, arg: T) -> Self
where T: Arg,

Source

pub fn bit_sar<T>(self, arg: T) -> Self
where T: Arg,

Source

pub fn round(self) -> Self

Source

pub fn ceil(self) -> Self

Source

pub fn floor(self) -> Self

Source

pub fn in_timezone<T>(self, arg: T) -> Self
where T: Arg,

Source

pub fn timezone(self) -> Self

Source

pub fn during<T>(self, arg: T) -> Self
where T: Arg,

Source

pub fn date(self) -> Self

Source

pub fn time_of_day(self) -> Self

Source

pub fn year(self) -> Self

Source

pub fn month(self) -> Self

Source

pub fn day(self) -> Self

Source

pub fn day_of_week(self) -> Self

Source

pub fn day_of_year(self) -> Self

Source

pub fn hours(self) -> Self

Source

pub fn minutes(self) -> Self

Source

pub fn seconds(self) -> Self

Source

pub fn to_iso8601(self) -> Self

Source

pub fn to_epoch_time(self) -> Self

Source

pub fn binary<T>(self, arg: T) -> Self
where T: Arg,

Source

pub fn do_<T>(self, arg: T) -> Self
where T: Arg,

Source

pub fn branch<T>(self, arg: T) -> Self
where T: Arg,

Source

pub fn for_each<T>(self, arg: T) -> Self
where T: Arg,

Source

pub fn default<T>(self, arg: T) -> Self
where T: Arg,

Source

pub fn coerce_to<T>(self, arg: T) -> Self
where T: Arg,

Source

pub fn type_of(self) -> Self

Source

pub fn info(self) -> Self

Source

pub fn to_json(self) -> Self

Source

pub fn distance<T>(self, arg: T) -> Self
where T: Arg,

Source

pub fn fill(self) -> Self

Source

pub fn to_geojson(self) -> Self

Source

pub fn get_intersecting<T>(self, arg: T) -> Self
where T: Arg,

Source

pub fn get_nearest<T>(self, arg: T) -> Self
where T: Arg,

Source

pub fn includes<T>(self, arg: T) -> Self
where T: Arg,

Source

pub fn intersects<T>(self, arg: T) -> Self
where T: Arg,

Source

pub fn polygon_sub<T>(self, arg: T) -> Self
where T: Arg,

Source

pub fn grant<T>(self, arg: T) -> Self
where T: Arg,

Source

pub fn config(self) -> Self

Source

pub fn rebalance(self) -> Self

Source

pub fn reconfigure<T>(self, arg: T) -> Self
where T: Arg,

Source

pub fn status(self) -> Self

Source

pub fn wait<T>(self, arg: T) -> Self
where T: Arg,

Source

pub fn run<A, T>(self, arg: A) -> impl Stream<Item = Result<T>>
where A: Arg, T: Unpin + DeserializeOwned,

Trait Implementations§

Source§

impl<T> Add<T> for Command
where T: Arg,

Source§

type Output = Command

The resulting type after applying the + operator.
Source§

fn add(self, arg: T) -> Self

Performs the + operation. Read more
Source§

impl<'a> Arg<'a> for Command

Source§

fn arg(self) -> Arg<Options<'a>>

Source§

impl Arg for Command

Source§

fn arg(self) -> Arg<()>

Source§

impl Arg for Command

Source§

fn arg(self) -> Arg<()>

Source§

impl Arg for Command

Source§

fn arg(self) -> Arg<()>

Source§

impl Arg for Command

Source§

fn arg(self) -> Arg<Options>

Source§

impl Arg for Command

Source§

fn arg(self) -> Arg<Options>

Source§

impl Arg for Command

Source§

fn arg(self) -> Arg<()>

Source§

impl Arg for Command

Source§

fn arg(self) -> Arg<()>

Source§

impl Arg for Command

Source§

fn arg(self) -> Arg<()>

Source§

impl Arg for Command

Source§

fn arg(self) -> Arg<()>

Source§

impl Arg for Command

Source§

fn arg(self) -> Arg<Options>

Source§

impl Arg for Command

Source§

fn arg(self) -> Arg<()>

Source§

impl Arg for Command

Source§

fn arg(self) -> Arg<()>

Source§

impl Arg for Command

Source§

fn arg(self) -> Arg<()>

Source§

impl Arg for Command

Source§

fn arg(self) -> Arg<()>

Source§

impl Arg for Command

Source§

fn arg(self) -> Arg<()>

Source§

impl Arg for Command

Source§

fn arg(self) -> Arg<()>

Source§

impl Arg for Command

Source§

fn arg(self) -> Arg<()>

Source§

impl Arg for Command

Source§

fn arg(self) -> Arg<()>

Source§

impl Arg for Command

Source§

fn arg(self) -> Arg<()>

Source§

impl Arg for Command

Source§

fn arg(self) -> Arg<()>

Source§

impl Arg for Command

Source§

fn arg(self) -> Arg<()>

Source§

impl Arg for Command

Source§

fn arg(self) -> Arg<()>

Source§

impl Arg for Command

Source§

fn arg(self) -> Arg<()>

Source§

impl Arg for Command

Source§

fn arg(self) -> Arg<()>

Source§

impl Arg for Command

Source§

fn arg(self) -> Arg<()>

Source§

impl Arg for Command

Source§

fn arg(self) -> Arg<()>

Source§

impl Arg for Command

Source§

fn arg(self) -> Arg<()>

Source§

impl Arg for Command

Source§

fn arg(self) -> Arg<()>

Source§

impl Arg for Command

Source§

fn arg(self) -> Arg<()>

Source§

impl Arg for Command

Source§

fn arg(self) -> Arg<()>

Source§

impl Arg for Command

Source§

fn arg(self) -> Arg<()>

Source§

impl Arg for Command

Source§

fn arg(self, parent: Option<Command>) -> Arg<()>

Source§

impl Arg for Command

Source§

fn arg(self) -> Arg<()>

Source§

impl Arg for Command

Source§

fn arg(self) -> Arg<()>

Source§

impl Arg for Command

Source§

fn arg(self) -> Arg<()>

Source§

impl Arg for Command

Source§

fn arg(self) -> Arg<()>

Source§

impl Arg for Command

Source§

fn arg(self) -> Arg<()>

Source§

impl Arg for Command

Source§

fn arg(self) -> Arg<Options>

Source§

impl Arg for Command

Source§

fn arg(self) -> Arg<()>

Source§

impl Arg for Command

Source§

fn arg(self) -> Arg<()>

Source§

impl Arg for Command

Source§

fn arg(self) -> Arg<()>

Source§

impl Arg for Command

Source§

fn arg(self) -> Arg<()>

Source§

impl Arg for Command

Source§

fn arg(self) -> Arg<()>

Source§

impl Arg for Command

Source§

fn arg(self) -> Arg<()>

Source§

impl Arg for Command

Source§

fn arg(self) -> Arg<()>

Source§

impl Arg for Command

Source§

fn arg(self) -> Arg<Options>

Source§

impl Arg for Command

Source§

fn arg(self) -> Arg<()>

Source§

impl Arg for Command

Source§

fn arg(self) -> Arg<()>

Source§

impl Arg for Command

Source§

fn arg(self) -> Arg<()>

Source§

impl Arg for Command

Source§

fn arg(self) -> Arg<()>

Source§

impl Arg for Command

Source§

fn arg(self) -> Arg<()>

Source§

impl Arg for Command

Source§

fn arg(self) -> Arg<()>

Source§

impl Arg for Command

Source§

fn arg(self) -> Arg<()>

Source§

impl Arg for Command

Source§

fn arg(self) -> Arg<()>

Source§

impl Arg for Command

Source§

fn arg(self) -> Arg<()>

Source§

impl Arg for Command

Source§

fn arg(self) -> Arg<()>

Source§

impl Arg for Command

Source§

fn arg(self) -> Arg<Options>

Source§

impl Arg for Command

Source§

fn arg(self) -> Arg<()>

Source§

impl Arg for Command

Source§

fn arg(self) -> Arg<()>

Source§

impl Arg for Command

Source§

fn arg(self) -> Arg<Options>

Source§

impl Arg for Command

Source§

fn arg(self) -> Arg<()>

Source§

impl Arg for Command

Source§

fn arg(self) -> Arg<()>

Source§

impl Arg for Command

Source§

fn arg(self) -> Arg<()>

Source§

impl Arg for Command

Source§

fn arg(self) -> Arg<()>

Source§

impl Arg for Command

Source§

fn arg(self) -> Arg<()>

Source§

impl Arg for Command

Source§

fn arg(self) -> Arg<()>

Source§

impl Arg for Command

Source§

fn arg(self) -> Arg<()>

Source§

impl Arg for Command

Source§

fn arg(self) -> Arg<()>

Source§

impl Arg for Command

Source§

fn arg(self) -> Arg<()>

Source§

impl Arg for Command

Source§

fn arg(self) -> Arg<()>

Source§

impl Arg for Command

Source§

fn arg(self) -> Arg<()>

Source§

impl Arg for Command

Source§

fn arg(self) -> Arg<()>

Source§

impl Arg for Command

Source§

fn arg(self) -> Arg<()>

Source§

impl Arg for Command

Source§

fn arg(self) -> Arg<()>

Source§

impl Arg for Command

Source§

fn arg(self) -> Arg<()>

Source§

impl Arg for Command

Source§

fn arg(self) -> Arg<()>

Source§

impl Arg for Command

Source§

fn arg(self) -> Arg<()>

Source§

impl Arg for Command

Source§

fn arg(self) -> Arg<()>

Source§

impl Arg for Command

Source§

fn arg(self) -> Arg<()>

Source§

impl Arg for Command

Source§

fn arg(self) -> Arg<()>

Source§

impl Arg for Command

Source§

fn arg(self) -> Arg<()>

Source§

impl Arg for Command

Source§

fn arg(self) -> Arg<()>

Source§

impl Arg for Command

Source§

fn arg(self) -> Arg<()>

Source§

impl Arg for Command

Source§

fn arg(self) -> Arg<()>

Source§

impl Arg for Command

Source§

fn arg(self) -> Arg<()>

Source§

impl Arg for Command

Source§

fn arg(self) -> Arg<()>

Source§

impl Arg for Command

Source§

fn arg(self) -> Arg<()>

Source§

impl Arg for Command

Source§

fn arg(self) -> Arg<()>

Source§

impl Arg for Command

Source§

fn arg(self) -> Arg<()>

Source§

impl Arg for Command

Source§

fn arg(self) -> Arg<()>

Source§

impl Arg for Command

Source§

fn arg(self) -> Arg<()>

Source§

impl Arg for Command

Source§

fn arg(self) -> Arg<()>

Source§

impl Arg for Command

Source§

fn arg(self) -> Arg<()>

Source§

impl Arg for Command

Source§

fn arg(self) -> Arg<()>

Source§

impl Arg for Command

Source§

fn arg(self) -> Arg<()>

Source§

impl Arg for Command

Source§

fn arg(self) -> Arg<()>

Source§

impl Arg for Command

Source§

fn arg(self) -> Arg<()>

Source§

impl Arg for Command

Source§

fn arg(self) -> Arg<Options>

Source§

impl Arg for Command

Source§

fn arg(self) -> Arg<()>

Source§

impl Arg for Command

Source§

fn arg(self) -> Arg<()>

Source§

impl Arg for Command

Source§

fn arg(self) -> Arg<()>

Source§

impl Arg for Command

Source§

fn arg(self) -> Arg<()>

Source§

impl Arg for Command

Source§

fn arg(self) -> Arg<()>

Source§

impl Arg for Command

Source§

fn arg(self) -> Arg<()>

Source§

impl Arg for Command

Source§

fn arg(self) -> Arg<()>

Source§

impl Arg for Command

Source§

fn arg(self) -> Arg<()>

Source§

impl Arg for Command

Source§

fn arg(self) -> Arg<()>

Source§

impl Arg for Command

Source§

fn arg(self) -> Arg<()>

Source§

impl Arg for Command

Source§

fn arg(self) -> Arg<()>

Source§

impl Arg for Command

Source§

fn arg(self) -> Arg<()>

Source§

impl<T> BitAnd<T> for Command
where T: Arg,

Source§

type Output = Command

The resulting type after applying the & operator.
Source§

fn bitand(self, arg: T) -> Self

Performs the & operation. Read more
Source§

impl<T> BitOr<T> for Command
where T: Arg,

Source§

type Output = Command

The resulting type after applying the | operator.
Source§

fn bitor(self, arg: T) -> Self

Performs the | operation. Read more
Source§

impl<T> BitXor<T> for Command
where T: Arg,

Source§

type Output = Command

The resulting type after applying the ^ operator.
Source§

fn bitxor(self, arg: T) -> Self

Performs the ^ operation. Read more
Source§

impl Clone for Command

Source§

fn clone(&self) -> Command

Returns a copy of the value. Read more
1.0.0 · Source§

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

Performs copy-assignment from source. Read more
Source§

impl Debug for Command

Source§

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

Formats the value using the given formatter. Read more
Source§

impl<T> Div<T> for Command
where T: Arg,

Source§

type Output = Command

The resulting type after applying the / operator.
Source§

fn div(self, arg: T) -> Self

Performs the / operation. Read more
Source§

impl<const N: usize> From<[Command; N]> for Command

Source§

fn from(arr: [Command; N]) -> Self

Converts to this type from the input type.
Source§

impl From<Result<Datum, Error>> for Command

Source§

fn from(result: Result<Datum>) -> Self

Converts to this type from the input type.
Source§

impl<T> Mul<T> for Command
where T: Arg,

Source§

type Output = Command

The resulting type after applying the * operator.
Source§

fn mul(self, arg: T) -> Self

Performs the * operation. Read more
Source§

impl Not for Command

Source§

type Output = Command

The resulting type after applying the ! operator.
Source§

fn not(self) -> Self

Performs the unary ! operation. Read more
Source§

impl<T> Rem<T> for Command
where T: Arg,

Source§

type Output = Command

The resulting type after applying the % operator.
Source§

fn rem(self, arg: T) -> Self

Performs the % operation. Read more
Source§

impl<T> Sub<T> for Command
where T: Arg,

Source§

type Output = Command

The resulting type after applying the - operator.
Source§

fn sub(self, arg: T) -> Self

Performs the - operation. Read more

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T> Instrument for T

Source§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
Source§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<V, T> VZip<V> for T
where V: MultiLane<T>,

Source§

fn vzip(self) -> V

Source§

impl<T> WithSubscriber for T

Source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
Source§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more