rbspy_ruby_structs/
lib.rs1#![allow(deref_nullptr)]
2#![allow(non_camel_case_types)]
3#![allow(non_snake_case)]
4#![allow(non_upper_case_globals)]
5#![allow(unnecessary_transmutes)]
6pub mod ruby_1_9_1_0;
7pub mod ruby_1_9_2_0;
8pub mod ruby_1_9_3_0;
9pub mod ruby_2_0_0_0;
10pub mod ruby_2_1_0;
11pub mod ruby_2_1_1;
12pub mod ruby_2_1_10;
13pub mod ruby_2_1_2;
14pub mod ruby_2_1_3;
15pub mod ruby_2_1_4;
16pub mod ruby_2_1_5;
17pub mod ruby_2_1_6;
18pub mod ruby_2_1_7;
19pub mod ruby_2_1_8;
20pub mod ruby_2_1_9;
21pub mod ruby_2_2_0;
22pub mod ruby_2_2_1;
23pub mod ruby_2_2_10;
24pub mod ruby_2_2_2;
25pub mod ruby_2_2_3;
26pub mod ruby_2_2_4;
27pub mod ruby_2_2_5;
28pub mod ruby_2_2_6;
29pub mod ruby_2_2_7;
30pub mod ruby_2_2_8;
31pub mod ruby_2_2_9;
32pub mod ruby_2_3_0;
33pub mod ruby_2_3_1;
34pub mod ruby_2_3_2;
35pub mod ruby_2_3_3;
36pub mod ruby_2_3_4;
37pub mod ruby_2_3_5;
38pub mod ruby_2_3_6;
39pub mod ruby_2_3_7;
40pub mod ruby_2_3_8;
41pub mod ruby_2_4_0;
42pub mod ruby_2_4_1;
43pub mod ruby_2_4_10;
44pub mod ruby_2_4_2;
45pub mod ruby_2_4_3;
46pub mod ruby_2_4_4;
47pub mod ruby_2_4_5;
48pub mod ruby_2_4_6;
49pub mod ruby_2_4_7;
50pub mod ruby_2_4_8;
51pub mod ruby_2_4_9;
52pub mod ruby_2_5_0;
53pub mod ruby_2_5_1;
54pub mod ruby_2_5_2;
55pub mod ruby_2_5_3;
56pub mod ruby_2_5_4;
57pub mod ruby_2_5_5;
58pub mod ruby_2_5_6;
59pub mod ruby_2_5_7;
60pub mod ruby_2_5_8;
61pub mod ruby_2_5_9;
62pub mod ruby_2_6_0;
63pub mod ruby_2_6_1;
64pub mod ruby_2_6_10;
65pub mod ruby_2_6_2;
66pub mod ruby_2_6_3;
67pub mod ruby_2_6_4;
68pub mod ruby_2_6_5;
69pub mod ruby_2_6_6;
70pub mod ruby_2_6_7;
71pub mod ruby_2_6_8;
72pub mod ruby_2_6_9;
73pub mod ruby_2_7_0;
74pub mod ruby_2_7_1;
75pub mod ruby_2_7_2;
76pub mod ruby_2_7_3;
77pub mod ruby_2_7_4;
78pub mod ruby_2_7_5;
79pub mod ruby_2_7_6;
80pub mod ruby_2_7_7;
81pub mod ruby_2_7_8;
82pub mod ruby_3_0_0;
83pub mod ruby_3_0_1;
84pub mod ruby_3_0_2;
85pub mod ruby_3_0_3;
86pub mod ruby_3_0_4;
87pub mod ruby_3_0_5;
88pub mod ruby_3_0_6;
89pub mod ruby_3_0_7;
90pub mod ruby_3_1_0;
91pub mod ruby_3_1_1;
92pub mod ruby_3_1_2;
93pub mod ruby_3_1_3;
94pub mod ruby_3_1_4;
95pub mod ruby_3_1_5;
96pub mod ruby_3_1_6;
97pub mod ruby_3_1_7;
98pub mod ruby_3_2_0;
99pub mod ruby_3_2_1;
100pub mod ruby_3_2_10;
101pub mod ruby_3_2_11;
102pub mod ruby_3_2_2;
103pub mod ruby_3_2_3;
104pub mod ruby_3_2_4;
105pub mod ruby_3_2_5;
106pub mod ruby_3_2_6;
107pub mod ruby_3_2_7;
108pub mod ruby_3_2_8;
109pub mod ruby_3_2_9;
110pub mod ruby_3_3_0;
111pub mod ruby_3_3_1;
112pub mod ruby_3_3_10;
113pub mod ruby_3_3_11;
114pub mod ruby_3_3_12;
115pub mod ruby_3_3_13;
116pub mod ruby_3_3_14;
117pub mod ruby_3_3_2;
118pub mod ruby_3_3_3;
119pub mod ruby_3_3_4;
120pub mod ruby_3_3_5;
121pub mod ruby_3_3_6;
122pub mod ruby_3_3_7;
123pub mod ruby_3_3_8;
124pub mod ruby_3_3_9;
125pub mod ruby_3_4_0;
126pub mod ruby_3_4_1;
127pub mod ruby_3_4_10;
128pub mod ruby_3_4_11;
129pub mod ruby_3_4_12;
130pub mod ruby_3_4_13;
131pub mod ruby_3_4_2;
132pub mod ruby_3_4_3;
133pub mod ruby_3_4_4;
134pub mod ruby_3_4_5;
135pub mod ruby_3_4_6;
136pub mod ruby_3_4_7;
137pub mod ruby_3_4_8;
138pub mod ruby_3_4_9;
139pub mod ruby_4_0_0;
140pub mod ruby_4_0_1;
141pub mod ruby_4_0_10;
142pub mod ruby_4_0_2;
143pub mod ruby_4_0_3;
144pub mod ruby_4_0_4;
145pub mod ruby_4_0_5;
146pub mod ruby_4_0_6;
147pub mod ruby_4_0_7;
148pub mod ruby_4_0_8;
149pub mod ruby_4_0_9;
150
151#[cfg(test)]
152mod tests {
153 use syn::{spanned::Spanned, visit::Visit};
154
155 #[derive(Default)]
156 struct BoolFields {
157 lines: Vec<usize>,
158 }
159
160 impl<'ast> Visit<'ast> for BoolFields {
161 fn visit_field(&mut self, field: &'ast syn::Field) {
162 if let syn::Type::Path(ty) = &field.ty {
163 if ty.qself.is_none() && ty.path.is_ident("bool") {
164 self.lines.push(field.span().start().line);
165 }
166 }
167 syn::visit::visit_field(self, field);
168 }
169 }
170
171 fn bool_field_lines(source: &str) -> syn::Result<Vec<usize>> {
172 let syntax = syn::parse_file(source)?;
173 let mut fields = BoolFields::default();
174 fields.visit_file(&syntax);
175 Ok(fields.lines)
176 }
177
178 #[test]
179 fn detects_bool_fields_regardless_of_formatting() {
180 let source = concat!(
181 "struct Example {\n",
182 "\tpub\tr#type: bool ,\n",
183 " pub Flag:\n",
184 " /* comment */ bool,\n",
185 "}\n",
186 "union Either { pub enabled: bool, pub byte: u8 }\n",
187 "struct Tuple(pub bool);\n",
188 );
189 assert_eq!(bool_field_lines(source).unwrap(), vec![2, 3, 6, 7]);
190 }
191
192 #[test]
193 fn ignores_bool_parameters_returns_and_comments() {
194 let source = r#"
195// pub misleading: bool,
196struct Example {
197 pub enabled: u8,
198 pub callback: unsafe extern "C" fn(bool) -> bool,
199}
200impl Example {
201 pub fn set_bit(&mut self, val: bool) {}
202 pub fn enabled(&self) -> bool { true }
203}
204"#;
205 assert!(bool_field_lines(source).unwrap().is_empty());
206 }
207
208 #[test]
209 fn bindings_have_no_bool_fields() -> std::io::Result<()> {
210 let source = std::path::Path::new(env!("CARGO_MANIFEST_DIR")).join("src");
211 let mut violations = Vec::new();
212 let mut files_checked = 0;
213 for entry in std::fs::read_dir(source)? {
214 let path = entry?.path();
215 let name = path.file_name().unwrap().to_string_lossy();
216 if !name.starts_with("ruby_") || !name.ends_with(".rs") {
217 continue;
218 }
219 files_checked += 1;
220 let contents = std::fs::read_to_string(&path)?;
221 let lines = bool_field_lines(&contents)
222 .unwrap_or_else(|error| panic!("Failed to parse {}: {error}", path.display()));
223 for line in lines {
224 violations.push(format!("{}:{line}", path.display()));
225 }
226 }
227 assert!(files_checked > 0, "No Ruby binding files were checked");
228 violations.sort();
229 assert!(
230 violations.is_empty(),
231 "Ruby bindings must use u8 instead of bool fields so every byte value is valid. \
232 Regenerate with the current xtask or replace these fields with u8:\n{}",
233 violations.join("\n")
234 );
235 Ok(())
236 }
237}