メインコンテンツへスキップ
見出し画像

AI、二つの数を足すプログラムを作ろう|L4-012

    【AI実装型座談会|RenaとMAIのデジタル探検編】
    LEVEL 4|CREATE・開発編
    L4-012|AI、二つの数を足すプログラムを作ろう
    AI, Let's Build a Program That Adds Two Numbers!

    ──────────────────
    専門用語|変数・演算子
    Technical Keywords|Variable / Operator / Assignment / Addition / Input / Output / Data Type / Decimal / Function / Input Validation / Exception Handling / Unit Test

    講師|MAI(Mind Artificial Intelligence)
    進行・質問・実装・確認|Rena

    開発言語|Python 3.10以降
    使用ライブラリ|Python標準ライブラリ
    制作目標|二つの数を入力し、その合計を表示する
    検証方式|基本動作確認・入力境界試験・自動テスト
    確認環境|Python 3.13.5

    ──────────────────
    ■足し算だけなら、プログラムは必要ない?

    日曜日の午後。

    Renaは、机の上に並べた文房具の値段をノートに書いていた。

    ノートが120円。

    ボールペンが80円。

    机の横では、全高50センチの白とオレンジの小さなAIロボット、MAIが青いデジタルの目を光らせている。

    「ねえAI、今日はプログラムを作ってみたいんだけど」
    MAI:「何を作りたいですか?」
    「二つの数を足すプログラム!」
    MAI:「いいですね。Pythonなら数行で作れます」
    「でもさ、120円と80円なら、普通に計算できるよね?」
    MAI:「はい。答えは200円です」
    「だったら、わざわざプログラムにする意味ってあるのかな?」

    MAIは少し考えた。

    MAI:「今回の目的は、足し算の答えを知ることだけではありません」
    「じゃあ、何?」
    MAI:「数字をどのように記憶し、どの演算を実行し、結果を画面に表示するのか。その仕組みを自分で作ることです」
    「なるほど。計算の仕組みそのものを理解するんだね」
    MAI:「はい」

    Renaはノートパソコンを開いた。

    「じゃあ、最初はできるだけ簡単なものを作ろう」
    MAI:「まずは4行から始めましょう」

    ──────────────────
    ■最初のプログラムは4行

    MAIは画面にコードを表示した。

    first = 120
    second = 80
    total = first + second
    print(total)

    「これだけ?」
    MAI:「はい」
    「何をしているのか、一行ずつ教えて」

    1行目

    first = 120

    firstという変数に、120という数値を代入します。

    2行目

    second = 80

    secondという変数に、80を代入します。

    3行目

    total = first + second

    firstとsecondを足して、結果をtotalへ代入します。

    4行目

    print(total)

    totalの値を画面に表示します。

    実行結果:

    200

    「200って出た!」
    MAI:「はい。二つの数を足すプログラムができました」
    「たった4行なのに、ちゃんと動くんだね」
    MAI:「はい」

    Renaは、表示された200を見つめた。

    普段なら一瞬で終わる足し算。

    でも、その答えを自分の書いたプログラムが表示している。

    それだけで、少し違うものに見えた。

    ──────────────────
    ■変数は、数値につけた名前

    「ねえAI、firstって何?」
    MAI:「変数です」
    「変数って、数字を入れる箱みたいなもの?」
    MAI:「最初はそのように考えてもよいですが、Pythonでは名前を値へ結び付ける仕組みとして理解すると、より正確です」

    例えば、

    first = 120

    では、firstという名前で120という値を参照できます。

    「じゃあ、150を入れたい時は?」
    MAI:「右側の値を変えます」

    first = 150
    second = 80
    
    total = first + second
    
    print(total)

    出力:

    230

    「数字を変えたら答えも変わった!」
    MAI:「はい」

    また、Pythonでは、同じ変数名へ別の値を代入することもできます。

    number = 10
    number = 20
    
    print(number)

    出力:

    20

    「最初の10は表示されないんだ」
    MAI:「はい。最後の代入で、numberは20という値を参照するようになっています」

    ここで、=と+は役割が異なります。

    =|右側の値や計算結果を、左側の名前へ代入する。

    +|二つの数値を足す。

    例えば、

    total = first + second

    は、数学的な等式を宣言しているのではありません。

    「右側を計算して、その結果を左側の変数に代入する」という処理です。

    「同じ記号でも、数学の式とは少し使い方が違うんだね」
    MAI:「はい」

    ──────────────────
    ■プラス記号は演算子

    「ねえAI、足し算の+って、特別な名前があるの?」
    MAI:「加算演算子と呼びます」
    「演算子?」
    MAI:「数値などに対して、計算や比較などの操作を行うための記号です」

    Pythonでは、例えば次の演算子が使えます。

    演算演算子使用例足し算+10 + 5引き算-10 - 5掛け算*10 * 5割り算/10 / 5

    「掛け算には*を使うんだね」
    MAI:「はい」

    今回の中心は足し算なので、使用する演算子は+です。

    ただし、同じ+でも、扱うデータの種類によって動作が変わることがあります。

    「えっ? 足し算なのに?」
    MAI:「その違いを、次に確認しましょう」

    ──────────────────
    ■120と80を足したら12080になった?

    「ねえAI、今のプログラムって、最初から数字が書いてあるよね?」
    MAI:「はい」
    「毎回好きな数字を入力できるようにしたいな」
    MAI:「では、input()を使いましょう」

    first = input("1つ目の数:")
    second = input("2つ目の数:")
    
    print(first + second)

    「これで完成?」
    MAI:「実行してみましょう」

    Renaは、120と80を入力した。

    しかし、画面に表示されたのは、

    12080

    だった。

    「……あれ?」
    MAI:「どうしました?」
    「200じゃなくて、12080になっちゃった!」
    MAI:「input()は、入力された内容を文字列として受け取るからです」
    「文字列?」
    MAI:「文字を並べたデータです」

    例えば、

    print("120" + "80")

    は、数値の足し算ではありません。

    二つの文字列をつなげる処理です。

    結果は、

    12080

    になります。

    一方、

    print(120 + 80)

    なら、数値の足し算なので、

    200

    になります。

    「見た目は同じ数字なのに、文字列か数値かで結果が違うんだ!」
    MAI:「はい」

    文字列の連結と、数値の加算は異なる操作です。

    「じゃあ、入力した文字を数値へ変えればいいんだね」
    MAI:「その通りです」

    ──────────────────
    ■入力した文字を数値に変える

    整数だけを扱う場合は、int()を使えます。

    first = int(input("1つ目の数:"))
    second = int(input("2つ目の数:"))
    
    total = first + second
    
    print(total)

    入力:

    120
    80

    結果:

    200

    「今度はちゃんと200になった!」
    MAI:「はい」

    ただし、int()は整数への変換です。

    例えば、

    1.2

    のような小数を、そのままint()へ渡すと、変換できずエラーになります。

    「じゃあ、小数も扱いたい時は?」
    MAI:「別の数値型を利用します」

    ──────────────────
    ■小数も正しく足したい

    「ねえAI、例えば1.2と0.35を足したいんだけど」
    MAI:「では、十進数を扱うDecimalを使いましょう」
    「デシマル?」
    MAI:「Pythonの標準ライブラリにある数値型です」

    Pythonには、小数の計算に広く使われるfloatもあります。

    しかし、floatは通常、二進浮動小数点を利用しています。

    そのため、十進数の0.1や0.2のような値を、内部で厳密に表現できない場合があります。

    例えば、

    print(0.1 + 0.2)

    を実行すると、一般的なPython環境では、

    0.30000000000000004

    と表示されます。

    「0.3じゃないんだ!」
    MAI:「二進浮動小数点の表現に由来する結果です」

    一方、Decimalを文字列から作ると、

    from decimal import Decimal
    
    first = Decimal("0.1")
    second = Decimal("0.2")
    
    print(first + second)

    という処理で、

    0.3

    を得られます。

    「じゃあ、今回の計算はDecimalにしよう」
    MAI:「はい。ただし、Decimalにも計算精度の設定があります」

    Decimalは、あらゆる桁数の計算で無条件に丸め誤差がなくなるという仕組みではありません。

    今回は入力する数の桁数を決め、その範囲の加算が丸められないように設計します。

    ──────────────────
    ■どんなプログラムを完成させる?

    Renaは、ノートに仕様を書き出した。

    「ねえAI、完成版はどんな動作にしようか?」
    MAI:「まず、入力と出力の条件を決めましょう」

    今回の完成版は、次のようなプログラムです。

    入力
    二つの十進数を、キーボードから一つずつ入力する。

    対応する数
    整数、小数、負の数、0。

    入力形式
    半角数字の0〜9、必要に応じて先頭の+または-、小数点の.を使用する。

    桁数の制限
    整数部分は最大12桁、小数部分は最大6桁。

    先頭にある0も、整数部分の桁数へ含める。

    計算
    二つの値をDecimalとして加算する。

    出力
    入力した数と、加算結果を表示する。

    エラーへの対応
    数字以外の文字、規定外の表記、桁数超過などは受け付けず、再入力を求める。

    入力中止
    入力を終了した場合には、案内を表示して処理を終える。

    「結構細かいね」
    MAI:「はい。動作を正しく確認するためには、何を受け付けて、何を受け付けないかを決める必要があります」

    今回、入力できる例:

    120
    -8
    +4.2
    0.35
    .5
    999999999999
    0.123456

    入力できない例:

    abc
    2+3
    1,000
    1e3
    12
    12.
    0.1234567
    1000000000000

    「2+3って入力しても、そのまま計算してくれるわけじゃないんだね」
    MAI:「はい。今回のプログラムでは、二つの数を別々に入力します」

    また、0000000000000のように先頭の0が13個ある入力も拒否します。

    「0なら、いくら並んでも同じ数じゃない?」
    MAI:「数値としては同じ0ですが、今回は入力形式として12桁以内という条件を定めています」
    「なるほど。値が正しいかと、入力形式が条件に合っているかは別なんだね」

    ──────────────────
    ■完成版Pythonコード

    ファイル名|L4-012_add_two_numbers_v2.py

    対応|Python 3.10以降
    必要な追加ライブラリ|なし

    以下のコードだけで、足し算プログラムと自動テストの両方を実行できます。

    """L4-012 v2.0: 二つの数を足す(Python 3.10以降、標準ライブラリのみ)。
    
    使い方:
      python L4-012_add_two_numbers_v2.py
      python L4-012_add_two_numbers_v2.py --test
    入力: 整数部は0~12桁、小数部は0~6桁(末尾ドットは禁止)。
           先頭の0も整数部分の桁数に含む。通常の半角十進数字を使用。
    """
    
    from decimal import Decimal, Inexact, InvalidOperation, localcontext
    from io import StringIO
    from unittest.mock import patch
    import re
    import sys
    import unittest
    
    # 12桁の整数部と6桁の小数部、必要なら符号1文字・点1文字。
    MAX_INPUT_LENGTH = 20
    NUMBER_PATTERN = re.compile(r"[+-]?(?:[0-9]+(?:\.[0-9]+)?|\.[0-9]+)")
    
    
    def parse_number(raw: str) -> Decimal:
        """半角の十進数文字列を検査してDecimalに変換する。"""
        if not isinstance(raw, str):
            raise ValueError("数値を文字で入力してください。")
        text = raw.strip()
        if len(text) > MAX_INPUT_LENGTH:
            raise ValueError("入力が長すぎます。整数12桁・小数6桁以内です。")
        if NUMBER_PATTERN.fullmatch(text) is None:
            raise ValueError("数字を入力してください(例:12、-3、0.5)。")
    
        unsigned = text.lstrip("+-")
        integer_part, dot, fractional_part = unsigned.partition(".")
        if len(integer_part) > 12 or len(fractional_part) > 6:
            raise ValueError("整数部分12桁・小数部分6桁以内にしてください。")
    
        try:
            return Decimal(text)
        except InvalidOperation as exc:
            raise ValueError("数値として読み取れません。") from exc
    
    
    def add_numbers(first: Decimal, second: Decimal) -> Decimal:
        """指定した桁数の二つの十進数を正確に加算する。"""
        # 最大値同士の加算は整数13桁+小数6桁 = 最大19桁。
        # 20桁の計算精度を設定し、意図しない丸めがあれば例外にする。
        with localcontext() as context:
            context.prec = 20
            context.traps[Inexact] = True
            return first + second
    
    
    def display(number: Decimal) -> str:
        """指数表記と不要な小数末尾の0を除いて表示する。"""
        rendered = format(number, "f")
        if "." in rendered:
            rendered = rendered.rstrip("0").rstrip(".")
        return "0" if rendered in ("-0", "+0") else rendered
    
    
    def ask_number(prompt: str) -> Decimal:
        """入力が不正な間、同じ項目を再入力する。"""
        while True:
            raw = input(prompt)
            try:
                return parse_number(raw)
            except ValueError as exc:
                print(f"入力エラー:{exc}")
    
    
    def main() -> int:
        print("二つの数を足します。")
        try:
            first = ask_number("1つ目の数:")
            second = ask_number("2つ目の数:")
        except (EOFError, KeyboardInterrupt):
            print("\n入力を中止しました。")
            return 1
    
        result = add_numbers(first, second)
        print(f"計算結果:{display(first)} + {display(second)} = {display(result)}")
        return 0
    
    
    class CalculatorTests(unittest.TestCase):
        # 解析: 正常入力
        def test_01_parse_integer(self):
            self.assertEqual(parse_number("12"), Decimal("12"))
    
        def test_02_parse_negative(self):
            self.assertEqual(parse_number("-8"), Decimal("-8"))
    
        def test_03_parse_explicit_plus(self):
            self.assertEqual(parse_number("+4.2"), Decimal("4.2"))
    
        def test_04_parse_fraction(self):
            self.assertEqual(parse_number("0.35"), Decimal("0.35"))
    
        def test_05_parse_dot_fraction(self):
            self.assertEqual(parse_number(".5"), Decimal("0.5"))
    
        def test_06_parse_signed_dot_fraction(self):
            self.assertEqual(parse_number("-.5"), Decimal("-0.5"))
    
        def test_07_parse_whitespace(self):
            self.assertEqual(parse_number("  -3.5  "), Decimal("-3.5"))
    
        def test_08_parse_twelve_digits(self):
            self.assertEqual(parse_number("999999999999"), Decimal("999999999999"))
    
        def test_09_parse_six_decimal_places(self):
            self.assertEqual(parse_number("0.123456"), Decimal("0.123456"))
    
        def test_10_parse_max_width(self):
            self.assertEqual(parse_number("-999999999999.999999"), Decimal("-999999999999.999999"))
    
        def test_11_parse_leading_zero_counted(self):
            self.assertEqual(parse_number("000000000001"), Decimal("1"))
    
        def test_12_parse_zero_and_negative_zero(self):
            self.assertEqual(parse_number("-0.000000"), Decimal("0"))
    
        # 解析: エラー
        def test_13_reject_blank(self):
            with self.assertRaises(ValueError):
                parse_number("   ")
    
        def test_14_reject_letters(self):
            with self.assertRaises(ValueError):
                parse_number("abc")
    
        def test_15_reject_expression(self):
            with self.assertRaises(ValueError):
                parse_number("2+3")
    
        def test_16_reject_thirteen_digits(self):
            with self.assertRaises(ValueError):
                parse_number("1000000000000")
    
        def test_17_reject_thirteen_leading_zeros(self):
            with self.assertRaises(ValueError):
                parse_number("0000000000000")
    
        def test_18_reject_seven_fraction_places(self):
            with self.assertRaises(ValueError):
                parse_number("0.1234567")
    
        def test_19_reject_exponents(self):
            with self.assertRaises(ValueError):
                parse_number("1e3")
    
        def test_20_reject_special_values(self):
            for s in ("NaN", "Infinity", "-Infinity"):
                with self.subTest(s=s), self.assertRaises(ValueError):
                    parse_number(s)
    
        def test_21_reject_comma(self):
            with self.assertRaises(ValueError):
                parse_number("1,000")
    
        def test_22_reject_trailing_dot(self):
            with self.assertRaises(ValueError):
                parse_number("12.")
    
        def test_23_reject_sign_only(self):
            with self.assertRaises(ValueError):
                parse_number("-")
    
        def test_24_reject_fullwidth_digits(self):
            with self.assertRaises(ValueError):
                parse_number("12")
    
        def test_25_reject_nonstring(self):
            with self.assertRaises(ValueError):
                parse_number(123)
    
        def test_26_reject_long_input(self):
            with self.assertRaises(ValueError):
                parse_number("0" * 1000)
    
        # 計算
        def test_27_add_positive(self):
            self.assertEqual(add_numbers(Decimal("120"), Decimal("80")), Decimal("200"))
    
        def test_28_add_zero(self):
            self.assertEqual(add_numbers(Decimal("0"), Decimal("0")), Decimal("0"))
    
        def test_29_add_negative(self):
            self.assertEqual(add_numbers(Decimal("-8"), Decimal("3")), Decimal("-5"))
    
        def test_30_add_canceling(self):
            self.assertEqual(add_numbers(Decimal("-3"), Decimal("3")), Decimal("0"))
    
        def test_31_add_fraction(self):
            self.assertEqual(add_numbers(Decimal("1.2"), Decimal("0.35")), Decimal("1.55"))
    
        def test_32_add_small_decimal(self):
            self.assertEqual(add_numbers(Decimal("0.1"), Decimal("0.2")), Decimal("0.3"))
    
        def test_33_add_digit_carry(self):
            self.assertEqual(add_numbers(parse_number("999999999999"), parse_number("1")), Decimal("1000000000000"))
    
        def test_34_add_six_places(self):
            self.assertEqual(add_numbers(parse_number("0.000001"), parse_number("0.000002")), Decimal("0.000003"))
    
        def test_35_add_max_width(self):
            self.assertEqual(add_numbers(parse_number("999999999999.999999"), parse_number("999999999999.999999")), Decimal("1999999999999.999998"))
    
        def test_36_add_low_global_precision(self):
            from decimal import localcontext
            with localcontext() as context:
                context.prec = 3
                result = add_numbers(parse_number("999999999999.999999"), parse_number("999999999999.999999"))
            self.assertEqual(result, Decimal("1999999999999.999998"))
    
        # 表示
        def test_37_display_trailing_zeros(self):
            self.assertEqual(display(Decimal("1.5500")), "1.55")
    
        def test_38_display_integer_zeros(self):
            self.assertEqual(display(Decimal("200")), "200")
    
        def test_39_display_negative_zero(self):
            self.assertEqual(display(Decimal("-0.0000")), "0")
    
        def test_40_display_small_fraction(self):
            self.assertEqual(display(Decimal("0.000001")), "0.000001")
    
        # 入出力と中止
        def test_41_retry_invalid(self):
            with patch("builtins.input", side_effect=["abc", "120"]), patch("sys.stdout", new_callable=StringIO) as output:
                number = ask_number("数:")
            self.assertEqual(number, Decimal("120"))
            self.assertIn("入力エラー", output.getvalue())
    
        def test_42_main_integers(self):
            with patch("builtins.input", side_effect=["120", "80"]), patch("sys.stdout", new_callable=StringIO) as output:
                exit_code = main()
            self.assertEqual(exit_code, 0)
            self.assertIn("計算結果:120 + 80 = 200", output.getvalue())
    
        def test_43_main_fractions(self):
            with patch("builtins.input", side_effect=["1.2", "0.35"]), patch("sys.stdout", new_callable=StringIO) as output:
                exit_code = main()
            self.assertEqual(exit_code, 0)
            self.assertIn("計算結果:1.2 + 0.35 = 1.55", output.getvalue())
    
        def test_44_main_negatives(self):
            with patch("builtins.input", side_effect=["-8", "3"]), patch("sys.stdout", new_callable=StringIO) as output:
                exit_code = main()
            self.assertEqual(exit_code, 0)
            self.assertIn("計算結果:-8 + 3 = -5", output.getvalue())
    
        def test_45_main_bad_then_good(self):
            with patch("builtins.input", side_effect=["abc", "120", "80"]), patch("sys.stdout", new_callable=StringIO) as output:
                exit_code = main()
            self.assertEqual(exit_code, 0)
            self.assertIn("入力エラー", output.getvalue())
            self.assertIn("計算結果:120 + 80 = 200", output.getvalue())
    
        def test_46_main_eof(self):
            with patch("builtins.input", side_effect=EOFError), patch("sys.stdout", new_callable=StringIO) as output:
                exit_code = main()
            self.assertEqual(exit_code, 1)
            self.assertIn("入力を中止", output.getvalue())
    
        def test_47_main_ctrl_c(self):
            with patch("builtins.input", side_effect=KeyboardInterrupt), patch("sys.stdout", new_callable=StringIO) as output:
                exit_code = main()
            self.assertEqual(exit_code, 1)
            self.assertIn("入力を中止", output.getvalue())
    
        def test_48_main_eof_second_number(self):
            with patch("builtins.input", side_effect=["120", EOFError]), patch("sys.stdout", new_callable=StringIO) as output:
                exit_code = main()
            self.assertEqual(exit_code, 1)
            self.assertIn("入力を中止", output.getvalue())
    
    
    def run_tests() -> int:
        suite = unittest.defaultTestLoader.loadTestsFromTestCase(CalculatorTests)
        passed = unittest.TextTestRunner(verbosity=1).run(suite)
        return 0 if passed.wasSuccessful() else 1
    
    
    if __name__ == "__main__":
        if sys.argv[1:] == ["--test"]:
            sys.exit(run_tests())
        if len(sys.argv) != 1:
            print("使い方:python L4-012_add_two_numbers_v2.py [--test]", file=sys.stderr)
            sys.exit(2)
        sys.exit(main())

    ──────────────────
    ■完成版は何をしているの?

    「ねえAI、ずいぶん長いコードになったね!」
    MAI:「はい。でも、足し算の中心は一行です」
    「どこ?」
    MAI:「この部分です」

    return first + second

    「本当だ。一行だけ!」
    MAI:「ほかの部分は、入力を正しく受け取り、計算結果を表示し、動作を確認するための仕組みです」

    全体を、六つの処理に分けられます。

    ① 入力|input()
    キーボードから文字列を受け取る。

    ② 検査・変換|parse_number()
    文字列が指定した形式に合っているか確認し、Decimalへ変換する。

    ③ 計算|add_numbers()
    二つの数値を加算する。

    ④ 表示の整形|display()
    必要のない小数末尾の0などを省いて、結果を読みやすくする。

    ⑤ 全体の進行|main()
    入力、計算、結果表示を順番に実行する。

    ⑥ 検証|CalculatorTests
    入力や計算が想定どおりに動くか、複数の条件で確認する。

    「足し算は簡単でも、使えるプログラムにするにはいろいろ必要なんだね」
    MAI:「はい」

    ──────────────────
    ■小数の計算精度はどう決めた?

    「ねえAI、Decimalなら小数は絶対に正確なの?」
    MAI:「入力と計算の条件によります。今回は条件を限定して、丸めを生じさせないようにしています」

    今回の入力は、

    整数部分|最大12桁
    小数部分|最大6桁

    です。

    正の最大値同士を足した場合、

    999999999999.999999
    +999999999999.999999

    結果は、

    1999999999999.999998

    となります。

    「整数部分が13桁になった!」
    MAI:「はい。入力の整数部分が12桁以内でも、加算結果は13桁になる場合があります」

    この結果は、整数部分13桁、小数部分6桁です。

    つまり、最大で19桁分の十進の有効数字を扱う必要があります。

    そこで、計算部分に、

    with localcontext() as context:
        context.prec = 20
        context.traps[Inexact] = True
        return first + second

    を使用しています。

    「20って何?」
    MAI:「計算に用いる十進の有効数字の精度です」
    「19桁必要だから、20桁にしているんだ」
    MAI:「はい」

    また、Inexactの設定によって、計算結果が正確に表現できず丸められる場合には、黙って計算を続けず例外を発生させます。

    今回の入力範囲では、最大値同士の加算も正確に表現できます。

    ただし、この設計が対象とするのは、今回決めた入力形式と桁数です。

    すべてのDecimal計算が、どのような桁数でも自動的に正確になるという意味ではありません。

    ──────────────────
    ■プログラムを保存して実行する

    まず、Python 3.10以降が使えることを確認してください。

    Windowsでは、コマンドプロンプトやPowerShellで、

    py --version

    を実行します。

    macOS・Linuxでは、

    python3 --version

    を使用できます。

    ※環境によって、Pythonの起動コマンドが異なる場合があります。

    次に、本文の完成版コードをコピーし、次のファイル名で保存します。

    L4-012_add_two_numbers_v2.py

    保存する文字コードはUTF-8を使用してください。

    そのファイルを保存したフォルダーで、次のコマンドを実行します。

    Windows

    py L4-012_add_two_numbers_v2.py

    macOS・Linux

    python3 L4-012_add_two_numbers_v2.py

    実行すると、二つの数字の入力を求められます。

    ──────────────────
    ■動作確認1|120+80

    入力例:

    二つの数を足します。
    1つ目の数:120
    2つ目の数:80
    計算結果:120 + 80 = 200

    「最初と同じ答えになった!」
    MAI:「はい」
    「でも今度は、数字を入力できるようになってる」
    MAI:「その通りです」

    ──────────────────
    ■動作確認2|小数の足し算

    二つの数を足します。
    1つ目の数:1.2
    2つ目の数:0.35
    計算結果:1.2 + 0.35 = 1.55

    「小数もちゃんと計算できた!」
    MAI:「はい」

    ──────────────────
    ■動作確認3|負の数の足し算

    二つの数を足します。
    1つ目の数:-8
    2つ目の数:3
    計算結果:-8 + 3 = -5

    「負の数も大丈夫なんだね」
    MAI:「はい」

    負の数を入力する時は、半角の-を使用してください。

    今回の入力形式では、全角のマイナス記号などを数値の符号として受け付けません。

    ──────────────────
    ■動作確認4|間違った文字を入力したら?

    次のように、数字ではない文字を入力したとします。

    二つの数を足します。
    1つ目の数:abc
    入力エラー:数字を入力してください(例:12、-3、0.5)。
    1つ目の数:120
    2つ目の数:80
    計算結果:120 + 80 = 200

    「文字を入れても、プログラムが止まらないんだ」
    MAI:「はい。不正な入力を検出して、同じ項目の再入力を求めます」

    今回のコードでは、

    try:
        return parse_number(raw)
    except ValueError as exc:
        print(f"入力エラー:{exc}")

    という処理を利用しています。

    「ValueErrorって何?」
    MAI:「今回のように、入力された値を受け付けられない場合などに使われる例外です」

    tryで処理を試み、exceptで対応する例外を受け取ります。

    そのため、間違った入力があっても、説明を表示して再入力へ戻れます。

    ──────────────────
    ■動作確認5|桁数の境界を確認する

    「ねえAI、最大桁数もちゃんと試したい」
    MAI:「では、最も大きい入力の一つを使ってみましょう」

    1つ目:

    999999999999.999999

    2つ目:

    999999999999.999999

    結果:

    計算結果:999999999999.999999 + 999999999999.999999 = 1999999999999.999998

    「入力は12桁まででも、結果は13桁になるんだ」
    MAI:「はい。入力の制限と、出力の桁数は同じではありません」

    一方、次の入力は拒否されます。

    1000000000000

    整数部分が13桁だからです。

    また、

    0000000000000

    も拒否します。

    「先頭が0でも、13桁ならだめなんだ」
    MAI:「はい。今回の入力仕様では、先頭の0も文字として数えています」

    このような入力の端にある条件を確認することを、境界値のテストと呼びます。

    ──────────────────
    ■動作確認6|入力を中止したら?

    「ねえAI、途中でやめたい時はどうなるの?」
    MAI:「入力を中止したことを検出した場合は、メッセージを表示して終了します」

    例えば、一般的なターミナル環境でCtrl+Cを押した場合です。

    入力を中止しました。

    という案内が表示され、プログラムが終了します。

    ただし、入力中止のキー操作や、ターミナルが入力終了を伝える方法は、OSや実行環境によって異なります。

    「強制的にウィンドウを閉じなくても、終了できるようにしてあるんだね」
    MAI:「はい」

    ──────────────────
    ■48件の自動テストを実行する

    「ねえAI、いろいろ動いたけど、もう完成って言っていい?」
    MAI:「基本的な動作は確認できました。ただし、入力の境界や例外を含めて、複数の条件で試しましょう」
    「それがテストだね」
    MAI:「はい」

    今回の完成版には48件の自動テストを含めています。

    テストを実行する場合は、通常のファイル名に--testを付けます。

    Windows

    py L4-012_add_two_numbers_v2.py --test

    macOS・Linux

    python3 L4-012_add_two_numbers_v2.py --test

    このテストでは、主に次の四つを確認します。

    入力検査|26件
    整数、小数、負の数、先頭の0、最大桁数、不正文字、指数表記、長すぎる入力など。

    計算|10件
    整数、0、負の数、小数、最大桁数、外部の計算精度設定が低い場合など。

    表示|4件
    小数末尾の0、整数の末尾の0、負の0、小さな小数など。

    入出力・中止|8件
    入力エラー後の再入力、正常終了、小数、負の数、入力中止など。

    合計48件です。

    ──────────────────
    ■実行したテスト結果

    Python 3.13.5で、完成版ファイルを実行しました。

    自動テスト結果:

    ................................................
    ----------------------------------------------------------------------
    Ran 48 tests in 0.004s
    
    OK

    48件中48件PASS。

    さらに、通常のプログラム実行でも、次の6ケースを別途確認しました。

    実行ケース結果120+802001.2+0.351.55-8+3-5abc入力後に再入力エラー表示後、再入力成功最大桁数同士の加算1999999999999.999998入力終了中止メッセージと終了コードを確認

    6ケースすべて成功。

    「じゃあ、48件のテストと、6件の実際の起動確認ができたんだね」
    MAI:「はい」
    「これで絶対に間違いがない?」
    MAI:「そうとは限りません」

    今回の結果は、指定したテスト条件で期待する動作が確認されたことを示しています。

    あらゆる入力、OS、Pythonのバージョン、利用状況で問題が起こらないことを証明したわけではありません。

    「テストに通った範囲と、まだ確認していない範囲を分けるんだね」
    MAI:「その通りです」

    ──────────────────
    ■間違った結果が出たら、どこを調べる?

    Renaは完成版コードを見直した。

    「ねえAI、もし計算結果がおかしかったら、どこから調べるの?」
    MAI:「処理を分けて確認します」

    例えば、

    入力
    意図した数字を入力できたか。

    変換
    文字列が正しいDecimalになっているか。

    計算
    二つの値が正しく加算されたか。

    表示
    計算結果が意図した文字列として表示されているか。

    「全部まとめて調べるより、どこで違いが生じたか見た方がいいんだね」
    MAI:「はい」

    例えば、計算結果が正しくても、画面表示の処理が間違っていれば、利用者には誤った結果に見えます。

    逆に、画面表示が正しくても、最初に入力した数字が意図したものと異なれば、求める答えにはなりません。

    入力・変換・計算・表示を分けておくと、原因を特定しやすくなります。

    ──────────────────
    ■AIが書いたコードなら、そのまま使っていい?

    「ねえAI、こういうコードってAIに全部書いてもらえるよね?」
    MAI:「はい。コード生成を補助することはできます」
    「じゃあ、プログラミングを覚えなくてもいいのかな?」
    MAI:「少なくとも、何を作りたいのか、どの入力を受け付けるのか、何を正しい結果とするのかを理解していると、生成されたコードを検証しやすくなります」

    例えば、

    「二つの数を足すプログラムを作って」

    という依頼だけでは、

    整数だけを扱うのか。
    小数も扱うのか。
    負の数を受け付けるのか。
    入力ミスをどう扱うのか。
    計算結果をどう表示するのか。

    といった条件が決まっていません。

    Renaは、今回のプログラムを依頼する文章を考えた。

    「Pythonで二つの数を入力して足すプログラムを作ってください。整数、小数、負の数に対応してください。入力できる桁数を決め、間違った入力では再入力できるようにしてください。実行方法と自動テストも付けてください」

    「こんな感じ?」
    MAI:「はい。必要な条件を明確に伝えられています」

    AIがコードを生成したことと、生成されたコードが利用目的に適していることは同じではありません。

    また、テストが成功したことと、実際の業務に採用してよいことも別です。

    今回の完成版は、プログラミングを学習するための小さな計算プログラムです。

    ──────────────────
    ■最初の200と、最後の200

    夕方。

    Renaは、文房具の買い物リストをもう一度見た。

    ノート120円。
    ボールペン80円。

    「ねえAI、結局、最初と最後で答えは同じ200なんだよね」
    MAI:「はい」
    「でも、なんだか違う」
    MAI:「何が違いますか?」

    Renaは完成したプログラムを見つめた。

    「最初の4行は、数字を決めて計算するだけだった」
    MAI:「はい」
    「でも今は、自分で数字を入力できる」
    MAI:「その通りです」
    「小数も負の数も使えるし、間違って入力してもやり直せる」
    MAI:「はい」
    「それに、いろんな条件でテストまでできる」
    MAI:「その通りです」

    Renaは、もう一度プログラムを実行した。

    1つ目の数に120。

    2つ目の数に80。

    画面には、

    計算結果:120 + 80 = 200

    と表示された。

    「最初と同じ200なのに、今度はどうやって出てきたのか説明できる」
    MAI:「それが、今回の学習で得られたことですね」

    Renaはノートの最後に書いた。

    Pythonでは、変数を使って値を参照し、加算演算子+によって二つの数を足せる。キーボードから入力した文字列を適切な数値型へ変換すれば、実行中に好きな数を指定できる。さらに、入力形式の確認、桁数の制限、エラー処理、表示、自動テストを組み合わせることで、単なる計算式を、再現可能で検証しやすいプログラムへ発展させられる。

    「これが今日の完成品だね」
    MAI:「はい」

    Renaは、しばらく画面を見つめていた。

    「でも、面白いね」
    MAI:「何がですか?」
    「足し算の答えなんて、最初から分かってたのに」
    MAI:「はい」
    「それでも、作ってみると、知らなかったことがこんなに出てくるんだね」

    MAIの青い目が、少し明るくなった。

    MAI:「プログラムは、答えだけでなく、その答えへ至る処理を作るものでもあります」

    Renaは笑った。

    「じゃあ、今日作ったのは、200を出す機械というより……」
    MAI:「はい」
    「好きな二つの数を、ちゃんと足せる仕組みなんだね」

    机の上には、120円のノートと80円のペン。

    そしてノートパソコンには、二つの数を足す小さなプログラムが保存されていた。

    たった一つの+から始まった、Renaの計算プログラムだった。

    ──────────────────
    ■今回の学習まとめ

    1|変数
    値に名前を付け、プログラムの中で参照するための仕組み。

    2|代入
    =を使い、右側の値や計算結果を左側の変数名へ結び付けること。

    3|演算子
    計算などの処理を行うための記号。加算演算子は+。

    4|input()
    キーボードから文字列を受け取る関数。

    5|データ型
    数値、文字列など、値の種類を表すもの。

    6|文字列の連結と数値の加算
    "120" + "80"は文字列の連結。120 + 80は数値の加算。

    7|Decimal
    十進数を扱う数値型。計算精度や対象範囲を適切に設定して使用する。

    8|関数
    処理をまとめて名前を付けたもの。add_numbers()は足し算を担当する。

    9|入力チェック
    入力した内容が、決められた形式や桁数に合っているか確認すること。

    10|例外処理
    不正な入力など、通常とは異なる状況に対応する仕組み。

    11|境界値
    入力可能な範囲の端にある値。最大桁数や、その一つ外側の値など。

    12|自動テスト
    決めた入力と期待結果を用いて、プログラムの動作を確認する仕組み。

    13|最も重要な理解
    足し算の計算自体はfirst + secondという一行で実現できる。しかし、利用者が入力して使えるプログラムにするには、入力、変換、計算、表示、エラー対応、検証を組み合わせる必要がある。

    ──────────────────
    ■理解問題|5問

    問題1|変数

    次のコードで、firstは何を表しますか?

    first = 120

    A|120という値を参照する変数
    B|ファイルの拡張子
    C|画面の解像度

    問題2|演算子

    二つの数を足すPythonの演算子は?

    A|-
    B|+
    C|/

    問題3|文字列と数値

    次のコードの結果は?

    print("12" + "8")

    A|20
    B|128
    C|エラー

    問題4|入力仕様

    今回の完成版で、0000000000000を拒否する理由は?

    A|0という数字が不正だから
    B|先頭の0も数えて整数部分が13桁になるから
    C|Pythonでは0を入力できないから

    問題5|テスト

    48件の自動テストがすべて成功した場合、何が言える?

    A|すべての環境で絶対に問題が起きない
    B|今回の48件のテスト条件について期待する動作が確認された
    C|今後の検証は一切不要

    解答と解説

    問題1|A
    firstは120という値を参照するための変数名です。

    問題2|B
    +は加算演算子です。

    問題3|B
    文字列同士の+は連結なので、128になります。

    問題4|B
    今回の入力仕様では、先頭の0も整数部分の桁数に含めます。

    問題5|B
    48件のテスト成功は、そのテスト条件での確認結果です。すべての状況での完全な正しさを証明したものではありません。

    ──────────────────
    ■今日の開発実践課題

    課題1|好きな二つの整数を足す

    完成版プログラムを起動し、次の値を入力してください。

    1つ目|250
    2つ目|375

    期待結果:

    計算結果:250 + 375 = 625

    完成条件|
    二つの数値を自分で入力し、期待した計算結果を確認できること。

    課題2|小数と負の数を確認する

    次の組み合わせを計算してください。

    A|-10と4
    B|0.1と0.2
    C|2.75と1.25
    D|0と0

    期待結果:

    A|-6
    B|0.3
    C|4
    D|0

    完成条件|
    整数、小数、負の数、0の加算結果を確認できること。

    課題3|入力の境界を調べる

    次の入力を試してください。

    999999999999
    1000000000000
    000000000001
    0000000000000
    0.123456
    0.1234567

    完成条件|
    受け付けられる入力と拒否される入力を区別し、その理由を説明できること。

    課題4|エラー処理を確認する

    次の文字を入力してみましょう。

    abc
    2+3
    1e3
    12

    完成条件|
    不正な入力に対してエラーが表示され、再入力を求められることを確認できること。

    課題5|48件の自動テストを実行する

    完成版ファイルへ--testを付けて実行してください。

    python L4-012_add_two_numbers_v2.py --test

    ※Pythonの起動コマンドは使用環境に合わせて変更してください。

    完成条件|
    テストの実行結果、テスト件数、Pythonのバージョンを記録できること。

    ──────────────────
    ■参考資料

    Python Software Foundation|The Python Tutorial
    https://docs.python.org/3/tutorial/

    Python Software Foundation|Built-in Functions
    https://docs.python.org/3/library/functions.html

    Python Software Foundation|decimal — Decimal fixed-point and floating-point arithmetic
    https://docs.python.org/3/library/decimal.html

    Python Software Foundation|unittest — Unit testing framework
    https://docs.python.org/3/library/unittest.html

    Python Software Foundation|Floating-Point Arithmetic: Issues and Limitations
    https://docs.python.org/3/tutorial/floatingpoint.html

    Python Software Foundation|re — Regular expression operations
    https://docs.python.org/3/library/re.html

    ※数値型、Decimalの計算精度、例外処理、自動テストなどの説明はPython公式ドキュメントを参考にしています。

    ──────────────────
    ■制作・検証について

    本作品は「AI実装型座談会|RenaとMAIのデジタル探検編」の独立した教育記事です。

    制作規格|RM-ACF v1.2
    学習区分|LEVEL 4・CREATE/開発編
    対象テーマ|L4-012
    記事版|v2.0・内容精査/完全改訂版

    構成・本文・コード・検証項目・実践課題生成|AI
    テーマ・制作方針・採用・公開判断|人間

    RenaとMAIは架空の登場人物です。作中の会話や文房具の買い物などは、プログラミングの仕組みを説明するための創作です。

    今回の改訂では、前稿の実装を再実行し、入力条件、桁数制限、数値変換、Decimalの計算精度、表示形式、入力中止処理を精査しました。

    初版で先頭の0を整数部分の桁数に含めていなかった実装を修正し、仕様との一致を確認しました。

    また、今回の入力範囲で加算結果を正確に表現できるよう、Decimalの計算精度を明示的に設定しました。

    Python 3.13.5で48件の自動テストを実行し、すべて成功しました。

    さらに、整数、小数、負の数、不正入力後の再入力、最大桁数での計算、入力終了の6ケースについて、通常起動での動作を確認しました。

    本プログラムは、整数部分12桁、小数部分6桁までの入力を対象とする学習用実装です。実際の決済、会計処理、業務システムへの採用を目的とした設計ではありません。

    外部ネットワーク通信、データベース更新、外部ファイルの変更、第三者サービスへの操作は行っていません。

    今回のテスト成功は、確認した条件に関する結果です。すべての環境や用途での動作を保証するものではありません。

    コードの生成、テスト成功、内容の採用、実行許可、公開は、それぞれ別の行為として管理します。

    「知らなくても始められる。どこまでも深く学べる。」

    #AI #AI座談会 #Rena #MAI #I2OS #デジタル探索 #Python #プログラミング初心者 #変数 #演算子 #足し算 #Python入門 #Decimal #例外処理 #自動テスト

     
     

    ANDOM

     
     
    I2OS|人間を超えるAI能力を、社会が理解・検証・許可・運用・修復できる形へ研究・構造化。「AIは人間を超えるか」ではなく「超えた能力をどう現実へ通すか」。Beyond AGI|全投稿AI生成|Xで広域DB構築・記録検証中|20:00〜24:00の趣味

    あなたへのおすすめ