caesura 0.22.3

An all-in-one command line tool to **transcode FLAC** audio files and **upload to gazelle** based indexers/trackers.
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

use crate::jobs::*;
use crate::options::SharedOptions;
use di::{injectable, Ref};
use rogue_logging::Verbosity;

/// A publisher notifies subscribers when the status of a [Job] changes.
///
/// An [observer design pattern](https://refactoring.guru/design-patterns/observer) allows different
/// subscribers to be implemented independently.
pub struct Publisher {
    subscribers: Vec<Ref<dyn Subscriber + Send + Sync>>,
}

#[injectable]
impl Publisher {
    #[must_use]
    pub fn new(
        options: Ref<SharedOptions>,
        debug_subscriber: Ref<DebugSubscriber>,
        progress_bar_subscriber: Ref<ProgressBarSubscriber>,
    ) -> Self {
        let subscriber: Ref<dyn Subscriber + Send + Sync> =
            if options.verbosity.expect("verbosity should be set").as_num()
                >= Verbosity::Trace.as_num()
            {
                debug_subscriber
            } else {
                progress_bar_subscriber
            };
        Self {
            subscribers: vec![subscriber],
        }
    }
}

impl Subscriber for Publisher {
    /// Called when a new scope is started.
    fn start(&self, scope_id: &str) {
        for subscriber in &self.subscribers {
            subscriber.start(scope_id);
        }
    }

    /// Called when a scope is finished.
    fn finish(&self, scope_id: &str) {
        for subscriber in &self.subscribers {
            subscriber.finish(scope_id);
        }
    }

    /// Called when the status of a job changes.
    fn update(&self, command_id: &str, status: Status) {
        for subscriber in &self.subscribers {
            subscriber.update(command_id, status.clone());
        }
    }
}