clojure / clojure/clojure-site
Add create-basis/process example to tools.build docs
Nobody has claimed this yet.
- Dominant language
- HTML
- Stars
- 259
- Forks
- 275
- PR merge metrics
- No merged PRs in 30d
Description
Per discussion on Slack about using clojure.tools.build to run tests that need a particular classpath, including the test runner itself, Alex said "you can use a combo of create-basis, java-command, and process to execute it".
It would be great if the tools.build guide had an example of doing this with Cognitect's test-runner to provide a canonical example of how to do this in a build script (where the build script is invoked as the only dependency via -T).
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start with the tools.build guide and identify where build-script examples using -T belong. Add a canonical example combining create-basis, java-command, and process to run Cognitect's test-runner with the required classpath, then verify that the guide clearly explains the invocation and expected result.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- clojure
- Domain
- documentation
- Issue type
- Documentation
- Difficulty
- 2/5
- Estimated time
- 1-3 hours
- Activity status
- Quiet
- Clarity
- Mostly clear
- Newbie friendliness
- 65/100