Struct Model

pub struct Model {
    pub id: i64,
    pub assignment_id: i64,
    pub user_id: i64,
    pub attempt: i64,
    pub earned: i64,
    pub total: i64,
    pub filename: String,
    pub file_hash: String,
    pub path: String,
    pub is_practice: bool,
    pub created_at: DateTime<Utc>,
    pub updated_at: DateTime<Utc>,
}

Represents a user’s submission for a specific assignment.

Each submission is linked to one assignment and one user. Timestamps are included to track when the submission was created and last updated.

Fields

id: i64

Primary key of the submission.

assignment_id: i64

ID of the related assignment.

user_id: i64

ID of the user who submitted the assignment.

attempt: i64

Attempt number

earned: i64

The score earned by the user.

total: i64

The total possible score.

filename: String

The original filename uploaded by the user.

file_hash: String

The hash of the submitted files.

path: String

Relative file path from the storage root.

is_practice: bool

Is this submission a practice submission?

created_at: DateTime<Utc>

Timestamp when the submission was created.

updated_at: DateTime<Utc>

Timestamp when the submission was last updated.

Implementations

impl Model

pub fn storage_root() -> PathBuf

Returns the root directory used for storing assignment submissions on disk.

Returns

• PathBuf pointing to the base directory.

Uses the ASSIGNMENT_STORAGE_ROOT environment variable if set, otherwise defaults to data/assignment_files.

pub fn full_directory_path( module_id: i64, assignment_id: i64, user_id: i64, attempt: i64, ) -> PathBuf

Constructs the full directory path for a submission based on its module and assignment identifiers.

Arguments

• module_id: ID of the module containing the assignment.
• assignment_id: ID of the specific assignment.

Returns

• PathBuf with the complete directory path.

pub fn full_path(&self) -> PathBuf

Computes the absolute path to the stored file on disk.

Returns

• PathBuf pointing to the file location.

pub async fn save_file( db: &DatabaseConnection, assignment_id: i64, user_id: i64, attempt: i64, earned: i64, total: i64, is_practice: bool, filename: &str, file_hash: &str, bytes: &[u8], ) -> Result<Self, DbErr>

Saves a file to disk and creates or updates its metadata in the database.

This method:

1. Creates a temporary DB entry.
2. Looks up the associated assignment and module.
3. Saves the file with a generated name on disk.
4. Updates the DB entry with the file path.

Arguments

• db: Reference to the active database connection.
• assignment_id: ID of the assignment this submission is for.
• user_id: ID of the user submitting.
• attempt: Attempt number,
• filename: The original filename as submitted.
• bytes: The file content as a byte slice.

Returns

• Ok(Model): The complete, updated Model representing the saved file.
• Err(DbErr): If any database or filesystem operation fails.

pub fn load_file(&self) -> Result<Vec<u8>, Error>

Loads the contents of the stored file from disk.

Returns

• Ok(Vec<u8>): The file contents as bytes.
• Err(std::io::Error): If reading the file fails.

pub fn delete_file_only(&self) -> Result<(), Error>

Deletes the file from disk without removing the database record.

Returns

• Ok(()): If the file was successfully deleted.
• Err(std::io::Error): If the file deletion failed.

pub async fn find_by_assignment( assignment_id: i64, db: &DatabaseConnection, ) -> Result<Vec<i64>, DbErr>

Find all submission IDs for a given assignment

pub async fn get_latest_submissions_for_assignment( db: &DatabaseConnection, assignment_id: i64, ) -> Result<Vec<Self>, DbErr>

Trait Implementations

impl Clone for Model

fn clone(&self) -> Model

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Model

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

Formats the value using the given formatter.

impl From<Model> for ActiveModel

fn from(m: Model) -> Self

Converts to this type from the input type.

impl FromQueryResult for Model

fn from_query_result(row: &QueryResult, pre: &str) -> Result<Self, DbErr>

Instantiate a Model from a [QueryResult]

fn from_query_result_optional( res: &QueryResult, pre: &str, ) -> Result<Option<Self>, DbErr>

Transform the error from instantiating a Model from a [QueryResult] and converting it to an Option

fn from_query_result_nullable( res: &QueryResult, pre: &str, ) -> Result<Self, TryGetError>

Transform the error from instantiating a Model from a [QueryResult] and converting it to an Option

fn find_by_statement(stmt: Statement) -> SelectorRaw<SelectModel<Self>>

impl IntoActiveModel<ActiveModel> for Model

fn into_active_model(self) -> ActiveModel

Method to call to perform the conversion

impl ModelTrait for Model

type Entity = Entity

fn get(&self, c: <Self::Entity as EntityTrait>::Column) -> Value

Get the [Value] of a column from an Entity

fn set(&mut self, c: <Self::Entity as EntityTrait>::Column, v: Value)

Set the [Value] of a column in an Entity

fn find_related<R>(&self, _: R) -> Select<R>

where R: EntityTrait, Self::Entity: Related<R>,

Find related Models

fn find_linked<L>(&self, l: L) -> Select<<L as Linked>::ToEntity>

where L: Linked<FromEntity = Self::Entity>,

Find linked Models

fn delete<'a, 'async_trait, A, C>( self, db: &'a C, ) -> Pin<Box<dyn Future<Output = Result<DeleteResult, DbErr>> + Send + 'async_trait>>

where 'a: 'async_trait, Self: IntoActiveModel<A> + 'async_trait, C: ConnectionTrait + 'async_trait, A: ActiveModelTrait<Entity = Self::Entity> + ActiveModelBehavior + Send + 'a + 'async_trait,

Delete a model

impl PartialEq for Model

fn eq(&self, other: &Model) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl TryFrom<ActiveModel> for Model

type Error = DbErr

The type returned in the event of a conversion error.

fn try_from(a: ActiveModel) -> Result<Self, DbErr>

Performs the conversion.

impl TryIntoModel<Model> for ActiveModel

fn try_into_model(self) -> Result<Model, DbErr>

Method to call to perform the conversion

impl StructuralPartialEq for Model