Struct g1::Connection

pub struct Connection { /* fields omitted */ }

A connection to a G1 database.

Methods

impl Connection

pub fn open(base_url: &str) -> Result<Connection, OpenError>

Opens a connection to the database at the given URL.

pub fn open_url(base_url: Url) -> Connection

Opens a connection to the database at the given URL.

impl Connection

pub async fn create_atom<'_>(&'_ self) -> Result<Atom, QueryError>

Creates a new Atom.

pub async fn create_name<'_, '_, '_>(
    &'_ self,
    atom: Atom,
    ns: &'_ str,
    title: &'_ str
) -> Result<(), QueryError>

Creates a new name for an Atom.

pub async fn delete_name<'_, '_, '_>(
    &'_ self,
    ns: &'_ str,
    title: &'_ str
) -> Result<bool, QueryError>

Deletes a name, returning whether it existed.

pub async fn find_atom_by_name<'_, '_, '_>(
    &'_ self,
    ns: &'_ str,
    title: &'_ str
) -> Result<Option<Atom>, QueryError>

Finds the Atom corresponding to the given name, if any.

pub async fn create_edge<'_, '_>(
    &'_ self,
    from: Atom,
    to: Atom,
    key: &'_ str
) -> Result<(), QueryError>

Creates an edge between two Atoms.

pub async fn delete_edge<'_, '_>(
    &'_ self,
    from: Atom,
    to: Atom,
    key: &'_ str
) -> Result<bool, QueryError>

Deletes an edge, returning whether it existed.

pub async fn find_edges<'_, '_>(
    &'_ self,
    from: Option<Atom>,
    to: Option<Atom>,
    key: Option<&'_ str>
) -> Result<Vec<(Atom, Atom, String)>, QueryError>

Returns the edges that meet the given criteria as (from, to, key) tuples.

None means "don't care," the query is otherwise a conjunction (an AND).

pub async fn create_tag<'_, '_, '_>(
    &'_ self,
    atom: Atom,
    kind: &'_ str,
    value: &'_ str
) -> Result<(), QueryError>

Adds a tag to an Atom with the given kind and value.

pub async fn find_tag<'_, '_>(
    &'_ self,
    atom: Atom,
    kind: &'_ str
) -> Result<Option<String>, QueryError>

Find the tag with the given kind on the Atom.

pub async fn delete_tag<'_, '_>(
    &'_ self,
    atom: Atom,
    kind: &'_ str
) -> Result<bool, QueryError>

Deletes the tag with the given kind on the Atom, returning whether it was found.

pub async fn create_blob<'_, '_>(
    &'_ self,
    atom: Atom,
    mime: Mime,
    contents: &'_ [u8]
) -> Result<(), QueryError>

Adds a blob to an Atom with the given MIME type and value.

pub async fn delete_blob<'_>(
    &'_ self,
    atom: Atom,
    mime: Mime
) -> Result<bool, QueryError>

Deletes the blob with the given MIME type on the Atom, returning whether it was found.

Trait Implementations

impl Debug for Connection

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

Formats the value using the given formatter.