add a fate dice roller (#1)

* add a fate dice roller
* add github action for tests

Author: jeremyqa

.github/actions/test_suite/action.yml

@@ -0,0 +1,16 @@
+name: "Test Suite"
+description: "Run tests"
+
+runs:
+  using: "composite"
+  steps:
+    - name: Install deps
+      run: |
+        pip install -r requirements.txt
+      shell: bash
+
+    - name: Run Tests
+      run: |
+        pytest src/
+      shell: bash
+

.github/workflows/pull_request.yml

@@ -0,0 +1,19 @@
+name: Pull Request
+
+on:
+  pull_request:
+    branches:
+      - '*'
+
+    paths-ignore:
+      - '**.md'
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - name: "Checkout code"
+        uses: actions/checkout@v2
+
+      - name: "Test Suite"
+        uses: ./.github/actions/test_suite

requirements.txt

@@ -1,2 +1,3 @@
 requests==2.28.1
-black==22.10.0
+black==22.10.0
+pytest==7.2.0

src/some_file.py

@@ -1,6 +1,19 @@
 import requests
+from random import randint
 
 
 def make_a_request() -> int:
     response = requests.get('https://example.com')
     return response.status_code
+
+
+def roll_fate(bonus: int = 0) -> int:
+    return sum([_fate_to_number(randint(1, 6)) for _ in range(4)]) + bonus
+
+
+def _fate_to_number(raw: int) -> int:
+    if raw < 3:
+        return -1
+    if raw > 4:
+        return 1
+    return 0

src/test_some_file.py

@@ -1,6 +1,20 @@
 from http import HTTPStatus
-from some_file import make_a_request
+from unittest.mock import patch
+
+from some_file import make_a_request, roll_fate
 
 
 def test_make_a_request() -> None:
     assert make_a_request() == HTTPStatus.OK
+
+
+def test_roll_fate_no_mock() -> None:
+    assert -4 <= roll_fate(0) <= 4
+
+
+class TestRollFate:
+    def test_all_1s_returns_negative_four(self) -> None:
+        with patch('some_file.randint', return_value=1):
+            assert roll_fate(0) == -4
+            assert roll_fate(0) == -4
+            assert roll_fate(0) == -4