Skip to content

Commit f619f7d

Browse files
committed
Adds notes on the Test library backend spec
1 parent 8a04200 commit f619f7d

1 file changed

Lines changed: 28 additions & 1 deletion

File tree

ports/spec.md

Lines changed: 28 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -76,4 +76,31 @@ A PorTS interpreter implementation should load the core procedures in the follow
7676
- Pair
7777
- Boolean
7878

79-
## Library Backend
79+
80+
## Ports Testing Library
81+
82+
### Required mechanisms
83+
- Declaring which suite is to be used
84+
- Filling placeholders, e.g. by implementing methods and adding annotations, or a dictionary mapping placeholder names to function identifiers
85+
- Starting the execution of the test suite, by calling `run-suite` with the required parameters
86+
87+
88+
### Optional mechanisms
89+
- Warning when placeholders are not defined
90+
- Proposing snippets to fill placeholders quickly
91+
- Selecting/excluding tests and capabilities (only, exclude for tests and capabilities)
92+
- Expected failures
93+
- Integration with host test runner
94+
95+
96+
### Required interface from the Ports Testing Library
97+
- Loading the ports.scm definitions
98+
- Defining ports primitives
99+
- assert
100+
- is-assertion-error?
101+
- create-placeholder
102+
- is-placeholder?
103+
- thread
104+
- thread-wait-for-completion
105+
- thread-sleep!
106+
- thread-yield

0 commit comments

Comments
 (0)