pezkuwichain/pezkuwi-subxt
1
0
Fork 0
mirror of https://github.com/pezkuwichain/pezkuwi-subxt.git synced 2026-06-13 11:41:04 +00:00
Code Issues Packages Projects Releases Wiki Activity

Cleanup rustdoc (#1965)

Browse Source 
* Hide `__GetByteStruct*` types in the docs

* Forward documentation to `GenesisConfig`

* Hide `PhantomItem` in docs for `Call`

* Hide public calls in `Module`

* Forward documenation for storage functions

* Hide auxiliary functions in documentation
This commit is contained in:
Bastian Köcher
2019-03-11 21:49:37 +01:00
committed by GitHub
parent a3a5031d9d
commit 0ea90111b4
3 changed files with 65 additions and 36 deletions
Download Patch File Download Diff File Expand all files Collapse all files
substrate/srml/support/procedural/src/storage/transformation.rs
+32 -8
View File
@@ -130,18 +130,20 @@ pub fn decl_storage_impl(input: TokenStream) -> TokenStream {
}
impl<#traitinstance: 'static + #traittype> #module_ident<#traitinstance> {
#impl_store_fns
#[doc(hidden)]
pub fn store_metadata() -> #scrate::storage::generator::StorageMetadata {
#scrate::storage::generator::StorageMetadata {
functions: #scrate::storage::generator::DecodeDifferent::Encode(#store_functions_to_metadata) ,
}
}
#[doc(hidden)]
pub fn store_metadata_functions() -> &'static [#scrate::storage::generator::StorageFunctionMetadata] {
#store_functions_to_metadata
}
#[doc(hidden)]
pub fn store_metadata_name() -> &'static str {
#cratename_string
}
}
#extra_genesis
@@ -168,6 +170,7 @@ fn decl_store_extra_genesis(
for sline in storage_lines.inner.iter() {
let DeclStorageLine {
attrs,
name,
getter,
config,
@@ -188,7 +191,13 @@ fn decl_store_extra_genesis(
let ident = &getter.getfn.content;
quote!( #ident )
} else {
return Err(syn::Error::new_spanned(name, format!("Invalid storage definiton, couldn't find config identifier: storage must either have a get identifier `get(ident)` or a defined config identifier `config(ident)`")));
return Err(
Error::new_spanned(
name,
"Invalid storage definiton, couldn't find config identifier: storage must either have a get identifier \
`get(ident)` or a defined config identifier `config(ident)`"
)
);
};
if type_infos.kind.is_simple() && ext::has_parametric_type(type_infos.value_type, traitinstance) {
is_trait_needed = true;
@@ -199,13 +208,17 @@ fn decl_store_extra_genesis(
if let DeclStorageTypeInfosKind::Map { key_type, .. } = type_infos.kind {
serde_complete_bound.insert(key_type);
}
// Propagate doc attributes.
let attrs = attrs.inner.iter().filter_map(|a| a.parse_meta().ok()).filter(|m| m.name() == "doc");
let storage_type = type_infos.typ.clone();
config_field.extend(match type_infos.kind {
DeclStorageTypeInfosKind::Simple => {
quote!( pub #ident: #storage_type, )
quote!( #( #[ #attrs ] )* pub #ident: #storage_type, )
},
DeclStorageTypeInfosKind::Map {key_type, .. } => {
quote!( pub #ident: Vec<(#key_type, #storage_type)>, )
quote!( #( #[ #attrs ] )* pub #ident: Vec<(#key_type, #storage_type)>, )
},
});
opt_build = Some(build.as_ref().map(|b| &b.expr.content).map(|b|quote!( #b ))
@@ -234,7 +247,7 @@ fn decl_store_extra_genesis(
let v = (#builder)(&self);
<#name<#traitinstance> as #scrate::storage::generator::StorageValue<#typ>>::put(&v, &storage);
}}
},
DeclStorageTypeInfosKind::Map { key_type, .. } => {
@@ -475,8 +488,12 @@ fn impl_store_items(
) -> TokenStream2 {
storage_lines.inner.iter().map(|sline| &sline.name)
.fold(TokenStream2::new(), |mut items, name| {
items.extend(quote!(type #name = #name<#traitinstance>;));
items
items.extend(
quote!(
type #name = #name<#traitinstance>;
)
);
items
})
}
@@ -488,6 +505,7 @@ fn impl_store_fns(
let mut items = TokenStream2::new();
for sline in storage_lines.inner.iter() {
let DeclStorageLine {
attrs,
name,
getter,
storage_type,
@@ -500,10 +518,14 @@ fn impl_store_fns(
let type_infos = get_type_infos(storage_type);
let value_type = type_infos.value_type;
// Propagate doc attributes.
let attrs = attrs.inner.iter().filter_map(|a| a.parse_meta().ok()).filter(|m| m.name() == "doc");
let typ = type_infos.typ;
let item = match type_infos.kind {
DeclStorageTypeInfosKind::Simple => {
quote!{
#( #[ #attrs ] )*
pub fn #get_fn() -> #value_type {
<#name<#traitinstance> as #scrate::storage::generator::StorageValue<#typ>> :: get(&#scrate::storage::RuntimeStorage)
}
@@ -511,6 +533,7 @@ fn impl_store_fns(
},
DeclStorageTypeInfosKind::Map { key_type, .. } => {
quote!{
#( #[ #attrs ] )*
pub fn #get_fn<K: #scrate::storage::generator::Borrow<#key_type>>(key: K) -> #value_type {
<#name<#traitinstance> as #scrate::storage::generator::StorageMap<#key_type, #typ>> :: get(key.borrow(), &#scrate::storage::RuntimeStorage)
}
@@ -579,7 +602,7 @@ fn store_functions_to_metadata (
})
.unwrap_or_else(|| quote!( Default::default() ));
let mut docs = TokenStream2::new();
for attr in attrs.inner.iter().filter_map(|v| v.interpret_meta()) {
for attr in attrs.inner.iter().filter_map(|v| v.parse_meta().ok()) {
if let syn::Meta::NameValue(syn::MetaNameValue{
ref ident,
ref lit,
@@ -608,6 +631,7 @@ fn store_functions_to_metadata (
};
items.extend(item);
let def_get = quote! {
#[doc(hidden)]
pub struct #struct_name<#traitinstance>(pub #scrate::rstd::marker::PhantomData<#traitinstance>);
#[cfg(feature = "std")]
#[allow(non_upper_case_globals)]
substrate/srml/support/src/dispatch.rs
+10 -5
View File
@@ -487,6 +487,7 @@ macro_rules! decl_module {
$vis:vis fn $name:ident ( root $(, $param:ident : $param_ty:ty )* ) { $( $impl:tt )* }
) => {
impl<$trait_instance: $trait_name> $module<$trait_instance> {
#[doc(hidden)]
$vis fn $name($( $param: $param_ty ),* ) -> $crate::dispatch::Result {
{ $( $impl )* }
Ok(())
@@ -503,6 +504,7 @@ macro_rules! decl_module {
) -> $result:ty { $( $impl:tt )* }
) => {
impl<$trait_instance: $trait_name> $module<$trait_instance> {
#[doc(hidden)]
$vis fn $name($( $param: $param_ty ),* ) -> $result {
$( $impl )*
}
@@ -518,6 +520,7 @@ macro_rules! decl_module {
) { $( $impl:tt )* }
) => {
impl<$trait_instance: $trait_name> $module<$trait_instance> {
#[doc(hidden)]
$vis fn $name(
$origin: $origin_ty $(, $param: $param_ty )*
) -> $crate::dispatch::Result {
@@ -608,10 +611,11 @@ macro_rules! decl_module {
#[cfg(feature = "std")]
$(#[$attr])*
pub enum $call_type<$trait_instance: $trait_name> {
#[doc(hidden)]
__PhantomItem(::std::marker::PhantomData<$trait_instance>),
__OtherPhantomItem(::std::marker::PhantomData<$trait_instance>),
$(
#[allow(non_camel_case_types)]
$(#[doc = $doc_attr])*
$fn_name ( $( $param ),* ),
)*
}
@@ -619,10 +623,11 @@ macro_rules! decl_module {
#[cfg(not(feature = "std"))]
$(#[$attr])*
pub enum $call_type<$trait_instance: $trait_name> {
#[doc(hidden)]
__PhantomItem(::core::marker::PhantomData<$trait_instance>),
__OtherPhantomItem(::core::marker::PhantomData<$trait_instance>),
$(
#[allow(non_camel_case_types)]
$(#[doc = $doc_attr])*
$fn_name ( $( $param ),* ),
)*
}
@@ -655,7 +660,6 @@ macro_rules! decl_module {
} else {
match *_other {
$call_type::__PhantomItem(_) => unreachable!(),
$call_type::__OtherPhantomItem(_) => unreachable!(),
_ => false,
}
}
@@ -698,7 +702,6 @@ macro_rules! decl_module {
fn encode_to<W: $crate::dispatch::Output>(&self, _dest: &mut W) {
$crate::__impl_encode!(_dest; *self; 0; $call_type; $( fn $fn_name( $( $(#[$codec_attr on type $param])* $param_name ),* ); )*);
if let $call_type::__PhantomItem(_) = *self { unreachable!() }
if let $call_type::__OtherPhantomItem(_) = *self { unreachable!() }
}
}
impl<$trait_instance: $trait_name> $crate::dispatch::Dispatchable
@@ -717,7 +720,7 @@ macro_rules! decl_module {
)
},
)*
_ => { panic!("__PhantomItem should never be used.") },
$call_type::__PhantomItem(_) => { panic!("__PhantomItem should never be used.") },
}
}
}
@@ -728,6 +731,7 @@ macro_rules! decl_module {
}
impl<$trait_instance: $trait_name> $mod_type<$trait_instance> {
#[doc(hidden)]
pub fn dispatch<D: $crate::dispatch::Dispatchable<Trait = $trait_instance>>(d: D, origin: D::Origin) -> $crate::dispatch::Result {
d.dispatch(origin)
}
@@ -944,6 +948,7 @@ macro_rules! __dispatch_impl_metadata {
$($rest:tt)*
) => {
impl<$trait_instance: $trait_name> $mod_type<$trait_instance> {
#[doc(hidden)]
pub fn call_functions() -> &'static [$crate::dispatch::FunctionMetadata] {
$crate::__call_to_functions!($($rest)*)
}