dbml-rs 1.0.1

A DBML parser for Rust.
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

use alloc::string::{
  String,
  ToString,
};
use alloc::vec::Vec;
use core::str::FromStr;

use super::*;

#[derive(Debug, Clone, Default)]
pub struct RefInline {
  /// The range of the span in the source text.
  pub span_range: SpanRange,
  pub rel: Relation,
  pub rhs: RefIdent,
}

#[derive(Debug, Clone, Default)]
pub struct RefBlock {
  /// The range of the span in the source text.
  pub span_range: SpanRange,
  pub name: Option<Ident>,
  pub rel: Relation,
  pub lhs: RefIdent,
  pub rhs: RefIdent,
  pub settings: Option<RefSettings>,
}

#[derive(Debug, PartialEq, Eq, Clone, Default)]
pub enum Relation {
  #[default]
  Undef,
  /// Represents '-' one-to-one. E.g: `users.id` - `user_infos.user_id`.
  One2One,
  /// Represents '<' one-to-many. E.g: `users.id` < `posts.user_id`.
  One2Many,
  /// Represents '>' many-to-one. E.g: `posts.user_id` > `users.id`.
  Many2One,
  /// Represents '<>' many-to-many. E.g: `authors.id` <> `books.id`.
  Many2Many,
}

impl FromStr for Relation {
  type Err = String;

  fn from_str(s: &str) -> Result<Self, Self::Err> {
    match s {
      "<" => Ok(Self::One2Many),
      ">" => Ok(Self::Many2One),
      "-" => Ok(Self::One2One),
      "<>" => Ok(Self::Many2Many),
      _ => Err(format!("invalid relation symbol '{}'", s)),
    }
  }
}

#[derive(Debug, Clone, Default)]
pub struct RefIdent {
  /// The range of the span in the source text.
  pub span_range: SpanRange,
  pub schema: Option<Ident>,
  pub table: Ident,
  pub compositions: Vec<Ident>,
}

#[derive(Debug, Clone)]
pub enum ReferentialAction {
  NoAction,
  Cascade,
  Restrict,
  SetNull,
  SetDefault,
}

impl FromStr for ReferentialAction {
  type Err = String;

  fn from_str(s: &str) -> Result<Self, Self::Err> {
    match s {
      "no action" => Ok(Self::NoAction),
      "cascade" => Ok(Self::Cascade),
      "restrict" => Ok(Self::Restrict),
      "set null" => Ok(Self::SetNull),
      "set default" => Ok(Self::SetDefault),
      _ => Err("invalid referential action".to_string()),
    }
  }
}

impl ToString for ReferentialAction {
  fn to_string(&self) -> String {
    let s = match self {
      Self::NoAction => "no action",
      Self::Cascade => "cascade",
      Self::Restrict => "restrict",
      Self::SetNull => "set null",
      Self::SetDefault => "set default",
    };

    s.to_string()
  }
}

#[derive(Debug, Clone, Default)]
pub struct RefSettings {
  /// The range of the span in the source text.
  pub span_range: SpanRange,
  /// A vector of key and optional value pairs representing attributes of the ref.
  pub attributes: Vec<Attribute>,
  pub on_delete: Option<ReferentialAction>,
  pub on_update: Option<ReferentialAction>,
}