Skip to content

[Documentation] Adding documentation for current guards to use in python3 test module#43209

Open
j-ororke wants to merge 7 commits intoproject-chip:masterfrom
j-ororke:create_guard_documentation
Open

[Documentation] Adding documentation for current guards to use in python3 test module#43209
j-ororke wants to merge 7 commits intoproject-chip:masterfrom
j-ororke:create_guard_documentation

Conversation

@j-ororke
Copy link
Contributor

Summary

Brief documentation added to python.md to help provide a reference for current guards available in the python3 test framework to be utilized to gate tests and test steps from being run in the event that the cluster being tested doesn't contain the attribute, feature, or command needed for that test step to run. Also includes documentation on PICS guard and the run_if_endpoint_matches decorator.

Testing

This is pure documentation only and no testing is needed to be performed to validate this

@j-ororke j-ororke self-assigned this Feb 18, 2026
@github-actions github-actions bot added the documentation Improvements or additions to documentation label Feb 18, 2026
Copy link
Contributor

@gemini-code-assist gemini-code-assist bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

The pull request adds valuable documentation for test guards and decorators in the Python test framework. This will significantly help developers understand how to conditionally run test steps or entire tests based on device capabilities. I have suggested a few minor updates to the code snippets to ensure they are self-contained and consistent with other examples in the document by using fully qualified names instead of undefined local variables.

@github-actions
Copy link

github-actions bot commented Feb 18, 2026

PR #43209: Size comparison from 54af27b to e422228

