Skip to content

Commit

Permalink
python/scrabble-score: download exercise
Browse files Browse the repository at this point in the history
  • Loading branch information
vpayno committed Apr 13, 2024
1 parent 4aebae8 commit 18b59c6
Show file tree
Hide file tree
Showing 6 changed files with 276 additions and 0 deletions.
32 changes: 32 additions & 0 deletions python/scrabble-score/.exercism/config.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,32 @@
{
"authors": [],
"contributors": [
"behrtam",
"cmccandless",
"Dog",
"ikhadykin",
"kotp",
"kytrinyx",
"lowks",
"N-Parsons",
"parinporecha",
"Peque",
"pheanex",
"sjakobi",
"tqa236"
],
"files": {
"solution": [
"scrabble_score.py"
],
"test": [
"scrabble_score_test.py"
],
"example": [
".meta/example.py"
]
},
"blurb": "Given a word, compute the Scrabble score for that word.",
"source": "Inspired by the Extreme Startup game",
"source_url": "https://github.com/rchatley/extreme_startup"
}
1 change: 1 addition & 0 deletions python/scrabble-score/.exercism/metadata.json
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
{"track":"python","exercise":"scrabble-score","id":"7be7d89515204f0e9edf77fbc1f183d4","url":"https://exercism.org/tracks/python/exercises/scrabble-score","handle":"vpayno","is_requester":true,"auto_approve":false}
130 changes: 130 additions & 0 deletions python/scrabble-score/HELP.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,130 @@
# Help

## Running the tests

We use [pytest][pytest: Getting Started Guide] as our website test runner.
You will need to install `pytest` on your development machine if you want to run tests for the Python track locally.
You should also install the following `pytest` plugins:

- [pytest-cache][pytest-cache]
- [pytest-subtests][pytest-subtests]

Extended information can be found in our website [Python testing guide][Python track tests page].


### Running Tests

To run the included tests, navigate to the folder where the exercise is stored using `cd` in your terminal (_replace `{exercise-folder-location}` below with your path_).
Test files usually end in `_test.py`, and are the same tests that run on the website when a solution is uploaded.

Linux/MacOS
```bash
$ cd {path/to/exercise-folder-location}
```

Windows
```powershell
PS C:\Users\foobar> cd {path\to\exercise-folder-location}
```

<br>

Next, run the `pytest` command in your terminal, replacing `{exercise_test.py}` with the name of the test file:

Linux/MacOS
```bash
$ python3 -m pytest -o markers=task {exercise_test.py}
==================== 7 passed in 0.08s ====================
```

Windows
```powershell
PS C:\Users\foobar> py -m pytest -o markers=task {exercise_test.py}
==================== 7 passed in 0.08s ====================
```


### Common options
- `-o` : override default `pytest.ini` (_you can use this to avoid marker warnings_)
- `-v` : enable verbose output.
- `-x` : stop running tests on first failure.
- `--ff` : run failures from previous test before running other test cases.

For additional options, use `python3 -m pytest -h` or `py -m pytest -h`.


### Fixing warnings

If you do not use `pytest -o markers=task` when invoking `pytest`, you might receive a `PytestUnknownMarkWarning` for tests that use our new syntax:

```bash
PytestUnknownMarkWarning: Unknown pytest.mark.task - is this a typo? You can register custom marks to avoid this warning - for details, see https://docs.pytest.org/en/stable/mark.html
```

To avoid typing `pytest -o markers=task` for every test you run, you can use a `pytest.ini` configuration file.
We have made one that can be downloaded from the top level of the Python track directory: [pytest.ini][pytest.ini].

You can also create your own `pytest.ini` file with the following content:

```ini
[pytest]
markers =
task: A concept exercise task.
```

Placing the `pytest.ini` file in the _root_ or _working_ directory for your Python track exercises will register the marks and stop the warnings.
More information on pytest marks can be found in the `pytest` documentation on [marking test functions][pytest: marking test functions with attributes] and the `pytest` documentation on [working with custom markers][pytest: working with custom markers].

Information on customizing pytest configurations can be found in the `pytest` documentation on [configuration file formats][pytest: configuration file formats].


### Extending your IDE or Code Editor

Many IDEs and code editors have built-in support for using `pytest` and other code quality tools.
Some community-sourced options can be found on our [Python track tools page][Python track tools page].

