WIP
This commit is contained in:
parent
d3265f3251
commit
17b11d1a25
22
Cargo.toml
22
Cargo.toml
@ -11,22 +11,24 @@ repository = "https://github.com/ruma/ruma-api-macros"
|
||||
version = "0.1.0"
|
||||
|
||||
[dependencies]
|
||||
quote = "0.3.15"
|
||||
ruma-api = "0.4.0"
|
||||
synom = "0.11.3"
|
||||
quote = "0.5.2"
|
||||
ruma-api = "0.5.0"
|
||||
|
||||
[dependencies.syn]
|
||||
version = "0.13.4"
|
||||
features = ["full"]
|
||||
version = "0.11.11"
|
||||
|
||||
[dependencies.proc-macro2]
|
||||
version = "0.3.8"
|
||||
features = ["nightly"]
|
||||
|
||||
[dev-dependencies]
|
||||
futures = "0.1.14"
|
||||
hyper = "0.11"
|
||||
serde = "1.0.8"
|
||||
serde_derive = "1.0.8"
|
||||
serde_json = "1.0.2"
|
||||
futures = "0.1.21"
|
||||
serde = "1.0.45"
|
||||
serde_derive = "1.0.45"
|
||||
serde_json = "1.0.17"
|
||||
serde_urlencoded = "0.5.1"
|
||||
url = "1.5.1"
|
||||
url = "1.7.0"
|
||||
|
||||
[lib]
|
||||
proc-macro = true
|
||||
|
@ -1,4 +1,5 @@
|
||||
use quote::{ToTokens, Tokens};
|
||||
use syn::synom::Synom;
|
||||
use syn::{Expr, Ident};
|
||||
|
||||
#[derive(Debug)]
|
||||
@ -11,6 +12,55 @@ pub struct Metadata {
|
||||
pub requires_authentication: Tokens,
|
||||
}
|
||||
|
||||
impl Synom for Metadata {
|
||||
named!(parse -> Self, do_parse!(
|
||||
ident: syn!(Ident) >>
|
||||
cond_reduce!(ident == "description") >>
|
||||
punct!(:) >>
|
||||
description: syn!(Expr) >>
|
||||
punct!(,) >>
|
||||
|
||||
ident: syn!(Ident) >>
|
||||
cond_reduce!(ident == "method") >>
|
||||
punct!(:) >>
|
||||
method: syn!(Expr) >>
|
||||
punct!(,) >>
|
||||
|
||||
ident: syn!(Ident) >>
|
||||
cond_reduce!(ident == "name") >>
|
||||
punct!(:) >>
|
||||
name: syn!(Expr) >>
|
||||
punct!(,) >>
|
||||
|
||||
ident: syn!(Ident) >>
|
||||
cond_reduce!(ident == "path") >>
|
||||
punct!(:) >>
|
||||
path: syn!(Expr) >>
|
||||
punct!(,) >>
|
||||
|
||||
ident: syn!(Ident) >>
|
||||
cond_reduce!(ident == "rate_limited") >>
|
||||
punct!(:) >>
|
||||
rate_limited: syn!(Expr) >>
|
||||
punct!(,) >>
|
||||
|
||||
ident: syn!(Ident) >>
|
||||
cond_reduce!(ident == "requires_authentication") >>
|
||||
punct!(:) >>
|
||||
requires_authentication: syn!(Expr) >>
|
||||
punct!(,) >>
|
||||
|
||||
(Metadata {
|
||||
description,
|
||||
method,
|
||||
name,
|
||||
path,
|
||||
rate_limited,
|
||||
requires_authentication,
|
||||
})
|
||||
));
|
||||
}
|
||||
|
||||
impl From<Vec<(Ident, Expr)>> for Metadata {
|
||||
fn from(fields: Vec<(Ident, Expr)>) -> Self {
|
||||
let mut description = None;
|
||||
|
632
src/api/mod.rs
632
src/api/mod.rs
@ -1,35 +1,39 @@
|
||||
use std::convert::{TryFrom, TryInto};
|
||||
|
||||
use quote::{ToTokens, Tokens};
|
||||
use syn::{Field, MetaItem};
|
||||
use syn::punctuated::Pair;
|
||||
use syn::synom::Synom;
|
||||
use syn::{Expr, Field, Ident, Meta};
|
||||
|
||||
mod metadata;
|
||||
mod request;
|
||||
mod response;
|
||||
|
||||
use parse::Entry;
|
||||
// use parse::Entry;
|
||||
use self::metadata::Metadata;
|
||||
use self::request::Request;
|
||||
use self::response::Response;
|
||||
|
||||
pub fn strip_serde_attrs(field: &Field) -> Field {
|
||||
let mut field = field.clone();
|
||||
// pub fn strip_serde_attrs(field: &Field) -> Field {
|
||||
// let mut field = field.clone();
|
||||
|
||||
field.attrs = field.attrs.into_iter().filter(|attr| {
|
||||
let (attr_ident, _) = match attr.value {
|
||||
MetaItem::List(ref attr_ident, _) => {
|
||||
(attr_ident, ())
|
||||
}
|
||||
_ => return true,
|
||||
};
|
||||
// field.attrs = field.attrs.into_iter().filter(|attr| {
|
||||
// let (attr_ident, _) = match attr.value {
|
||||
// Meta::List(ref attr_ident, _) => {
|
||||
// (attr_ident, ())
|
||||
// }
|
||||
// _ => return true,
|
||||
// };
|
||||
|
||||
if attr_ident != "serde" {
|
||||
return true;
|
||||
}
|
||||
// if attr_ident != "serde" {
|
||||
// return true;
|
||||
// }
|
||||
|
||||
false
|
||||
}).collect();
|
||||
// false
|
||||
// }).collect();
|
||||
|
||||
field
|
||||
}
|
||||
// field
|
||||
// }
|
||||
|
||||
#[derive(Debug)]
|
||||
pub struct Api {
|
||||
@ -38,291 +42,333 @@ pub struct Api {
|
||||
response: Response,
|
||||
}
|
||||
|
||||
impl ToTokens for Api {
|
||||
fn to_tokens(&self, tokens: &mut Tokens) {
|
||||
let description = &self.metadata.description;
|
||||
let method = &self.metadata.method;
|
||||
let name = &self.metadata.name;
|
||||
let path = &self.metadata.path;
|
||||
let rate_limited = &self.metadata.rate_limited;
|
||||
let requires_authentication = &self.metadata.requires_authentication;
|
||||
impl TryFrom<Vec<Expr>> for Api {
|
||||
type Error = &'static str;
|
||||
|
||||
let request_types = {
|
||||
let mut tokens = Tokens::new();
|
||||
self.request.to_tokens(&mut tokens);
|
||||
tokens
|
||||
};
|
||||
let response_types = {
|
||||
let mut tokens = Tokens::new();
|
||||
self.response.to_tokens(&mut tokens);
|
||||
tokens
|
||||
};
|
||||
|
||||
let set_request_path = if self.request.has_path_fields() {
|
||||
let path_str_quoted = path.as_str();
|
||||
assert!(
|
||||
path_str_quoted.starts_with('"') && path_str_quoted.ends_with('"'),
|
||||
"path needs to be a string literal"
|
||||
);
|
||||
|
||||
let path_str = &path_str_quoted[1 .. path_str_quoted.len() - 1];
|
||||
|
||||
assert!(path_str.starts_with('/'), "path needs to start with '/'");
|
||||
assert!(
|
||||
path_str.chars().filter(|c| *c == ':').count() == self.request.path_field_count(),
|
||||
"number of declared path parameters needs to match amount of placeholders in path"
|
||||
);
|
||||
|
||||
let request_path_init_fields = self.request.request_path_init_fields();
|
||||
|
||||
let mut tokens = quote! {
|
||||
let request_path = RequestPath {
|
||||
#request_path_init_fields
|
||||
};
|
||||
|
||||
// This `unwrap()` can only fail when the url is a
|
||||
// cannot-be-base url like `mailto:` or `data:`, which is not
|
||||
// the case for our placeholder url.
|
||||
let mut path_segments = url.path_segments_mut().unwrap();
|
||||
};
|
||||
|
||||
for segment in path_str[1..].split('/') {
|
||||
tokens.append(quote! {
|
||||
path_segments.push
|
||||
});
|
||||
|
||||
tokens.append("(");
|
||||
|
||||
if segment.starts_with(':') {
|
||||
tokens.append("&request_path.");
|
||||
tokens.append(&segment[1..]);
|
||||
tokens.append(".to_string()");
|
||||
} else {
|
||||
tokens.append("\"");
|
||||
tokens.append(segment);
|
||||
tokens.append("\"");
|
||||
}
|
||||
|
||||
tokens.append(");");
|
||||
}
|
||||
|
||||
tokens
|
||||
} else {
|
||||
quote! {
|
||||
url.set_path(metadata.path);
|
||||
}
|
||||
};
|
||||
|
||||
let set_request_query = if self.request.has_query_fields() {
|
||||
let request_query_init_fields = self.request.request_query_init_fields();
|
||||
|
||||
quote! {
|
||||
let request_query = RequestQuery {
|
||||
#request_query_init_fields
|
||||
};
|
||||
|
||||
url.set_query(Some(&::serde_urlencoded::to_string(request_query)?));
|
||||
}
|
||||
} else {
|
||||
Tokens::new()
|
||||
};
|
||||
|
||||
let add_body_to_request = if let Some(field) = self.request.newtype_body_field() {
|
||||
let field_name = field.ident.as_ref().expect("expected body field to have a name");
|
||||
|
||||
quote! {
|
||||
let request_body = RequestBody(request.#field_name);
|
||||
|
||||
hyper_request.set_body(::serde_json::to_vec(&request_body)?);
|
||||
}
|
||||
} else if self.request.has_body_fields() {
|
||||
let request_body_init_fields = self.request.request_body_init_fields();
|
||||
|
||||
quote! {
|
||||
let request_body = RequestBody {
|
||||
#request_body_init_fields
|
||||
};
|
||||
|
||||
hyper_request.set_body(::serde_json::to_vec(&request_body)?);
|
||||
}
|
||||
} else {
|
||||
Tokens::new()
|
||||
};
|
||||
|
||||
let deserialize_response_body = if let Some(field) = self.response.newtype_body_field() {
|
||||
let field_type = &field.ty;
|
||||
let mut tokens = Tokens::new();
|
||||
|
||||
tokens.append(quote! {
|
||||
let future_response = hyper_response.body()
|
||||
.fold::<_, _, Result<_, ::std::io::Error>>(Vec::new(), |mut bytes, chunk| {
|
||||
bytes.write_all(&chunk)?;
|
||||
|
||||
Ok(bytes)
|
||||
})
|
||||
.map_err(::ruma_api::Error::from)
|
||||
.and_then(|bytes| {
|
||||
::serde_json::from_slice::<#field_type>(bytes.as_slice())
|
||||
.map_err(::ruma_api::Error::from)
|
||||
})
|
||||
});
|
||||
|
||||
tokens.append(".and_then(move |response_body| {");
|
||||
|
||||
tokens
|
||||
} else if self.response.has_body_fields() {
|
||||
let mut tokens = Tokens::new();
|
||||
|
||||
tokens.append(quote! {
|
||||
let future_response = hyper_response.body()
|
||||
.fold::<_, _, Result<_, ::std::io::Error>>(Vec::new(), |mut bytes, chunk| {
|
||||
bytes.write_all(&chunk)?;
|
||||
|
||||
Ok(bytes)
|
||||
})
|
||||
.map_err(::ruma_api::Error::from)
|
||||
.and_then(|bytes| {
|
||||
::serde_json::from_slice::<ResponseBody>(bytes.as_slice())
|
||||
.map_err(::ruma_api::Error::from)
|
||||
})
|
||||
});
|
||||
|
||||
tokens.append(".and_then(move |response_body| {");
|
||||
|
||||
tokens
|
||||
} else {
|
||||
let mut tokens = Tokens::new();
|
||||
|
||||
tokens.append(quote! {
|
||||
let future_response = ::futures::future::ok(())
|
||||
});
|
||||
|
||||
tokens.append(".and_then(move |_| {");
|
||||
|
||||
tokens
|
||||
};
|
||||
|
||||
let mut closure_end = Tokens::new();
|
||||
closure_end.append("});");
|
||||
|
||||
let extract_headers = if self.response.has_header_fields() {
|
||||
quote! {
|
||||
let mut headers = hyper_response.headers().clone();
|
||||
}
|
||||
} else {
|
||||
Tokens::new()
|
||||
};
|
||||
|
||||
let response_init_fields = if self.response.has_fields() {
|
||||
self.response.init_fields()
|
||||
} else {
|
||||
Tokens::new()
|
||||
};
|
||||
|
||||
tokens.append(quote! {
|
||||
#[allow(unused_imports)]
|
||||
use std::io::Write as _Write;
|
||||
|
||||
#[allow(unused_imports)]
|
||||
use ::futures::{Future as _Future, Stream as _Stream};
|
||||
use ::ruma_api::Endpoint as _RumaApiEndpoint;
|
||||
|
||||
/// The API endpoint.
|
||||
#[derive(Debug)]
|
||||
pub struct Endpoint;
|
||||
|
||||
#request_types
|
||||
|
||||
impl ::std::convert::TryFrom<Request> for ::hyper::Request {
|
||||
type Error = ::ruma_api::Error;
|
||||
|
||||
#[allow(unused_mut, unused_variables)]
|
||||
fn try_from(request: Request) -> Result<Self, Self::Error> {
|
||||
let metadata = Endpoint::METADATA;
|
||||
|
||||
// Use dummy homeserver url which has to be overwritten in
|
||||
// the calling code. Previously (with hyper::Uri) this was
|
||||
// not required, but Url::parse only accepts absolute urls.
|
||||
let mut url = ::url::Url::parse("http://invalid-host-please-change/").unwrap();
|
||||
|
||||
{ #set_request_path }
|
||||
{ #set_request_query }
|
||||
|
||||
let mut hyper_request = ::hyper::Request::new(
|
||||
metadata.method,
|
||||
// Every valid URL is a valid URI
|
||||
url.into_string().parse().unwrap(),
|
||||
);
|
||||
|
||||
{ #add_body_to_request }
|
||||
|
||||
Ok(hyper_request)
|
||||
}
|
||||
}
|
||||
|
||||
#response_types
|
||||
|
||||
impl ::futures::future::FutureFrom<::hyper::Response> for Response {
|
||||
type Future = Box<_Future<Item = Self, Error = Self::Error>>;
|
||||
type Error = ::ruma_api::Error;
|
||||
|
||||
#[allow(unused_variables)]
|
||||
fn future_from(hyper_response: ::hyper::Response)
|
||||
-> Box<_Future<Item = Self, Error = Self::Error>> {
|
||||
#extract_headers
|
||||
|
||||
#deserialize_response_body
|
||||
|
||||
let response = Response {
|
||||
#response_init_fields
|
||||
};
|
||||
|
||||
Ok(response)
|
||||
#closure_end
|
||||
|
||||
Box::new(future_response)
|
||||
}
|
||||
}
|
||||
|
||||
impl ::ruma_api::Endpoint for Endpoint {
|
||||
type Request = Request;
|
||||
type Response = Response;
|
||||
|
||||
const METADATA: ::ruma_api::Metadata = ::ruma_api::Metadata {
|
||||
description: #description,
|
||||
method: ::hyper::#method,
|
||||
name: #name,
|
||||
path: #path,
|
||||
rate_limited: #rate_limited,
|
||||
requires_authentication: #requires_authentication,
|
||||
};
|
||||
}
|
||||
});
|
||||
}
|
||||
}
|
||||
|
||||
impl From<Vec<Entry>> for Api {
|
||||
fn from(entries: Vec<Entry>) -> Api {
|
||||
if entries.len() != 3 {
|
||||
panic!("ruma_api! expects 3 blocks: metadata, request, and response");
|
||||
fn try_from(exprs: Vec<Expr>) -> Result<Self, Self::Error> {
|
||||
if exprs.len() != 3 {
|
||||
return Err("ruma_api! expects 3 blocks: metadata, request, and response");
|
||||
}
|
||||
|
||||
let mut metadata = None;
|
||||
let mut request = None;
|
||||
let mut response = None;
|
||||
|
||||
for entry in entries {
|
||||
match entry {
|
||||
Entry::Metadata(fields) => metadata = Some(Metadata::from(fields)),
|
||||
Entry::Request(fields) => request = Some(Request::from(fields)),
|
||||
Entry::Response(fields) => response = Some(Response::from(fields)),
|
||||
for expr in exprs {
|
||||
let expr = match expr {
|
||||
Expr::Struct(expr) => expr,
|
||||
_ => return Err("ruma_api! blocks should use struct syntax"),
|
||||
};
|
||||
|
||||
let segments = expr.path.segments;
|
||||
|
||||
if segments.len() != 1 {
|
||||
return Err("ruma_api! blocks must be one of: metadata, request, or response");
|
||||
}
|
||||
|
||||
let Pair::End(last_segment) = segments.last().unwrap();
|
||||
|
||||
match last_segment.ident.as_ref() {
|
||||
"metadata" => metadata = Some(expr.try_into()?),
|
||||
"request" => request = Some(expr.try_into()?),
|
||||
"response" => response = Some(expr.try_into()?),
|
||||
_ => return Err("ruma_api! blocks must be one of: metadata, request, or response"),
|
||||
}
|
||||
}
|
||||
|
||||
Api {
|
||||
metadata: metadata.expect("ruma_api! is missing metadata"),
|
||||
request: request.expect("ruma_api! is missing request"),
|
||||
response: response.expect("ruma_api! is missing response"),
|
||||
if metadata.is_none() {
|
||||
return Err("ruma_api! is missing metadata");
|
||||
}
|
||||
|
||||
if request.is_none() {
|
||||
return Err("ruma_api! is missing request");
|
||||
}
|
||||
|
||||
if response.is_none() {
|
||||
return Err("ruma_api! is missing response");
|
||||
}
|
||||
|
||||
Ok(Api {
|
||||
metadata: metadata.unwrap(),
|
||||
request: request.unwrap(),
|
||||
response: response.unwrap(),
|
||||
})
|
||||
|
||||
}
|
||||
}
|
||||
|
||||
pub struct Exprs {
|
||||
pub inner: Vec<Expr>,
|
||||
}
|
||||
|
||||
impl Synom for Exprs {
|
||||
named!(parse -> Self, do_parse!(
|
||||
exprs: many0!(syn!(Expr)) >>
|
||||
(Exprs {
|
||||
inner: exprs,
|
||||
})
|
||||
));
|
||||
}
|
||||
// impl ToTokens for Api {
|
||||
// fn to_tokens(&self, tokens: &mut Tokens) {
|
||||
// let description = &self.metadata.description;
|
||||
// let method = &self.metadata.method;
|
||||
// let name = &self.metadata.name;
|
||||
// let path = &self.metadata.path;
|
||||
// let rate_limited = &self.metadata.rate_limited;
|
||||
// let requires_authentication = &self.metadata.requires_authentication;
|
||||
|
||||
// let request_types = {
|
||||
// let mut tokens = Tokens::new();
|
||||
// self.request.to_tokens(&mut tokens);
|
||||
// tokens
|
||||
// };
|
||||
// let response_types = {
|
||||
// let mut tokens = Tokens::new();
|
||||
// self.response.to_tokens(&mut tokens);
|
||||
// tokens
|
||||
// };
|
||||
|
||||
// let set_request_path = if self.request.has_path_fields() {
|
||||
// let path_str_quoted = path.as_str();
|
||||
// assert!(
|
||||
// path_str_quoted.starts_with('"') && path_str_quoted.ends_with('"'),
|
||||
// "path needs to be a string literal"
|
||||
// );
|
||||
|
||||
// let path_str = &path_str_quoted[1 .. path_str_quoted.len() - 1];
|
||||
|
||||
// assert!(path_str.starts_with('/'), "path needs to start with '/'");
|
||||
// assert!(
|
||||
// path_str.chars().filter(|c| *c == ':').count() == self.request.path_field_count(),
|
||||
// "number of declared path parameters needs to match amount of placeholders in path"
|
||||
// );
|
||||
|
||||
// let request_path_init_fields = self.request.request_path_init_fields();
|
||||
|
||||
// let mut tokens = quote! {
|
||||
// let request_path = RequestPath {
|
||||
// #request_path_init_fields
|
||||
// };
|
||||
|
||||
// // This `unwrap()` can only fail when the url is a
|
||||
// // cannot-be-base url like `mailto:` or `data:`, which is not
|
||||
// // the case for our placeholder url.
|
||||
// let mut path_segments = url.path_segments_mut().unwrap();
|
||||
// };
|
||||
|
||||
// for segment in path_str[1..].split('/') {
|
||||
// tokens.append(quote! {
|
||||
// path_segments.push
|
||||
// });
|
||||
|
||||
// tokens.append("(");
|
||||
|
||||
// if segment.starts_with(':') {
|
||||
// tokens.append("&request_path.");
|
||||
// tokens.append(&segment[1..]);
|
||||
// tokens.append(".to_string()");
|
||||
// } else {
|
||||
// tokens.append("\"");
|
||||
// tokens.append(segment);
|
||||
// tokens.append("\"");
|
||||
// }
|
||||
|
||||
// tokens.append(");");
|
||||
// }
|
||||
|
||||
// tokens
|
||||
// } else {
|
||||
// quote! {
|
||||
// url.set_path(metadata.path);
|
||||
// }
|
||||
// };
|
||||
|
||||
// let set_request_query = if self.request.has_query_fields() {
|
||||
// let request_query_init_fields = self.request.request_query_init_fields();
|
||||
|
||||
// quote! {
|
||||
// let request_query = RequestQuery {
|
||||
// #request_query_init_fields
|
||||
// };
|
||||
|
||||
// url.set_query(Some(&::serde_urlencoded::to_string(request_query)?));
|
||||
// }
|
||||
// } else {
|
||||
// Tokens::new()
|
||||
// };
|
||||
|
||||
// let add_body_to_request = if let Some(field) = self.request.newtype_body_field() {
|
||||
// let field_name = field.ident.as_ref().expect("expected body field to have a name");
|
||||
|
||||
// quote! {
|
||||
// let request_body = RequestBody(request.#field_name);
|
||||
|
||||
// hyper_request.set_body(::serde_json::to_vec(&request_body)?);
|
||||
// }
|
||||
// } else if self.request.has_body_fields() {
|
||||
// let request_body_init_fields = self.request.request_body_init_fields();
|
||||
|
||||
// quote! {
|
||||
// let request_body = RequestBody {
|
||||
// #request_body_init_fields
|
||||
// };
|
||||
|
||||
// hyper_request.set_body(::serde_json::to_vec(&request_body)?);
|
||||
// }
|
||||
// } else {
|
||||
// Tokens::new()
|
||||
// };
|
||||
|
||||
// let deserialize_response_body = if let Some(field) = self.response.newtype_body_field() {
|
||||
// let field_type = &field.ty;
|
||||
// let mut tokens = Tokens::new();
|
||||
|
||||
// tokens.append(quote! {
|
||||
// let future_response = hyper_response.body()
|
||||
// .fold::<_, _, Result<_, ::std::io::Error>>(Vec::new(), |mut bytes, chunk| {
|
||||
// bytes.write_all(&chunk)?;
|
||||
|
||||
// Ok(bytes)
|
||||
// })
|
||||
// .map_err(::ruma_api::Error::from)
|
||||
// .and_then(|bytes| {
|
||||
// ::serde_json::from_slice::<#field_type>(bytes.as_slice())
|
||||
// .map_err(::ruma_api::Error::from)
|
||||
// })
|
||||
// });
|
||||
|
||||
// tokens.append(".and_then(move |response_body| {");
|
||||
|
||||
// tokens
|
||||
// } else if self.response.has_body_fields() {
|
||||
// let mut tokens = Tokens::new();
|
||||
|
||||
// tokens.append(quote! {
|
||||
// let future_response = hyper_response.body()
|
||||
// .fold::<_, _, Result<_, ::std::io::Error>>(Vec::new(), |mut bytes, chunk| {
|
||||
// bytes.write_all(&chunk)?;
|
||||
|
||||
// Ok(bytes)
|
||||
// })
|
||||
// .map_err(::ruma_api::Error::from)
|
||||
// .and_then(|bytes| {
|
||||
// ::serde_json::from_slice::<ResponseBody>(bytes.as_slice())
|
||||
// .map_err(::ruma_api::Error::from)
|
||||
// })
|
||||
// });
|
||||
|
||||
// tokens.append(".and_then(move |response_body| {");
|
||||
|
||||
// tokens
|
||||
// } else {
|
||||
// let mut tokens = Tokens::new();
|
||||
|
||||
// tokens.append(quote! {
|
||||
// let future_response = ::futures::future::ok(())
|
||||
// });
|
||||
|
||||
// tokens.append(".and_then(move |_| {");
|
||||
|
||||
// tokens
|
||||
// };
|
||||
|
||||
// let mut closure_end = Tokens::new();
|
||||
// closure_end.append("});");
|
||||
|
||||
// let extract_headers = if self.response.has_header_fields() {
|
||||
// quote! {
|
||||
// let mut headers = hyper_response.headers().clone();
|
||||
// }
|
||||
// } else {
|
||||
// Tokens::new()
|
||||
// };
|
||||
|
||||
// let response_init_fields = if self.response.has_fields() {
|
||||
// self.response.init_fields()
|
||||
// } else {
|
||||
// Tokens::new()
|
||||
// };
|
||||
|
||||
// tokens.append(quote! {
|
||||
// #[allow(unused_imports)]
|
||||
// use std::io::Write as _Write;
|
||||
|
||||
// #[allow(unused_imports)]
|
||||
// use ::futures::{Future as _Future, Stream as _Stream};
|
||||
// use ::ruma_api::Endpoint as _RumaApiEndpoint;
|
||||
|
||||
// /// The API endpoint.
|
||||
// #[derive(Debug)]
|
||||
// pub struct Endpoint;
|
||||
|
||||
// #request_types
|
||||
|
||||
// impl ::std::convert::TryFrom<Request> for ::hyper::Request {
|
||||
// type Error = ::ruma_api::Error;
|
||||
|
||||
// #[allow(unused_mut, unused_variables)]
|
||||
// fn try_from(request: Request) -> Result<Self, Self::Error> {
|
||||
// let metadata = Endpoint::METADATA;
|
||||
|
||||
// // Use dummy homeserver url which has to be overwritten in
|
||||
// // the calling code. Previously (with hyper::Uri) this was
|
||||
// // not required, but Url::parse only accepts absolute urls.
|
||||
// let mut url = ::url::Url::parse("http://invalid-host-please-change/").unwrap();
|
||||
|
||||
// { #set_request_path }
|
||||
// { #set_request_query }
|
||||
|
||||
// let mut hyper_request = ::hyper::Request::new(
|
||||
// metadata.method,
|
||||
// // Every valid URL is a valid URI
|
||||
// url.into_string().parse().unwrap(),
|
||||
// );
|
||||
|
||||
// { #add_body_to_request }
|
||||
|
||||
// Ok(hyper_request)
|
||||
// }
|
||||
// }
|
||||
|
||||
// #response_types
|
||||
|
||||
// impl ::futures::future::FutureFrom<::hyper::Response> for Response {
|
||||
// type Future = Box<_Future<Item = Self, Error = Self::Error>>;
|
||||
// type Error = ::ruma_api::Error;
|
||||
|
||||
// #[allow(unused_variables)]
|
||||
// fn future_from(hyper_response: ::hyper::Response)
|
||||
// -> Box<_Future<Item = Self, Error = Self::Error>> {
|
||||
// #extract_headers
|
||||
|
||||
// #deserialize_response_body
|
||||
|
||||
// let response = Response {
|
||||
// #response_init_fields
|
||||
// };
|
||||
|
||||
// Ok(response)
|
||||
// #closure_end
|
||||
|
||||
// Box::new(future_response)
|
||||
// }
|
||||
// }
|
||||
|
||||
// impl ::ruma_api::Endpoint for Endpoint {
|
||||
// type Request = Request;
|
||||
// type Response = Response;
|
||||
|
||||
// const METADATA: ::ruma_api::Metadata = ::ruma_api::Metadata {
|
||||
// description: #description,
|
||||
// method: ::hyper::#method,
|
||||
// name: #name,
|
||||
// path: #path,
|
||||
// rate_limited: #rate_limited,
|
||||
// requires_authentication: #requires_authentication,
|
||||
// };
|
||||
// }
|
||||
// });
|
||||
// }
|
||||
// }
|
||||
|
||||
|
@ -1,5 +1,6 @@
|
||||
use quote::{ToTokens, Tokens};
|
||||
use syn::{Field, MetaItem, NestedMetaItem};
|
||||
use syn::synom::Synom;
|
||||
use syn::{Field, FieldsNamed, Meta, NestedMeta};
|
||||
|
||||
use api::strip_serde_attrs;
|
||||
|
||||
@ -8,6 +9,15 @@ pub struct Request {
|
||||
fields: Vec<RequestField>,
|
||||
}
|
||||
|
||||
impl Synom for Request {
|
||||
named!(parse -> Self, do_parse!(
|
||||
fields: syn!(FieldsNamed) >>
|
||||
(Request {
|
||||
fields,
|
||||
})
|
||||
));
|
||||
}
|
||||
|
||||
impl Request {
|
||||
pub fn has_body_fields(&self) -> bool {
|
||||
self.fields.iter().any(|field| field.is_body())
|
||||
@ -74,7 +84,7 @@ impl From<Vec<Field>> for Request {
|
||||
|
||||
field.attrs = field.attrs.into_iter().filter(|attr| {
|
||||
let (attr_ident, nested_meta_items) = match attr.value {
|
||||
MetaItem::List(ref attr_ident, ref nested_meta_items) => (attr_ident, nested_meta_items),
|
||||
Meta::List(ref attr_ident, ref nested_meta_items) => (attr_ident, nested_meta_items),
|
||||
_ => return true,
|
||||
};
|
||||
|
||||
@ -84,9 +94,9 @@ impl From<Vec<Field>> for Request {
|
||||
|
||||
for nested_meta_item in nested_meta_items {
|
||||
match *nested_meta_item {
|
||||
NestedMetaItem::MetaItem(ref meta_item) => {
|
||||
NestedMeta::Meta(ref meta_item) => {
|
||||
match *meta_item {
|
||||
MetaItem::Word(ref ident) => {
|
||||
Meta::Word(ref ident) => {
|
||||
if ident == "body" {
|
||||
has_newtype_body = true;
|
||||
request_field_kind = RequestFieldKind::NewtypeBody;
|
||||
@ -107,7 +117,7 @@ impl From<Vec<Field>> for Request {
|
||||
),
|
||||
}
|
||||
}
|
||||
NestedMetaItem::Literal(_) => panic!(
|
||||
NestedMeta::Literal(_) => panic!(
|
||||
"ruma_api! attribute meta item on requests must be: body, header, path, or query"
|
||||
),
|
||||
}
|
||||
|
@ -1,5 +1,5 @@
|
||||
use quote::{ToTokens, Tokens};
|
||||
use syn::{Field, MetaItem, NestedMetaItem};
|
||||
use syn::{Field, Meta, NestedMeta};
|
||||
|
||||
use api::strip_serde_attrs;
|
||||
|
||||
@ -83,7 +83,7 @@ impl From<Vec<Field>> for Response {
|
||||
|
||||
field.attrs = field.attrs.into_iter().filter(|attr| {
|
||||
let (attr_ident, nested_meta_items) = match attr.value {
|
||||
MetaItem::List(ref attr_ident, ref nested_meta_items) => {
|
||||
Meta::List(ref attr_ident, ref nested_meta_items) => {
|
||||
(attr_ident, nested_meta_items)
|
||||
}
|
||||
_ => return true,
|
||||
@ -95,9 +95,9 @@ impl From<Vec<Field>> for Response {
|
||||
|
||||
for nested_meta_item in nested_meta_items {
|
||||
match *nested_meta_item {
|
||||
NestedMetaItem::MetaItem(ref meta_item) => {
|
||||
NestedMeta::Meta(ref meta_item) => {
|
||||
match *meta_item {
|
||||
MetaItem::Word(ref ident) => {
|
||||
Meta::Word(ref ident) => {
|
||||
if ident == "body" {
|
||||
has_newtype_body = true;
|
||||
response_field_kind = ResponseFieldKind::NewtypeBody;
|
||||
@ -114,7 +114,7 @@ impl From<Vec<Field>> for Response {
|
||||
),
|
||||
}
|
||||
}
|
||||
NestedMetaItem::Literal(_) => panic!(
|
||||
NestedMeta::Literal(_) => panic!(
|
||||
"ruma_api! attribute meta item on responses must be: header"
|
||||
),
|
||||
}
|
||||
|
22
src/lib.rs
22
src/lib.rs
@ -4,24 +4,24 @@
|
||||
//! See the documentation for the `ruma_api!` macro for usage details.
|
||||
|
||||
#![deny(missing_debug_implementations)]
|
||||
#![feature(proc_macro)]
|
||||
#![feature(proc_macro, try_from)]
|
||||
#![recursion_limit="256"]
|
||||
#![allow(warnings)]
|
||||
|
||||
extern crate proc_macro;
|
||||
#[macro_use] extern crate quote;
|
||||
extern crate ruma_api;
|
||||
extern crate syn;
|
||||
#[macro_use] extern crate synom;
|
||||
#[macro_use] extern crate syn;
|
||||
|
||||
use proc_macro::TokenStream;
|
||||
use std::convert::TryFrom;
|
||||
|
||||
use quote::{ToTokens, Tokens};
|
||||
|
||||
use api::Api;
|
||||
use parse::parse_entries;
|
||||
use api::{Api, Exprs};
|
||||
|
||||
mod api;
|
||||
mod parse;
|
||||
// mod parse;
|
||||
|
||||
/// Generates a `ruma_api::Endpoint` from a concise definition.
|
||||
///
|
||||
@ -196,13 +196,15 @@ mod parse;
|
||||
/// ```
|
||||
#[proc_macro]
|
||||
pub fn ruma_api(input: TokenStream) -> TokenStream {
|
||||
let entries = parse_entries(&input.to_string()).expect("ruma_api! failed to parse input");
|
||||
|
||||
let api = Api::from(entries);
|
||||
let exprs: Exprs = syn::parse(input).expect("ruma_api! failed to parse input");
|
||||
let api = match Api::try_from(exprs.inner) {
|
||||
Ok(api) => api,
|
||||
Err(error) => panic!("{}", error),
|
||||
};
|
||||
|
||||
let mut tokens = Tokens::new();
|
||||
|
||||
api.to_tokens(&mut tokens);
|
||||
|
||||
tokens.parse().expect("ruma_api! failed to parse output tokens as a TokenStream")
|
||||
tokens.into()
|
||||
}
|
||||
|
79
src/parse.rs
79
src/parse.rs
@ -6,12 +6,12 @@ use syn::{
|
||||
Expr,
|
||||
Field,
|
||||
Ident,
|
||||
MetaItem,
|
||||
NestedMetaItem,
|
||||
Meta,
|
||||
NestedMeta,
|
||||
Visibility,
|
||||
};
|
||||
use syn::parse::{expr, ident, lit, ty};
|
||||
use synom::space::{block_comment, whitespace};
|
||||
// use syn::parse::{expr, ident, lit, ty};
|
||||
// use synom::space::{block_comment, whitespace};
|
||||
|
||||
#[derive(Debug)]
|
||||
pub enum Entry {
|
||||
@ -27,27 +27,24 @@ named!(pub parse_entries -> Vec<Entry>, do_parse!(
|
||||
|
||||
named!(entry -> Entry, alt!(
|
||||
do_parse!(
|
||||
keyword!("metadata") >>
|
||||
punct!("{") >>
|
||||
fields: many0!(struct_init_field) >>
|
||||
punct!("}") >>
|
||||
(Entry::Metadata(fields))
|
||||
block_type: syn!(Ident) >>
|
||||
cond_reduce!(block_type == "metadata") >>
|
||||
brace_and_fields: braces!(many0!(struct_init_field)) >>
|
||||
(Entry::Metadata(brace_and_fields.1))
|
||||
)
|
||||
|
|
||||
do_parse!(
|
||||
keyword!("request") >>
|
||||
punct!("{") >>
|
||||
fields: terminated_list!(punct!(","), struct_field) >>
|
||||
punct!("}") >>
|
||||
(Entry::Request(fields))
|
||||
block_type: syn!(Ident) >>
|
||||
cond_reduce!(block_type == "request") >>
|
||||
brace_and_fields: braces!(terminated_list!(punct!(","), struct_field)) >>
|
||||
(Entry::Request(brace_and_fields.1))
|
||||
)
|
||||
|
|
||||
do_parse!(
|
||||
keyword!("response") >>
|
||||
punct!("{") >>
|
||||
fields: terminated_list!(punct!(","), struct_field) >>
|
||||
punct!("}") >>
|
||||
(Entry::Response(fields))
|
||||
block_type: syn!(Ident) >>
|
||||
cond_reduce!(block_type == "response") >>
|
||||
brace_and_fields: braces!(terminated_list!(punct!(","), struct_field)) >>
|
||||
(Entry::Response(brace_and_fields.1))
|
||||
)
|
||||
));
|
||||
|
||||
@ -55,9 +52,9 @@ named!(entry -> Entry, alt!(
|
||||
|
||||
named!(struct_init_field -> (Ident, Expr), do_parse!(
|
||||
ident: ident >>
|
||||
punct!(":") >>
|
||||
punct!(:) >>
|
||||
expr: expr >>
|
||||
punct!(",") >>
|
||||
punct!(,) >>
|
||||
(ident, expr)
|
||||
));
|
||||
|
||||
@ -65,7 +62,7 @@ named!(struct_field -> Field, do_parse!(
|
||||
attrs: many0!(outer_attr) >>
|
||||
visibility >>
|
||||
id: ident >>
|
||||
punct!(":") >>
|
||||
punct!(:) >>
|
||||
ty: ty >>
|
||||
(Field {
|
||||
ident: Some(id),
|
||||
@ -77,24 +74,24 @@ named!(struct_field -> Field, do_parse!(
|
||||
|
||||
named!(outer_attr -> Attribute, alt!(
|
||||
do_parse!(
|
||||
punct!("#") >>
|
||||
punct!("[") >>
|
||||
meta_item: meta_item >>
|
||||
punct!("]") >>
|
||||
punct!(#) >>
|
||||
brackets_and_meta_item: brackets!(meta_item) >>
|
||||
(Attribute {
|
||||
style: AttrStyle::Outer,
|
||||
value: meta_item,
|
||||
value: brackets_and_meta_item.1,
|
||||
is_sugared_doc: false,
|
||||
})
|
||||
)
|
||||
|
|
||||
do_parse!(
|
||||
punct!("///") >>
|
||||
punct!(/) >>
|
||||
punct!(/) >>
|
||||
punct!(/) >>
|
||||
not!(tag!("/")) >>
|
||||
content: take_until!("\n") >>
|
||||
(Attribute {
|
||||
style: AttrStyle::Outer,
|
||||
value: MetaItem::NameValue(
|
||||
value: Meta::NameValue(
|
||||
"doc".into(),
|
||||
format!("///{}", content).into(),
|
||||
),
|
||||
@ -108,7 +105,7 @@ named!(outer_attr -> Attribute, alt!(
|
||||
com: block_comment >>
|
||||
(Attribute {
|
||||
style: AttrStyle::Outer,
|
||||
value: MetaItem::NameValue(
|
||||
value: Meta::NameValue(
|
||||
"doc".into(),
|
||||
com.into(),
|
||||
),
|
||||
@ -117,33 +114,31 @@ named!(outer_attr -> Attribute, alt!(
|
||||
)
|
||||
));
|
||||
|
||||
named!(meta_item -> MetaItem, alt!(
|
||||
named!(meta_item -> Meta, alt!(
|
||||
do_parse!(
|
||||
id: ident >>
|
||||
punct!("(") >>
|
||||
inner: terminated_list!(punct!(","), nested_meta_item) >>
|
||||
punct!(")") >>
|
||||
(MetaItem::List(id, inner))
|
||||
parens_and_inner: parens!(terminated_list!(punct!(,), nested_meta_item)) >>
|
||||
(Meta::List(id, parens_and_inner.1))
|
||||
)
|
||||
|
|
||||
do_parse!(
|
||||
name: ident >>
|
||||
punct!("=") >>
|
||||
punct!(=) >>
|
||||
value: lit >>
|
||||
(MetaItem::NameValue(name, value))
|
||||
(Meta::NameValue(name, value))
|
||||
)
|
||||
|
|
||||
map!(ident, MetaItem::Word)
|
||||
map!(ident, Meta::Word)
|
||||
));
|
||||
|
||||
named!(nested_meta_item -> NestedMetaItem, alt!(
|
||||
meta_item => { NestedMetaItem::MetaItem }
|
||||
named!(nested_meta_item -> NestedMeta, alt!(
|
||||
meta_item => { NestedMeta::Meta }
|
||||
|
|
||||
lit => { NestedMetaItem::Literal }
|
||||
lit => { NestedMeta::Literal }
|
||||
));
|
||||
|
||||
named!(visibility -> Visibility, alt!(
|
||||
keyword!("pub") => { |_| Visibility::Public }
|
||||
keyword!(pub) => { |_| Visibility::Public }
|
||||
|
|
||||
epsilon!() => { |_| Visibility::Inherited }
|
||||
));
|
||||
|
Loading…
x
Reference in New Issue
Block a user