primeiro commit com exercicios de Exercism realizados até esta data
This commit is contained in:
@@ -0,0 +1,27 @@
|
||||
{
|
||||
"authors": [
|
||||
"pheanex"
|
||||
],
|
||||
"contributors": [
|
||||
"BethanyG",
|
||||
"cmccandless",
|
||||
"Dog",
|
||||
"thomasjpfan",
|
||||
"tqa236",
|
||||
"yawpitch"
|
||||
],
|
||||
"files": {
|
||||
"solution": [
|
||||
"isbn_verifier.py"
|
||||
],
|
||||
"test": [
|
||||
"isbn_verifier_test.py"
|
||||
],
|
||||
"example": [
|
||||
".meta/example.py"
|
||||
]
|
||||
},
|
||||
"blurb": "Check if a given string is a valid ISBN-10 number.",
|
||||
"source": "Converting a string into a number and some basic processing utilizing a relatable real world example.",
|
||||
"source_url": "https://en.wikipedia.org/wiki/International_Standard_Book_Number#ISBN-10_check_digit_calculation"
|
||||
}
|
||||
@@ -0,0 +1 @@
|
||||
{"track":"python","exercise":"isbn-verifier","id":"ea0dcdf76bbb4c899e829912e28f0179","url":"https://exercism.org/tracks/python/exercises/isbn-verifier","handle":"sanctushck","is_requester":true,"auto_approve":false}
|
||||
@@ -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 isbn_verifier.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.
|
||||
@@ -0,0 +1,66 @@
|
||||
# ISBN Verifier
|
||||
|
||||
Welcome to ISBN Verifier on Exercism's Python Track.
|
||||
If you need help running the tests or submitting your code, check out `HELP.md`.
|
||||
|
||||
## Instructions
|
||||
|
||||
The [ISBN-10 verification process][isbn-verification] is used to validate book identification numbers.
|
||||
These normally contain dashes and look like: `3-598-21508-8`
|
||||
|
||||
## ISBN
|
||||
|
||||
The ISBN-10 format is 9 digits (0 to 9) plus one check character (either a digit or an X only).
|
||||
In the case the check character is an X, this represents the value '10'.
|
||||
These may be communicated with or without hyphens, and can be checked for their validity by the following formula:
|
||||
|
||||
```text
|
||||
(d₁ * 10 + d₂ * 9 + d₃ * 8 + d₄ * 7 + d₅ * 6 + d₆ * 5 + d₇ * 4 + d₈ * 3 + d₉ * 2 + d₁₀ * 1) mod 11 == 0
|
||||
```
|
||||
|
||||
If the result is 0, then it is a valid ISBN-10, otherwise it is invalid.
|
||||
|
||||
## Example
|
||||
|
||||
Let's take the ISBN-10 `3-598-21508-8`.
|
||||
We plug it in to the formula, and get:
|
||||
|
||||
```text
|
||||
(3 * 10 + 5 * 9 + 9 * 8 + 8 * 7 + 2 * 6 + 1 * 5 + 5 * 4 + 0 * 3 + 8 * 2 + 8 * 1) mod 11 == 0
|
||||
```
|
||||
|
||||
Since the result is 0, this proves that our ISBN is valid.
|
||||
|
||||
## Task
|
||||
|
||||
Given a string the program should check if the provided string is a valid ISBN-10.
|
||||
Putting this into place requires some thinking about preprocessing/parsing of the string prior to calculating the check digit for the ISBN.
|
||||
|
||||
The program should be able to verify ISBN-10 both with and without separating dashes.
|
||||
|
||||
## Caveats
|
||||
|
||||
Converting from strings to numbers can be tricky in certain languages.
|
||||
Now, it's even trickier since the check digit of an ISBN-10 may be 'X' (representing '10').
|
||||
For instance `3-598-21507-X` is a valid ISBN-10.
|
||||
|
||||
[isbn-verification]: https://en.wikipedia.org/wiki/International_Standard_Book_Number
|
||||
|
||||
## Source
|
||||
|
||||
### Created by
|
||||
|
||||
- @pheanex
|
||||
|
||||
### Contributed to by
|
||||
|
||||
- @BethanyG
|
||||
- @cmccandless
|
||||
- @Dog
|
||||
- @thomasjpfan
|
||||
- @tqa236
|
||||
- @yawpitch
|
||||
|
||||
### Based on
|
||||
|
||||
Converting a string into a number and some basic processing utilizing a relatable real world example. - https://en.wikipedia.org/wiki/International_Standard_Book_Number#ISBN-10_check_digit_calculation
|
||||
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
@@ -0,0 +1,24 @@
|
||||
def is_valid(isbn):
|
||||
# remove dashes
|
||||
isbn_no_dashes: str = "".join(isbn.split("-"))
|
||||
sum: int = 0
|
||||
# is isbn empty
|
||||
if isbn == "":
|
||||
return False
|
||||
# isbn length must be 10
|
||||
if len(isbn_no_dashes) < 10 or len(isbn_no_dashes) > 10:
|
||||
return False
|
||||
for index, digit in enumerate(isbn_no_dashes):
|
||||
# non-digit in isbn not as a checksum, return False
|
||||
if digit.isalpha() and index != 9:
|
||||
return False
|
||||
# if its a digit, ok
|
||||
if digit.isdigit():
|
||||
sum += int(digit) * (10 - index)
|
||||
# if check digit is not digit or not an 'X', return False
|
||||
if index == 9 and digit.isalpha() and digit.lower() != "x":
|
||||
return False
|
||||
# if check digit is the letter 'X' treat it as a 10
|
||||
if digit.isalpha() and index == 9 and digit.lower() == "x":
|
||||
sum += 10 * (10 - index)
|
||||
return False if sum % 11 else True
|
||||
@@ -0,0 +1,68 @@
|
||||
# These tests are auto-generated with test data from:
|
||||
# https://github.com/exercism/problem-specifications/tree/main/exercises/isbn-verifier/canonical-data.json
|
||||
# File last updated on 2023-07-19
|
||||
|
||||
import unittest
|
||||
|
||||
from isbn_verifier import (
|
||||
is_valid,
|
||||
)
|
||||
|
||||
|
||||
class IsbnVerifierTest(unittest.TestCase):
|
||||
def test_valid_isbn(self):
|
||||
self.assertIs(is_valid("3-598-21508-8"), True)
|
||||
|
||||
def test_invalid_isbn_check_digit(self):
|
||||
self.assertIs(is_valid("3-598-21508-9"), False)
|
||||
|
||||
def test_valid_isbn_with_a_check_digit_of_10(self):
|
||||
self.assertIs(is_valid("3-598-21507-X"), True)
|
||||
|
||||
def test_check_digit_is_a_character_other_than_x(self):
|
||||
self.assertIs(is_valid("3-598-21507-A"), False)
|
||||
|
||||
def test_invalid_check_digit_in_isbn_is_not_treated_as_zero(self):
|
||||
self.assertIs(is_valid("4-598-21507-B"), False)
|
||||
|
||||
def test_invalid_character_in_isbn_is_not_treated_as_zero(self):
|
||||
self.assertIs(is_valid("3-598-P1581-X"), False)
|
||||
|
||||
def test_x_is_only_valid_as_a_check_digit(self):
|
||||
self.assertIs(is_valid("3-598-2X507-9"), False)
|
||||
|
||||
def test_valid_isbn_without_separating_dashes(self):
|
||||
self.assertIs(is_valid("3598215088"), True)
|
||||
|
||||
def test_isbn_without_separating_dashes_and_x_as_check_digit(self):
|
||||
self.assertIs(is_valid("359821507X"), True)
|
||||
|
||||
def test_isbn_without_check_digit_and_dashes(self):
|
||||
self.assertIs(is_valid("359821507"), False)
|
||||
|
||||
def test_too_long_isbn_and_no_dashes(self):
|
||||
self.assertIs(is_valid("3598215078X"), False)
|
||||
|
||||
def test_too_short_isbn(self):
|
||||
self.assertIs(is_valid("00"), False)
|
||||
|
||||
def test_isbn_without_check_digit(self):
|
||||
self.assertIs(is_valid("3-598-21507"), False)
|
||||
|
||||
def test_check_digit_of_x_should_not_be_used_for_0(self):
|
||||
self.assertIs(is_valid("3-598-21515-X"), False)
|
||||
|
||||
def test_empty_isbn(self):
|
||||
self.assertIs(is_valid(""), False)
|
||||
|
||||
def test_input_is_9_characters(self):
|
||||
self.assertIs(is_valid("134456729"), False)
|
||||
|
||||
def test_invalid_characters_are_not_ignored_after_checking_length(self):
|
||||
self.assertIs(is_valid("3132P34035"), False)
|
||||
|
||||
def test_invalid_characters_are_not_ignored_before_checking_length(self):
|
||||
self.assertIs(is_valid("3598P215088"), False)
|
||||
|
||||
def test_input_is_too_long_but_contains_a_valid_isbn(self):
|
||||
self.assertIs(is_valid("98245726788"), False)
|
||||
Reference in New Issue
Block a user