Full report (35 builds for bl602, bl702, bl702l, cc13x4_26x4, cc32xx, efr32, esp32, nrfconnect, nxp, psoc6, qpg, realtek, stm32, telink)
platform target config section 54af27b e422228 change % change
bl602 lighting-app bl602+mfd+littlefs+rpc FLASH 1108158 1108158 0 0.0
RAM 178674 178674 0 0.0
bl702 lighting-app bl702+eth FLASH 663234 663234 0 0.0
RAM 134689 134689 0 0.0
bl702+wifi FLASH 838940 838940 0 0.0
RAM 124213 124213 0 0.0
bl706+mfd+rpc+littlefs FLASH 1073168 1073168 0 0.0
RAM 117157 117157 0 0.0
bl702l contact-sensor-app bl702l+mfd+littlefs FLASH 905782 905782 0 0.0
RAM 105748 105748 0 0.0
lighting-app bl702l+mfd+littlefs FLASH 986234 986234 0 0.0
RAM 109644 109644 0 0.0
cc13x4_26x4 lighting-app LP_EM_CC1354P10_6 FLASH 777460 777460 0 0.0
RAM 103280 103280 0 0.0
lock-ftd LP_EM_CC1354P10_6 FLASH 785984 785984 0 0.0
RAM 108496 108496 0 0.0
pump-app LP_EM_CC1354P10_6 FLASH 731060 731060 0 0.0
RAM 97260 97260 0 0.0
pump-controller-app LP_EM_CC1354P10_6 FLASH 715580 715580 0 0.0
RAM 97460 97460 0 0.0
cc32xx air-purifier CC3235SF_LAUNCHXL FLASH 556492 556492 0 0.0
RAM 204448 204448 0 0.0
lock CC3235SF_LAUNCHXL FLASH 590688 590688 0 0.0
RAM 204744 204744 0 0.0
efr32 lock-app BRD4187C FLASH 969152 969144 -8 -0.0
RAM 125476 125476 0 0.0
BRD4338a FLASH 757692 757684 -8 -0.0
RAM 237712 237712 0 0.0
window-app BRD4187C FLASH 1066840 1066832 -8 -0.0
RAM 126700 126700 0 0.0
esp32 all-clusters-app c3devkit DRAM 98260 98260 0 0.0
FLASH 1590100 1590100 0 0.0
IRAM 93514 93514 0 0.0
nrfconnect all-clusters-app nrf52840dk_nrf52840 FLASH 955920 955920 0 0.0
RAM 162081 162081 0 0.0
nxp contact mcxw71+release FLASH 746416 746416 0 0.0
RAM 66912 66912 0 0.0
psoc6 all-clusters cy8ckit_062s2_43012 FLASH 1701788 1701788 0 0.0
RAM 213852 213852 0 0.0
all-clusters-minimal cy8ckit_062s2_43012 FLASH 1602908 1602908 0 0.0
RAM 210740 210740 0 0.0
light cy8ckit_062s2_43012 FLASH 1468652 1468652 0 0.0
RAM 196936 196936 0 0.0
lock cy8ckit_062s2_43012 FLASH 1496772 1496772 0 0.0
RAM 224720 224720 0 0.0
qpg lighting-app qpg6200+debug FLASH 840292 840292 0 0.0
RAM 127764 127764 0 0.0
lock-app qpg6200+debug FLASH 778888 778888 0 0.0
RAM 118712 118712 0 0.0
realtek light-switch-app rtl8777g FLASH 704936 704936 0 0.0
RAM 113440 113440 0 0.0
lighting-app rtl8777g FLASH 750656 750656 0 0.0
RAM 114640 114640 0 0.0
stm32 light STM32WB5MM-DK FLASH 477264 477264 0 0.0
RAM 141280 141280 0 0.0
telink bridge-app tl7218x FLASH 726486 726486 0 0.0
RAM 95708 95708 0 0.0
light-app-ota-compress-lzma-shell-factory-data tl3218x FLASH 851162 851162 0 0.0
RAM 44144 44144 0 0.0
tl7218x FLASH 842562 842562 0 0.0
RAM 99528 99528 0 0.0
light-switch-app-ota-compress-lzma-factory-data tl7218x_retention FLASH 725062 725062 0 0.0
RAM 55728 55728 0 0.0
light-switch-app-ota-compress-lzma-shell-factory-data tlsr9528a FLASH 787688 787688 0 0.0
RAM 74912 74912 0 0.0
light-switch-app-ota-factory-data tl3218x_retention FLASH 725062 725062 0 0.0
RAM 33212 33212 0 0.0
lighting-app-ota-factory-data tlsr9118bdk40d FLASH 613762 613762 0 0.0
RAM 118192 118192 0 0.0
lighting-app-ota-rpc-factory-data-4mb tlsr9518adk80d FLASH 841412 841416 4 0.0
RAM 97236 97236 0 0.0

j-ororke and others added 5 commits February 18, 2026 12:12
Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>
Fixing documentation string error
I dont even know why stylizer made this change
@j-ororke j-ororke marked this pull request as ready for review February 18, 2026 20:29
@github-actions
Copy link

github-actions bot commented Feb 18, 2026

PR #43209: Size comparison from 54af27b to 7fba52e

