httpgenerator 1.1.0

Generate .http files from OpenAPI specifications
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

use std::{error::Error, fmt, path::PathBuf};

use httpgenerator_core::openapi::OpenApiSpecificationVersion;

#[derive(Debug, Clone, PartialEq, Eq)]
pub enum CliError {
    MissingInput,
    InspectOpenApi(String),
    LoadOpenApi(String),
    UnsupportedValidationVersion {
        version: OpenApiSpecificationVersion,
    },
    CreateOutputDirectory {
        path: PathBuf,
        reason: String,
    },
    WriteFiles {
        path: PathBuf,
        reason: String,
    },
    WriteTimeout {
        seconds: u64,
    },
    WriteChannelClosed,
}

impl fmt::Display for CliError {
    fn fmt(&self, formatter: &mut fmt::Formatter<'_>) -> fmt::Result {
        match self {
            Self::MissingInput => write!(
                formatter,
                "missing OpenAPI input path or URL; run with --help for usage"
            ),
            Self::InspectOpenApi(reason) => write!(formatter, "{reason}"),
            Self::LoadOpenApi(reason) => write!(formatter, "{reason}"),
            Self::UnsupportedValidationVersion { version } => write!(
                formatter,
                "{version} documents are not supported by CLI validation yet; retry with --skip-validation"
            ),
            Self::CreateOutputDirectory { path, reason } => write!(
                formatter,
                "failed to create output directory '{}': {reason}",
                path.display()
            ),
            Self::WriteFiles { path, reason } => write!(
                formatter,
                "failed to write generated file '{}': {reason}",
                path.display()
            ),
            Self::WriteTimeout { seconds } => write!(
                formatter,
                "timed out after {seconds} second(s) while writing generated files"
            ),
            Self::WriteChannelClosed => write!(
                formatter,
                "file writing worker stopped before reporting a result"
            ),
        }
    }
}

impl Error for CliError {}

impl CliError {
    pub const fn telemetry_name(&self) -> &'static str {
        match self {
            Self::MissingInput => "MissingInput",
            Self::InspectOpenApi(_) => "InspectOpenApi",
            Self::LoadOpenApi(_) => "LoadOpenApi",
            Self::UnsupportedValidationVersion { .. } => "UnsupportedValidationVersion",
            Self::CreateOutputDirectory { .. } => "CreateOutputDirectory",
            Self::WriteFiles { .. } => "WriteFiles",
            Self::WriteTimeout { .. } => "WriteTimeout",
            Self::WriteChannelClosed => "WriteChannelClosed",
        }
    }
}