subx-core 1.0.0

Core subtitle processing library for SubX: matching, format conversion, synchronization, and AI service integrations.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64

//! Core processing engine for SubX.
//!
//! This module contains core subsystems for file operations, subtitle format
//! handling, language detection, matching algorithms, parallel processing,
//! synchronization, and dependency injection management.
//!
//! Each subsystem is organized into its own submodule:
//! - `file_manager` for safe file operations with rollback support
//! - `formats` for parsing and converting subtitle formats
//! - `language` for language detection and handling
//! - `input` for input path collection, directory scanning and archive extraction
//! - `matcher` for AI-powered subtitle matching algorithms
//! - `parallel` for task scheduling and parallel execution
//! - `report` for the transport-agnostic reporting seam core reports through
//! - `sync` for audio-text synchronization engines
//! - `factory` for component creation with dependency injection
//! - `services` for service container and dependency management
//!
#![allow(dead_code)]

pub mod archive;
pub mod factory;
pub mod file_manager;
pub mod formats;
pub mod fs_util;
pub mod input;
pub mod language;
pub mod lock;
pub mod matcher;
pub mod parallel;
pub mod report;
pub mod sync;
pub mod translation;
pub mod uuidv7;

// Re-export commonly used types
pub use factory::ComponentFactory;

/// Compile-time thread-safety contract for the orchestration surface.
///
/// The list below is the contract, not a record of one change's edits:
/// every type named here is guaranteed `Send + Sync + 'static`, and a new
/// public engine, factory or manager type must be added by the change that
/// adds it (see the `async-runtime-safety` requirement *Library Engine
/// Types Are `Send` and `Sync`*).
///
/// A compile failure on one of these lines means a field of that type lost
/// its auto traits (an `Rc`, a `RefCell`, or a trait object whose trait
/// names no `Send`/`Sync` supertraits) — it does not mean the assertion is
/// wrong. Fix the field, or move the type out of the orchestration surface
/// deliberately.
#[cfg(test)]
mod thread_safety {
    const fn assert_send_sync<T: Send + Sync + 'static>() {}

    const _: () = assert_send_sync::<crate::core::formats::manager::FormatManager>();
    const _: () = assert_send_sync::<crate::core::formats::converter::FormatConverter>();
    const _: () = assert_send_sync::<crate::core::translation::TranslationEngine>();
    const _: () = assert_send_sync::<crate::core::matcher::MatchEngine>();
    const _: () = assert_send_sync::<crate::core::sync::SyncEngine>();
    const _: () = assert_send_sync::<crate::core::ComponentFactory>();
    const _: () = assert_send_sync::<crate::core::file_manager::FileManager>();
    const _: () = assert_send_sync::<Box<dyn crate::core::formats::SubtitleFormat>>();
}