Full report (35 builds for bl602, bl702, bl702l, cc13x4_26x4, cc32xx, efr32, esp32, nrfconnect, nxp, psoc6, qpg, realtek, stm32, telink)
platform target config section 54af27b 7fba52e change % change
bl602 lighting-app bl602+mfd+littlefs+rpc FLASH 1108158 1108158 0 0.0
RAM 178674 178674 0 0.0
bl702 lighting-app bl702+eth FLASH 663234 663234 0 0.0
RAM 134689 134689 0 0.0
bl702+wifi FLASH 838940 838940 0 0.0
RAM 124213 124213 0 0.0
bl706+mfd+rpc+littlefs FLASH 1073168 1073168 0 0.0
RAM 117157 117157 0 0.0
bl702l contact-sensor-app bl702l+mfd+littlefs FLASH 905782 905782 0 0.0
RAM 105748 105748 0 0.0
lighting-app bl702l+mfd+littlefs FLASH 986234 986234 0 0.0
RAM 109644 109644 0 0.0
cc13x4_26x4 lighting-app LP_EM_CC1354P10_6 FLASH 777460 777636 176 0.0
RAM 103280 103280 0 0.0
lock-ftd LP_EM_CC1354P10_6 FLASH 785984 785984 0 0.0
RAM 108496 108496 0 0.0
pump-app LP_EM_CC1354P10_6 FLASH 731060 731060 0 0.0
RAM 97260 97260 0 0.0
pump-controller-app LP_EM_CC1354P10_6 FLASH 715580 715580 0 0.0
RAM 97460 97460 0 0.0
cc32xx air-purifier CC3235SF_LAUNCHXL FLASH 556492 556492 0 0.0
RAM 204448 204448 0 0.0
lock CC3235SF_LAUNCHXL FLASH 590688 590688 0 0.0
RAM 204744 204744 0 0.0
efr32 lock-app BRD4187C FLASH 969152 969144 -8 -0.0
RAM 125476 125476 0 0.0
BRD4338a FLASH 757692 757684 -8 -0.0
RAM 237712 237712 0 0.0
window-app BRD4187C FLASH 1066840 1066832 -8 -0.0
RAM 126700 126700 0 0.0
esp32 all-clusters-app c3devkit DRAM 98260 98260 0 0.0
FLASH 1590100 1590100 0 0.0
IRAM 93514 93514 0 0.0
nrfconnect all-clusters-app nrf52840dk_nrf52840 FLASH 955920 955920 0 0.0
RAM 162081 162081 0 0.0
nxp contact mcxw71+release FLASH 746416 746416 0 0.0
RAM 66912 66912 0 0.0
psoc6 all-clusters cy8ckit_062s2_43012 FLASH 1701788 1701788 0 0.0
RAM 213852 213852 0 0.0
all-clusters-minimal cy8ckit_062s2_43012 FLASH 1602908 1602908 0 0.0
RAM 210740 210740 0 0.0
light cy8ckit_062s2_43012 FLASH 1468652 1468732 80 0.0
RAM 196936 196936 0 0.0
lock cy8ckit_062s2_43012 FLASH 1496772 1496772 0 0.0
RAM 224720 224720 0 0.0
qpg lighting-app qpg6200+debug FLASH 840292 840292 0 0.0
RAM 127764 127764 0 0.0
lock-app qpg6200+debug FLASH 778888 778888 0 0.0
RAM 118712 118712 0 0.0
realtek light-switch-app rtl8777g FLASH 704936 704936 0 0.0
RAM 113440 113440 0 0.0
lighting-app rtl8777g FLASH 750656 750832 176 0.0
RAM 114640 114640 0 0.0
stm32 light STM32WB5MM-DK FLASH 477264 477440 176 0.0
RAM 141280 141280 0 0.0
telink bridge-app tl7218x FLASH 726486 726486 0 0.0
RAM 95708 95708 0 0.0
light-app-ota-compress-lzma-shell-factory-data tl3218x FLASH 851162 851362 200 0.0
RAM 44144 44148 4 0.0
tl7218x FLASH 842562 842762 200 0.0
RAM 99528 99532 4 0.0
light-switch-app-ota-compress-lzma-factory-data tl7218x_retention FLASH 725062 725062 0 0.0
RAM 55728 55728 0 0.0
light-switch-app-ota-compress-lzma-shell-factory-data tlsr9528a FLASH 787688 787688 0 0.0
RAM 74912 74912 0 0.0
light-switch-app-ota-factory-data tl3218x_retention FLASH 725062 725062 0 0.0
RAM 33212 33212 0 0.0
lighting-app-ota-factory-data tlsr9118bdk40d FLASH 613762 613962 200 0.0
RAM 118192 118196 4 0.0
lighting-app-ota-rpc-factory-data-4mb tlsr9518adk80d FLASH 841412 841616 204 0.0
RAM 97236 97240 4 0.0

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation review - pending

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants

Comments