mirror of
https://github.com/OMGeeky/google-apis-rs.git
synced 2026-02-23 15:49:49 +01:00
aadf37004e
We assure to know about it, instead of writing nonsense about that 'methods' resources which does not actually exist. I am relatively sure to have found all the spots. Fixes #22
131 lines
4.8 KiB
Mako
131 lines
4.8 KiB
Mako
<%!
|
|
from util import (schema_markers, rust_doc_comment, mangle_ident, to_rust_type, put_and,
|
|
IO_TYPES, activity_split, enclose_in, REQUEST_MARKER_TRAIT, mb_type, indent_all_but_first_by,
|
|
NESTED_TYPE_SUFFIX, RESPONSE_MARKER_TRAIT, split_camelcase_s, METHODS_RESOURCE)
|
|
|
|
default_traits = ('RustcEncodable', 'Clone', 'Default')
|
|
%>\
|
|
## Build a schema which must be an object
|
|
###################################################################################################################
|
|
###################################################################################################################
|
|
<%def name="_new_object(s, properties, c)">\
|
|
<% struct = 'pub struct ' + s.id %>\
|
|
% if properties:
|
|
${struct} {
|
|
% for pn, p in properties.iteritems():
|
|
${p.get('description', 'no description provided') | rust_doc_comment, indent_all_but_first_by(1)}
|
|
pub ${mangle_ident(pn)}: ${to_rust_type(schemas, s.id, pn, p)},
|
|
% endfor
|
|
}
|
|
% elif 'additionalProperties' in s:
|
|
${struct}(${to_rust_type(schemas, s.id, NESTED_TYPE_SUFFIX, s)});
|
|
% else: ## it's an empty struct, i.e. struct Foo;
|
|
${struct};
|
|
% endif ## 'properties' in s
|
|
</%def>
|
|
|
|
## Create new schema with everything.
|
|
## 's' contains the schema structure from json to build
|
|
###################################################################################################################
|
|
###################################################################################################################
|
|
<%def name="new(s, c)">\
|
|
<%
|
|
markers = schema_markers(s, c)
|
|
traits = ['Default', 'Clone', 'Debug']
|
|
|
|
if REQUEST_MARKER_TRAIT in markers:
|
|
traits.append('RustcEncodable')
|
|
if RESPONSE_MARKER_TRAIT in markers:
|
|
traits.append('RustcDecodable')
|
|
|
|
## waiting for Default: https://github.com/rust-lang/rustc-serialize/issues/71
|
|
if s.type == 'any':
|
|
traits.remove('Default')
|
|
%>\
|
|
<%block filter="rust_doc_comment">\
|
|
${doc(s, c)}\
|
|
</%block>
|
|
#[derive(${', '.join(traits)})]
|
|
% if s.type == 'object':
|
|
${_new_object(s, s.get('properties'), c)}\
|
|
% elif s.type == 'array':
|
|
% if s.items.get('type') != 'object':
|
|
pub struct ${s.id}(${to_rust_type(schemas, s.id, NESTED_TYPE_SUFFIX, s)});
|
|
% else:
|
|
${_new_object(s, s.items.get('properties'), c)}\
|
|
% endif ## array item != 'object'
|
|
% elif s.type == 'any':
|
|
## waiting for Default: https://github.com/rust-lang/rustc-serialize/issues/71
|
|
pub struct ${s.id}(rustc_serialize::json::Json);
|
|
|
|
impl Default for ${s.id} {
|
|
fn default() -> ${s.id} {
|
|
${s.id}(rustc_serialize::json::Json::Null)
|
|
}
|
|
}
|
|
% else:
|
|
<% assert False, "Object not handled: %s" % str(s) %>\
|
|
% endif ## type == ?
|
|
|
|
% for marker_trait in markers:
|
|
impl ${marker_trait} for ${s.id} {}
|
|
% endfor
|
|
|
|
% if REQUEST_MARKER_TRAIT in markers and 'properties' in s:
|
|
impl ${s.id} {
|
|
/// Return a comma separated list of members that are currently set, i.e. for which `self.member.is_some()`.
|
|
/// The produced string is suitable for use as a parts list that indicates the parts you are sending, and/or
|
|
/// the parts you want to see in the server response.
|
|
fn to_parts(&self) -> String {
|
|
let mut r = String::new();
|
|
% for pn, p in s.properties.iteritems():
|
|
<%
|
|
mn = 'self.' + mangle_ident(pn)
|
|
rt = to_rust_type(schemas, s.id, pn, p)
|
|
check = 'is_some()'
|
|
if rt.startswith('Vec') or rt.startswith('HashMap'):
|
|
check = 'len() > 0'
|
|
%>\
|
|
if ${mn}.${check} { r = r + "${pn},"; }
|
|
% endfor
|
|
## remove (possibly non-existing) trailing comma
|
|
r.pop();
|
|
r
|
|
}
|
|
}
|
|
% endif
|
|
</%def>
|
|
|
|
#########################################################################################################
|
|
#########################################################################################################
|
|
<%def name="doc(s, c)">\
|
|
${s.get('description', 'There is no detailed description.')}
|
|
% if s.id in c.sta_map:
|
|
|
|
# Activities
|
|
|
|
This type is used in activities, which are methods you may call on this type or where this type is involved in.
|
|
The list links the activity name, along with information about where it is used (one of ${put_and(enclose_in('*', IO_TYPES))}).
|
|
|
|
% for a, iot in c.sta_map[s.id].iteritems():
|
|
<%
|
|
category, name, method = activity_split(a)
|
|
name_suffix = ' ' + split_camelcase_s(name)
|
|
if name == METHODS_RESOURCE:
|
|
name_suffix = ''
|
|
struct_url = 'struct.' + mb_type(name, method) + '.html'
|
|
method_name = ' '.join(split_camelcase_s(method).split('.')) + name_suffix
|
|
value_type = '|'.join(iot) or 'none'
|
|
%>\
|
|
* [${method_name}](${struct_url}) (${value_type})
|
|
% endfor
|
|
% else:
|
|
|
|
This type is not used in any activity, and only used as *part* of another schema.
|
|
% endif
|
|
% if s.type != 'object':
|
|
|
|
## for some reason, it's not shown in rustdoc ...
|
|
The contained type is `${to_rust_type(schemas, s.id, s.id, s)}`.
|
|
%endif
|
|
</%def> |