cargo-textus 0.2.0

Cargo CLI and macros for Rustacean who are truly serious about writing
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

//! This target also runs with --no-default-features, without CLI dependencies.

#[doc = cargo_textus::include_str!("tests/fixtures/guide.md")]
struct Documented;

#[test]
fn macro_is_usable_as_an_attribute_and_string_expression() {
    let _ = Documented;
    let expected = match option_env!("TEXTUS_LANG") {
        None => "Default documentation\n",
        Some("en") => "English documentation\n",
        Some("ko") => "한국어 문서\n",
        Some(language) => panic!("no test fixture for language {language}"),
    };
    assert_eq!(
        cargo_textus::include_str!("tests/fixtures/guide.md"),
        expected
    );
}

#[doc = cargo_textus::include_str_from_dir!(
    "tests/fixtures/guide.md", ko = "tests/fixtures/ko/", en = "tests/fixtures/english",
)]
struct DirectoryDocumented;

#[test]
fn directory_macro_selects_explicit_mapping() {
    let _ = DirectoryDocumented;
    let expected = match option_env!("TEXTUS_LANG") {
        None => "Default documentation\n",
        Some("en") => "English directory documentation\n",
        Some("ko") => "한국어 디렉토리 문서\n",
        Some(language) => panic!("no test fixture for language {language}"),
    };
    assert_eq!(
        cargo_textus::include_str_from_dir!(
            "tests/fixtures/guide.md",
            ko = "tests/fixtures/ko/",
            en = "tests/fixtures/english",
        ),
        expected
    );
}