gtest 1.10.0

Testing utils for developing Gear programs.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81

// This file is part of Gear.
//
// Copyright (C) 2021-2025 Gear Technologies Inc.
// SPDX-License-Identifier: GPL-3.0-or-later WITH Classpath-exception-2.0
//
// This program is free software: you can redistribute it and/or modify
// it under the terms of the GNU General Public License as published by
// the Free Software Foundation, either version 3 of the License, or
// (at your option) any later version.
//
// This program is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
// GNU General Public License for more details.
//
// You should have received a copy of the GNU General Public License
// along with this program. If not, see <https://www.gnu.org/licenses/>.

use super::*;
use crate::state::programs::GTestProgram;

impl ExtManager {
    /// Call non-void meta function from actor stored in manager.
    /// Warning! This is a static call that doesn't change actors pages data.
    pub(crate) fn read_state_bytes(
        &mut self,
        payload: Vec<u8>,
        program_id: ActorId,
    ) -> Result<Vec<u8>> {
        ProgramsStorageManager::has_program(program_id)
            .then_some(())
            .ok_or(TestError::ActorNotFound(program_id))?;

        if ProgramsStorageManager::is_mock_program(program_id) {
            ProgramsStorageManager::modify_program(program_id, |program| {
                let Some(GTestProgram::Mock { handlers, .. }) = program else {
                    unreachable!("checked upper, that it's the case for a mock program");
                };

                handlers
                    .state()
                    .map_err(|e| TestError::ReadStateError(e.to_string()))
            })
        } else {
            let allocations = ProgramsStorageManager::allocations(program_id);
            let code_id = ProgramsStorageManager::access_primary_program(program_id, |program| {
                let Some(Program::Active(ActiveProgram { code_id, .. })) = program else {
                    // Above checked that program exists and it's not a mock program
                    unreachable!("checked upper, that it's the case for an active program");
                };

                *code_id
            });
            debug_assert!(code_id != CUSTOM_WASM_PROGRAM_CODE_ID);

            let code_metadata = self
                .code_metadata(code_id)
                .cloned()
                .expect("internal error: code metadata not found for existing active program");
            let instrumented_code = self
                .instrumented_code(code_id)
                .cloned()
                .expect("internal error: instrumented code not found for existing active program");
            core_processor::informational::execute_for_reply::<Ext<LazyPagesNative>, _>(
                String::from("state"),
                instrumented_code,
                code_metadata,
                allocations,
                Some((program_id, Default::default())),
                payload,
                MAX_USER_GAS_LIMIT,
                self.blocks_manager.get(),
            )
            .map_err(TestError::ReadStateError)
        }
    }

    pub(crate) fn read_memory_pages(&self, program_id: ActorId) -> BTreeMap<GearPage, PageBuf> {
        ProgramsStorageManager::program_pages(program_id)
    }
}