🎨 Macros update and documentation

[lrazovic]

This pull request introduces significant improvements and new features to macros in the pallets/funding/src/instantiator/macros.rs file. The changes include enhancements to the assert_close_enough! macro, the addition of a new is_close_enough! macro, and a comprehensive overhaul of the find_event! macro to support more advanced use cases. These updates improve functionality, readability, and flexibility when working with runtime events and assertions in the Substrate framework.

Enhancements to assert_close_enough! macro:

• Improved logic to handle edge cases where both values are zero, ensuring Perquintill::one() is returned in such scenarios.
• Enhanced support for custom error messages by restructuring the macro to accept variadic arguments for the message.
• Refactored the implementation for better readability and maintainability by introducing intermediate variables for clarity.

Addition of is_close_enough! macro:

• Introduced a new macro is_close_enough! to check if two values are close enough based on a minimum percentage, returning a boolean instead of asserting.
• Incorporated the same edge case handling and refactored logic as in assert_close_enough! for consistency.

[lrazovic]

• [DNM] Instantiator refactor and cleanup #494
• Bid with receiving account: xcm support #490
• Possible bug fixes #491
• feat: specify amount to invest #489
• 🎨 Refactor the Price Buckets #488
• ⚡️ Remove AccountId and id from stored value #487
• ✨ Use PLMC amount in Evaluation #484
• ⚡️ Remove useless clone #486
• 🎨 Simplify the acceptable_assets #485
• 🎨 Macros update and documentation #483 👈 (View in Graphite)
• ⬆️ Bump to Polkadot SDK stable 2503-5 #482 : 1 other dependent PR (#493 )
• main

This stack of pull requests is managed by Graphite. Learn more about stacking.

[Copilot]

Pull Request Overview

This PR updates macros in the funding instantiator to improve runtime event assertions and introduce new functionality.

• Enhances the assert_close_enough! macro with clearer intermediate variables and a unified edge-case handling.
• Adds the new is_close_enough! macro for boolean checks based on closeness.
• Overhauls the find_event! macro to support advanced event filtering with field checks.

[dastansam]

Suggested change

#[macro_export]

doesn't need to be exported? (not sure if it works though)

[lrazovic]

Merge activity

• Aug 4, 7:49 AM UTC: A user started a stack merge that includes this pull request via Graphite.
• Aug 4, 7:51 AM UTC: Graphite rebased this pull request as part of a merge.
• Aug 4, 7:52 AM UTC: @lrazovic merged this pull request with Graphite.