Exercism exercises in V.

To test the exercises, run ./bin/test. This command will iterate over all exercises and check to see if their example implementation passes all the tests.

configlet is an Exercism-wide tool for working with tracks. You can download it by running:

$ ./bin/fetch-configlet

Run its lint command to verify if all exercises have all the necessary files and if config files are correct:

$ ./bin/configlet lint

The lint command is under development.
Please re-run this command regularly to see if your track passes the latest linting rules.

Basic linting finished successfully:
- config.json exists and is valid JSON
- config.json has these valid fields:
    language, slug, active, blurb, version, status, online_editor, key_features, tags
- Every concept has the required .md files
- Every concept has a valid links.json file
- Every concept has a valid .meta/config.json file
- Every concept exercise has the required .md files
- Every concept exercise has a valid .meta/config.json file
- Every practice exercise has the required .md files
- Every practice exercise has a valid .meta/config.json file
- Required track docs are present
- Required shared exercise docs are present

See INSTALLATION.md

Before committing, please run v fmt -w [FILE_NAME] on whatever file you're committing to ensure it is formatted properly. More info on V formatting can be found in the docs

Use conventional comments

Opening new issues is highly encouraged! To make the process as smooth as possible, please include as much information as possible about the issue. Better to have more information than not enough.

• Please use conventional commits
• If your PR is related to or fixes an open issue, please reference the issue number in the PR title. Here's an example.

A good place to start in the docs is to understand how the Hello World exercise is created. Make sure you've fetched configlet!

1. Pick an exercise from the problem-specifications repo.
2. Create a new entry for the exercise in config.json. Include

• a new UUID for the exercise (generated with bin/configlet uuid)
• the slug of the exercise (should be the same as in problem-specifications)
• the name of the exercise (should be the same as in problem-specifications)
• any concepts it practices and prereqs it has (safe to leave blank usually!)
• your best estimate of how difficult the task is

3. Create the directory for the exercise and download shared files using these two commands:

• bin/configlet sync --update --yes --docs --metadata --exercise [SLUG]
• bin/configlet sync --update --tests include --exercise [SLUG]

4. Create 3 files in the new directory (located at exercises/practice/[SLUG]):

• run_test.v
• [SLUG].v
• .meta/example.v

5. Write an example implementation in [SLUG].v
6. Write a test suite in run_test.v based on the canonical data in problem-specifications. Here's an example of canonical data and here's the corresponding test suite.
7. Run the test suite with v -stats test run_test.v
8. Once all tests pass, make sure code is formatted properly with v fmt -w [V_FILE] on all the v files (example and test files)
9. Copypaste everything in [SLUG].v into .meta/example.v
10. Remove everything from [SLUG].v except the stub of the needed function, the module main at the top, and make a stub of a struct or two.
11. Add needed info to the ...[SLUG]/.meta/config.json file:

• Author's GitHub username
• solution file name (should be [SLUG].v)
• test file name (should be run_test.v)
• example solution file name (should be .meta/example.v)

12. Commit changes with conventional commits
13. Make your PR and do a little happy dance

(putting these here for now until someone tells me a better place or I find a better place)

See solution #3 in (this excellent repo](https://github.com/petertseng/exercism-v#readme)

example.v

run_test.v

"All test functions have to be inside a test file whose name ends in _test.v."