blob: 3d970d83bccb93441fb32b4498508707fcdff6e9 [file] [log] [blame]
David Tolnay17e137f2020-05-08 15:55:28 -07001use crate::syntax::discriminant::DiscriminantSet;
David Tolnayc598a272020-08-29 15:10:18 -07002use crate::syntax::file::{Item, ItemForeignMod};
David Tolnay52759782020-05-03 23:59:40 -07003use crate::syntax::report::Errors;
David Tolnayeebe9b72020-04-14 16:32:18 -07004use crate::syntax::Atom::*;
David Tolnay7db73692019-10-20 14:51:12 -04005use crate::syntax::{
David Tolnayb7eb65e2020-11-27 20:00:53 -08006 attrs, error, Api, Array, Derive, Doc, Enum, ExternFn, ExternType, Impl, Include, IncludeKind,
David Tolnayee312322020-12-28 22:04:10 -08007 Lang, Lifetimes, Namespace, Pair, Receiver, Ref, RustName, Signature, SliceRef, Struct, Ty1,
8 Type, TypeAlias, Var, Variant,
David Tolnay7db73692019-10-20 14:51:12 -04009};
David Tolnay9a69d8a2020-11-16 09:16:41 -080010use proc_macro2::{Delimiter, Group, Span, TokenStream, TokenTree};
David Tolnaye2e303f2020-05-10 20:52:00 -070011use quote::{format_ident, quote, quote_spanned};
David Tolnaye2f9ec42020-05-07 16:19:33 -070012use syn::parse::{ParseStream, Parser};
David Tolnaye3a48152020-04-08 19:38:05 -070013use syn::punctuated::Punctuated;
David Tolnay7db73692019-10-20 14:51:12 -040014use syn::{
Xiangpeng Hao78762352020-11-12 10:24:18 +080015 Abi, Attribute, Error, Expr, Fields, FnArg, ForeignItem, ForeignItemFn, ForeignItemType,
David Tolnayee312322020-12-28 22:04:10 -080016 GenericArgument, GenericParam, Generics, Ident, ItemEnum, ItemImpl, ItemStruct, Lit, LitStr,
17 Pat, PathArguments, Result, ReturnType, Token, TraitBound, TraitBoundModifier,
David Tolnayb7eb65e2020-11-27 20:00:53 -080018 Type as RustType, TypeArray, TypeBareFn, TypeParamBound, TypePath, TypeReference,
David Tolnayd6143702020-12-29 23:48:09 -080019 Variant as RustVariant, Visibility,
David Tolnay7db73692019-10-20 14:51:12 -040020};
21
David Tolnaye3a48152020-04-08 19:38:05 -070022pub mod kw {
David Tolnayb27f7872020-11-15 15:07:04 -080023 syn::custom_keyword!(Pin);
David Tolnaye3a48152020-04-08 19:38:05 -070024 syn::custom_keyword!(Result);
25}
26
David Tolnayd7a3a182020-11-01 20:45:14 -080027pub fn parse_items(
28 cx: &mut Errors,
29 items: Vec<Item>,
30 trusted: bool,
31 namespace: &Namespace,
32) -> Vec<Api> {
David Tolnay7db73692019-10-20 14:51:12 -040033 let mut apis = Vec::new();
34 for item in items {
35 match item {
David Tolnay302b1752020-11-10 18:43:24 -080036 Item::Struct(item) => match parse_struct(cx, item, namespace) {
David Tolnay52759782020-05-03 23:59:40 -070037 Ok(strct) => apis.push(strct),
38 Err(err) => cx.push(err),
39 },
David Tolnay302b1752020-11-10 18:43:24 -080040 Item::Enum(item) => match parse_enum(cx, item, namespace) {
David Tolnay52759782020-05-03 23:59:40 -070041 Ok(enm) => apis.push(enm),
42 Err(err) => cx.push(err),
43 },
Adrian Taylorc8713432020-10-21 18:20:55 -070044 Item::ForeignMod(foreign_mod) => {
David Tolnayd7a3a182020-11-01 20:45:14 -080045 parse_foreign_mod(cx, foreign_mod, &mut apis, trusted, namespace)
Adrian Taylorc8713432020-10-21 18:20:55 -070046 }
David Tolnay313cc0a2020-11-24 21:47:01 -080047 Item::Impl(item) => match parse_impl(item) {
David Tolnay7e69f892020-10-03 22:20:22 -070048 Ok(imp) => apis.push(imp),
49 Err(err) => cx.push(err),
50 },
David Tolnay52759782020-05-03 23:59:40 -070051 Item::Use(item) => cx.error(item, error::USE_NOT_ALLOWED),
David Tolnay00a83852020-08-29 15:06:16 -070052 Item::Other(item) => cx.error(item, "unsupported item"),
David Tolnay7db73692019-10-20 14:51:12 -040053 }
54 }
David Tolnay52759782020-05-03 23:59:40 -070055 apis
David Tolnay7db73692019-10-20 14:51:12 -040056}
57
David Tolnay302b1752020-11-10 18:43:24 -080058fn parse_struct(cx: &mut Errors, item: ItemStruct, namespace: &Namespace) -> Result<Api> {
David Tolnay7db73692019-10-20 14:51:12 -040059 let mut doc = Doc::new();
60 let mut derives = Vec::new();
David Tolnay302b1752020-11-10 18:43:24 -080061 let mut namespace = namespace.clone();
David Tolnay885be132020-12-21 15:52:47 -080062 let mut cxx_name = None;
63 let mut rust_name = None;
David Tolnayb129ea72020-05-10 14:29:30 -070064 attrs::parse(
David Tolnay3e628882020-05-10 15:30:14 -070065 cx,
David Tolnayb129ea72020-05-10 14:29:30 -070066 &item.attrs,
67 attrs::Parser {
68 doc: Some(&mut doc),
69 derives: Some(&mut derives),
David Tolnayd7a3a182020-11-01 20:45:14 -080070 namespace: Some(&mut namespace),
David Tolnay885be132020-12-21 15:52:47 -080071 cxx_name: Some(&mut cxx_name),
72 rust_name: Some(&mut rust_name),
David Tolnayddf69e22020-05-10 22:08:20 -070073 ..Default::default()
David Tolnayb129ea72020-05-10 14:29:30 -070074 },
David Tolnay3e628882020-05-10 15:30:14 -070075 );
David Tolnay09462ac2020-03-20 14:58:41 -070076
David Tolnaybc954d92020-12-21 15:17:10 -080077 let generics = &item.generics;
78 if !generics.params.is_empty() || generics.where_clause.is_some() {
79 let struct_token = item.struct_token;
80 let ident = &item.ident;
81 let where_clause = &generics.where_clause;
82 let span = quote!(#struct_token #ident #generics #where_clause);
83 return Err(Error::new_spanned(
84 span,
85 "struct with generic parameters is not supported yet",
86 ));
87 }
88
David Tolnay302b1752020-11-10 18:43:24 -080089 let named_fields = match item.fields {
David Tolnay09462ac2020-03-20 14:58:41 -070090 Fields::Named(fields) => fields,
91 Fields::Unit => return Err(Error::new_spanned(item, "unit structs are not supported")),
92 Fields::Unnamed(_) => {
David Tolnay2c4b35f2020-10-04 21:22:30 -070093 return Err(Error::new_spanned(item, "tuple structs are not supported"));
David Tolnay09462ac2020-03-20 14:58:41 -070094 }
95 };
96
David Tolnay38c11212020-11-25 15:50:19 -080097 let mut fields = Vec::new();
98 for field in named_fields.named {
99 let ident = field.ident.unwrap();
David Tolnayb4a05c32020-12-30 15:37:01 -0800100 let mut doc = Doc::new();
101 attrs::parse(
102 cx,
103 &field.attrs,
104 attrs::Parser {
105 doc: Some(&mut doc),
106 ..Default::default()
107 },
108 );
David Tolnay38c11212020-11-25 15:50:19 -0800109 let ty = match parse_type(&field.ty) {
110 Ok(ty) => ty,
111 Err(err) => {
112 cx.push(err);
113 continue;
114 }
115 };
David Tolnay89902442020-12-30 15:10:40 -0800116 let visibility = Token![pub](match field.vis {
117 Visibility::Public(vis) => vis.pub_token.span,
118 Visibility::Crate(vis) => vis.crate_token.span,
119 Visibility::Restricted(vis) => vis.pub_token.span,
120 Visibility::Inherited => ident.span(),
121 });
122 fields.push(Var {
David Tolnayb4a05c32020-12-30 15:37:01 -0800123 doc,
David Tolnay89902442020-12-30 15:10:40 -0800124 visibility,
125 ident,
126 ty,
127 });
David Tolnay38c11212020-11-25 15:50:19 -0800128 }
David Tolnay302b1752020-11-10 18:43:24 -0800129
David Tolnay64343af2020-12-30 15:26:06 -0800130 let visibility = Token![pub](match item.vis {
131 Visibility::Public(vis) => vis.pub_token.span,
132 Visibility::Crate(vis) => vis.crate_token.span,
133 Visibility::Restricted(vis) => vis.pub_token.span,
134 Visibility::Inherited => item.ident.span(),
135 });
David Tolnayddbcb522020-12-21 15:24:45 -0800136 let struct_token = item.struct_token;
David Tolnay885be132020-12-21 15:52:47 -0800137 let name = pair(namespace, &item.ident, cxx_name, rust_name);
David Tolnayddbcb522020-12-21 15:24:45 -0800138 let brace_token = named_fields.brace_token;
139
David Tolnay09462ac2020-03-20 14:58:41 -0700140 Ok(Api::Struct(Struct {
141 doc,
142 derives,
David Tolnay64343af2020-12-30 15:26:06 -0800143 visibility,
David Tolnayddbcb522020-12-21 15:24:45 -0800144 struct_token,
145 name,
146 brace_token,
David Tolnay302b1752020-11-10 18:43:24 -0800147 fields,
David Tolnay09462ac2020-03-20 14:58:41 -0700148 }))
David Tolnay7db73692019-10-20 14:51:12 -0400149}
150
David Tolnay302b1752020-11-10 18:43:24 -0800151fn parse_enum(cx: &mut Errors, item: ItemEnum, namespace: &Namespace) -> Result<Api> {
David Tolnayddf69e22020-05-10 22:08:20 -0700152 let mut doc = Doc::new();
David Tolnayfbc46692020-11-27 11:33:29 -0800153 let mut derives = Vec::new();
David Tolnayddf69e22020-05-10 22:08:20 -0700154 let mut repr = None;
David Tolnay302b1752020-11-10 18:43:24 -0800155 let mut namespace = namespace.clone();
David Tolnay885be132020-12-21 15:52:47 -0800156 let mut cxx_name = None;
157 let mut rust_name = None;
David Tolnayddf69e22020-05-10 22:08:20 -0700158 attrs::parse(
159 cx,
160 &item.attrs,
161 attrs::Parser {
162 doc: Some(&mut doc),
David Tolnayfbc46692020-11-27 11:33:29 -0800163 derives: Some(&mut derives),
David Tolnayddf69e22020-05-10 22:08:20 -0700164 repr: Some(&mut repr),
David Tolnayd7a3a182020-11-01 20:45:14 -0800165 namespace: Some(&mut namespace),
David Tolnay885be132020-12-21 15:52:47 -0800166 cxx_name: Some(&mut cxx_name),
167 rust_name: Some(&mut rust_name),
David Tolnayddf69e22020-05-10 22:08:20 -0700168 ..Default::default()
169 },
170 );
Joel Galensonc03402a2020-04-23 17:31:09 -0700171
David Tolnaybc954d92020-12-21 15:17:10 -0800172 let generics = &item.generics;
173 if !generics.params.is_empty() || generics.where_clause.is_some() {
174 let enum_token = item.enum_token;
175 let ident = &item.ident;
176 let where_clause = &generics.where_clause;
177 let span = quote!(#enum_token #ident #generics #where_clause);
178 return Err(Error::new_spanned(
179 span,
180 "enums with generic parameters are not allowed",
181 ));
182 }
183
Joel Galenson88547732020-05-05 08:23:42 -0700184 let mut variants = Vec::new();
David Tolnayddf69e22020-05-10 22:08:20 -0700185 let mut discriminants = DiscriminantSet::new(repr);
Joel Galenson88547732020-05-05 08:23:42 -0700186 for variant in item.variants {
David Tolnay6bf9ef42020-12-21 16:11:40 -0800187 match parse_variant(cx, variant, &mut discriminants) {
David Tolnay26809232020-12-21 16:06:47 -0800188 Ok(variant) => variants.push(variant),
189 Err(err) => cx.push(err),
Joel Galensonc03402a2020-04-23 17:31:09 -0700190 }
191 }
192
David Tolnaye2e303f2020-05-10 20:52:00 -0700193 let enum_token = item.enum_token;
194 let brace_token = item.brace_token;
195
David Tolnay58eee392020-11-20 20:37:58 -0800196 let explicit_repr = repr.is_some();
David Tolnay0435a812020-05-10 21:58:15 -0700197 let mut repr = U8;
198 match discriminants.inferred_repr() {
199 Ok(inferred) => repr = inferred,
David Tolnaye2e303f2020-05-10 20:52:00 -0700200 Err(err) => {
201 let span = quote_spanned!(brace_token.span=> #enum_token {});
David Tolnay0435a812020-05-10 21:58:15 -0700202 cx.error(span, err);
203 variants.clear();
David Tolnaye2e303f2020-05-10 20:52:00 -0700204 }
David Tolnay0435a812020-05-10 21:58:15 -0700205 }
David Tolnaye2e303f2020-05-10 20:52:00 -0700206
David Tolnay885be132020-12-21 15:52:47 -0800207 let name = pair(namespace, &item.ident, cxx_name, rust_name);
David Tolnayddbcb522020-12-21 15:24:45 -0800208 let repr_ident = Ident::new(repr.as_ref(), Span::call_site());
209 let repr_type = Type::Ident(RustName::new(repr_ident));
David Tolnay9a69d8a2020-11-16 09:16:41 -0800210
Joel Galensonc03402a2020-04-23 17:31:09 -0700211 Ok(Api::Enum(Enum {
212 doc,
David Tolnayfbc46692020-11-27 11:33:29 -0800213 derives,
David Tolnaye2e303f2020-05-10 20:52:00 -0700214 enum_token,
David Tolnayddbcb522020-12-21 15:24:45 -0800215 name,
David Tolnaye2e303f2020-05-10 20:52:00 -0700216 brace_token,
David Tolnay7ae018f2020-05-05 10:11:30 -0700217 variants,
David Tolnaye2e303f2020-05-10 20:52:00 -0700218 repr,
David Tolnay9a69d8a2020-11-16 09:16:41 -0800219 repr_type,
David Tolnay58eee392020-11-20 20:37:58 -0800220 explicit_repr,
Joel Galensonc03402a2020-04-23 17:31:09 -0700221 }))
222}
223
David Tolnay6bf9ef42020-12-21 16:11:40 -0800224fn parse_variant(
225 cx: &mut Errors,
226 variant: RustVariant,
227 discriminants: &mut DiscriminantSet,
228) -> Result<Variant> {
David Tolnay4486f722020-12-30 00:01:26 -0800229 let mut doc = Doc::new();
David Tolnay6bf9ef42020-12-21 16:11:40 -0800230 let mut cxx_name = None;
231 let mut rust_name = None;
232 attrs::parse(
233 cx,
234 &variant.attrs,
235 attrs::Parser {
David Tolnay4486f722020-12-30 00:01:26 -0800236 doc: Some(&mut doc),
David Tolnay6bf9ef42020-12-21 16:11:40 -0800237 cxx_name: Some(&mut cxx_name),
238 rust_name: Some(&mut rust_name),
239 ..Default::default()
240 },
241 );
242
David Tolnay26809232020-12-21 16:06:47 -0800243 match variant.fields {
244 Fields::Unit => {}
245 _ => {
246 let msg = "enums with data are not supported yet";
247 return Err(Error::new_spanned(variant, msg));
248 }
249 }
250
251 let expr = variant.discriminant.as_ref().map(|(_, expr)| expr);
252 let try_discriminant = match &expr {
253 Some(lit) => discriminants.insert(lit),
254 None => discriminants.insert_next(),
255 };
256 let discriminant = match try_discriminant {
257 Ok(discriminant) => discriminant,
258 Err(err) => return Err(Error::new_spanned(variant, err)),
259 };
David Tolnaye6f62142020-12-21 16:00:41 -0800260
David Tolnay6bf9ef42020-12-21 16:11:40 -0800261 let name = pair(Namespace::ROOT, &variant.ident, cxx_name, rust_name);
David Tolnay26809232020-12-21 16:06:47 -0800262 let expr = variant.discriminant.map(|(_, expr)| expr);
263
264 Ok(Variant {
David Tolnay4486f722020-12-30 00:01:26 -0800265 doc,
David Tolnaye6f62142020-12-21 16:00:41 -0800266 name,
David Tolnay26809232020-12-21 16:06:47 -0800267 discriminant,
268 expr,
269 })
270}
271
David Tolnay805dca32020-08-29 19:09:55 -0700272fn parse_foreign_mod(
273 cx: &mut Errors,
274 foreign_mod: ItemForeignMod,
275 out: &mut Vec<Api>,
276 trusted: bool,
David Tolnayd7a3a182020-11-01 20:45:14 -0800277 namespace: &Namespace,
David Tolnay805dca32020-08-29 19:09:55 -0700278) {
David Tolnay3a451732020-08-29 18:54:55 -0700279 let lang = match parse_lang(&foreign_mod.abi) {
David Tolnay52759782020-05-03 23:59:40 -0700280 Ok(lang) => lang,
281 Err(err) => return cx.push(err),
282 };
David Tolnay7db73692019-10-20 14:51:12 -0400283
David Tolnay3a451732020-08-29 18:54:55 -0700284 match lang {
285 Lang::Rust => {
David Tolnay805dca32020-08-29 19:09:55 -0700286 if foreign_mod.unsafety.is_some() {
David Tolnay3a451732020-08-29 18:54:55 -0700287 let unsafety = foreign_mod.unsafety;
David Tolnay7be5b1f2020-11-11 10:48:32 -0800288 let abi = &foreign_mod.abi;
David Tolnay3a451732020-08-29 18:54:55 -0700289 let span = quote!(#unsafety #abi);
290 cx.error(span, "extern \"Rust\" block does not need to be unsafe");
291 }
292 }
293 Lang::Cxx => {}
294 }
295
David Tolnay805dca32020-08-29 19:09:55 -0700296 let trusted = trusted || foreign_mod.unsafety.is_some();
297
David Tolnay7feb2642020-11-10 18:49:04 -0800298 let mut namespace = namespace.clone();
299 attrs::parse(
300 cx,
301 &foreign_mod.attrs,
302 attrs::Parser {
303 namespace: Some(&mut namespace),
304 ..Default::default()
305 },
306 );
307
Joel Galensone1e969d2020-04-21 12:50:20 -0700308 let mut items = Vec::new();
309 for foreign in &foreign_mod.items {
310 match foreign {
Adrian Taylorc8713432020-10-21 18:20:55 -0700311 ForeignItem::Type(foreign) => {
David Tolnayf5ead102020-11-24 17:08:05 -0800312 let ety = parse_extern_type(cx, foreign, lang, trusted, &namespace);
313 items.push(ety);
Adrian Taylorc8713432020-10-21 18:20:55 -0700314 }
David Tolnay556738d2020-11-15 13:58:44 -0800315 ForeignItem::Fn(foreign) => {
316 match parse_extern_fn(cx, foreign, lang, trusted, &namespace) {
317 Ok(efn) => items.push(efn),
318 Err(err) => cx.push(err),
319 }
320 }
David Tolnay7db73692019-10-20 14:51:12 -0400321 ForeignItem::Macro(foreign) if foreign.mac.path.is_ident("include") => {
David Tolnay91e87fa2020-05-11 19:10:23 -0700322 match foreign.mac.parse_body_with(parse_include) {
David Tolnay52759782020-05-03 23:59:40 -0700323 Ok(include) => items.push(Api::Include(include)),
324 Err(err) => cx.push(err),
325 }
David Tolnay7db73692019-10-20 14:51:12 -0400326 }
Adrian Taylorc8713432020-10-21 18:20:55 -0700327 ForeignItem::Verbatim(tokens) => {
David Tolnayb7eb65e2020-11-27 20:00:53 -0800328 match parse_extern_verbatim(cx, tokens, lang, trusted, &namespace) {
Adrian Taylorc8713432020-10-21 18:20:55 -0700329 Ok(api) => items.push(api),
330 Err(err) => cx.push(err),
331 }
332 }
David Tolnay52759782020-05-03 23:59:40 -0700333 _ => cx.error(foreign, "unsupported foreign item"),
David Tolnay7db73692019-10-20 14:51:12 -0400334 }
335 }
David Tolnaya1f29c42020-04-22 18:01:38 -0700336
David Tolnay7be5b1f2020-11-11 10:48:32 -0800337 if !trusted
338 && items.iter().any(|api| match api {
339 Api::CxxFunction(efn) => efn.unsafety.is_none(),
340 _ => false,
341 })
342 {
343 cx.error(
344 foreign_mod.abi,
345 "block must be declared `unsafe extern \"C++\"` if it contains any safe-to-call C++ functions",
346 );
347 }
348
David Tolnaya1f29c42020-04-22 18:01:38 -0700349 let mut types = items.iter().filter_map(|item| match item {
David Tolnay17a934c2020-11-02 00:40:04 -0800350 Api::CxxType(ety) | Api::RustType(ety) => Some(&ety.name),
351 Api::TypeAlias(alias) => Some(&alias.name),
David Tolnaya1f29c42020-04-22 18:01:38 -0700352 _ => None,
353 });
354 if let (Some(single_type), None) = (types.next(), types.next()) {
David Tolnaye5a015a2020-05-07 21:54:26 -0700355 let single_type = single_type.clone();
David Tolnaya1f29c42020-04-22 18:01:38 -0700356 for item in &mut items {
357 if let Api::CxxFunction(efn) | Api::RustFunction(efn) = item {
358 if let Some(receiver) = &mut efn.receiver {
David Tolnay2d99b002020-12-21 14:34:35 -0800359 if receiver.ty.rust == "Self" {
360 receiver.ty.rust = single_type.rust.clone();
David Tolnaya1f29c42020-04-22 18:01:38 -0700361 }
362 }
363 }
364 }
365 }
366
David Tolnay52759782020-05-03 23:59:40 -0700367 out.extend(items);
David Tolnay7db73692019-10-20 14:51:12 -0400368}
369
David Tolnay3a451732020-08-29 18:54:55 -0700370fn parse_lang(abi: &Abi) -> Result<Lang> {
David Tolnay7db73692019-10-20 14:51:12 -0400371 let name = match &abi.name {
372 Some(name) => name,
373 None => {
374 return Err(Error::new_spanned(
375 abi,
David Tolnayc72a9f62020-11-11 10:56:26 -0800376 "ABI name is required, extern \"C++\" or extern \"Rust\"",
David Tolnay7db73692019-10-20 14:51:12 -0400377 ));
378 }
379 };
David Tolnayddbcb522020-12-21 15:24:45 -0800380
David Tolnay7db73692019-10-20 14:51:12 -0400381 match name.value().as_str() {
David Tolnayea25ac82020-11-11 10:35:23 -0800382 "C++" => Ok(Lang::Cxx),
David Tolnay7db73692019-10-20 14:51:12 -0400383 "Rust" => Ok(Lang::Rust),
David Tolnay2757ca82020-11-14 15:12:06 -0800384 _ => Err(Error::new_spanned(
385 abi,
386 "unrecognized ABI, requires either \"C++\" or \"Rust\"",
387 )),
David Tolnay7db73692019-10-20 14:51:12 -0400388 }
389}
390
David Tolnay00f236a2020-08-29 19:07:18 -0700391fn parse_extern_type(
392 cx: &mut Errors,
393 foreign_type: &ForeignItemType,
394 lang: Lang,
395 trusted: bool,
David Tolnay302b1752020-11-10 18:43:24 -0800396 namespace: &Namespace,
David Tolnayf5ead102020-11-24 17:08:05 -0800397) -> Api {
Adrian Taylorc8713432020-10-21 18:20:55 -0700398 let mut doc = Doc::new();
David Tolnay16e26202020-11-27 19:28:37 -0800399 let mut derives = Vec::new();
David Tolnay302b1752020-11-10 18:43:24 -0800400 let mut namespace = namespace.clone();
David Tolnay885be132020-12-21 15:52:47 -0800401 let mut cxx_name = None;
402 let mut rust_name = None;
Adrian Taylorc8713432020-10-21 18:20:55 -0700403 attrs::parse(
404 cx,
405 &foreign_type.attrs,
406 attrs::Parser {
407 doc: Some(&mut doc),
David Tolnay16e26202020-11-27 19:28:37 -0800408 derives: Some(&mut derives),
David Tolnayd7a3a182020-11-01 20:45:14 -0800409 namespace: Some(&mut namespace),
David Tolnay885be132020-12-21 15:52:47 -0800410 cxx_name: Some(&mut cxx_name),
411 rust_name: Some(&mut rust_name),
Adrian Taylorc8713432020-10-21 18:20:55 -0700412 ..Default::default()
413 },
414 );
David Tolnayddbcb522020-12-21 15:24:45 -0800415
David Tolnay7db73692019-10-20 14:51:12 -0400416 let type_token = foreign_type.type_token;
David Tolnay885be132020-12-21 15:52:47 -0800417 let name = pair(namespace, &foreign_type.ident, cxx_name, rust_name);
David Tolnayee312322020-12-28 22:04:10 -0800418 let generics = Lifetimes {
419 lt_token: None,
420 lifetimes: Punctuated::new(),
421 gt_token: None,
422 };
David Tolnayddbcb522020-12-21 15:24:45 -0800423 let colon_token = None;
424 let bounds = Vec::new();
David Tolnayc8361022020-08-25 21:57:53 -0700425 let semi_token = foreign_type.semi_token;
David Tolnayddbcb522020-12-21 15:24:45 -0800426
427 (match lang {
David Tolnay295ef6b2020-05-07 16:10:22 -0700428 Lang::Cxx => Api::CxxType,
429 Lang::Rust => Api::RustType,
David Tolnayddbcb522020-12-21 15:24:45 -0800430 })(ExternType {
David Tolnay16e26202020-11-27 19:28:37 -0800431 lang,
David Tolnay7db73692019-10-20 14:51:12 -0400432 doc,
David Tolnay16e26202020-11-27 19:28:37 -0800433 derives,
David Tolnay7db73692019-10-20 14:51:12 -0400434 type_token,
David Tolnayddbcb522020-12-21 15:24:45 -0800435 name,
David Tolnayee312322020-12-28 22:04:10 -0800436 generics,
David Tolnayddbcb522020-12-21 15:24:45 -0800437 colon_token,
438 bounds,
David Tolnayc8361022020-08-25 21:57:53 -0700439 semi_token,
David Tolnay00f236a2020-08-29 19:07:18 -0700440 trusted,
David Tolnayf5ead102020-11-24 17:08:05 -0800441 })
David Tolnay7db73692019-10-20 14:51:12 -0400442}
443
Adrian Taylorc8713432020-10-21 18:20:55 -0700444fn parse_extern_fn(
445 cx: &mut Errors,
446 foreign_fn: &ForeignItemFn,
447 lang: Lang,
David Tolnay556738d2020-11-15 13:58:44 -0800448 trusted: bool,
David Tolnay302b1752020-11-10 18:43:24 -0800449 namespace: &Namespace,
Adrian Taylorc8713432020-10-21 18:20:55 -0700450) -> Result<Api> {
David Tolnaybc954d92020-12-21 15:17:10 -0800451 let mut doc = Doc::new();
David Tolnaya2dfcbf2020-12-21 15:46:24 -0800452 let mut namespace = namespace.clone();
David Tolnaybc954d92020-12-21 15:17:10 -0800453 let mut cxx_name = None;
454 let mut rust_name = None;
David Tolnaybc954d92020-12-21 15:17:10 -0800455 attrs::parse(
456 cx,
457 &foreign_fn.attrs,
458 attrs::Parser {
459 doc: Some(&mut doc),
David Tolnaya2dfcbf2020-12-21 15:46:24 -0800460 namespace: Some(&mut namespace),
David Tolnaybc954d92020-12-21 15:17:10 -0800461 cxx_name: Some(&mut cxx_name),
462 rust_name: Some(&mut rust_name),
David Tolnaybc954d92020-12-21 15:17:10 -0800463 ..Default::default()
464 },
465 );
466
David Tolnay7db73692019-10-20 14:51:12 -0400467 let generics = &foreign_fn.sig.generics;
David Tolnay9938b642020-11-15 18:11:40 -0800468 if generics.where_clause.is_some()
469 || generics.params.iter().any(|param| match param {
470 GenericParam::Lifetime(lifetime) => !lifetime.bounds.is_empty(),
471 GenericParam::Type(_) | GenericParam::Const(_) => true,
472 })
473 {
David Tolnay7db73692019-10-20 14:51:12 -0400474 return Err(Error::new_spanned(
475 foreign_fn,
476 "extern function with generic parameters is not supported yet",
477 ));
478 }
David Tolnayddbcb522020-12-21 15:24:45 -0800479
David Tolnay7db73692019-10-20 14:51:12 -0400480 if let Some(variadic) = &foreign_fn.sig.variadic {
481 return Err(Error::new_spanned(
482 variadic,
483 "variadic function is not supported yet",
484 ));
485 }
David Tolnayddbcb522020-12-21 15:24:45 -0800486
David Tolnay8de461f2020-11-19 13:46:14 -0800487 if foreign_fn.sig.asyncness.is_some() {
488 return Err(Error::new_spanned(
489 foreign_fn,
490 "async function is not directly supported yet, but see https://cxx.rs/async.html for a working approach",
491 ));
492 }
David Tolnayddbcb522020-12-21 15:24:45 -0800493
David Tolnay80ef0682020-11-19 13:56:07 -0800494 if foreign_fn.sig.constness.is_some() {
495 return Err(Error::new_spanned(
496 foreign_fn,
497 "const extern function is not supported",
498 ));
499 }
David Tolnayddbcb522020-12-21 15:24:45 -0800500
David Tolnay80ef0682020-11-19 13:56:07 -0800501 if let Some(abi) = &foreign_fn.sig.abi {
502 return Err(Error::new_spanned(
503 abi,
504 "explicit ABI on extern function is not supported",
505 ));
506 }
David Tolnay7db73692019-10-20 14:51:12 -0400507
508 let mut receiver = None;
David Tolnaye3a48152020-04-08 19:38:05 -0700509 let mut args = Punctuated::new();
510 for arg in foreign_fn.sig.inputs.pairs() {
511 let (arg, comma) = arg.into_tuple();
David Tolnay7db73692019-10-20 14:51:12 -0400512 match arg {
David Tolnay1dd11a12020-04-22 12:31:48 -0700513 FnArg::Receiver(arg) => {
David Tolnaya1f29c42020-04-22 18:01:38 -0700514 if let Some((ampersand, lifetime)) = &arg.reference {
515 receiver = Some(Receiver {
David Tolnay9c76c392020-11-15 16:07:08 -0800516 pinned: false,
David Tolnaya1f29c42020-04-22 18:01:38 -0700517 ampersand: *ampersand,
518 lifetime: lifetime.clone(),
David Tolnay9c4ac2e2020-11-15 21:14:03 -0800519 mutable: arg.mutability.is_some(),
David Tolnaya1f29c42020-04-22 18:01:38 -0700520 var: arg.self_token,
David Tolnay2d99b002020-12-21 14:34:35 -0800521 ty: RustName::new(Ident::new("Self", arg.self_token.span)),
David Tolnaya1f29c42020-04-22 18:01:38 -0700522 shorthand: true,
David Tolnay9c76c392020-11-15 16:07:08 -0800523 pin_tokens: None,
David Tolnay9c4ac2e2020-11-15 21:14:03 -0800524 mutability: arg.mutability,
David Tolnaya1f29c42020-04-22 18:01:38 -0700525 });
526 continue;
Joel Galensone1e969d2020-04-21 12:50:20 -0700527 }
David Tolnay1dd11a12020-04-22 12:31:48 -0700528 return Err(Error::new_spanned(arg, "unsupported signature"));
David Tolnay7db73692019-10-20 14:51:12 -0400529 }
530 FnArg::Typed(arg) => {
531 let ident = match arg.pat.as_ref() {
532 Pat::Ident(pat) => pat.ident.clone(),
Joel Galensonba676072020-04-27 15:55:45 -0700533 Pat::Wild(pat) => {
David Tolnayb4c14552020-12-29 15:44:19 -0800534 Ident::new(&format!("arg{}", args.len()), pat.underscore_token.span)
Joel Galensonba676072020-04-27 15:55:45 -0700535 }
David Tolnay7db73692019-10-20 14:51:12 -0400536 _ => return Err(Error::new_spanned(arg, "unsupported signature")),
537 };
David Tolnay313cc0a2020-11-24 21:47:01 -0800538 let ty = parse_type(&arg.ty)?;
David Tolnay7db73692019-10-20 14:51:12 -0400539 if ident != "self" {
David Tolnayb4a05c32020-12-30 15:37:01 -0800540 let doc = Doc::new();
David Tolnay89902442020-12-30 15:10:40 -0800541 let visibility = Token![pub](ident.span());
542 args.push_value(Var {
David Tolnayb4a05c32020-12-30 15:37:01 -0800543 doc,
David Tolnay89902442020-12-30 15:10:40 -0800544 visibility,
545 ident,
546 ty,
547 });
David Tolnaye3a48152020-04-08 19:38:05 -0700548 if let Some(comma) = comma {
549 args.push_punct(*comma);
550 }
David Tolnay7db73692019-10-20 14:51:12 -0400551 continue;
552 }
553 if let Type::Ref(reference) = ty {
554 if let Type::Ident(ident) = reference.inner {
555 receiver = Some(Receiver {
David Tolnay9c76c392020-11-15 16:07:08 -0800556 pinned: reference.pinned,
David Tolnayfb6e3862020-04-20 01:33:23 -0700557 ampersand: reference.ampersand,
David Tolnay0bd50fa2020-04-22 15:31:33 -0700558 lifetime: reference.lifetime,
David Tolnay9c4ac2e2020-11-15 21:14:03 -0800559 mutable: reference.mutable,
Adrian Taylorc8713432020-10-21 18:20:55 -0700560 var: Token![self](ident.rust.span()),
David Tolnay05e11cc2020-04-20 02:13:56 -0700561 ty: ident,
David Tolnay62d360c2020-04-22 16:26:21 -0700562 shorthand: false,
David Tolnay9c76c392020-11-15 16:07:08 -0800563 pin_tokens: reference.pin_tokens,
David Tolnay9c4ac2e2020-11-15 21:14:03 -0800564 mutability: reference.mutability,
David Tolnay7db73692019-10-20 14:51:12 -0400565 });
566 continue;
567 }
568 }
569 return Err(Error::new_spanned(arg, "unsupported method receiver"));
570 }
571 }
572 }
David Tolnay59b7ede2020-03-16 00:30:23 -0700573
David Tolnaye3a48152020-04-08 19:38:05 -0700574 let mut throws_tokens = None;
David Tolnay313cc0a2020-11-24 21:47:01 -0800575 let ret = parse_return_type(&foreign_fn.sig.output, &mut throws_tokens)?;
David Tolnaye3a48152020-04-08 19:38:05 -0700576 let throws = throws_tokens.is_some();
David Tolnaybdb576c2020-09-06 23:45:55 -0700577 let unsafety = foreign_fn.sig.unsafety;
David Tolnay7db73692019-10-20 14:51:12 -0400578 let fn_token = foreign_fn.sig.fn_token;
David Tolnay6a990f82020-12-21 15:42:31 -0800579 let name = pair(namespace, &foreign_fn.sig.ident, cxx_name, rust_name);
David Tolnay9938b642020-11-15 18:11:40 -0800580 let generics = generics.clone();
David Tolnaye3a48152020-04-08 19:38:05 -0700581 let paren_token = foreign_fn.sig.paren_token;
David Tolnay7db73692019-10-20 14:51:12 -0400582 let semi_token = foreign_fn.semi_token;
David Tolnayddbcb522020-12-21 15:24:45 -0800583
584 Ok(match lang {
David Tolnay295ef6b2020-05-07 16:10:22 -0700585 Lang::Cxx => Api::CxxFunction,
586 Lang::Rust => Api::RustFunction,
David Tolnayddbcb522020-12-21 15:24:45 -0800587 }(ExternFn {
David Tolnay6cde49f2020-03-16 12:25:45 -0700588 lang,
David Tolnay7db73692019-10-20 14:51:12 -0400589 doc,
David Tolnay17a934c2020-11-02 00:40:04 -0800590 name,
David Tolnay16448732020-03-18 12:39:36 -0700591 sig: Signature {
David Tolnaybdb576c2020-09-06 23:45:55 -0700592 unsafety,
David Tolnay16448732020-03-18 12:39:36 -0700593 fn_token,
David Tolnay9938b642020-11-15 18:11:40 -0800594 generics,
David Tolnay16448732020-03-18 12:39:36 -0700595 receiver,
596 args,
597 ret,
598 throws,
David Tolnaye3a48152020-04-08 19:38:05 -0700599 paren_token,
600 throws_tokens,
David Tolnay16448732020-03-18 12:39:36 -0700601 },
David Tolnay7db73692019-10-20 14:51:12 -0400602 semi_token,
David Tolnay556738d2020-11-15 13:58:44 -0800603 trusted,
David Tolnay295ef6b2020-05-07 16:10:22 -0700604 }))
David Tolnay7db73692019-10-20 14:51:12 -0400605}
606
Adrian Taylorc8713432020-10-21 18:20:55 -0700607fn parse_extern_verbatim(
608 cx: &mut Errors,
609 tokens: &TokenStream,
610 lang: Lang,
David Tolnayb7eb65e2020-11-27 20:00:53 -0800611 trusted: bool,
David Tolnay302b1752020-11-10 18:43:24 -0800612 namespace: &Namespace,
Adrian Taylorc8713432020-10-21 18:20:55 -0700613) -> Result<Api> {
David Tolnayb7eb65e2020-11-27 20:00:53 -0800614 |input: ParseStream| -> Result<Api> {
David Tolnaye2f9ec42020-05-07 16:19:33 -0700615 let attrs = input.call(Attribute::parse_outer)?;
David Tolnayd6143702020-12-29 23:48:09 -0800616 input.parse::<Visibility>()?;
David Tolnaye2f9ec42020-05-07 16:19:33 -0700617 let type_token: Token![type] = match input.parse()? {
618 Some(type_token) => type_token,
619 None => {
620 let span = input.cursor().token_stream();
621 return Err(Error::new_spanned(span, "unsupported foreign item"));
622 }
623 };
624 let ident: Ident = input.parse()?;
David Tolnaye81647f2020-12-28 19:30:01 -0800625 let generics: Generics = input.parse()?;
David Tolnayee312322020-12-28 22:04:10 -0800626 let mut lifetimes = Punctuated::new();
David Tolnaye81647f2020-12-28 19:30:01 -0800627 let mut has_unsupported_generic_param = false;
David Tolnayee312322020-12-28 22:04:10 -0800628 for pair in generics.params.into_pairs() {
629 let (param, punct) = pair.into_tuple();
David Tolnaye81647f2020-12-28 19:30:01 -0800630 match param {
631 GenericParam::Lifetime(param) => {
632 if !param.bounds.is_empty() && !has_unsupported_generic_param {
633 let msg = "lifetime parameter with bounds is not supported yet";
634 cx.error(&param, msg);
635 has_unsupported_generic_param = true;
636 }
David Tolnayee312322020-12-28 22:04:10 -0800637 lifetimes.push_value(param.lifetime);
638 if let Some(punct) = punct {
639 lifetimes.push_punct(punct);
640 }
David Tolnaye81647f2020-12-28 19:30:01 -0800641 }
642 GenericParam::Type(param) => {
643 if !has_unsupported_generic_param {
644 let msg = "extern type with generic type parameter is not supported yet";
645 cx.error(&param, msg);
646 has_unsupported_generic_param = true;
647 }
648 }
649 GenericParam::Const(param) => {
650 if !has_unsupported_generic_param {
651 let msg = "extern type with const generic parameter is not supported yet";
652 cx.error(&param, msg);
653 has_unsupported_generic_param = true;
654 }
655 }
656 }
657 }
David Tolnayee312322020-12-28 22:04:10 -0800658 let lifetimes = Lifetimes {
659 lt_token: generics.lt_token,
660 lifetimes,
661 gt_token: generics.gt_token,
662 };
David Tolnayb7eb65e2020-11-27 20:00:53 -0800663 let lookahead = input.lookahead1();
664 if lookahead.peek(Token![=]) {
665 // type Alias = crate::path::to::Type;
David Tolnaye81647f2020-12-28 19:30:01 -0800666 parse_type_alias(
667 cx, attrs, type_token, ident, lifetimes, input, lang, namespace,
668 )
David Tolnaya870ac72020-12-28 19:48:33 -0800669 } else if lookahead.peek(Token![:]) || lookahead.peek(Token![;]) {
David Tolnayb7eb65e2020-11-27 20:00:53 -0800670 // type Opaque: Bound2 + Bound2;
671 parse_extern_type_bounded(
David Tolnaye81647f2020-12-28 19:30:01 -0800672 cx, attrs, type_token, ident, lifetimes, input, lang, trusted, namespace,
David Tolnayb7eb65e2020-11-27 20:00:53 -0800673 )
674 } else {
675 Err(lookahead.error())
David Tolnaye2f9ec42020-05-07 16:19:33 -0700676 }
677 }
David Tolnayb7eb65e2020-11-27 20:00:53 -0800678 .parse2(tokens.clone())
679}
680
681fn parse_type_alias(
682 cx: &mut Errors,
683 attrs: Vec<Attribute>,
684 type_token: Token![type],
685 ident: Ident,
David Tolnayee312322020-12-28 22:04:10 -0800686 generics: Lifetimes,
David Tolnayb7eb65e2020-11-27 20:00:53 -0800687 input: ParseStream,
688 lang: Lang,
689 namespace: &Namespace,
690) -> Result<Api> {
691 let eq_token: Token![=] = input.parse()?;
692 let ty: RustType = input.parse()?;
693 let semi_token: Token![;] = input.parse()?;
694
695 let mut doc = Doc::new();
696 let mut derives = Vec::new();
697 let mut namespace = namespace.clone();
David Tolnay885be132020-12-21 15:52:47 -0800698 let mut cxx_name = None;
699 let mut rust_name = None;
David Tolnayb7eb65e2020-11-27 20:00:53 -0800700 attrs::parse(
701 cx,
702 &attrs,
703 attrs::Parser {
704 doc: Some(&mut doc),
705 derives: Some(&mut derives),
706 namespace: Some(&mut namespace),
David Tolnay885be132020-12-21 15:52:47 -0800707 cxx_name: Some(&mut cxx_name),
708 rust_name: Some(&mut rust_name),
David Tolnayb7eb65e2020-11-27 20:00:53 -0800709 ..Default::default()
710 },
711 );
712
713 if lang == Lang::Rust {
714 let span = quote!(#type_token #semi_token);
715 let msg = "type alias in extern \"Rust\" block is not supported";
716 return Err(Error::new_spanned(span, msg));
717 }
718
David Tolnay885be132020-12-21 15:52:47 -0800719 let name = pair(namespace, &ident, cxx_name, rust_name);
David Tolnayddbcb522020-12-21 15:24:45 -0800720
David Tolnayb7eb65e2020-11-27 20:00:53 -0800721 Ok(Api::TypeAlias(TypeAlias {
722 doc,
723 derives,
724 type_token,
David Tolnayddbcb522020-12-21 15:24:45 -0800725 name,
David Tolnayee312322020-12-28 22:04:10 -0800726 generics,
David Tolnayb7eb65e2020-11-27 20:00:53 -0800727 eq_token,
728 ty,
729 semi_token,
730 }))
731}
732
733fn parse_extern_type_bounded(
734 cx: &mut Errors,
735 attrs: Vec<Attribute>,
736 type_token: Token![type],
737 ident: Ident,
David Tolnayee312322020-12-28 22:04:10 -0800738 generics: Lifetimes,
David Tolnayb7eb65e2020-11-27 20:00:53 -0800739 input: ParseStream,
740 lang: Lang,
741 trusted: bool,
742 namespace: &Namespace,
743) -> Result<Api> {
David Tolnayb7eb65e2020-11-27 20:00:53 -0800744 let mut bounds = Vec::new();
David Tolnaya870ac72020-12-28 19:48:33 -0800745 let colon_token: Option<Token![:]> = input.parse()?;
746 if colon_token.is_some() {
747 loop {
748 match input.parse()? {
749 TypeParamBound::Trait(TraitBound {
750 paren_token: None,
751 modifier: TraitBoundModifier::None,
752 lifetimes: None,
753 path,
754 }) if if let Some(derive) = path.get_ident().and_then(Derive::from) {
755 bounds.push(derive);
756 true
757 } else {
758 false
759 } => {}
760 bound @ TypeParamBound::Trait(_) | bound @ TypeParamBound::Lifetime(_) => {
761 cx.error(bound, "unsupported trait");
762 }
David Tolnayb7eb65e2020-11-27 20:00:53 -0800763 }
David Tolnayb7eb65e2020-11-27 20:00:53 -0800764
David Tolnaya870ac72020-12-28 19:48:33 -0800765 let lookahead = input.lookahead1();
766 if lookahead.peek(Token![+]) {
767 input.parse::<Token![+]>()?;
768 } else if lookahead.peek(Token![;]) {
769 break;
770 } else {
771 return Err(lookahead.error());
772 }
David Tolnayb7eb65e2020-11-27 20:00:53 -0800773 }
774 }
775 let semi_token: Token![;] = input.parse()?;
776
777 let mut doc = Doc::new();
778 let mut derives = Vec::new();
779 let mut namespace = namespace.clone();
David Tolnay885be132020-12-21 15:52:47 -0800780 let mut cxx_name = None;
781 let mut rust_name = None;
David Tolnayb7eb65e2020-11-27 20:00:53 -0800782 attrs::parse(
783 cx,
784 &attrs,
785 attrs::Parser {
786 doc: Some(&mut doc),
787 derives: Some(&mut derives),
788 namespace: Some(&mut namespace),
David Tolnay885be132020-12-21 15:52:47 -0800789 cxx_name: Some(&mut cxx_name),
790 rust_name: Some(&mut rust_name),
David Tolnayb7eb65e2020-11-27 20:00:53 -0800791 ..Default::default()
792 },
793 );
794
David Tolnay885be132020-12-21 15:52:47 -0800795 let name = pair(namespace, &ident, cxx_name, rust_name);
David Tolnayddbcb522020-12-21 15:24:45 -0800796
797 Ok(match lang {
David Tolnayb7eb65e2020-11-27 20:00:53 -0800798 Lang::Cxx => Api::CxxType,
799 Lang::Rust => Api::RustType,
David Tolnayddbcb522020-12-21 15:24:45 -0800800 }(ExternType {
David Tolnayb7eb65e2020-11-27 20:00:53 -0800801 lang,
802 doc,
803 derives,
804 type_token,
David Tolnayddbcb522020-12-21 15:24:45 -0800805 name,
David Tolnayee312322020-12-28 22:04:10 -0800806 generics,
David Tolnayddbcb522020-12-21 15:24:45 -0800807 colon_token,
David Tolnayb7eb65e2020-11-27 20:00:53 -0800808 bounds,
809 semi_token,
810 trusted,
811 }))
David Tolnaye2f9ec42020-05-07 16:19:33 -0700812}
813
David Tolnay313cc0a2020-11-24 21:47:01 -0800814fn parse_impl(imp: ItemImpl) -> Result<Api> {
David Tolnay7e69f892020-10-03 22:20:22 -0700815 if !imp.items.is_empty() {
816 let mut span = Group::new(Delimiter::Brace, TokenStream::new());
817 span.set_span(imp.brace_token.span);
818 return Err(Error::new_spanned(span, "expected an empty impl block"));
819 }
820
David Tolnay7e69f892020-10-03 22:20:22 -0700821 if let Some((bang, path, for_token)) = &imp.trait_ {
David Tolnay028d3d22020-11-29 18:09:52 -0800822 let self_ty = &imp.self_ty;
David Tolnay7e69f892020-10-03 22:20:22 -0700823 let span = quote!(#bang #path #for_token #self_ty);
824 return Err(Error::new_spanned(
825 span,
826 "unexpected impl, expected something like `impl UniquePtr<T> {}`",
827 ));
828 }
829
830 let generics = &imp.generics;
831 if !generics.params.is_empty() || generics.where_clause.is_some() {
832 return Err(Error::new_spanned(
833 imp,
834 "generic parameters on an impl is not supported",
835 ));
836 }
837
David Tolnay028d3d22020-11-29 18:09:52 -0800838 let mut negative_token = None;
839 let mut self_ty = *imp.self_ty;
840 if let RustType::Verbatim(ty) = &self_ty {
841 let mut iter = ty.clone().into_iter();
842 if let Some(TokenTree::Punct(punct)) = iter.next() {
843 if punct.as_char() == '!' {
844 let ty = iter.collect::<TokenStream>();
845 if !ty.is_empty() {
846 negative_token = Some(Token![!](punct.span()));
847 self_ty = syn::parse2(ty)?;
848 }
849 }
850 }
851 }
852
David Tolnayddbcb522020-12-21 15:24:45 -0800853 let impl_token = imp.impl_token;
854 let negative = negative_token.is_some();
855 let ty = parse_type(&self_ty)?;
856 let brace_token = imp.brace_token;
857
David Tolnay7e69f892020-10-03 22:20:22 -0700858 Ok(Api::Impl(Impl {
David Tolnayddbcb522020-12-21 15:24:45 -0800859 impl_token,
860 negative,
861 ty,
862 brace_token,
David Tolnay028d3d22020-11-29 18:09:52 -0800863 negative_token,
David Tolnay7e69f892020-10-03 22:20:22 -0700864 }))
865}
866
David Tolnayb0cd3272020-10-27 21:32:54 -0700867fn parse_include(input: ParseStream) -> Result<Include> {
David Tolnay91e87fa2020-05-11 19:10:23 -0700868 if input.peek(LitStr) {
David Tolnayb0cd3272020-10-27 21:32:54 -0700869 let lit: LitStr = input.parse()?;
870 let span = lit.span();
871 return Ok(Include {
872 path: lit.value(),
873 kind: IncludeKind::Quoted,
874 begin_span: span,
875 end_span: span,
876 });
David Tolnay91e87fa2020-05-11 19:10:23 -0700877 }
878
879 if input.peek(Token![<]) {
880 let mut path = String::new();
David Tolnayb0cd3272020-10-27 21:32:54 -0700881
David Tolnay2cc2e3a2020-10-28 13:12:35 -0700882 let langle: Token![<] = input.parse()?;
David Tolnay91e87fa2020-05-11 19:10:23 -0700883 while !input.is_empty() && !input.peek(Token![>]) {
884 let token: TokenTree = input.parse()?;
885 match token {
886 TokenTree::Ident(token) => path += &token.to_string(),
887 TokenTree::Literal(token)
888 if token
889 .to_string()
890 .starts_with(|ch: char| ch.is_ascii_digit()) =>
891 {
892 path += &token.to_string();
893 }
894 TokenTree::Punct(token) => path.push(token.as_char()),
895 _ => return Err(Error::new(token.span(), "unexpected token in include path")),
896 }
897 }
David Tolnayb0cd3272020-10-27 21:32:54 -0700898 let rangle: Token![>] = input.parse()?;
David Tolnayb0cd3272020-10-27 21:32:54 -0700899
900 return Ok(Include {
901 path,
902 kind: IncludeKind::Bracketed,
David Tolnay2cc2e3a2020-10-28 13:12:35 -0700903 begin_span: langle.span,
904 end_span: rangle.span,
David Tolnayb0cd3272020-10-27 21:32:54 -0700905 });
David Tolnay91e87fa2020-05-11 19:10:23 -0700906 }
907
908 Err(input.error("expected \"quoted/path/to\" or <bracketed/path/to>"))
909}
910
David Tolnay313cc0a2020-11-24 21:47:01 -0800911fn parse_type(ty: &RustType) -> Result<Type> {
David Tolnay59b7ede2020-03-16 00:30:23 -0700912 match ty {
David Tolnay313cc0a2020-11-24 21:47:01 -0800913 RustType::Reference(ty) => parse_type_reference(ty),
914 RustType::Path(ty) => parse_type_path(ty),
David Tolnay313cc0a2020-11-24 21:47:01 -0800915 RustType::Array(ty) => parse_type_array(ty),
916 RustType::BareFn(ty) => parse_type_fn(ty),
David Tolnayb40b9db2020-03-18 13:50:31 -0700917 RustType::Tuple(ty) if ty.elems.is_empty() => Ok(Type::Void(ty.paren_token.span)),
918 _ => Err(Error::new_spanned(ty, "unsupported type")),
919 }
920}
921
David Tolnay313cc0a2020-11-24 21:47:01 -0800922fn parse_type_reference(ty: &TypeReference) -> Result<Type> {
David Tolnayddbcb522020-12-21 15:24:45 -0800923 let ampersand = ty.and_token;
924 let lifetime = ty.lifetime.clone();
925 let mutable = ty.mutability.is_some();
926 let mutability = ty.mutability;
927
David Tolnaye0dca7b2020-11-25 17:18:57 -0800928 if let RustType::Slice(slice) = ty.elem.as_ref() {
929 let inner = parse_type(&slice.elem)?;
David Tolnayddbcb522020-12-21 15:24:45 -0800930 let bracket = slice.bracket_token;
David Tolnay69db8142020-11-25 17:49:25 -0800931 return Ok(Type::SliceRef(Box::new(SliceRef {
David Tolnayddbcb522020-12-21 15:24:45 -0800932 ampersand,
933 lifetime,
934 mutable,
935 bracket,
David Tolnay69db8142020-11-25 17:49:25 -0800936 inner,
David Tolnayddbcb522020-12-21 15:24:45 -0800937 mutability,
David Tolnay69db8142020-11-25 17:49:25 -0800938 })));
David Tolnaye0dca7b2020-11-25 17:18:57 -0800939 }
940
David Tolnay313cc0a2020-11-24 21:47:01 -0800941 let inner = parse_type(&ty.elem)?;
David Tolnayddbcb522020-12-21 15:24:45 -0800942 let pinned = false;
943 let pin_tokens = None;
944
945 Ok(match &inner {
Adrian Taylorc8713432020-10-21 18:20:55 -0700946 Type::Ident(ident) if ident.rust == "str" => {
David Tolnayb40b9db2020-03-18 13:50:31 -0700947 if ty.mutability.is_some() {
948 return Err(Error::new_spanned(ty, "unsupported type"));
949 } else {
950 Type::Str
David Tolnay7db73692019-10-20 14:51:12 -0400951 }
952 }
David Tolnayb40b9db2020-03-18 13:50:31 -0700953 _ => Type::Ref,
David Tolnayddbcb522020-12-21 15:24:45 -0800954 }(Box::new(Ref {
955 pinned,
956 ampersand,
957 lifetime,
958 mutable,
David Tolnayb40b9db2020-03-18 13:50:31 -0700959 inner,
David Tolnayddbcb522020-12-21 15:24:45 -0800960 pin_tokens,
961 mutability,
David Tolnayb40b9db2020-03-18 13:50:31 -0700962 })))
963}
964
David Tolnay313cc0a2020-11-24 21:47:01 -0800965fn parse_type_path(ty: &TypePath) -> Result<Type> {
David Tolnayb40b9db2020-03-18 13:50:31 -0700966 let path = &ty.path;
967 if ty.qself.is_none() && path.leading_colon.is_none() && path.segments.len() == 1 {
968 let segment = &path.segments[0];
969 let ident = segment.ident.clone();
970 match &segment.arguments {
David Tolnay75ea17c2020-12-06 21:08:34 -0800971 PathArguments::None => return Ok(Type::Ident(RustName::new(ident))),
David Tolnayb40b9db2020-03-18 13:50:31 -0700972 PathArguments::AngleBracketed(generic) => {
973 if ident == "UniquePtr" && generic.args.len() == 1 {
974 if let GenericArgument::Type(arg) = &generic.args[0] {
David Tolnay313cc0a2020-11-24 21:47:01 -0800975 let inner = parse_type(arg)?;
David Tolnayb40b9db2020-03-18 13:50:31 -0700976 return Ok(Type::UniquePtr(Box::new(Ty1 {
David Tolnayda71ef62020-11-02 00:36:00 -0800977 name: ident,
David Tolnayb40b9db2020-03-18 13:50:31 -0700978 langle: generic.lt_token,
979 inner,
980 rangle: generic.gt_token,
981 })));
982 }
David Tolnayb3b24a12020-12-01 15:27:43 -0800983 } else if ident == "SharedPtr" && generic.args.len() == 1 {
984 if let GenericArgument::Type(arg) = &generic.args[0] {
985 let inner = parse_type(arg)?;
986 return Ok(Type::SharedPtr(Box::new(Ty1 {
987 name: ident,
988 langle: generic.lt_token,
989 inner,
990 rangle: generic.gt_token,
991 })));
992 }
David Tolnay215e77f2020-12-28 17:09:48 -0800993 } else if ident == "WeakPtr" && generic.args.len() == 1 {
994 if let GenericArgument::Type(arg) = &generic.args[0] {
995 let inner = parse_type(arg)?;
996 return Ok(Type::WeakPtr(Box::new(Ty1 {
997 name: ident,
998 langle: generic.lt_token,
999 inner,
1000 rangle: generic.gt_token,
1001 })));
1002 }
David Tolnaye1dcdf72020-04-24 17:40:55 -07001003 } else if ident == "CxxVector" && generic.args.len() == 1 {
Myron Ahneba35cf2020-02-05 19:41:51 +07001004 if let GenericArgument::Type(arg) = &generic.args[0] {
David Tolnay313cc0a2020-11-24 21:47:01 -08001005 let inner = parse_type(arg)?;
David Tolnay4377a9e2020-04-24 15:20:26 -07001006 return Ok(Type::CxxVector(Box::new(Ty1 {
David Tolnayda71ef62020-11-02 00:36:00 -08001007 name: ident,
Myron Ahneba35cf2020-02-05 19:41:51 +07001008 langle: generic.lt_token,
1009 inner,
1010 rangle: generic.gt_token,
1011 })));
1012 }
David Tolnayb40b9db2020-03-18 13:50:31 -07001013 } else if ident == "Box" && generic.args.len() == 1 {
1014 if let GenericArgument::Type(arg) = &generic.args[0] {
David Tolnay313cc0a2020-11-24 21:47:01 -08001015 let inner = parse_type(arg)?;
David Tolnayb40b9db2020-03-18 13:50:31 -07001016 return Ok(Type::RustBox(Box::new(Ty1 {
David Tolnayda71ef62020-11-02 00:36:00 -08001017 name: ident,
David Tolnayb40b9db2020-03-18 13:50:31 -07001018 langle: generic.lt_token,
1019 inner,
1020 rangle: generic.gt_token,
1021 })));
1022 }
Myron Ahneba35cf2020-02-05 19:41:51 +07001023 } else if ident == "Vec" && generic.args.len() == 1 {
1024 if let GenericArgument::Type(arg) = &generic.args[0] {
David Tolnay313cc0a2020-11-24 21:47:01 -08001025 let inner = parse_type(arg)?;
Myron Ahneba35cf2020-02-05 19:41:51 +07001026 return Ok(Type::RustVec(Box::new(Ty1 {
David Tolnayda71ef62020-11-02 00:36:00 -08001027 name: ident,
Myron Ahneba35cf2020-02-05 19:41:51 +07001028 langle: generic.lt_token,
1029 inner,
1030 rangle: generic.gt_token,
1031 })));
1032 }
David Tolnaycbc2a4b2020-11-15 15:08:44 -08001033 } else if ident == "Pin" && generic.args.len() == 1 {
1034 if let GenericArgument::Type(arg) = &generic.args[0] {
David Tolnay313cc0a2020-11-24 21:47:01 -08001035 let inner = parse_type(arg)?;
David Tolnayc94035a2020-11-15 16:49:18 -08001036 let pin_token = kw::Pin(ident.span());
David Tolnaycbc2a4b2020-11-15 15:08:44 -08001037 if let Type::Ref(mut inner) = inner {
David Tolnaycbc2a4b2020-11-15 15:08:44 -08001038 inner.pinned = true;
1039 inner.pin_tokens =
1040 Some((pin_token, generic.lt_token, generic.gt_token));
1041 return Ok(Type::Ref(inner));
1042 }
1043 }
David Tolnayb40b9db2020-03-18 13:50:31 -07001044 }
1045 }
1046 PathArguments::Parenthesized(_) => {}
David Tolnayfb134ed2020-03-15 23:17:48 -07001047 }
David Tolnay7db73692019-10-20 14:51:12 -04001048 }
David Tolnayddbcb522020-12-21 15:24:45 -08001049
David Tolnay7db73692019-10-20 14:51:12 -04001050 Err(Error::new_spanned(ty, "unsupported type"))
1051}
1052
David Tolnay313cc0a2020-11-24 21:47:01 -08001053fn parse_type_array(ty: &TypeArray) -> Result<Type> {
1054 let inner = parse_type(&ty.elem)?;
David Tolnayd9f97842020-11-24 21:00:05 -08001055
1056 let len_expr = if let Expr::Lit(lit) = &ty.len {
1057 lit
1058 } else {
1059 let msg = "unsupported expression, array length must be an integer literal";
1060 return Err(Error::new_spanned(&ty.len, msg));
1061 };
1062
1063 let len_token = if let Lit::Int(int) = &len_expr.lit {
1064 int.clone()
1065 } else {
1066 let msg = "array length must be an integer literal";
1067 return Err(Error::new_spanned(len_expr, msg));
1068 };
1069
David Tolnay581f72d2020-11-25 15:48:59 -08001070 let len = len_token.base10_parse::<usize>()?;
1071 if len == 0 {
1072 let msg = "array with zero size is not supported";
1073 return Err(Error::new_spanned(ty, msg));
1074 }
1075
David Tolnayd9f97842020-11-24 21:00:05 -08001076 let bracket = ty.bracket_token;
1077 let semi_token = ty.semi_token;
David Tolnayd9f97842020-11-24 21:00:05 -08001078
1079 Ok(Type::Array(Box::new(Array {
1080 bracket,
1081 inner,
1082 semi_token,
1083 len,
1084 len_token,
1085 })))
David Tolnay2d0df232020-11-24 20:50:32 -08001086}
1087
David Tolnay313cc0a2020-11-24 21:47:01 -08001088fn parse_type_fn(ty: &TypeBareFn) -> Result<Type> {
David Tolnayc071b892020-03-18 16:59:53 -07001089 if ty.lifetimes.is_some() {
1090 return Err(Error::new_spanned(
1091 ty,
1092 "function pointer with lifetime parameters is not supported yet",
1093 ));
1094 }
David Tolnayddbcb522020-12-21 15:24:45 -08001095
David Tolnayc071b892020-03-18 16:59:53 -07001096 if ty.variadic.is_some() {
1097 return Err(Error::new_spanned(
1098 ty,
1099 "variadic function pointer is not supported yet",
1100 ));
1101 }
David Tolnayddbcb522020-12-21 15:24:45 -08001102
David Tolnayc071b892020-03-18 16:59:53 -07001103 let args = ty
1104 .inputs
1105 .iter()
1106 .enumerate()
1107 .map(|(i, arg)| {
David Tolnay313cc0a2020-11-24 21:47:01 -08001108 let ty = parse_type(&arg.ty)?;
David Tolnayc071b892020-03-18 16:59:53 -07001109 let ident = match &arg.name {
1110 Some(ident) => ident.0.clone(),
David Tolnayb4c14552020-12-29 15:44:19 -08001111 None => format_ident!("arg{}", i),
David Tolnayc071b892020-03-18 16:59:53 -07001112 };
David Tolnayb4a05c32020-12-30 15:37:01 -08001113 let doc = Doc::new();
David Tolnay89902442020-12-30 15:10:40 -08001114 let visibility = Token![pub](ident.span());
1115 Ok(Var {
David Tolnayb4a05c32020-12-30 15:37:01 -08001116 doc,
David Tolnay89902442020-12-30 15:10:40 -08001117 visibility,
1118 ident,
1119 ty,
1120 })
David Tolnayc071b892020-03-18 16:59:53 -07001121 })
1122 .collect::<Result<_>>()?;
David Tolnayddbcb522020-12-21 15:24:45 -08001123
David Tolnaye3a48152020-04-08 19:38:05 -07001124 let mut throws_tokens = None;
David Tolnay313cc0a2020-11-24 21:47:01 -08001125 let ret = parse_return_type(&ty.output, &mut throws_tokens)?;
David Tolnaye3a48152020-04-08 19:38:05 -07001126 let throws = throws_tokens.is_some();
David Tolnayddbcb522020-12-21 15:24:45 -08001127
1128 let unsafety = ty.unsafety;
1129 let fn_token = ty.fn_token;
1130 let generics = Generics::default();
1131 let receiver = None;
1132 let paren_token = ty.paren_token;
1133
David Tolnayc071b892020-03-18 16:59:53 -07001134 Ok(Type::Fn(Box::new(Signature {
David Tolnayddbcb522020-12-21 15:24:45 -08001135 unsafety,
1136 fn_token,
1137 generics,
1138 receiver,
David Tolnayc071b892020-03-18 16:59:53 -07001139 args,
1140 ret,
1141 throws,
David Tolnayddbcb522020-12-21 15:24:45 -08001142 paren_token,
David Tolnaye3a48152020-04-08 19:38:05 -07001143 throws_tokens,
David Tolnayc071b892020-03-18 16:59:53 -07001144 })))
1145}
1146
David Tolnaye3a48152020-04-08 19:38:05 -07001147fn parse_return_type(
1148 ty: &ReturnType,
1149 throws_tokens: &mut Option<(kw::Result, Token![<], Token![>])>,
1150) -> Result<Option<Type>> {
David Tolnayc071b892020-03-18 16:59:53 -07001151 let mut ret = match ty {
1152 ReturnType::Default => return Ok(None),
1153 ReturnType::Type(_, ret) => ret.as_ref(),
1154 };
David Tolnayddbcb522020-12-21 15:24:45 -08001155
David Tolnayc071b892020-03-18 16:59:53 -07001156 if let RustType::Path(ty) = ret {
1157 let path = &ty.path;
1158 if ty.qself.is_none() && path.leading_colon.is_none() && path.segments.len() == 1 {
1159 let segment = &path.segments[0];
1160 let ident = segment.ident.clone();
1161 if let PathArguments::AngleBracketed(generic) = &segment.arguments {
1162 if ident == "Result" && generic.args.len() == 1 {
1163 if let GenericArgument::Type(arg) = &generic.args[0] {
1164 ret = arg;
David Tolnaye3a48152020-04-08 19:38:05 -07001165 *throws_tokens =
1166 Some((kw::Result(ident.span()), generic.lt_token, generic.gt_token));
David Tolnayc071b892020-03-18 16:59:53 -07001167 }
1168 }
1169 }
1170 }
1171 }
David Tolnayddbcb522020-12-21 15:24:45 -08001172
David Tolnay313cc0a2020-11-24 21:47:01 -08001173 match parse_type(ret)? {
David Tolnayc071b892020-03-18 16:59:53 -07001174 Type::Void(_) => Ok(None),
1175 ty => Ok(Some(ty)),
1176 }
1177}
David Tolnay6a990f82020-12-21 15:42:31 -08001178
1179fn pair(namespace: Namespace, default: &Ident, cxx: Option<Ident>, rust: Option<Ident>) -> Pair {
1180 let default = || default.clone();
David Tolnayc2a4c782020-12-21 15:55:31 -08001181 Pair {
David Tolnay6a990f82020-12-21 15:42:31 -08001182 namespace,
David Tolnayc2a4c782020-12-21 15:55:31 -08001183 cxx: cxx.unwrap_or_else(default),
1184 rust: rust.unwrap_or_else(default),
1185 }
David Tolnay6a990f82020-12-21 15:42:31 -08001186}