calcit 0.12.30

Interpreter and js codegen for Calcit
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
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125

use std::{
  path::{Path, PathBuf},
  process::Command,
};

/// abstraction of a local git repository
pub struct GitRepo {
  pub dir: PathBuf,
}

impl GitRepo {
  fn run_command(&self, args: &[&str]) -> Result<String, String> {
    let mut command = Command::new("git");
    command.current_dir(&self.dir).args(args);

    let output = command.output().map_err(|e| e.to_string())?;
    if !output.status.success() {
      let err = String::from_utf8_lossy(&output.stderr);
      Err(format!("{} from args {:?}", err.trim(), command.get_args()))
    } else {
      let stdout = String::from_utf8_lossy(&output.stdout);
      Ok(stdout.trim().to_string())
    }
  }

  pub fn checkout(&self, version: &str) -> Result<(), String> {
    self.run_command(&["checkout", version]).map(|_a| ())
  }

  /// clone to directory
  pub fn clone_to(dir: &Path, url: &str, version: &str, shallow: bool) -> Result<(), String> {
    let container = GitRepo { dir: dir.to_path_buf() };
    if shallow {
      container.run_command(&["clone", "--branch", version, "--depth", "1", url])?;
    } else {
      container.run_command(&["clone", "--branch", version, url])?;
    }
    Ok(())
  }

  /// get the current head of the repository
  pub fn current_head(&self) -> Result<GitHead, String> {
    let branch = self.run_command(&["branch", "--show-current"])?;
    if branch.is_empty() {
      // probably a tag
      Ok(GitHead::Tag(self.describe_tag()?))
    } else {
      Ok(GitHead::Branch(branch))
    }
  }

  /// get unix timestamp of a commit
  /// ```bash
  /// git show -s --format=%ct <SHA>
  /// ```
  pub fn timestamp(&self, sha: &str) -> Result<u32, String> {
    let timestamp = self.run_command(&["show", "-s", "--format=%ct", sha])?;
    let v = timestamp.trim().parse::<u32>().map_err(|e| e.to_string())?;
    Ok(v)
  }

  /// get latest tag
  /// ```bash
  /// git describe --tags $(git rev-list --tags --max-count=1)
  /// ```
  /// fails when no tag is found
  pub fn latest_tag(&self) -> Result<String, String> {
    let rev_output = self.run_command(&["rev-list", "--tags", "--max-count=1"])?;
    let tag = self.run_command(&["describe", "--tags", rev_output.trim()])?;
    Ok(tag.trim().to_string())
  }

  /// get SHA of a tag or ref
  /// ```bash
  /// git rev-parse <REF>
  /// ```
  #[allow(dead_code)]
  pub fn rev_parse(&self, ref_name: &str) -> Result<String, String> {
    let sha = self.run_command(&["rev-parse", ref_name])?;
    Ok(sha.trim().to_string())
  }

  pub fn check_branch_or_tag(&self, version: &str, folder: &str) -> Result<bool, String> {
    match self.run_command(&["show-ref", "--verify", &format!("refs/tags/{version}")]) {
      Ok(_) => Ok(true),
      Err(_) => {
        let ret = self.run_command(&["show-ref", "--verify", &format!("refs/heads/{version}")]);
        match ret {
          Ok(_) => Ok(true),
          Err(_) => Err(format!("failed to check branch or tag `{version}` in `{folder}`")),
        }
      }
    }
  }

  pub fn fetch(&self) -> Result<(), String> {
    self.run_command(&["fetch", "origin", "--tags"])?;
    Ok(())
  }

  pub fn describe_tag(&self) -> Result<String, String> {
    let tag = self.run_command(&["describe", "--tags"])?.trim().to_string();
    Ok(tag)
  }

  pub fn pull(&self, branch: &str) -> Result<(), String> {
    self.run_command(&["pull", "origin", branch])?;
    Ok(())
  }
}

#[derive(Debug, PartialEq, Eq)]
pub enum GitHead {
  Branch(String),
  Tag(String),
}

impl GitHead {
  pub fn get_name(&self) -> String {
    match self {
      GitHead::Branch(s) => s.to_string(),
      GitHead::Tag(s) => s.to_string(),
    }
  }
}