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
83
84
85
86
87
88

extern crate stripper_lib;

use std::io;
use std::path::Path;
use stripper_lib::{loop_over_files, parse_cmts, regenerate_comments, strip_comments};

#[derive(Clone, Copy, Debug)]
pub enum Library {
    GstWebRTC,
    GstVideo,
    GstSdp,
    GstRtspServer,
    GstRtsp,
    GstRtp,
    GstPlayer,
    GstNet,
    GstGL,
    GES,
    GstCheck,
    GstPbutils,
    GstBase,
    GstAudio,
    GstApp,
    Gst,
}

fn docs(lib: Library) -> Option<&'static str> {
    match lib {
        Library::GstWebRTC => Some(include_str!("../gstreamer-webrtc/docs.md")),
        Library::GstVideo => Some(include_str!("../gstreamer-video/docs.md")),
        Library::GstSdp => Some(include_str!("../gstreamer-sdp/docs.md")),
        Library::GstRtspServer => Some(include_str!("../gstreamer-rtsp-server/docs.md")),
        Library::GstRtsp => Some(include_str!("../gstreamer-rtsp/docs.md")),
        Library::GstRtp => Some(include_str!("../gstreamer-rtp/docs.md")),
        Library::GstPlayer => Some(include_str!("../gstreamer-player/docs.md")),
        Library::GstNet => Some(include_str!("../gstreamer-net/docs.md")),
        Library::GstGL => Some(include_str!("../gstreamer-gl/docs.md")),
        Library::GES => Some(include_str!("../gstreamer-editing-services/docs.md")),
        Library::GstCheck => Some(include_str!("../gstreamer-check/docs.md")),
        Library::GstPbutils => Some(include_str!("../gstreamer-pbutils/docs.md")),
        Library::GstBase => Some(include_str!("../gstreamer-base/docs.md")),
        Library::GstAudio => Some(include_str!("../gstreamer-audio/docs.md")),
        Library::GstApp => Some(include_str!("../gstreamer-app/docs.md")),
        Library::Gst => Some(include_str!("../gstreamer/docs.md")),
    }
}

fn vendor_docs(_lib: Library) -> Option<&'static str> {
    None
}

/// Embeds the docs.
///
/// `path` is the root directory to process.
///
/// `ignores` is the list of files to skip (relative to `path`).
pub fn embed<P: AsRef<Path>>(library: Library, path: P, ignores: &[&str]) {
    if let Some(docs) = docs(library) {
        do_embed(docs, path.as_ref(), ignores);
    }
    if let Some(docs) = vendor_docs(library) {
        do_embed(docs, path.as_ref(), ignores);
    }
}

fn do_embed(docs: &str, path: &Path, ignores: &[&str]) {
    let mut infos = parse_cmts(docs.lines(), true);
    loop_over_files(
        path,
        &mut |w, s| regenerate_comments(w, s, &mut infos, true, true),
        &ignores,
        false,
    );
}

/// Remove any doc comments.
///
/// `path` is the root directory to process.
///
/// `ignores` is the list of files to skip (relative to `path`).
pub fn purge<P: AsRef<Path>>(path: P, ignores: &[&str]) {
    loop_over_files(
        path.as_ref(),
        &mut |w, s| strip_comments(w, s, &mut io::sink(), true),
        &ignores,
        false,
    );
}