Skip to main content

​
Tests

Libraries and code tools can carry a deterministic test suite. The suite checks helpers with known inputs and expected outputs. It does not write live project data. It is not the same as a live tool run in Preview.

​
Where it lives

Open App Blueprint → Libraries or App Blueprint → Tools, then open the item. Use the Source Code and Tests tabs. Tests shows the suite source, the last run, and a run history. Each run stores the capability version at that time, pass or fail, counts, duration, and related metrics. View report opens the case-by-case result for that run, including failures, expected vs actual values, logs, and any stubbed HTTP. On a phone the report fills the screen. You do not edit suites on that page. Ask the builder in Building to add or change them.

​
How to verify

  1. Open a library or tool that should have tests.
  2. Open the Tests tab and confirm the suite source, last run, and earlier runs. Open View report when you need the case breakdown, not only the counts.
  3. If status is failed, stale, or missing (tests exist but have not been run), ask the builder to fix the suite or re-run it before you rely on Publish. Ask the builder when you need earlier runs compared by version.
  4. Publish still succeeds with a warning when tests last failed, have not been run, or the source moved since the last run. That warning does not block Publish.

​
Limits and notes

  • Suites never write live project data. Database work uses a temporary copy, not the live project. Session files and import history stay in that throwaway session. Notifications, invites, and hook events are captured on the run report and are not delivered. Outbound HTTP must be stubbed.
  • Shared helpers belong on the library suite so every tool that imports the library is covered once.
  • A live Preview run still hits real project data. Use that for integration checks, not as a substitute for the suite.
  • Export and import include suite source. Run history stays on the original workspace and is not part of export. The Tests tab shows up to 100 recent runs per library or tool.