89 lines
No EOL
2.9 KiB
Markdown
89 lines
No EOL
2.9 KiB
Markdown
# Help
|
|
|
|
## Running the tests
|
|
|
|
Execute the tests with:
|
|
|
|
```bash
|
|
$ cargo test
|
|
```
|
|
|
|
All but the first test have been ignored. After you get the first test to
|
|
pass, open the tests source file which is located in the `tests` directory
|
|
and remove the `#[ignore]` flag from the next test and get the tests to pass
|
|
again. Each separate test is a function with `#[test]` flag above it.
|
|
Continue, until you pass every test.
|
|
|
|
If you wish to run _only ignored_ tests without editing the tests source file, use:
|
|
|
|
```bash
|
|
$ cargo test -- --ignored
|
|
```
|
|
|
|
If you are using Rust 1.51 or later, you can run _all_ tests with
|
|
|
|
```bash
|
|
$ cargo test -- --include-ignored
|
|
```
|
|
|
|
To run a specific test, for example `some_test`, you can use:
|
|
|
|
```bash
|
|
$ cargo test some_test
|
|
```
|
|
|
|
If the specific test is ignored, use:
|
|
|
|
```bash
|
|
$ cargo test some_test -- --ignored
|
|
```
|
|
|
|
To learn more about Rust tests refer to the online [test documentation][rust-tests].
|
|
|
|
[rust-tests]: https://doc.rust-lang.org/book/ch11-02-running-tests.html
|
|
|
|
## Submitting your solution
|
|
|
|
You can submit your solution using the `exercism submit src/lib.rs Cargo.toml` command.
|
|
This command will upload your solution to the Exercism website and print the solution page's URL.
|
|
|
|
It's possible to submit an incomplete solution which allows you to:
|
|
|
|
- See how others have completed the exercise
|
|
- Request help from a mentor
|
|
|
|
## Need to get help?
|
|
|
|
If you'd like help solving the exercise, check the following pages:
|
|
|
|
- The [Rust track's documentation](https://exercism.org/docs/tracks/rust)
|
|
- The [Rust track's programming category on the forum](https://forum.exercism.org/c/programming/rust)
|
|
- [Exercism's programming category on the forum](https://forum.exercism.org/c/programming/5)
|
|
- The [Frequently Asked Questions](https://exercism.org/docs/using/faqs)
|
|
|
|
Should those resources not suffice, you could submit your (incomplete) solution to request mentoring.
|
|
|
|
## Rust Installation
|
|
|
|
Refer to the [exercism help page][help-page] for Rust installation and learning
|
|
resources.
|
|
|
|
## Submitting the solution
|
|
|
|
Generally you should submit all files in which you implemented your solution (`src/lib.rs` in most cases). If you are using any external crates, please consider submitting the `Cargo.toml` file. This will make the review process faster and clearer.
|
|
|
|
## Feedback, Issues, Pull Requests
|
|
|
|
Head to [the forum](https://forum.exercism.org/c/programming/rust/) and create a post to provide feedback about an exercise or if you want to help implement new exercises.
|
|
Members of the rust track team are happy to help!
|
|
|
|
The GitHub [track repository][github] is the home for all of the Rust exercises.
|
|
|
|
If you want to know more about Exercism, take a look at the [contribution guide].
|
|
|
|
## Submitting Incomplete Solutions
|
|
It's possible to submit an incomplete solution so you can see how others have completed the exercise.
|
|
|
|
[help-page]: https://exercism.org/tracks/rust/learning
|
|
[github]: https://github.com/exercism/rust
|
|
[contribution guide]: https://exercism.org/docs/community/contributors |