wdl-doc 0.1.0

Documentation generator for Workflow Description Language (WDL) documents.
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
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109

//! Create HTML documentation for WDL tasks.

use std::fmt::Display;

use html::content;
use html::text_content;
use wdl_ast::AstNode;
use wdl_ast::v1::MetadataSection;

use crate::parameter::Parameter;

/// A task in a WDL document.
#[derive(Debug)]
pub struct Task {
    /// The name of the task.
    name: String,
    /// The meta section of the task.
    meta_section: Option<MetadataSection>,
    /// The input parameters of the task.
    inputs: Vec<Parameter>,
    /// The output parameters of the task.
    outputs: Vec<Parameter>,
}

impl Task {
    /// Create a new task.
    pub fn new(
        name: String,
        meta_section: Option<MetadataSection>,
        inputs: Vec<Parameter>,
        outputs: Vec<Parameter>,
    ) -> Self {
        Self {
            name,
            meta_section,
            inputs,
            outputs,
        }
    }

    /// Get the name of the task.
    pub fn name(&self) -> &str {
        &self.name
    }

    /// Get the meta section of the task.
    pub fn meta_section(&self) -> Option<&MetadataSection> {
        self.meta_section.as_ref()
    }

    /// Get the input parameters of the task.
    pub fn inputs(&self) -> &[Parameter] {
        &self.inputs
    }

    /// Get the output parameters of the task.
    pub fn outputs(&self) -> &[Parameter] {
        &self.outputs
    }
}

impl Display for Task {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        let task_name = content::Heading1::builder()
            .text(self.name().to_owned())
            .build();

        let mut content = text_content::UnorderedList::builder();
        if let Some(meta_section) = self.meta_section() {
            content.push(
                text_content::ListItem::builder()
                    .text("Meta:")
                    .push(meta_section.syntax().to_string())
                    .build(),
            );
        }
        content.push(
            text_content::ListItem::builder()
                .text("Inputs:")
                .push(
                    text_content::UnorderedList::builder()
                        .extend(self.inputs().iter().map(|param| {
                            text_content::ListItem::builder()
                                .push(param.to_string())
                                .build()
                        }))
                        .build(),
                )
                .build(),
        );
        content.push(
            text_content::ListItem::builder()
                .text("Outputs:")
                .push(
                    text_content::UnorderedList::builder()
                        .extend(self.outputs().iter().map(|param| {
                            text_content::ListItem::builder()
                                .push(param.to_string())
                                .build()
                        }))
                        .build(),
                )
                .build(),
        );

        write!(f, "{}", task_name)?;
        write!(f, "{}", content.build())
    }
}