55 lines
2.6 KiB
Markdown
55 lines
2.6 KiB
Markdown
|
# Help
|
||
|
|
|
||
|
|
## Running the tests
|
||
|
|
|
||
|
|
To run the included *tests*, run the test file using the `pytest` module, replacing `{exercise_name}`:
|
||
|
|
|
||
|
|
```bash
|
||
|
|
$ python3 -m pytest {exercise_name}_test.py
|
||
|
|
```
|
||
|
|
|
||
|
|
Many IDE's and code editors have built-in support for using Pytest to run tests; check them out [here](https://github.com/exercism/python/blob/main/docs/TOOLS.md#editors-and-ides).
|
||
|
|
|
||
|
|
For more information about running tests using `pytest`, checkout our [Python testing guide](https://github.com/exercism/python/blob/main/docs/TESTS.md#pytest).
|
||
|
|
|
||
|
|
### Common pytest options
|
||
|
|
|
||
|
|
- `-v` : enable verbose output.
|
||
|
|
- `-x` : stop running tests on first failure.
|
||
|
|
- `--ff` : run failures from previous test before running other test cases.
|
||
|
|
|
||
|
|
For other options, see `python3 -m pytest -h`.
|
||
|
|
|
||
|
|
## Submitting your solution
|
||
|
|
|
||
|
|
You can submit your solution using the `exercism submit grains.py` 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 [Python track's documentation](https://exercism.org/docs/tracks/python)
|
||
|
|
- [Exercism's support channel on gitter](https://gitter.im/exercism/support)
|
||
|
|
- The [Frequently Asked Questions](https://exercism.org/docs/using/faqs)
|
||
|
|
|
||
|
|
Should those resources not suffice, you could submit your (incomplete) solution to request mentoring.
|
||
|
|
|
||
|
|
Below are some resources for getting help if you run into trouble:
|
||
|
|
|
||
|
|
- [The PSF](https://www.python.org) hosts Python downloads, documentation, and community resources.
|
||
|
|
- [Python Community on Discord](https://pythondiscord.com/) is a very helpful and active community.
|
||
|
|
- [#python on Libera.chat](https://www.python.org/community/irc/) this is where the cored developers for the language hang out and get work done.
|
||
|
|
- [Exercism on Gitter](https://gitter.im/exercism/home) join the Python room for Python-related questions or problems.
|
||
|
|
- [/r/learnpython/](https://www.reddit.com/r/learnpython/) is a subreddit designed for Python learners.
|
||
|
|
- [Python Community Forums](https://discuss.python.org/)
|
||
|
|
- [Pythontutor](http://pythontutor.com/) for stepping through small code snippets visually.
|
||
|
|
|
||
|
|
|
||
|
|
Additionally, [StackOverflow](http://stackoverflow.com/questions/tagged/python) is a good spot to search for your problem/question to see if it has been answered already.
|
||
|
|
If not - you can always [ask](https://stackoverflow.com/help/how-to-ask) or [answer](https://stackoverflow.com/help/how-to-answer) someone else's question.
|