Skip to content

Latest commit

 

History

History
75 lines (46 loc) · 3.21 KB

README.md

File metadata and controls

75 lines (46 loc) · 3.21 KB
Raw

Exercism Factor Track

[Configlet Status]

Exercism problems in Factor.

We ❤️ pull requests, issues and suggestions.

Contributing Guide

Please see the contributing guide.

Working on the Exercises

We welcome both improvements to the existing exercises and new exercises. A pool of exercise ideas can be found in the x-common repo.

If you do contribute, please try to follow the guidelines for Factor code in this repo:

  • Factor code should run in both the latest stable Factor as well as the latest nightly Factor. This is not a very hard requirement to meet, since Factor is very stable. If something only works in a certain version, find a different way.

  • Code should strictly follow the Factor code conventions. This is also not a very hard task, and makes reading and writing code much easier.

  • Code should compile and pass all of its unit tests, tested using exercism.testing.

Get set up with using Factor to run and test the exercise code

Here's what you need to do to start working with the Factor code in the exercises directory.

  1. Download exercism.testing and put it somewhere Factor can find it. Your resource:work directory is a good choice, so testing.factor is resource:work/exercism/testing/testing.factor.

  2. Test an exercise's example code with:

factor (master) $ factor -run=exericsm.testing hello-world
working directory OK: /home/you/git/factor is a dev-env
config.json and exercises OK

testing exercise: hello-world

Unit Test: { { "Hello, World!" } [ say-hello ] }

Alternatively, to run all tests in all exercise directories:

factor (master) $ factor -run=exericsm.testing run-all
working directory OK: /home/you/git/factor is a dev-env
config.json and exercises OK

testing exercise: hello-world

Unit Test: { { "Hello, World!" } [ say-hello ] }

config.json is verified for logical integrity on each run. To only check config.json's validity:

factor (master) $ factor -run=exericsm.testing VERIFY
working directory OK: /home/you/git/factor is a dev-env
config.json and exercises OK

If config.json is invalid, then an error will be thrown and tests will not run.

Check out exercism-testing's documentation for more information.

  1. Find a bug, or have a question or comment about exercism.testing? Open an issue or pull request!

Working on the Documentation

If you think you've found a factual or technical error, or you just have a question or suggestion about some part of the Markdown or Factor documentation, we'd ❤️ you to open an issue or pull request.

Factor icon

The Factor "Tyrannosaurus Rex" logo is owned by John Benediktsson. We have adapted it, changing the colour scheme, with his permission.