[Pytest: Getting Started Guide]: https://docs.pytest.org/en/latest/getting-started.html
[Python track tools page]: https://exercism.org/docs/tracks/python/tools
[Python track tests page]: https://exercism.org/docs/tracks/python/tests
[pytest-cache]:http://pythonhosted.org/pytest-cache/
[pytest-subtests]:https://github.com/pytest-dev/pytest-subtests
[pytest.ini]: https://github.com/exercism/python/blob/main/pytest.ini
[pytest: configuration file formats]: https://docs.pytest.org/en/6.2.x/customize.html#configuration-file-formats
[pytest: marking test functions with attributes]: https://docs.pytest.org/en/6.2.x/mark.html#raising-errors-on-unknown-marks
[pytest: working with custom markers]: https://docs.pytest.org/en/6.2.x/example/markers.html#working-with-custom-markers

## Submitting your solution

You can submit your solution using the `exercism submit scrabble_score.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)
- The [Python track's programming category on the forum](https://forum.exercism.org/c/programming/python)
- [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.

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.
- [The Exercism Community on Discord](https://exercism.org/r/discord)
- [Python Community on Discord](https://pythondiscord.com/) is a very helpful and active community.
- [/r/learnpython/](https://www.reddit.com/r/learnpython/) is a subreddit designed for Python learners.
- [#python on Libera.chat](https://www.python.org/community/irc/) this is where the core developers for the language hang out and get work done.
- [Python Community Forums](https://discuss.python.org/)
- [Free Code Camp Community Forums](https://forum.freecodecamp.org/)
- [CodeNewbie Community Help Tag](https://community.codenewbie.org/t/help)
- [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.
67 changes: 67 additions & 0 deletions python/scrabble-score/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,67 @@
# Scrabble Score

Welcome to Scrabble Score on Exercism's Python Track.
If you need help running the tests or submitting your code, check out `HELP.md`.

## Instructions

Given a word, compute the Scrabble score for that word.

## Letter Values

You'll need these:

```text
Letter Value
A, E, I, O, U, L, N, R, S, T 1
D, G 2
B, C, M, P 3
F, H, V, W, Y 4
K 5
J, X 8
Q, Z 10
```

## Examples

"cabbage" should be scored as worth 14 points:

- 3 points for C
- 1 point for A, twice
- 3 points for B, twice
- 2 points for G
- 1 point for E

And to total:

- `3 + 2*1 + 2*3 + 2 + 1`
- = `3 + 2 + 6 + 3`
- = `5 + 9`
- = 14

## Extensions

- You can play a double or a triple letter.
- You can play a double or a triple word.

## Source

### Contributed to by

- @behrtam
- @cmccandless
- @Dog
- @ikhadykin
- @kotp
- @kytrinyx
- @lowks
- @N-Parsons
- @parinporecha
- @Peque
- @pheanex
- @sjakobi
- @tqa236

### Based on

Inspired by the Extreme Startup game - https://github.com/rchatley/extreme_startup
2 changes: 2 additions & 0 deletions python/scrabble-score/scrabble_score.py
Original file line number Diff line number Diff line change
@@ -0,0 +1,2 @@
def score(word):
pass
44 changes: 44 additions & 0 deletions python/scrabble-score/scrabble_score_test.py
Original file line number Diff line number Diff line change
@@ -0,0 +1,44 @@
# These tests are auto-generated with test data from:
# https://github.com/exercism/problem-specifications/tree/main/exercises/scrabble-score/canonical-data.json
# File last updated on 2023-07-19

import unittest

from scrabble_score import (
score,
)


class ScrabbleScoreTest(unittest.TestCase):
def test_lowercase_letter(self):
self.assertEqual(score("a"), 1)

def test_uppercase_letter(self):
self.assertEqual(score("A"), 1)

def test_valuable_letter(self):
self.assertEqual(score("f"), 4)

def test_short_word(self):
self.assertEqual(score("at"), 2)

def test_short_valuable_word(self):
self.assertEqual(score("zoo"), 12)

def test_medium_word(self):
self.assertEqual(score("street"), 6)

def test_medium_valuable_word(self):
self.assertEqual(score("quirky"), 22)

def test_long_mixed_case_word(self):
self.assertEqual(score("OxyphenButazone"), 41)

def test_english_like_word(self):
self.assertEqual(score("pinata"), 8)

def test_empty_input(self):
self.assertEqual(score(""), 0)

def test_entire_alphabet_available(self):
self.assertEqual(score("abcdefghijklmnopqrstuvwxyz"), 87)

0 comments on commit 18b59c6

Please sign in to comment.