deno_doc 0.198.0

doc generation for deno
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

// Copyright 2018-2024 the Deno authors. All rights reserved. MIT license.

use super::Change;
use super::ts_type::TsTypeDiff;
use crate::variable::VariableDef;
use deno_ast::swc::ast::VarDeclKind;
use serde::Deserialize;
use serde::Serialize;

#[derive(Debug, Clone, Serialize, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct VariableDiff {
  #[serde(skip_serializing_if = "Option::is_none")]
  pub ts_type_change: Option<TsTypeDiff>,
  #[serde(skip_serializing_if = "Option::is_none")]
  pub kind_change: Option<Change<VarDeclKind>>,
}

impl VariableDiff {
  pub fn diff(old: &VariableDef, new: &VariableDef) -> Option<Self> {
    let VariableDef {
      ts_type: old_ts_type,
      kind: old_kind,
    } = old;
    let VariableDef {
      ts_type: new_ts_type,
      kind: new_kind,
    } = new;

    let ts_type_change = match (old_ts_type, new_ts_type) {
      (Some(old_type), Some(new_type)) => TsTypeDiff::diff(old_type, new_type),
      (None, None) => None,
      (Some(old_type), None) => Some(TsTypeDiff {
        old: old_type.clone(),
        new: crate::ts_type::TsTypeDef::keyword("unknown"),
      }),
      (None, Some(new_type)) => Some(TsTypeDiff {
        old: crate::ts_type::TsTypeDef::keyword("unknown"),
        new: new_type.clone(),
      }),
    };

    let kind_change = if old_kind != new_kind {
      Some(Change::new(*old_kind, *new_kind))
    } else {
      None
    };

    if ts_type_change.is_none() && kind_change.is_none() {
      return None;
    }

    Some(VariableDiff {
      ts_type_change,
      kind_change,
    })
  }

  pub fn change_percentage(&self) -> f64 {
    let total = 2.0;
    let changed =
      self.ts_type_change.is_some() as u8 + self.kind_change.is_some() as u8;
    changed as f64 / total
  }
}