boilerplate 1.1.1

Minimal compile-time Rust template engine
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

use {
  super::*,
  std::{fmt::Display, io},
};

/// Reloaded template.
pub struct Reload<T> {
  pub(super) text: Vec<String>,
  pub(super) inner: T,
}

impl<T: Boilerplate> Display for Reload<&T> {
  fn fmt(&self, f: &mut Formatter) -> fmt::Result {
    self.inner.boilerplate(&self.text, f)
  }
}

/// Template reload errors.
#[derive(Debug)]
pub enum Error {
  /// New template is not compatible with the old template.
  Incompatible { new: String, old: String },
  /// I/O error loading new template.
  Io {
    path: &'static str,
    source: io::Error,
  },
  /// New template does not have the same number of blocks.
  Length { new: usize, old: usize },
  /// Failed to parse new template.
  ParseNew(boilerplate_parser::Error),
  /// Failed to parse old template.
  ParseOld(boilerplate_parser::Error),
  /// Template has no path
  Path,
}

impl Display for Error {
  fn fmt(&self, f: &mut Formatter) -> fmt::Result {
    match self {
      Self::Incompatible { new, old } => {
        write!(f, "template blocks are not compatible: {new} != {old}")
      }
      Self::Io { path, .. } => write!(f, "I/O error loading template from: {path}"),
      Self::Length { new, old } => write!(
        f,
        "new template has {new} blocks but old template has {old} blocks",
      ),
      Self::ParseNew(err) => write!(f, "failed to parse new template: {err}"),
      Self::ParseOld(err) => write!(f, "failed to parse old template: {err}"),
      Self::Path => write!(f, "template has no path"),
    }
  }
}

impl core::error::Error for Error {
  fn source(&self) -> Option<&(dyn std::error::Error + 'static)> {
    if let Self::Io { source, .. } = self {
      Some(source)
    } else {
      None
    }
  }
}