Files
pezkuwi-subxt/substrate/frame/support/test/tests/pallet_compatibility_instance.rs
T
Guillaume Thiolliere 137628b4d7 Add feature: no-metadata-doc which removes doc from metadata and full-metadata which build metadata with all doc (#10493)
* add features to remove or add doc

* fmt

* add test for event/error/call

* fmt
2022-01-17 22:21:19 +01:00

369 lines
11 KiB
Rust

// This file is part of Substrate.
// Copyright (C) 2020-2022 Parity Technologies (UK) Ltd.
// SPDX-License-Identifier: Apache-2.0
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
// http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.
// Old macros don't support the flag `no-metadata-docs` so the result differs when the feature is
// activated.
#![cfg(not(feature = "no-metadata-docs"))]
use frame_support::traits::{ConstU32, ConstU64};
mod pallet_old {
use frame_support::{
decl_error, decl_event, decl_module, decl_storage, traits::Get, weights::Weight, Parameter,
};
use frame_system::ensure_root;
pub trait Config<I: Instance = DefaultInstance>: frame_system::Config {
type SomeConst: Get<Self::Balance>;
type Balance: Parameter + codec::HasCompact + From<u32> + Into<Weight> + Default;
type Event: From<Event<Self, I>> + Into<<Self as frame_system::Config>::Event>;
}
decl_storage! {
trait Store for Module<T: Config<I>, I: Instance = DefaultInstance> as Example {
/// Some documentation
Dummy get(fn dummy) config(): Option<T::Balance>;
Bar get(fn bar) config(): map hasher(blake2_128_concat) T::AccountId => T::Balance;
Foo get(fn foo) config(): T::Balance = 3.into();
Double get(fn double):
double_map hasher(blake2_128_concat) u32, hasher(twox_64_concat) u64 => u16;
}
}
decl_event!(
pub enum Event<T, I = DefaultInstance>
where
Balance = <T as Config<I>>::Balance,
{
/// Dummy event, just here so there's a generic type that's used.
Dummy(Balance),
}
);
decl_module! {
pub struct Module<T: Config<I>, I: Instance = DefaultInstance> for enum Call
where origin: T::Origin
{
type Error = Error<T, I>;
fn deposit_event() = default;
const SomeConst: T::Balance = T::SomeConst::get();
#[weight = <T::Balance as Into<Weight>>::into(new_value.clone())]
fn set_dummy(origin, #[compact] new_value: T::Balance) {
ensure_root(origin)?;
<Dummy<T, I>>::put(&new_value);
Self::deposit_event(RawEvent::Dummy(new_value));
}
fn on_initialize(_n: T::BlockNumber) -> Weight {
<Dummy<T, I>>::put(T::Balance::from(10));
10
}
fn on_finalize(_n: T::BlockNumber) {
<Dummy<T, I>>::put(T::Balance::from(11));
}
}
}
decl_error! {
pub enum Error for Module<T: Config<I>, I: Instance> {
/// Some wrong behavior
Wrong,
}
}
}
#[frame_support::pallet]
pub mod pallet {
use frame_support::{pallet_prelude::*, scale_info};
use frame_system::{ensure_root, pallet_prelude::*};
#[pallet::config]
pub trait Config<I: 'static = ()>: frame_system::Config {
type Balance: Parameter
+ codec::HasCompact
+ From<u32>
+ Into<Weight>
+ Default
+ MaybeSerializeDeserialize
+ scale_info::StaticTypeInfo;
#[pallet::constant]
type SomeConst: Get<Self::Balance>;
type Event: From<Event<Self, I>> + IsType<<Self as frame_system::Config>::Event>;
}
#[pallet::pallet]
pub struct Pallet<T, I = ()>(PhantomData<(T, I)>);
#[pallet::hooks]
impl<T: Config<I>, I: 'static> Hooks<T::BlockNumber> for Pallet<T, I> {
fn on_initialize(_n: T::BlockNumber) -> Weight {
<Dummy<T, I>>::put(T::Balance::from(10));
10
}
fn on_finalize(_n: T::BlockNumber) {
<Dummy<T, I>>::put(T::Balance::from(11));
}
}
#[pallet::call]
impl<T: Config<I>, I: 'static> Pallet<T, I> {
#[pallet::weight(<T::Balance as Into<Weight>>::into(new_value.clone()))]
pub fn set_dummy(
origin: OriginFor<T>,
#[pallet::compact] new_value: T::Balance,
) -> DispatchResultWithPostInfo {
ensure_root(origin)?;
<Dummy<T, I>>::put(&new_value);
Self::deposit_event(Event::Dummy(new_value));
Ok(().into())
}
}
#[pallet::error]
pub enum Error<T, I = ()> {
/// Some wrong behavior
Wrong,
}
#[pallet::event]
#[pallet::generate_deposit(fn deposit_event)]
pub enum Event<T: Config<I>, I: 'static = ()> {
/// Dummy event, just here so there's a generic type that's used.
Dummy(T::Balance),
}
#[pallet::storage]
/// Some documentation
type Dummy<T: Config<I>, I: 'static = ()> = StorageValue<_, T::Balance, OptionQuery>;
#[pallet::storage]
type Bar<T: Config<I>, I: 'static = ()> =
StorageMap<_, Blake2_128Concat, T::AccountId, T::Balance, ValueQuery>;
#[pallet::storage]
type Foo<T: Config<I>, I: 'static = ()> =
StorageValue<_, T::Balance, ValueQuery, OnFooEmpty<T, I>>;
#[pallet::type_value]
pub fn OnFooEmpty<T: Config<I>, I: 'static>() -> T::Balance {
3.into()
}
#[pallet::storage]
type Double<T, I = ()> =
StorageDoubleMap<_, Blake2_128Concat, u32, Twox64Concat, u64, u16, ValueQuery>;
#[pallet::genesis_config]
pub struct GenesisConfig<T: Config<I>, I: 'static = ()> {
dummy: Option<T::Balance>,
bar: Vec<(T::AccountId, T::Balance)>,
foo: T::Balance,
}
impl<T: Config<I>, I: 'static> Default for GenesisConfig<T, I> {
fn default() -> Self {
GenesisConfig {
dummy: Default::default(),
bar: Default::default(),
foo: OnFooEmpty::<T, I>::get(),
}
}
}
#[pallet::genesis_build]
impl<T: Config<I>, I: 'static> GenesisBuild<T, I> for GenesisConfig<T, I> {
fn build(&self) {
if let Some(dummy) = self.dummy.as_ref() {
<Dummy<T, I>>::put(dummy);
}
for (k, v) in &self.bar {
<Bar<T, I>>::insert(k, v);
}
<Foo<T, I>>::put(&self.foo);
}
}
}
impl frame_system::Config for Runtime {
type BlockWeights = ();
type BlockLength = ();
type DbWeight = ();
type BaseCallFilter = frame_support::traits::Everything;
type Origin = Origin;
type Index = u64;
type BlockNumber = u32;
type Call = Call;
type Hash = sp_runtime::testing::H256;
type Hashing = sp_runtime::traits::BlakeTwo256;
type AccountId = u64;
type Lookup = sp_runtime::traits::IdentityLookup<Self::AccountId>;
type Header = Header;
type Event = Event;
type BlockHashCount = ConstU32<250>;
type Version = ();
type PalletInfo = PalletInfo;
type AccountData = ();
type OnNewAccount = ();
type OnKilledAccount = ();
type SystemWeightInfo = ();
type SS58Prefix = ();
type OnSetCode = ();
type MaxConsumers = ConstU32<16>;
}
impl pallet::Config for Runtime {
type Event = Event;
type SomeConst = ConstU64<10>;
type Balance = u64;
}
impl pallet::Config<pallet::Instance2> for Runtime {
type Event = Event;
type SomeConst = ConstU64<10>;
type Balance = u64;
}
impl pallet::Config<pallet::Instance3> for Runtime {
type Event = Event;
type SomeConst = ConstU64<10>;
type Balance = u64;
}
impl pallet_old::Config for Runtime {
type Event = Event;
type SomeConst = ConstU64<10>;
type Balance = u64;
}
impl pallet_old::Config<pallet_old::Instance2> for Runtime {
type Event = Event;
type SomeConst = ConstU64<10>;
type Balance = u64;
}
impl pallet_old::Config<pallet_old::Instance3> for Runtime {
type Event = Event;
type SomeConst = ConstU64<10>;
type Balance = u64;
}
pub type Header = sp_runtime::generic::Header<u32, sp_runtime::traits::BlakeTwo256>;
pub type Block = sp_runtime::generic::Block<Header, UncheckedExtrinsic>;
pub type UncheckedExtrinsic = sp_runtime::generic::UncheckedExtrinsic<u32, Call, (), ()>;
frame_support::construct_runtime!(
pub enum Runtime where
Block = Block,
NodeBlock = Block,
UncheckedExtrinsic = UncheckedExtrinsic
{
System: frame_system::{Pallet, Call, Event<T>},
Example: pallet::{Pallet, Call, Event<T>, Config<T>, Storage},
PalletOld: pallet_old::{Pallet, Call, Event<T>, Config<T>, Storage},
Instance2Example: pallet::<Instance2>::{Pallet, Call, Event<T>, Config<T>, Storage},
PalletOld2: pallet_old::<Instance2>::{Pallet, Call, Event<T>, Config<T>, Storage},
Instance3Example: pallet::<Instance3>::{Pallet, Call, Event<T>, Config<T>, Storage},
PalletOld3: pallet_old::<Instance3>::{Pallet, Call, Event<T>, Config<T>, Storage},
}
);
#[cfg(test)]
mod test {
use super::{pallet, pallet_old, Runtime};
use codec::{Decode, Encode};
use scale_info::{form::PortableForm, Variant};
#[test]
fn metadata() {
let metadata = Runtime::metadata();
let (pallets, types) = match metadata.1 {
frame_support::metadata::RuntimeMetadata::V14(metadata) =>
(metadata.pallets, metadata.types),
_ => unreachable!(),
};
let get_enum_variants = |ty_id| match types.resolve(ty_id).map(|ty| ty.type_def()) {
Some(ty) => match ty {
scale_info::TypeDef::Variant(var) => var.variants(),
_ => panic!("Expected variant type"),
},
_ => panic!("No type found"),
};
let assert_enum_variants = |vs1: &[Variant<PortableForm>],
vs2: &[Variant<PortableForm>]| {
assert_eq!(vs1.len(), vs2.len());
for i in 0..vs1.len() {
let v1 = &vs2[i];
let v2 = &vs2[i];
assert_eq!(v1.fields().len(), v2.fields().len());
for f in 0..v1.fields().len() {
let f1 = &v1.fields()[f];
let f2 = &v2.fields()[f];
pretty_assertions::assert_eq!(f1.name(), f2.name());
pretty_assertions::assert_eq!(f1.ty(), f2.ty());
}
}
};
for i in vec![1, 3, 5].into_iter() {
pretty_assertions::assert_eq!(pallets[i].storage, pallets[i + 1].storage);
let call1_variants = get_enum_variants(pallets[i].calls.as_ref().unwrap().ty.id());
let call2_variants = get_enum_variants(pallets[i + 1].calls.as_ref().unwrap().ty.id());
assert_enum_variants(call1_variants, call2_variants);
// event: check variants and fields but ignore the type name which will be different
let event1_variants = get_enum_variants(pallets[i].event.as_ref().unwrap().ty.id());
let event2_variants = get_enum_variants(pallets[i + 1].event.as_ref().unwrap().ty.id());
assert_enum_variants(event1_variants, event2_variants);
let err1 = get_enum_variants(pallets[i].error.as_ref().unwrap().ty.id())
.iter()
.filter(|v| v.name() == "__Ignore")
.cloned()
.collect::<Vec<_>>();
let err2 = get_enum_variants(pallets[i + 1].error.as_ref().unwrap().ty.id())
.iter()
.filter(|v| v.name() == "__Ignore")
.cloned()
.collect::<Vec<_>>();
assert_enum_variants(&err1, &err2);
pretty_assertions::assert_eq!(pallets[i].constants, pallets[i + 1].constants);
}
}
#[test]
fn types() {
assert_eq!(
pallet_old::Event::<Runtime>::decode(
&mut &pallet::Event::<Runtime>::Dummy(10).encode()[..]
)
.unwrap(),
pallet_old::Event::<Runtime>::Dummy(10),
);
assert_eq!(
pallet_old::Call::<Runtime>::decode(
&mut &pallet::Call::<Runtime>::set_dummy { new_value: 10 }.encode()[..]
)
.unwrap(),
pallet_old::Call::<Runtime>::set_dummy { new_value: 10 },
);
}
}