versa 1.9.0-rc2

Versa types and utilities for developing Versa client applications in 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
113
114
115
116

use serde::{Deserialize, Serialize};
use std::fmt;

#[cfg(feature = "diesel")]
use std::io::Write;

#[cfg(feature = "diesel")]
use diesel::deserialize::{self, FromSql};
#[cfg(feature = "diesel")]
use diesel::serialize::{self, IsNull, Output, ToSql};
#[cfg(feature = "diesel")]
use diesel::sql_types::Text;

#[cfg(feature = "diesel")]
use diesel::mysql::{Mysql, MysqlValue};

#[derive(Debug, Deserialize, Serialize)]
pub struct CustomerRef {
  pub handle: String,
  pub handle_type: HandleType,
  pub receiver_org_id: Option<String>,
}

impl CustomerRef {
  pub fn new(handle: String, handle_type: HandleType) -> Self {
    Self {
      handle,
      handle_type,
      receiver_org_id: None,
    }
  }

  pub fn with_receiver_org_id(mut self, receiver_org_id: String) -> Self {
    self.receiver_org_id = Some(receiver_org_id);
    self
  }
}

#[derive(Debug, Deserialize, Serialize)]
pub struct SenderCustomerRef {
  pub handle: String,
  pub handle_type: HandleType,
  pub receiver_org_id: String,
}

impl Into<CustomerRef> for SenderCustomerRef {
  fn into(self) -> CustomerRef {
    CustomerRef {
      handle: self.handle,
      handle_type: self.handle_type,
      receiver_org_id: Some(self.receiver_org_id),
    }
  }
}

pub struct ReceiverCustomerRef {
  pub handle: String,
  pub handle_type: HandleType,
}

impl Into<CustomerRef> for ReceiverCustomerRef {
  fn into(self) -> CustomerRef {
    CustomerRef {
      handle: self.handle,
      handle_type: self.handle_type,
      receiver_org_id: None,
    }
  }
}

#[derive(Clone, Debug, Deserialize, PartialEq, Serialize)]
#[serde(rename_all = "snake_case")]
#[cfg_attr(
  feature = "diesel",
  derive(diesel::expression::AsExpression, diesel::deserialize::FromSqlRow)
)]
#[cfg_attr(feature = "diesel", diesel(sql_type = Text))]
pub enum HandleType {
  CustomerEmail,
  CustomerEmailDomain,
  MerchantGroupCode,
  MerchantUserCode,
}

impl fmt::Display for HandleType {
  fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
    let s = match self {
      HandleType::CustomerEmail => "customer_email",
      HandleType::CustomerEmailDomain => "customer_email_domain",
      HandleType::MerchantGroupCode => "merchant_group_code",
      HandleType::MerchantUserCode => "merchant_user_code",
    };
    write!(f, "{}", s)
  }
}

#[cfg(feature = "diesel")]
impl ToSql<Text, Mysql> for HandleType {
  fn to_sql<'b>(&'b self, out: &mut Output<'b, '_, Mysql>) -> serialize::Result {
    out.write_all(self.to_string().as_bytes())?;
    Ok(IsNull::No)
  }
}

#[cfg(feature = "diesel")]
impl FromSql<Text, Mysql> for HandleType {
  fn from_sql(bytes: MysqlValue<'_>) -> deserialize::Result<Self> {
    match bytes.as_bytes() {
      b"customer_email" => Ok(HandleType::CustomerEmail),
      b"customer_email_domain" => Ok(HandleType::CustomerEmailDomain),
      b"merchant_group_code" => Ok(HandleType::MerchantGroupCode),
      b"merchant_user_code" => Ok(HandleType::MerchantUserCode),
      _ => Err("Unrecognized handle_type enum variant".into()),
    }
  }
}