Debian Codegraph @

.cargo/vendor/cbindgen/src/bindgen/rename.rs

raw
1 /* This Source Code Form is subject to the terms of the Mozilla Public
2 * License, v. 2.0. If a copy of the MPL was not distributed with this
3 * file, You can obtain one at http://mozilla.org/MPL/2.0/. */
4
5 use std::borrow::Cow;
6 use std::str::FromStr;
7
8 /// The type of identifier to be renamed.
9 #[derive(Debug, Clone, Copy)]
10 pub enum IdentifierType<'a> {
11 StructMember,
12 EnumVariant { prefix: &'a str },
13 FunctionArg,
14 Type,
15 Enum,
16 }
17
18 impl<'a> IdentifierType<'a> {
19 fn to_str(self) -> &'static str {
20 match self {
21 IdentifierType::StructMember => "m",
22 IdentifierType::EnumVariant { .. } => "",
23 IdentifierType::FunctionArg => "a",
24 IdentifierType::Type => "",
25 IdentifierType::Enum => "",
26 }
27 }
28 }
29
30 /// A rule to apply to an identifier when generating bindings.
31 #[derive(Debug, Clone, Copy)]
32 pub enum RenameRule {
33 /// Do not apply any renaming. The default.
34 None,
35 /// Converts the identifier to PascalCase and adds a context dependent prefix
36 GeckoCase,
37 /// Converts the identifier to lower case.
38 LowerCase,
39 /// Converts the identifier to upper case.
40 UpperCase,
41 /// Converts the identifier to PascalCase.
42 PascalCase,
43 /// Converts the identifier to camelCase.
44 CamelCase,
45 /// Converts the identifier to snake_case.
46 SnakeCase,
47 /// Converts the identifier to SCREAMING_SNAKE_CASE.
48 ScreamingSnakeCase,
49 /// Converts the identifier to SCREAMING_SNAKE_CASE and prefixes enum variants
50 /// with the enum name.
51 QualifiedScreamingSnakeCase,
52 }
53
54 impl RenameRule {
55 pub(crate) fn not_none(self) -> Option<Self> {
56 match self {
57 RenameRule::None => None,
58 other => Some(other),
59 }
60 }
61
62 /// Applies the rename rule to a string
63 pub fn apply<'a>(self, text: &'a str, context: IdentifierType) -> Cow<'a, str> {
64 use heck::*;
65
66 if text.is_empty() {
67 return Cow::Borrowed(text);
68 }
69
70 Cow::Owned(match self {
71 RenameRule::None => return Cow::Borrowed(text),
72 RenameRule::GeckoCase => context.to_str().to_owned() + &text.to_upper_camel_case(),
73 RenameRule::LowerCase => text.to_lowercase(),
74 RenameRule::UpperCase => text.to_uppercase(),
75 RenameRule::PascalCase => text.to_pascal_case(),
76 RenameRule::CamelCase => text.to_lower_camel_case(),
77 RenameRule::SnakeCase => text.to_snake_case(),
78 RenameRule::ScreamingSnakeCase => text.to_shouty_snake_case(),
79 RenameRule::QualifiedScreamingSnakeCase => {
80 let mut result = String::new();
81
82 if let IdentifierType::EnumVariant { prefix } = context {
83 result.push_str(
84 &RenameRule::ScreamingSnakeCase.apply(prefix, IdentifierType::Enum),
85 );
86 result.push('_');
87 }
88
89 result.push_str(&RenameRule::ScreamingSnakeCase.apply(text, context));
90 result
91 }
92 })
93 }
94 }
95
96 impl Default for RenameRule {
97 fn default() -> RenameRule {
98 RenameRule::None
99 }
100 }
101
102 impl FromStr for RenameRule {
103 type Err = String;
104
105 fn from_str(s: &str) -> Result<RenameRule, Self::Err> {
106 match s {
107 "none" => Ok(RenameRule::None),
108 "None" => Ok(RenameRule::None),
109
110 "mGeckoCase" => Ok(RenameRule::GeckoCase),
111 "GeckoCase" => Ok(RenameRule::GeckoCase),
112 "gecko_case" => Ok(RenameRule::GeckoCase),
113
114 "lowercase" => Ok(RenameRule::LowerCase),
115 "LowerCase" => Ok(RenameRule::LowerCase),
116 "lower_case" => Ok(RenameRule::LowerCase),
117
118 "UPPERCASE" => Ok(RenameRule::UpperCase),
119 "UpperCase" => Ok(RenameRule::UpperCase),
120 "upper_case" => Ok(RenameRule::UpperCase),
121
122 "PascalCase" => Ok(RenameRule::PascalCase),
123 "pascal_case" => Ok(RenameRule::PascalCase),
124
125 "camelCase" => Ok(RenameRule::CamelCase),
126 "CamelCase" => Ok(RenameRule::CamelCase),
127 "camel_case" => Ok(RenameRule::CamelCase),
128
129 "snake_case" => Ok(RenameRule::SnakeCase),
130 "SnakeCase" => Ok(RenameRule::SnakeCase),
131
132 "SCREAMING_SNAKE_CASE" => Ok(RenameRule::ScreamingSnakeCase),
133 "ScreamingSnakeCase" => Ok(RenameRule::ScreamingSnakeCase),
134 "screaming_snake_case" => Ok(RenameRule::ScreamingSnakeCase),
135
136 "QUALIFIED_SCREAMING_SNAKE_CASE" => Ok(RenameRule::QualifiedScreamingSnakeCase),
137 "QualifiedScreamingSnakeCase" => Ok(RenameRule::QualifiedScreamingSnakeCase),
138 "qualified_screaming_snake_case" => Ok(RenameRule::QualifiedScreamingSnakeCase),
139
140 _ => Err(format!("Unrecognized RenameRule: '{}'.", s)),
141 }
142 }
143 }
144
145 deserialize_enum_str!(RenameRule);