Struct Remove

pub struct Remove<'a> { /* private fields */ }

Instruction for removing papers from the database.

This struct implements the DatabaseInstruction trait to provide paper removal functionality. It handles:

• Paper identification through queries
• Related data cleanup (authors, files)
• Transaction management
• Dry run simulation

Implementations

impl<'a> Remove<'a>

pub fn from_query(query: Query<'a>) -> Self

Creates a remove instruction from an existing query.

This method allows any query to be converted into a remove operation, providing maximum flexibility in identifying papers to remove.

Arguments

• query - The query that identifies papers to remove

Examples

// Remove papers matching a text search
let query = Query::text("quantum computing");
let remove = Remove::from_query(query);

// Remove papers before a date
use chrono::{DateTime, Utc};
let date = DateTime::parse_from_rfc3339("2020-01-01T00:00:00Z").unwrap().with_timezone(&Utc);
let query = Query::before_date(date);
let remove = Remove::from_query(query);

pub fn by_source(source: &'a str, identifier: &'a str) -> Self

Creates a remove instruction for a specific paper by its source and identifier.

This is a convenience method for the common case of removing a single paper identified by its source system and ID.

Arguments

• source - The paper’s source system (arXiv, DOI, etc.)
• identifier - The source-specific identifier

Examples

// Remove an arXiv paper
let remove = Remove::by_source("arxiv", "2301.07041");

// Remove a DOI paper
let remove = Remove::by_source("doi", "10.1145/1327452.1327492");

pub fn by_author(name: &'a str) -> Self

Creates a remove instruction for all papers by a specific author.

This method provides a way to remove all papers associated with a particular author name. It performs partial matching on the name.

Arguments

• name - The author name to match

Examples

// Remove all papers by an author
let remove = Remove::by_author("Alice Researcher");

pub fn dry_run(self) -> Self

Enables dry run mode for the remove operation.

In dry run mode, the operation will:

• Query papers that would be removed
• Return the list of papers
• Not modify the database

This is useful for:

• Previewing removal operations
• Validating queries
• Testing removal logic

Examples

// Preview papers that would be removed
let papers = Remove::by_author("Alice Researcher").dry_run().execute(&mut db).await?;

println!("Would remove {} papers", papers.len());

Trait Implementations

impl DatabaseInstruction for Remove<'_>

type Output = Vec<Paper>

The type returned by executing this instruction.

fn execute<'life0, 'life1, 'async_trait>( &'life0 self, db: &'life1 mut Database, ) -> Pin<Box<dyn Future<Output = Result<Self::Output>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Executes the instruction against a database connection.