feat: add test stub generation

[skywardboundd]

Closes #3287

[skywardboundd]

Example

// !!THIS FILE IS GENERATED BY TACT. THIS FILE IS REGENERATED EVERY TIME, COPY IT TO YOUR PROJECT MANUALLY!!
// https://docs.tact-lang.org/book/debug/

import { Escrow } from './escrow_Escrow';
import { Blockchain, createShardAccount } from "@ton/sandbox";

export type FromInitEscrow = typeof Escrow.fromInit;

export type TestCase = (fromInit: FromInitEscrow) => void;

export const testEscrow = (fromInit: FromInitEscrow) => {
    describe("Escrow Contract", () => {
        // Test receivers
        testInternalMessageFunding(fromInit);
        testInternalMessageUpdateJettonWalletCode(fromInit);
        testInternalMessageJettonNotification(fromInit);
        testInternalMessageApprove(fromInit);
        testInternalMessageCancel(fromInit);
        testInternalMessageProvideEscrowData(fromInit);
        // Test getters
        getterTestcalculateRoyaltyAmount(fromInit);
        getterTestwalletAddress(fromInit);
        getterTestescrowInfo(fromInit);
    });
};

const globalSetup = async (fromInit: FromInitEscrow) => {
    const blockchain = await Blockchain.create();
    // @ts-ignore
    const contract = await blockchain.openContract(await fromInit(
        // TODO: implement default values
    ));
        
    // Universal method for deploy contract without sending message
    await blockchain.setShardAccount(contract.address, createShardAccount({
        address: contract.address,
        code: contract.init!.code,
        data: contract.init!.data,
        balance: 0n,
        workchain: 0
    }));
        
    const owner = await blockchain.treasury("owner");
    const notOwner = await blockchain.treasury("notOwner");
    
    return { blockchain, contract, owner, notOwner };
};

const testInternalMessageFunding: TestCase = (fromInit) => {
    describe("InternalMessageFunding", () => {
        const setup = async () => {
            return await globalSetup(fromInit);
        };
        
        // !!THIS FILE IS GENERATED BY TACT. THIS FILE IS REGENERATED EVERY TIME, COPY IT TO YOUR PROJECT MANUALLY!!
        // TODO: You can write tests for InternalMessageFunding here
        
        it("should perform correctly", async () => {
            const { blockchain, contract, owner, notOwner } = await setup();
        });
    });
};
...

[Kaladin13]

I like the idea behind the PR, it's very fresh and could be useful

However, I think we should discuss the end result more, because all Tact users would be affected by such test template generation, so it needs to be polished

One way is to move it to CLI instead of default build pipeline, or maybe add flag to the tact.config

[xpyctumo]

I think maintaining a template file will be clearer and easier than generating it on-fly with many f.write functions

// !!THIS FILE IS GENERATED BY TACT. COPY IT TO YOUR PROJECT MANUALLY!!
// https://docs.tact-lang.org/book/debug/

{{#imports}}
import {{.}};
{{/imports}}

export type FromInit{{contractName}} = typeof {{contractName}}.fromInit;
export type TestCase = (fromInit: FromInit{{contractName}}) => void;

export const test{{contractName}} = (fromInit: FromInit{{contractName}}) => {
    describe("{{contractName}} Contract", () => {
        // Test receivers
        {{#receivers}}
        test{{.}}(fromInit);
        {{/receivers}}

        // Test getters
        {{#getters}}
        getterTest{{.}}(fromInit);
        {{/getters}}
    });
};

const globalSetup = async (fromInit: FromInit{{contractName}}) => {
    const blockchain = await Blockchain.create();
    // @ts-ignore
    const contract = await blockchain.openContract(await fromInit(
        // TODO: implement default values
    ));

    // Universal deploy without message
    await blockchain.setShardAccount(contract.address, createShardAccount({
        address: contract.address,
        code: contract.init!.code,
        data: contract.init!.data,
        balance: 0n,
        workchain: 0,
    }));

    const owner = await blockchain.treasury("owner");
    const notOwner = await blockchain.treasury("notOwner");

    return { blockchain, contract, owner, notOwner };
};

{{#receiverBlocks}}
{{{.}}}
{{/receiverBlocks}}

{{#getterBlocks}}
{{{.}}}
{{/getterBlocks}}

// entry point
test{{contractName}}({{contractName}}.fromInit.bind({{contractName}}));

[Kaladin13]

Great work here! PR approved, please fix small nitpicks

[novusnota]

Nice work! Left a couple of nitpicks to resolve altogether

[novusnota]

Whoops, chose the wrong radio button :)

[novusnota]

yay!