[python] Introduce Mypy Typechecking

.github/workflows/python.yml

@@ -78,14 +78,16 @@ jobs:
       - name: pytest
         working-directory: ./python
         run: bash run_unittests.sh
-  # mypy:
-  #   timeout-minutes: 10
-  #   runs-on: ubuntu-latest
-  #   needs: change-detection
-  #   if: needs.change-detection.outputs.python-changes == 'true'
-  #   steps:
-  #     - uses: actions/checkout@v6
-  #     - uses: ./.github/actions/setup-python
-  #     - name: mypy
-  #       working-directory: ./python
-  #       run: mypy .
+  mypy:
+    timeout-minutes: 10
+    runs-on: ubuntu-latest
+    needs: change-detection
+    if: needs.change-detection.outputs.python-changes == 'true'
+    steps:
+      - uses: actions/checkout@v6
+      - uses: ./.github/actions/setup-python
+      - name: mypy
+        working-directory: ./python
+        env:
+          MYPYPATH: src
+        run: mypy --namespace-packages --explicit-package-bases .

python/calculator_cli_app/src/application.py

@@ -1,6 +1,5 @@
-from args_validation import __validate__
-from calculation_query import CalculationQuery
-from data_type_conversion import __to_int_with_rescue__
+from __future__ import annotations
+
 import sys
 sys.path.append('./calculator_cli_app/src')
 sys.path.append('./calculator_cli_app/src/lib')
@@ -9,7 +8,7 @@
 
 
 class Application:
-    def __init__(self, args):
+    def __init__(self, args: list[str]) -> None:
         self.args_size = len(args)
         if self.args_size > 0:
             self.seed = args[0]
@@ -19,7 +18,7 @@ def __init__(self, args):
             self.n = ''
         self.calculation_query = CalculationQuery(self.seed)
 
-    def run(self):
+    def run(self) -> None:
         __validate__(self.args_size, self.seed, __to_int_with_rescue__(self.n))
 
         result = self.calculation_query.f(__to_int_with_rescue__(self.n))

python/calculator_cli_app/src/lib/data_type_conversion.py

@@ -1,4 +1,7 @@
-def __to_int_with_rescue__(n):
+from __future__ import annotations
+
+
+def __to_int_with_rescue__(n: str) -> int | str:
     try:
         return int(n)
     except ValueError:

python/calculator_cli_app/src/queries/calculation_query.py

@@ -4,11 +4,11 @@
 
 
 class CalculationQuery:
-    def __init__(self, seed):
+    def __init__(self, seed: str) -> None:
         self.seed = seed
         self.uri = os.environ['CALCULATION_API']
 
-    def f(self, n):
+    def f(self, n: int) -> int:
         if n == 0:
             return 1
         elif n == 2:
@@ -21,7 +21,7 @@ def f(self, n):
 
   # private
 
-    def __ask_server__(self, n):
+    def __ask_server__(self, n: int) -> int:
         params = {'seed': self.seed, 'n': n}
         req = urllib.request.Request('{}?{}'.format(
             self.uri, urllib.parse.urlencode(params)))

python/calculator_cli_app/src/validations/args_validation.py

@@ -1,4 +1,7 @@
-def __validate__(args_size, seed, n):
+from __future__ import annotations
+
+
+def __validate__(args_size: int, seed: str, n: int | str) -> None:
     if args_size > 2:
         print('Too many arguments')
         exit(1)

python/fibonacci_sequence/src/fibonacci.py

@@ -1,4 +1,7 @@
-def fibonacci(init_num, iter):
+from __future__ import annotations
+
+
+def fibonacci(init_num: int, iter: int) -> list[int]:
     current_num = init_num
     next_num = current_num + 1
     result = list()

python/fizzbuzz/src/fizzbuzz.py

@@ -1,4 +1,4 @@
-def fizzbuzz_in_if(num):
+def fizzbuzz_in_if(num: int) -> str:
     if num % 3 == 0 and num % 5 == 0:
         result = 'FizzBuzz'
     elif num % 3 == 0:
@@ -10,7 +10,7 @@ def fizzbuzz_in_if(num):
     return result
 
 
-def fizzbuzz_in_ternary(num):
+def fizzbuzz_in_ternary(num: int) -> str:
     result = 'FizzBuzz' if num % 3 == 0 and num % 5 == 0 else 'Fizz' if num % 3 == 0 else 'Buzz' if num % 5 == 0 else str(
         num)
     return result

python/letter_inspection/src/application.py

@@ -1,14 +1,14 @@
 class Application:
-    def __init__(self, str_1, str_2):
+    def __init__(self, str_1: str, str_2: str) -> None:
         self.str_1 = str_1
         self.str_2 = str_2
 
-    def exactly_equal_size_and_included(self):
+    def exactly_equal_size_and_included(self) -> bool:
         return self.__sort_string__(
             self.str_1) == self.__sort_string__(
             self.str_2)
 
     # private
 
-    def __sort_string__(self, str):
+    def __sort_string__(self, str: str) -> str:
         return ''.join(sorted(str))

python/nabeatsu/src/nabeatsu.py

@@ -1,4 +1,4 @@
-def go_crazy_in_if(num):
+def go_crazy_in_if(num: int) -> str:
     if num % 3 == 0 or '3' in str(num):
         # Express the status of 'crazy' with '!'
         result = str(num) + '!'
@@ -7,7 +7,7 @@ def go_crazy_in_if(num):
     return result
 
 
-def go_crazy_in_ternary(num):
+def go_crazy_in_ternary(num: int) -> str:
     # Express the status of 'crazy' with '!'
     result = str(num) + '!' if num % 3 == 0 or '3' in str(num) else str(num)
     return result

python/pyproject.toml

@@ -0,0 +1,5 @@
+[tool.mypy]
+python_version = "3.14"
+warn_return_any = true
+warn_unused_configs = true
+disallow_untyped_defs = true