translation-rs 0.3.2

Safe Rust bindings for Translation.framework — language availability, session workflows, and language recognition on macOS
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
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82

use serde::{Deserialize, Serialize};

use crate::language::Language;

#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
#[serde(rename_all = "camelCase")]
/// Serializable counterpart to `TranslationSession.Response` in Translation.framework.
pub struct TranslationResponse {
    source_language: Language,
    target_language: Language,
    source_text: String,
    target_text: String,
    client_identifier: Option<String>,
}

impl TranslationResponse {
    #[must_use]
    /// Creates a translation response from source and translated text.
    pub fn new(
        source_language: impl Into<Language>,
        target_language: impl Into<Language>,
        source_text: impl Into<String>,
        target_text: impl Into<String>,
    ) -> Self {
        Self {
            source_language: source_language.into(),
            target_language: target_language.into(),
            source_text: source_text.into(),
            target_text: target_text.into(),
            client_identifier: None,
        }
    }

    #[must_use]
    /// Returns the source language identifier.
    pub fn source_language(&self) -> &str {
        self.source_language.identifier()
    }

    #[must_use]
    /// Returns the target language identifier.
    pub fn target_language(&self) -> &str {
        self.target_language.identifier()
    }

    #[must_use]
    /// Returns the source language object.
    pub fn source_language_object(&self) -> &Language {
        &self.source_language
    }

    #[must_use]
    /// Returns the target language object.
    pub fn target_language_object(&self) -> &Language {
        &self.target_language
    }

    #[must_use]
    /// Returns the original source text.
    pub fn source_text(&self) -> &str {
        &self.source_text
    }

    #[must_use]
    /// Returns the translated target text.
    pub fn target_text(&self) -> &str {
        &self.target_text
    }

    #[must_use]
    /// Returns the client identifier, if one was set on the request.
    pub fn client_identifier(&self) -> Option<&str> {
        self.client_identifier.as_deref()
    }

    #[must_use]
    /// Returns a copy with the given client identifier.
    pub fn with_client_identifier(mut self, client_identifier: impl Into<String>) -> Self {
        self.client_identifier = Some(client_identifier.into());
        self
    }
}