Struct Binded 

pub struct Binded<'a, Id: BindableId, C: PostArchiverConnection = Connection> { /* private fields */ }

Available on crate feature utils only.

A bound entity context for update, delete, and relation operations.

Created via PostArchiverManager::bind(id). The Id type parameter is inferred from the argument — no turbofish needed.

Examples

// Binded<'_, PostId, _> — type inferred from post_id
manager.bind(post_id).delete()?;

Implementations

impl<'a, Id: BindableId, C: PostArchiverConnection> Binded<'a, Id, C>

pub fn new(manager: &'a PostArchiverManager<C>, id: Id) -> Self

pub fn id(&self) -> Id

Returns the bound entity ID.

pub fn manager(&self) -> &'a PostArchiverManager<C>

Returns a reference to the underlying manager.

pub fn conn(&self) -> &Connection

Shortcut: returns a reference to the database connection.

impl<'a, C: PostArchiverConnection> Binded<'a, AuthorId, C>

pub fn value(&self) -> Result<Author>

Get this author’s current data from the database.

pub fn delete(self) -> Result<()>

Remove this author from the archive.

This also removes all associated aliases and author-post relationships.

pub fn update(&self, update: UpdateAuthor) -> Result<()>

Apply a batch of field updates to this author in a single SQL statement.

Only fields set on update (i.e. Some(...)) are written to the database.

impl<'a, C: PostArchiverConnection> Binded<'a, AuthorId, C>

pub fn list_aliases(&self) -> Result<Vec<Alias>>

List all aliases associated with this author.

pub fn add_aliases( &self, aliases: Vec<(String, PlatformId, Option<String>)>, ) -> Result<()>

Add or update aliases for this author.

Parameters

• aliases: Vec of (source, platform, link)

pub fn remove_aliases(&self, aliases: &[(String, PlatformId)]) -> Result<()>

Remove aliases from this author.

Parameters

• aliases: &[(source, platform)]

pub fn set_alias_name( &self, alias: &(String, PlatformId), name: String, ) -> Result<()>

Set an alias’s name.

pub fn set_alias_platform( &self, alias: &(String, PlatformId), platform: PlatformId, ) -> Result<()>

Set an alias’s platform.

pub fn set_alias_link( &self, alias: &(String, PlatformId), link: Option<String>, ) -> Result<()>

Set an alias’s link.

impl<'a, C: PostArchiverConnection> Binded<'a, AuthorId, C>

pub fn list_posts(&self) -> Result<Vec<PostId>>

List all post IDs associated with this author.

impl<'a, C: PostArchiverConnection> Binded<'a, CollectionId, C>

pub fn value(&self) -> Result<Collection>

Get this collection’s current data from the database.

pub fn delete(self) -> Result<()>

Remove this collection from the archive.

Also removes all collection-post relationships.

pub fn update(&self, update: UpdateCollection) -> Result<()>

Apply a batch of field updates to this collection in a single SQL statement.

Only fields set on update (i.e. Some(...)) are written to the database.

impl<'a, C: PostArchiverConnection> Binded<'a, CollectionId, C>

pub fn list_posts(&self) -> Result<Vec<PostId>>

List all post IDs in this collection.

pub fn add_posts(&self, posts: &[PostId]) -> Result<()>

Add posts to this collection.

pub fn remove_posts(&self, posts: &[PostId]) -> Result<()>

Remove posts from this collection.

impl<'a, C: PostArchiverConnection> Binded<'a, FileMetaId, C>

pub fn value(&self) -> Result<FileMeta>

Get this file metadata’s current data from the database.

pub fn delete(self) -> Result<()>

Remove this file metadata from the archive.

This operation will also remove all associated thumb references. But it will not delete post.content related to this file.

pub fn update<T>(&self, update: UpdateFileMeta<T>) -> Result<()>

Apply a batch of field updates to this file metadata in a single SQL statement.

Only fields set on update (i.e. Some(...)) are written to the database.

pub fn update_with_content<T>(&self, update: UpdateFileMeta<T>) -> Result<()>

where T: WritableFileMeta,

pub fn get_path(&self) -> Result<PathBuf>

Get the file path of this file metadata.

impl<'a, C: PostArchiverConnection> Binded<'a, PlatformId, C>

pub fn value(&self) -> Result<Platform>

Get this platform’s current data from the database.

pub fn delete(self) -> Result<()>

Remove this platform from the archive.

This operation will also set the platform to UNKNOWN for all author aliases and posts. Tags associated with the platform will be deleted.

pub fn update(&self, update: UpdatePlatform) -> Result<()>

Apply a batch of field updates to this platform in a single SQL statement.

Only fields set on update (i.e. Some(...)) are written to the database.

impl<'a, C: PostArchiverConnection> Binded<'a, PlatformId, C>

pub fn list_tags(&self) -> Result<Vec<TagId>>

List all tag IDs associated with this platform.

pub fn list_posts(&self) -> Result<Vec<PostId>>

List all post IDs associated with this platform.

impl<'a, C: PostArchiverConnection> Binded<'a, PostId, C>

pub fn value(&self) -> Result<Post>

Get this post’s current data from the database.

pub fn delete(self) -> Result<()>

Remove this post from the archive.

This also removes all associated file metadata, author associations, tag associations, and collection associations.

pub fn update(&self, update: UpdatePost) -> Result<()>

Apply a batch of field updates to this post in a single SQL statement.

Only fields set on update (i.e. Some(...)) are written to the database.

pub fn list_file_metas(&self) -> Result<Vec<FileMetaId>>

List all file metadata IDs associated with this post.

impl<'a, C: PostArchiverConnection> Binded<'a, PostId, C>

pub fn list_authors(&self) -> Result<Vec<AuthorId>>

List all author IDs associated with this post.

pub fn add_authors(&self, authors: &[AuthorId]) -> Result<()>

Associate one or more authors with this post. Duplicate associations are silently ignored.

pub fn remove_authors(&self, authors: &[AuthorId]) -> Result<()>

Remove one or more authors from this post.

impl<'a, C: PostArchiverConnection> Binded<'a, PostId, C>

pub fn list_tags(&self) -> Result<Vec<TagId>>

List all tag IDs associated with this post.

pub fn add_tags(&self, tags: &[TagId]) -> Result<()>

Associate one or more tags with this post. Duplicate associations are silently ignored.

pub fn remove_tags(&self, tags: &[TagId]) -> Result<()>

Remove one or more tags from this post.

impl<'a, C: PostArchiverConnection> Binded<'a, PostId, C>

pub fn list_collections(&self) -> Result<Vec<CollectionId>>

List all collection IDs associated with this post.

pub fn add_collections(&self, collections: &[CollectionId]) -> Result<()>

Associate one or more collections with this post. Duplicate associations are silently ignored.

pub fn remove_collections(&self, collections: &[CollectionId]) -> Result<()>

Remove one or more collections from this post.

impl<'a, C: PostArchiverConnection> Binded<'a, TagId, C>

pub fn value(&self) -> Result<Tag>

Get this tag’s current data from the database.

pub fn delete(self) -> Result<()>

Remove this tag from the archive.

This will also remove all post-tag relationships, but will not delete the posts themselves.

pub fn update(&self, update: UpdateTag) -> Result<()>

Apply a batch of field updates to this tag in a single SQL statement.

Only fields set on update (i.e. Some(...)) are written to the database.

impl<'a, C: PostArchiverConnection> Binded<'a, TagId, C>

pub fn list_posts(&self) -> Result<Vec<PostId>>

List all post IDs associated with this tag.

Trait Implementations

impl<'a, Id: Debug + BindableId, C: Debug + PostArchiverConnection> Debug for Binded<'a, Id, C>

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

Formats the value using the given formatter.