···11+# Generated by Cargo
22+# will have compiled files and executables
33+/target/
44+**/*.rs.bk
55+66+# Remove Cargo.lock from gitignore if creating an executable, leave it for libraries
77+# More information here http://doc.crates.io/guide.html#cargotoml-vs-cargolock
88+Cargo.lock
···11+# Help
22+33+## Running the tests
44+55+Execute the tests with:
66+77+```bash
88+$ cargo test
99+```
1010+1111+All but the first test have been ignored. After you get the first test to
1212+pass, open the tests source file which is located in the `tests` directory
1313+and remove the `#[ignore]` flag from the next test and get the tests to pass
1414+again. Each separate test is a function with `#[test]` flag above it.
1515+Continue, until you pass every test.
1616+1717+If you wish to run _only ignored_ tests without editing the tests source file, use:
1818+1919+```bash
2020+$ cargo test -- --ignored
2121+```
2222+2323+If you are using Rust 1.51 or later, you can run _all_ tests with
2424+2525+```bash
2626+$ cargo test -- --include-ignored
2727+```
2828+2929+To run a specific test, for example `some_test`, you can use:
3030+3131+```bash
3232+$ cargo test some_test
3333+```
3434+3535+If the specific test is ignored, use:
3636+3737+```bash
3838+$ cargo test some_test -- --ignored
3939+```
4040+4141+To learn more about Rust tests refer to the online [test documentation][rust-tests].
4242+4343+[rust-tests]: https://doc.rust-lang.org/book/ch11-02-running-tests.html
4444+4545+## Submitting your solution
4646+4747+You can submit your solution using the `exercism submit src/lib.rs` command.
4848+This command will upload your solution to the Exercism website and print the solution page's URL.
4949+5050+It's possible to submit an incomplete solution which allows you to:
5151+5252+- See how others have completed the exercise
5353+- Request help from a mentor
5454+5555+## Need to get help?
5656+5757+If you'd like help solving the exercise, check the following pages:
5858+5959+- The [Rust track's documentation](https://exercism.org/docs/tracks/rust)
6060+- [Exercism's support channel on gitter](https://gitter.im/exercism/support)
6161+- The [Frequently Asked Questions](https://exercism.org/docs/using/faqs)
6262+6363+Should those resources not suffice, you could submit your (incomplete) solution to request mentoring.
6464+6565+## Rust Installation
6666+6767+Refer to the [exercism help page][help-page] for Rust installation and learning
6868+resources.
6969+7070+## Submitting the solution
7171+7272+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.
7373+7474+## Feedback, Issues, Pull Requests
7575+7676+The GitHub [track repository][github] is the home for all of the Rust exercises. If you have feedback about an exercise, or want to help implement new exercises, head over there and create an issue. Members of the rust track team are happy to help!
7777+7878+If you want to know more about Exercism, take a look at the [contribution guide].
7979+8080+## Submitting Incomplete Solutions
8181+It's possible to submit an incomplete solution so you can see how others have completed the exercise.
8282+8383+[help-page]: https://exercism.io/tracks/rust/learning
8484+[github]: https://github.com/exercism/rust
8585+[contribution guide]: https://exercism.io/docs/community/contributors
+69
rust/minesweeper/README.md
···11+# Minesweeper
22+33+Welcome to Minesweeper on Exercism's Rust Track.
44+If you need help running the tests or submitting your code, check out `HELP.md`.
55+66+## Instructions
77+88+Add the mine counts to a completed Minesweeper board.
99+1010+Minesweeper is a popular game where the user has to find the mines using
1111+numeric hints that indicate how many mines are directly adjacent
1212+(horizontally, vertically, diagonally) to a square.
1313+1414+In this exercise you have to create some code that counts the number of
1515+mines adjacent to a given empty square and replaces that square with the
1616+count.
1717+1818+The board is a rectangle composed of blank space (' ') characters. A mine
1919+is represented by an asterisk ('\*') character.
2020+2121+If a given space has no adjacent mines at all, leave that square blank.
2222+2323+## Examples
2424+2525+For example you may receive a 5 x 4 board like this (empty spaces are
2626+represented here with the '·' character for display on screen):
2727+2828+```
2929+·*·*·
3030+··*··
3131+··*··
3232+·····
3333+```
3434+3535+And your code will transform it into this:
3636+3737+```
3838+1*3*1
3939+13*31
4040+·2*2·
4141+·111·
4242+```
4343+4444+## Source
4545+4646+### Created by
4747+4848+- @EduardoBautista
4949+5050+### Contributed to by
5151+5252+- @ashleygwilliams
5353+- @coriolinus
5454+- @cwhakes
5555+- @EduardoBautista
5656+- @efx
5757+- @ErikSchierboom
5858+- @ffflorian
5959+- @IanWhitney
6060+- @kytrinyx
6161+- @lutostag
6262+- @mkantor
6363+- @nfiles
6464+- @petertseng
6565+- @rofrol
6666+- @stringparser
6767+- @workingjubilee
6868+- @xakon
6969+- @ZapAnton