Struct ClipManager 

pub struct ClipManager { /* private fields */ }

Main clip management system.

Implementations

impl ClipManager

pub async fn new(database_url: impl AsRef<str>) -> ClipResult<Self>

Creates a new clip manager.

Errors

Returns an error if the database cannot be initialized.

pub async fn add_clip(&self, clip: Clip) -> ClipResult<ClipId>

Adds a clip to the database.

Errors

Returns an error if the clip cannot be saved.

pub async fn get_clip(&self, clip_id: &ClipId) -> ClipResult<Clip>

Gets a clip by ID.

Errors

Returns an error if the clip is not found.

pub async fn update_clip(&self, clip: Clip) -> ClipResult<()>

Updates a clip.

Errors

Returns an error if the clip cannot be updated.

pub async fn delete_clip(&self, clip_id: &ClipId) -> ClipResult<()>

Deletes a clip.

Errors

Returns an error if the clip cannot be deleted.

pub async fn get_all_clips(&self) -> ClipResult<Vec<Clip>>

Gets all clips.

Errors

Returns an error if clips cannot be loaded.

pub async fn clip_count(&self) -> ClipResult<i64>

Returns the number of clips.

Errors

Returns an error if the count fails.

pub async fn add_clips(&self, clips: Vec<Clip>) -> ClipResult<Vec<ClipId>>

Adds multiple clips in a single database transaction (bulk import).

Significantly more efficient than calling add_clip() in a loop.

Errors

Returns an error if the transaction or any individual save fails.

pub async fn list_clips( &self, page: i64, page_size: i64, ) -> ClipResult<Vec<Clip>>

Lists clips with pagination.

page is 0-indexed; page_size is the number of clips per page.

Errors

Returns an error if the query fails.

pub async fn search_paged( &self, query: &str, page: i64, page_size: i64, ) -> ClipResult<Vec<Clip>>

Searches clips by query string with pagination.

Errors

Returns an error if the search fails.

pub async fn search(&self, query: &str) -> ClipResult<Vec<Clip>>

Searches clips by query string.

Errors

Returns an error if the search fails.

pub async fn filter(&self, filter: &ClipFilter) -> ClipResult<Vec<Clip>>

Filters clips using advanced criteria.

Errors

Returns an error if the filter operation fails.

pub fn create_bin(&mut self, name: impl Into<String>) -> BinId

Creates a new bin.

pub fn get_bin(&self, bin_id: &BinId) -> ClipResult<&Bin>

Gets a bin by ID.

Errors

Returns an error if the bin is not found.

pub fn get_bin_mut(&mut self, bin_id: &BinId) -> ClipResult<&mut Bin>

Gets a mutable bin by ID.

Errors

Returns an error if the bin is not found.

pub fn add_clip_to_bin( &mut self, bin_id: &BinId, clip_id: ClipId, ) -> ClipResult<()>

Adds a clip to a bin.

Errors

Returns an error if the bin is not found.

pub fn list_bins(&self) -> Vec<&Bin>

Lists all bins.

pub fn create_folder(&mut self, name: impl Into<String>) -> FolderId

Creates a new folder.

pub fn create_child_folder( &mut self, name: impl Into<String>, parent_id: FolderId, ) -> FolderId

Creates a child folder.

pub fn get_folder(&self, folder_id: &FolderId) -> ClipResult<&Folder>

Gets a folder by ID.

Errors

Returns an error if the folder is not found.

pub fn create_collection(&mut self, name: impl Into<String>) -> CollectionId

Creates a new collection.

pub fn get_collection( &self, collection_id: &CollectionId, ) -> ClipResult<&Collection>

Gets a collection by ID.

Errors

Returns an error if the collection is not found.

pub fn add_clip_to_collection( &mut self, collection_id: &CollectionId, clip_id: ClipId, ) -> ClipResult<()>

Adds a clip to a collection.

Errors

Returns an error if the collection is not found.

pub fn create_smart_collection(&mut self, smart_collection: SmartCollection)

Creates a new smart collection.

pub async fn update_smart_collections(&mut self) -> ClipResult<()>

Updates all smart collections.

Errors

Returns an error if clips cannot be loaded.

pub fn add_marker(&mut self, clip_id: ClipId, marker: Marker)

Adds a marker to a clip.

pub fn get_markers(&self, clip_id: &ClipId) -> Vec<&Marker>

Gets markers for a clip.

pub fn remove_marker( &mut self, clip_id: &ClipId, marker_id: &MarkerId, ) -> ClipResult<()>

Removes a marker.

Errors

Returns an error if the marker is not found.

pub fn add_take(&mut self, take: Take)

Adds a take.

pub fn get_scene_takes(&self, scene: &str) -> Vec<&Take>

Gets takes for a scene.

pub fn get_clip_takes(&self, clip_id: &ClipId) -> Vec<&Take>

Gets takes for a clip.

pub fn add_proxy(&mut self, link: ProxyLink)

Adds a proxy link.

pub fn get_proxies(&self, clip_id: &ClipId) -> Vec<&ProxyLink>

Gets proxy links for a clip.

pub fn get_best_proxy(&self, clip_id: &ClipId) -> Option<&ProxyLink>

Gets the best proxy for a clip.

pub async fn scan_directory( &self, path: impl AsRef<Path>, ) -> ClipResult<Vec<Clip>>

Scans a directory for media files.

Errors

Returns an error if the scan fails.

pub fn import_clips(&self, paths: Vec<PathBuf>) -> Vec<Clip>

Imports clips from file paths.

pub async fn export_csv(&self, clip_ids: &[ClipId]) -> ClipResult<String>

Exports clips to CSV.

Errors

Returns an error if the export fails.

pub async fn export_edl( &self, clip_ids: &[ClipId], frame_rate: Rational, ) -> ClipResult<String>

Exports clips to EDL.

Errors

Returns an error if the export fails.