Skip to main content

rbspy_ruby_structs/
lib.rs

1#![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}