import sqlite3

初期化処理ではデータベースの作成と、JSONファイルから読み込んだデータを

データベースに追加しています

データベースはファイルで保存されます

※MYSQLなどはファイルとして見えないようになっています

　（どのような製品でもデータを保持するためにはファイルは必要ですけど…）

バイナリファイルなので中身の確認は難しいですが、ファイルが存在することで、

データベースが存在することがわかります

データベースファイル名をemployee.dbにして、ファイルが存在しないであれば、

データベースを作成するようにしてます

    self.mydb: str = 'employee.db' 

    if (not os.path.exists(self.mydb)):

データベースファイルに接続します

データベースファイルがなければ作成してくれます

なので「CREATE DATABASE IF NOT EXISTS employee.db」は不要です

データベースオブジェクトを返してくれます

以降、データベースオブジェクトを利用してデータベース操作を行います

        conn = sqlite3.connect(self.mydb)

データベース接続オブジェクトを利用してカーソルを作成します

カーソルはSQL 文を実行し、SQL クエリから結果を取得するためのオブジェクトです

        cursor = conn.cursor()

データベースにテーブルを作成します

社員情報テーブル、社員趣味情報テーブル、社員特技情報テーブルの３つを作成して

います

※Pythonは、シングルクォーテーションまたはダブルクォーテーション３つで

　文字列を挟むと改行した文字列を１つの文字列とみなしてくれます

　私は好きではないので、後ほど修正しておきます

　※ちなみに、改行に続くスペースも文字列の中に含まれてしまいますが

　　sqlite3が大丈夫なように作成してくれています

           cursor.execute("""CREATE TABLE IF NOT EXISTS tbl_employee(

                              no INTEGER PRIMARY KEY,

                              name TEXT,

                              birth TEXT,

                              sex TEXT)""")

            # 社員趣味情報テーブルを作成する

            cursor.execute("""CREATE TABLE IF NOT EXISTS tbl_employee_hobby(

                              id INTEGER PRIMARY KEY AUTOINCREMENT,

                              no INTEGER,

                              hobby TEXT)""")

            # 社員特技情報をテーブルを作成する

            cursor.execute("""CREATE TABLE IF NOT EXISTS tbl_employee_skill(

                              id INTEGER PRIMARY KEY AUTOINCREMENT,

                              no INTEGER,

                              skill TEXT)""")

社員情報テーブルに追加する処理は以下です

SQLコマンドを作成するときに文字列のformatメソッドを利用しています

文字列内に{0],{1},…と記述しておいて、それに対応する文字列をformatメソッドの

引数に順番に並べて記述すると、{0},{1]に割り当てて文字列を作成してくれます

なお、1行で式が記述できないときは「\」を行の最後に記述すると次の行も１つの

行とみなしてくれます

その後、SQL文を実行することにより、テーブルに情報を追加します

このひとまとまりの情報を「行」と呼びます

                        sql_emp: str = \
                            "INSERT INTO tbl_employee VALUES " + \
                            "('{0}', '{1}', '{2}', '{3}')".format(
                                str(emp['no']),
                                emp['name'],
                                emp['birth'],
                                emp['sex'])
                        cursor.execute(sql_emp)
 

社員趣味情報テーブル、社員特技情報テーブルも同様ですが、主キーは自動生成して

もらうので、行に追加する情報としては記述していません

最後にカーソルを閉じて、データベース接続を閉じて終了です…

        cursor.close()
        conn.commit()
        conn.close()
 

何か１つ余分な記述がありますね…

commitは「送り込む、収容する」という意味の英単語です

「INSERT」で情報を追加したのですが、実はデータベースには格納されていません

複数テーブルに複数行を追加していますが、途中で不具合が発生したときは追加が

中途半端になってしまいますよね

一連の処理の一部でもかけてしまったら、例えば趣味の追加が失敗したら、趣味が

なくなってしまいます

複数行に複数行を追加するような一連の操作を「トランザクション」と呼びます

データベースは「常に正しい状態を維持する」機能を持っているのです

特に「更新を伴う処理」に対しては

「トランザクション」が無事に成功するまではデータベースに「正しい情報『群』」を

追加しないようにしてくれているのです

そして、プログラムが最後まで正しく動作した時にcommitメソッドを発行して、

データベースに変更した（今回は追加した）内容を送り込んでいるのです

なかなかの優れものですね

※ちなみに失敗した時に、明示的にデータベースへの操作（変更とか追加とか）を

　無効にするのはrollbackメソッドです

　初期化処理内では、データベース接続オブジェクトでテーブルへのデータ追加

　トランザデータ処理しか行ってないので、rollbackメソッドを意識してません

　失敗したら、どっかで例外が発生してccommitメソッド発行されずに終了する

　ので問題ないです

　割といい加減なようですけど、これで大丈夫だと思います

　（複数のトランザクションがなければ大丈夫です）

みましょう

社員リストはJSONファイルから読み込みます

【emplist.json】

{    "data": [        {            "no": 2601,            "name": "鈴木一郎",            "birth": "1974/02/09",            "sex": "男",            "skill": ["野球"]        },        {            "no": 2602,            "name": "山田花子",            "birth": "1992/03/31",            "sex": "女",            "hobby": ["料理"],            "skill": ["ピアノ"]        },        {            "no": 2603,             "name": "佐藤翠",            "birth": "2008/11/23",            "sex": "女",            "hobby": ["キャンプ"]        },        {            "no": 2604,             "name": "高橋湊",            "birth": "2000/07/10",            "sex": "男"        },        {            "no": 2605,             "name": "伊藤陽菜",            "birth": "2000/12/24",            "sex": "女",            "hobby": ["水泳", "ゴルフ"],            "skill": ["料理"]        },        {            "no": 2606,             "name": "渡辺謙",            "birth": "1970/05/31",            "sex": "男",            "hobby": ["料理"],            "skill": ["キャンプ", "釣り"]        }    ]}

演習問題１の辞書に保存する部分をデータベースに保存するようにしました

（解説は次回に続く）

【employee.py】

######################################################################## 社員情報#                                                Copyrint 2026 Precede.#######################################################################import datetimeimport enumimport jsonimport osimport sqlite3class ErrMsg(enum.StrEnum):    ''' エラーメッセージ        Args:            enum.StrEnum : 文字列列挙クラス        Returns:            None    '''    # 「社員リストが見つかりません」    LIST_NOT_FOUND = "No employee list."    # 「社員リストへの登録がありません」    LIST_EMPTY = "No one is registered on the employee list."    # 「社員番号がありません」    EMPLOYEE_NO_INVALID = "The employee number is invalid."    # 「社員番号が不正です」    EMPLOYEE_NO_NOT_FOUND = "Employee number not found."    # 「管理者に問い合わせてください」    UNKNOW = "Please contact your system administrator."class Employee:    ''' 社員情報        Args:            None        Returns:            社員情報(str)    '''    def __init__(self):        ''' コンストラクタ            Args:                self : 自分自身            Returns:                None        '''        # エラーコード        self.err_msg: ErrMsg = None        # 社員リストファイル名        self.inp_filename: str = "emplist.json"        # ログファイル        self.log_filename: str = "employee.log"        # データベース名プロパティを設定する        self.mydb: str = 'employee.db'        # データベースが存在しない場合        if (not os.path.exists(self.mydb)):            # データベースを作成する            conn = sqlite3.connect(self.mydb)            # カーソルを作成する            cursor = conn.cursor()            # 社員情報テーブルを作成する            cursor.execute("""CREATE TABLE IF NOT EXISTS tbl_employee(                              no INTEGER PRIMARY KEY,                              name TEXT,                              birth TEXT,                              sex TEXT)""")            # 社員趣味情報テーブルを作成する            cursor.execute("""CREATE TABLE IF NOT EXISTS tbl_employee_hobby(                              id INTEGER PRIMARY KEY AUTOINCREMENT,                              no INTEGER,                              hobby TEXT)""")            # 社員スキル情報をテーブルを作成する            cursor.execute("""CREATE TABLE IF NOT EXISTS tbl_employee_skill(                              id INTEGER PRIMARY KEY AUTOINCREMENT,                              no INTEGER,                              skill TEXT)""")            # 社員リストファイルが存在する場合            if (os.path.exists(self.inp_filename)):                # 社員リストファイルが空の場合                if (os.path.getsize(self.inp_filename) == 0):                    # エラーメッセージに「社員リストへの登録がありません」を設定する                    self.err_msg = ErrMsg.LIST_EMPTY                # 社員リストファイルが空でない場合                else:                    # 社員リストファイルを開く                    with open(self.inp_filename, "r", encoding="utf-8") as fn:                        # 社員情報数分繰り返す                        for emp in json.load(fn)['data']:                            # 社員情報追加コマンドを編集する                            sql_emp: str = \                                "INSERT INTO tbl_employee VALUES " + \                                "('{0}', '{1}', '{2}', '{3}')".format(                                    str(emp['no']),                                    emp['name'],                                    emp['birth'],                                    emp['sex'])                            # 社員情報を社員情報テーブルに追加する                            cursor.execute(sql_emp)                            # 社員情報に趣味が登録されている場合                            if ('hobby' in emp):                                # 社員情報の趣味数分繰り返す                                for hby in emp['hobby']:                                    # 社員趣味情報追加コマンドを編集する                                    sql_emp_hby: str = \                                        "INSERT INTO tbl_employee_hobby " + \                                        "(no, hobby) VALUES " +\                                        "('{0}', '{1}')".format(str(emp['no']),                                                                hby)                                    # 社員趣味情報を社員趣味情報テーブルに追加する                                    cursor.execute(sql_emp_hby)                            # 社員情報に特技が登録されている場合                            if ('skill' in emp):                                # 社員情報の特技数分繰り返す                                for skl in emp['skill']:                                    # 社員特技情報追加コマンドを編集する                                    sql_emp_skl: str = \                                        "INSERT INTO tbl_employee_skill " + \                                        "(no, skill) VALUES " + \                                        "('{0}', '{1}')".format(str(emp['no']),                                                                skl)                                    # 社員特技情報を社員特技情報テーブルに追加する                                    cursor.execute(sql_emp_skl)            # 社員リストファイルが存在しない場合            else:                # エラーメッセージに「社員リストが見つかりません」を設定する                self.err_msg = ErrMsg.LIST_NOT_FOUND            # カーソルを閉じる            cursor.close()            # 変更を確定する            conn.commit()            # データベースを閉じる            conn.close()        return    def get(self, emp_no: str = None):        ''' 社員情報を標準出力する            Args:                self   : 自分自身                emp_no : 社員番号            Returns:                None        '''        # 戻り値初期化        ret: str = ""        # エラーメッセージが設定されてない場合        if (self.err_msg is None):            # 社員番号が数値文字列、かつ、４桁の場合            if (emp_no.isdigit() and (len(emp_no) == 4)):                # データベースを開く                conn = sqlite3.connect(self.mydb)                # カーソルを作成する                cursor = conn.cursor()                # 社員情報取得コマンド編集                sql_emp = "SELECT * FROM tbl_employee " + \                          "WHERE no = '{0}'".format(emp_no)                # 社員情報取得コマンド実行                cursor.execute(sql_emp)                # 社員情報行を取得する                row = cursor.fetchone()                # 社員情報がある場合                if (row is not None):                    # 現在の日付を取得                    now_date = datetime.datetime.now()                    # 誕生日を日付時刻型に変換する                    birth_date = datetime.datetime.strptime(row[2], '%Y/%m/%d')                    # 年齢＝現在年－誕生年                    age = now_date.year - birth_date.year                    # 誕生月を超えた場合                    if (now_date.month > birth_date.month):                        # 年齢に１歳加える                        age += 1                    # 誕生月の場合                    elif (now_date.month == birth_date.month):                        # 誕生日を超えた場合                        if (now_date.day >= birth_date.day):                            # 年齢に１を加える                            age += 1                    # 戻り値に社員番号、社員名、年齢、性別を設定する                    ret = str(row[0]) + " " + row[1] + \                        "(" + str(age) + ") " + row[3]                    # 趣味特技なし                    flg_hobby_skill: bool = False                    # 社員趣味情報取得コマンド編集                    sql_emp_hby = "SELECT hobby FROM tbl_employee_hobby " + \                                  "WHERE no = '{0}'".format(emp_no)                    # 社員趣味情報取得コマンド実行                    cursor.execute(sql_emp_hby)                    # 社員趣味情報行を取得する                    rows_emp_hby = cursor.fetchall()                    # 社員趣味情報がある場合                    if (len(rows_emp_hby) > 0):                        # 戻り値に" <趣味:"を追加                        ret += " <趣味:"                        # 社員趣味情報数分繰り返す                        for i in range(len(rows_emp_hby)):                            # 最初でない場合                            if (i > 0):                                # カンマを追加                                ret += ","                            # 戻り値に趣味を追加                            ret += rows_emp_hby[i][0]                        # 趣味特技あり                        flg_hobby_skill = True                    # 社員特技情報取得コマンド編集                    sql_emp_skl = "SELECT skill FROM tbl_employee_skill " + \                                  "WHERE no = '{0}'".format(emp_no)                    # 社員特技情報コマンド実行                    cursor.execute(sql_emp_skl)                    # 社員特技情報行を取得する                    rows_emp_skl = cursor.fetchall()                    # 社員特技情報がある場合                    if (len(rows_emp_skl) > 0):                        # 趣味が登録されてない場合                        if (not flg_hobby_skill):                            # 戻り値に" <"を追加                            ret += " <"                        # 趣味が登録されている場合                        else:                            # メッセージに"/"を追加                            ret += "/"                        # メッセージに"特技:"                        ret += "特技:"                        # 社員特技情報数分繰り返す                        for i in range(len(rows_emp_skl)):                            # 最初でない場合                            if (i > 0):                                # カンマを追加                                ret += ","                            # 戻り値に特技を追加                            ret += rows_emp_skl[i][0]                        # 趣味特技あり                        flg_hobby_skill = True                    # 趣味特技ありの場合                    if (flg_hobby_skill):                        # 戻り値に">"を追加                        ret += ">"                    # ログ出力する                    self.output_log(ret, emp_no)                # 社員情報がない場合                else:                    # 戻り値に「社員番号がありません」を設定する                    ret = ErrMsg.EMPLOYEE_NO_NOT_FOUND                # カーソルを閉じる                cursor.close()                # データベースを閉じる                conn.close()            # 社員番号が数値文字列以外、または、４桁でない場合            else:                # 戻り値に「社員番号が不正です」を設定する                ret = ErrMsg.EMPLOYEE_NO_INVALID                # エラーメッセージをログ出力する                self.output_log("%s(%s)" % (ret, self.err_msg))        # エラーメッセージが設定されている場合        else:            # 戻り値「管理者に問い合わせてください」を設定する            ret = ErrMsg.UNKNOW            # エラーメッセージをログ出力する            self.output_log("%s(%s)" % (ret, self.err_msg))        # 戻り値を返す        return ret    def output_log(self, outp: str, inp: str = None):        ''' ログ出力する            Args:                self : 自分自身                inp  : 入力情報                outp : 出力情報            Returns:                None        '''        # ログファイルが存在し、書き込み不可の場合        if (os.path.exists(self.log_filename) and           (not os.access(self.log_filename, os.W_OK))):            # 何もしない            pass        # ログファイルが存在しない、あるいは書き込み可能な場合        else:            # ログファイルを開く            with open(self.log_filename, "a", encoding="utf-8") as self.fn:                # 現在時刻を取得する                now_time = datetime.datetime.now()                # 取得した現在時刻を出力の型式に変換する                tm = now_time.strftime("%Y/%m/%d %H:%M:%S")                # 入力情報が設定されてない場合                if (inp is None):                    # ログファイルに現在時刻、出力情報を出力する                    self.fn.write("%s %s\n" % (tm, outp))                # 入力情報が設定されている場合                else:                    # ログファイルに現在時刻、入力情報、出力情報を出力する                    self.fn.write("%s %s: %s\n" % (tm, inp, outp))        return

でも、これからの説明は今までよりも「難しいな…」と感じるかもしれません

私なりに理由を考えてみました

１つ目は「知らなければならないことが増える」からだと思います

そして「知るための努力」をしなければならないからだと思います

「知るための努力」は「勉強」と言うよりは「調査」だと思います

最近はWebでいろいろと調べられるので、とても便利です

慌てないで１つずつ調べていけば良いのです

２つ目は「何をしなければならないのか？」を（「段階を追って」）考えることが

なかなか大変な作業だからです

焦らずに、業務などを通じて経験値を増やしていけば大丈夫です

まずはデータベースの知識を増やしましょう

データベースを利用するには、データベースがなければならないですよね

既存のデータベースを利用するには、

データベースのある場所を知らなければなりませんよね

今回はデータベースがありません

なので、まずは「データベースを作成する」ことです

ほんの少しだけ具体的に言えば、

データベースとは「情報基地」ですから「基地を作って、その中にデータを入れる」

ことが「データベース」を作成することになりますよね

データベースを作成するには、どうすれば良いでしょうか？

データベースを作成するツール（ソフトウェア）を利用すれば良いです

世の中にはいくつかの優れたデータベースソフトが提供されています

MySQLやPostgreSQLがその代表格です

これらのデータベースを利用しても良いのですが、

インストールなどに手間がかかり、それだけで嫌になってしまうので、

Pythonのsqlite3ライブラリを利用します

※sqlite3をコマンドラインで利用するにはsqlite3ソフトをインストールする必要が

　ありますが、それは、またの機会にしましょう

MySQLやPostgreSQLには「SQL」という単語が含まれています

SQL(Structured Query Language：構造化照会言語(直訳だと理解できない…)）は、

データベース言語です

多くのデータベースで使える「共通の言語」ですので便利ですよね

このSQL言語を利用するとデータベースへのアクセス（定義とか操作など）が容易に

なりますので、利用していきましょう

今回、まず、必要になるのは「データベースの作成」です

データベースの作成するSQL文は以下になります

　CREATE DATABASE IF NOT EXISTS employee.db

「CREATE DATABASE」で社員データベース(employee.db)を作成できます

「IF NOT EXISTS」はなくても良いのですが、

対象となるデータベース(今回はemployee.db)がなければ作成するという意味で、

記述しておくと良いでしょう

※記述しないと、データベースがあった場合に失敗します

データベースの作成することはできそうですが、それだけでは使えません

「情報基地」に「情報」を無造作に置けませんし、置けたとしても、どこに何が

あるのかわからない状態では使い物になりません

実際のデータを置く場所を「テーブル」といいます

いくつかのテーブルを設けて、データを置いていくと使いやすいですよね

今回は以下の３つのテーブルを作成することにします

・社員テーブル

・社員趣味テーブル

・社員特技テーブル

テーブルを作成するＳＱＬ文は以下になります

　社員テーブル（tbl_employee）

　CREATE TABLE IF NOT EXISTS tbl_employee(

　                              no INTEGER PRIMARY KEY,

　                              name TEXT,

　                              birth TEXT,

　                              sex TEXT)

　社員趣味テーブル（tbl_employee_hobby）

　CREATE TABLE IF NOT EXISTS tbl_employee_hobby(

　                              id INTEGER PRIMARY KEY AUTOINCREMENT,

　                              no INTEGER,

　                              hobby TEXT)

　社員特技テーブル（tbl_employee_hobby）

　CREATE TABLE IF NOT EXISTS tbl_employee_skill(

　                              id INTEGER PRIMARY KEY AUTOINCREMENT,

　                              no INTEGER,

　                              skill TEXT)

データベースの作成もそうでしたが、作成するときは「CREATE」なんですね

「IF NOT EXISTS」の説明もデータベースの作成と同様です

その後にテーブル名を記述して()内に情報を羅列していけば良いです

テーブル内の情報の名称を「フィールド」または「カラム」と呼びます

テーブル名もそうですけどフィールド名(カラム名)もSQL文内でアクセス（例えば

取得）する際に使用されます

フィールド名の後にデータの種類（型：タイプ）を指定します

データの種類はたくさんありますが、今回は整数(INTEGER)と文字列(TEXT)の２つを

使用しています

「PRIMARY KEY」は主キーです

主キーというのは、テーブル内の情報を一意に定めることのできるフィールド(カラム)

だと考えてよいです

主キーに指定するフィールド(カラム)はテーブルに１つ定義するものだと考えてよい

です

（主キーについて「考えてよいです」と記述した理由は機会があったら説明します）

社員テーブルの主キーは社員番号としました

社員名を主キーにしたいところですが、文字列型を主キーにすることができません

工夫すれば何とかなるのですけれど、今回は社員番号を主キーとしました

※社員番号（社員コード）などは主キーにしやすいです

社員趣味テーブルと社員特技テーブルは社員番号を主キーにすることができません

社員によっては複数の趣味や特技を持っている人がいるので、社員番号が複数に

なってしまうからです

なので、ほかの主キーを作成する必要があります

idと言うフィールド(カラム)を設けて主キーとすることにしました

このフィールドは実際のプログラムでは不要な項目になります

なので、プログラム内で設定する必要はないですよね

その場合は「PRIMARY KEY」の後に「 AUTOINCREMENT」と記述すると、

データベースがidを自動的に割り振ってくれます

テーブルを作成しても、テーブルの上には何も置いてありません

テーブルの上に物(情報)を置いていく(格納する)には以下のSQL文を利用します

　社員テーブル（tbl_employee）

　INSERT INTO tbl_employee VALUES ('{0}', '{1}', '{2}', '{3}')

　　{0}：社員番号(2601や2602など)

　　{1}：社員名(鈴木一郎や山田花子など)

　　{2}：生年月日(1974/02/09や1992/03/31など)

　　{3}：性別(男や女)

　社員趣味テーブル（tbl_employee_hobby）

　INSERT INTO tbl_employee_hobby (no, hobby) VALUES ('{0}', '{1}')

　　{0}：社員番号(2601や2602など)

　　{1}：趣味(料理やキャンプなど)

　社員特技テーブル（tbl_employee_skill）

　INSERT INTO tbl_employee_skill (no, skill) VALUES ('{0}', '{1}')

　　{0}：社員番号(2601や2602など)

　　{1}：特技(野球やピアノなど)

「INSERT INTO」の後にテーブル名を記述しその後に()内に情報を格納するフィールド(カラム)をカンマ区切りで記述します

その後に「VALUES」を記述して()内にフィールド(カラム)に対応する情報をカンマ

区切りで記述します

各情報はシングルクォーテーションで囲みます

社員テーブルのようにすべての情報を格納する場合はフィールド(カラム)リストを

省略できます

データベースから情報を取得するSQL文は以下になります

　社員テーブル（tbl_employee）

　SELECT * FROM tbl_employee WHERE no = '{0}'

　　{0}：社員番号(2601や2602など)

　社員趣味テーブル（tbl_employee_hobby）

　SELECT hobby FROM tbl_employee_hobby WHERE no = '{0}'

　　{0}：社員番号(2601や2602など)

　社員特技テーブル（tbl_employee_skill）

　SELECT skill FROM tbl_employee_skill WHERE no = '{0}'

　　{0}：社員番号(2601や2602など)

取得コマンドは「SELECT」です

社員情報はすべての情報を取得するので「SELECT」の後に「*」を記述します

※社員番号は取得しなくても良いのですけど、１つくらい余分でも良いと思います

その後に「FROM」を記述し、続いて取得する情報のテーブル名を記述します

「WHERE」で取得する条件を記述できます

指定した社員番号の情報を取得するようにします

社員趣味テーブル、社員特技テーブルも同様ですが、趣味(hobby)、特技(skill)のみを

取得するようにします

「SELECT」の後にフィールド名を記述すれば良いです

これで、今回、利用するSQL文が揃いました

何事もそうですが「段取り」は大切ですよね

「段取り八分」とはよく言ったもので、準備をしっかりすれば後はプログラムを

作るだけです

あまりよろしくありません

・csv型式のファイルもjson型式のファイルでもデータの型式が明確に定義されません

　でした。json型式のファイルでは文字列と数値の区別くらいは出来たのですけど、

　数値では範囲（例えば年齢なら0～150歳くらい）とかが決められませんでした

　（pythonではあまり関係ないのですけど、）数値情報は取り得る範囲で情報の入れ物

　のサイズ（情報量）を決めて効率よく管理するほうが良いです

　※現在はメモリとかディスクの容量が潤沢なのですが、昔は少なくて、効率化

　　しないとだめだったのです

・情報量が多くなってくるとファイルサイズが大きくなるだけでなく、ファイル内の

　情報を探す効率が悪くなります

　※複数ファイルに分割した時には情報の重複とかも注意しなければなりません

・複数のプログラムで情報を共有する場合に、同時に情報を変更したりすると、

　つじつまが合わなくなる可能性があります

ここまで言っておいて何ですが、ファイルで情報を管理することは、別に悪いこと

ではありません。大切なのは考え方だと思います

データベースを利用しても、正しく情報の管理ができなければ意味がありませんし、

ファイルを利用して、正しく情報の管理ができれば問題ありません

それでも、データベースを使う理由は、情報を管理しやすくなるからです

情報の持ち方について、考えてみましょう

社員情報を以下のようにします

この形のままで情報を持つと趣味や特技のない人の領域をもたなければならなく

以下を必須とします

・仕様を提示すること

・単体テストを実施すること

・カバレッジ測定を実施すること

・テスト報告書を提示すること

・操作ログを提示すること

問題を考えるのが面倒なので手を抜いている訳ではありません…

たぶん違う、違うんじゃないかな、少しくらいは…

図工とかって何を作るのか決められてないことも多いじゃないですか！　

みなさんの発想に期待したいです

それに、決められたことだけ作業するのってつまらないですよね

実際の業務では、決められた通りに作らなければならないですからね…

（決められた中で工夫して「どうよ！」っていうのも楽しいですけど…）

でも、あまり頑張りすぎると、挫折しますので、ほどほどの発想でお願いします

よろしくです

演習問題１では

コマンドの引数で社員番号を指定していました

それゆえ、複数の社員の情報を取得したい場合は、毎回、引数を指定して呼び出す

必要があります

ちょっと面倒なので、キーボードから入力できるようにします

キーボードのことを標準入力といいます

画面のことを標準出力と呼んでいました（特に説明してませんでしたけど…）

横道に逸れてしまいますが…

厳密に言うと、標準入力とか標準出力は違うかもしれません

「標準」の意味は…、難しいですね…、

コンピュータの世界では「一般的な」でしょうか…

そう考えると以下のようになりますね

　標準入力：コンピュータではキーボード

　標準出力：コンピュータではディスプレイ

でもですね…

タブレットとかではキーボードが「標準装備」されてないですので、タッチパネルが

標準入力ですよね…

また、常にファイルに出力するなら（画面には表示されないので）「ファイル」が

標準出力ですよね…、プリンタが標準出力になるかもしれません

てな感じですので、標準入力とか標準出力と言う言葉が使われたら「一般的に」

対象となる装置の中で、入出力できる（される）場所（キーボードとか画面とか）と

考えれば良いです

※１つだけ憶えておきたい用語があります

　「標準エラー出力」と呼ばれるものなのですけど、エラーの出力先になります

　パソコンなどは「標準出力」も「標準エラー出力」もディスプレイになってます

　ので、目視では両者の区別ができないです

　pythonでよく利用されるログ記録用のloggingというモジュールがあります

　このモジュールの場合は「標準エラー出力(stderr)」がデフォルトになります

　loggingモジュールが「エラー発生時のログ」を想定しているからだと思います

　もし「標準出力」「標準エラー出力」の装置が異なっていた場合は、「標準出力」

　の装置ではログが確認できないので「標準エラー出力」の装置を見なければ

　なりません

　（標準入力と標準エラー出力の装置が異なる場合は、そうそうありませんが…）

　おまけ

　　以下のキーワードが使用されることも多々あります

　　　標準入力：stdin

　　　標準出力：stdout

　　　標準エラー出力：stderr

脱線し過ぎました…

キーボードで社員番号を入力するにはPython組み込みのinput関数を使用すれば

良いです

######################################################################## 主制御#                                                Copyrint 2026 Precede.#######################################################################from myproject.employee import Employee# =====================================================================# 関数# =====================================================================def main():    ''' 主制御        Args:            None        Returns:            None    '''    # ガイダンスを表示    print("'q'でプログラムを終了できます")    # 無限ループ    while (True):        # 入力待ち        emp_no: str = input("数字4桁の社員番号を入力してください: ")        # "q"が入力された場合        if emp_no == 'q':            # 無限ループを終了            break        # 社員番号を表示する        print(emp_no)        # 社員クラスのインスタンス生成        employee = Employee()        # 社員情報を取得する        msg: str = employee.get(emp_no)        # 社員情報を表示する        print(msg)    returnif __name__ == "__main__":    main()

引数を利用していないので引数を指定せずに起動します

（引数を指定しても起動しますが…）

社員番号を入力してEnterキーを押すと社員情報が表示されます

小文字のqを入力してEnterキーを押すとプログラムが終了します

※説明は割愛しますが、まぁ、大丈夫でしょう…

　（決して「手抜き」ではありません…？）

returnだけ記述しても、何も起こらないのですけれど、retrunの後に値を記述すると

関数を呼び出したプログラム（呼び出し元）に値を返すことができます

演習問題１のプログラムで値を返すようにしてみましょう

employee.pyのoutputメソッドの名称をgetに変更します

呼び出し元に値を返すので、呼び出し元から見れば「値を取得する」ことになります

※関数名（メソッド名）は重要です

　outputでも良いような感じもありますがgetのほうがプログラムらしいです

print文で標準出力していた文字列をmsg変数に設定しておいて、msg変数をreturnの

後に記述します

    def get(self, emp_no: str = None):
        …
        ''' 社員情報を標準出力する
            Args:
                self   : 自分自身
                emp_no : 社員番号
            Returns:
                None
        '''
        # 標準出力メッセージ初期化
        msg: str = ""
        …
        # メッセージを返す
        return msg
 

呼び出し元（main.pyのmain関数）ではget関数が返す値を変数に入れます

　    msg: str = employee.get(emp_no)

そして、その値をprint文で標準出力するようにします

※今までと同じ標準出力にしたかったので、get関数の前に入力された社員番号も

　print文で標準出力するようにしています

######################################################################## 主制御#                                                Copyrint 2026 Precede.#######################################################################import sysfrom myproject.employee import Employee# =====================================================================# 関数# =====================================================================def main():    ''' 主制御        Args:            None        Returns:            None    '''    # 引数の数が正しく設定されてない場合    if (len(sys.argv) != 2):        # 使い方を表示する        print("usage: python main.py emp_no")        print("         emp_no : 社員番号")    # 引数の数が正しく設定されている場合    else:        # 社員クラスのインスタンス生成        employee = Employee()        # 社員番号を設定する        emp_no = sys.argv[1]        # 社員番号を表示する        print(emp_no)        # 社員情報を取得する        msg: str = employee.get(emp_no)        # 社員情報を表示する        print(msg)    returnif __name__ == "__main__":    main()

何となくいい感じになりました

今回はこれで良いのですけど、もう少し勉強しましょう

実はpythonは複数の値を返すことができます

returnの後、２つ目以降の値をカンマで区切って並べてあげれば良いです

※古い言語(?)（例えばC言語(?)）などでは１つだけしか返せなかったのです

　（最近のC言語の中には複数の値を返せるらしいですね…）

社員番号と社員情報を戻り値に設定して、呼び出し元で表示するには以下のように

プログラムします

employee.pyのgetメソッド

        # 社員番号、社員番号を返す
        return emp_no, msg

呼び出し元（main.pyのmain関数）では戻り値の社員番号と社員情報を表示する

ようにします

######################################################################## 主制御#                                                Copyrint 2026 Precede.#######################################################################import sysfrom myproject.employee import Employee# =====================================================================# 関数# =====================================================================def main():    ''' 主制御        Args:            None        Returns:            None    '''    # 引数の数が正しく設定されてない場合    if (len(sys.argv) != 2):        # 使い方を表示する        print("usage: python main.py emp_no")        print("         emp_no : 社員番号")    # 引数の数が正しく設定されている場合    else:        # 社員クラスのインスタンス生成        employee = Employee()        # 社員情報を取得する        emp_no, msg = employee.get(sys.argv[1])        # 社員番号を表示する        print(emp_no)        # 社員情報を表示する        print(msg)    returnif __name__ == "__main__":    main()

※複数の戻り値を返したいことは、多々あります

　昔のC言語などでは工夫して返していましたが、Pythonは工夫しなくても返せます

　なお、戻り値が複数の場合は型ヒント(: strのように変数の型の想定）を記述する

　ことができないようです

　「型ヒント」と呼ばれるくらいなので、記述しても実際には入力された値の型に

　なってしまいますが、プログラムを記述するときにはなるべく記述したほうが

　良いと思います（プログラム作成するときにも役に立つはずです）

　今回、あえて記述しようとするなら複数行で記述するのでしょうね…

        emp_no: str = None

        msg: str = None

        emp_no, msg = employee.get(sys.argv[1])

　　※「 = None」は特に記述しなくても大丈夫です

「でした」という表現は正しくないですよね

JavaScriptの枠を超えて利用されているデータ定義文です

RESTful APIで使用されているデータ定義文だと思い付くソフトウェア技術者も多いと

思います

JSONを利用する機会も少なくないので、演習問題１の入力ファイルをCSVからJSON

に変更してみます

CVS形式の社員リストファイル(emplist.csv)の内容を現状のプログラムへの影響が

少ないようにJSON形式の社員リストファイル(emplist.json)に書き換えると以下の

ようになります

{    "0001": {        "name": "鈴木一郎",        "age": "52",        "sex": "男",        "skill": "野球"    },    "0002": {        "name": "山田花子",        "age": "34",        "sex": "女",        "hobby": "料理",        "skill": "ピアノ"    },    "0003": {        "name": "佐藤翠",        "age": "19",        "sex": "女",        "hobby": "キャンプ"    },    "0099": {        "name": "高橋湊",        "age": "27",        "sex": "男"    }}

pythonの辞書型と似てますね

キーと値の組み合わせで記述します

文字列はダブルクォーテーションで囲みます

社員個々のデータは複数の要素を（{},）で区切ることにより記述できます

社員個々の中のデータは配列でも定義できますが、キー、値の型式で記述して

あります

プログラムを配列で取り扱う方法から、キーと値で取り扱う方法に変更したからで

この形式のほうがプログラムにとってはありがたいですし、一般的な記述方法に

「近い」からです

プログラムで社員リストファイルから社員情報を読み込む箇所も変更します

Pythonはjsonライブラリを組み込んであるのでインポートして使用します

　import json

初期化処理（コンストラクタ）でファイル名（のプロパティ値）を変更します

　self.inp_filename: str = "emplist.json"

jsonライブラリではファイルからjson形式の情報を読み込んで、辞書型に変換する

メソッドがあります

　self.emp_list: dict = json.load(fn)

この修正だけで、既存のプログラムは動作します

######################################################################## 社員クラス#                                                Copyrint 2026 Precede.#######################################################################…import json…class Employee:    def __init__(self):        ''' コンストラクタ            Args:                self : 自分自身            Returns:                None        '''        # エラーコード        self.err_msg: ErrMsg = None        # 社員リストファイル名        self.inp_filename: str = "emplist.json"        # ログファイル        self.log_filename: str = "employee.log"        # 社員リストファイルが存在する場合        if (os.path.exists(self.inp_filename)):            # 社員リストファイルが空の場合            if (os.path.getsize(self.inp_filename) == 0):                # エラーメッセージに「社員リストへの登録がありません」を設定する                self.err_msg = ErrMsg.LIST_EMPTY            # 社員リストファイルが空でない場合            else:                # 社員リストファイルを開く                with open(self.inp_filename, "r", encoding="utf-8") as fn:                    # 社員情報テーブルに格納する                    self.emp_list: dict = json.load(fn)        # 社員リストファイルが存在しない場合        else:            # エラーメッセージに「社員リストが見つかりません」を設定する            self.err_msg = ErrMsg.LIST_NOT_FOUND        return    …

いい感じなんですが、用意した社員リストのJSONファイルは一般的な記述方法と

しては今一つです

「社員番号」が判断できないですよね

JSON形式は値が示す内容を判断できるようにするのが一般的です

（キーと値の組み合わせで情報を表現するのが普通です）

なので、以下のように記述することにします

"data"キーを最上位のキーにして、配列で社員情報を複数、持てるようにします

個々の社員情報は{}でひとまとまりの辞書型式とします

その中にキーと値を「キー:値」の型式で記述すれば良いです

今回は年齢は文字列でなく、数値で記述しました

（ダブルクォーテーションをとりました）

{    "data": [        {            "no": "0001",            "name": "鈴木一郎",            "age": 52,            "sex": "男",            "skill": "野球"        },        {            "no": "0002",            "name": "山田花子",            "age": 34,            "sex": "女",            "hobby": "料理",            "skill": "ピアノ"        },        {            "no": "0003",             "name": "佐藤翠",            "age": 19,            "sex": "女",            "hobby": "キャンプ"        },        {            "no": "0099",             "name": "高橋湊",            "age": 27,            "sex": "男"        }    ]}

プログラムも修正が必要です

※「既存のプログラムに影響を与えないようにする」のはとても大切なのですが、

　「本来あるべき姿」でプログラムを作成することも大切です

　そして、どのような修正が適切かを判断できるようになると良いですね

　今回は「開発中」であることを想定して「本来あるべき姿」に修正します

修正箇所は以下です

__init__

　ファイル名プロパティの設定値をJSONファイルにしました

　　self.inp_filename: str = "emplist.json"

　JSONファイルでは"data"キーに社員リスト情報が複数、記述されていますので、

　ファイルから読み込んで辞書型に変換した内容の'data'の中身をemp_listに格納

　するようにしています

　　self.emp_list: dict = json.load(fn)['data']

　※Pythonプログラム内では文字列はダブルクォーテーションでも大丈夫です

　　（self.emp_list: dict = json.load(fn)["data"]でもよいです）

output

　社員番号が個々の社員情報の中に入っているので、社員情報を１行ずつ読み込んで

　入力された社員番号と一致するかを判断するようにしました

　社員番号に対する情報の有無を判定する変数を用意しました

　社員番号に対する情報が見つかった時に「社員情報あり」にして、

　繰り返しを抜けるようにしてます

　なお、年齢は数値データにしたので、文字列型に変換しています

　　str(emp['age'])

　str(変数名)で文字列型にできます

　「文字列型にキャストする」と呼びます

　※今回は使用してませんが「int()」とかもあります

　# 社員不在

　flg_exist: bool = False

　for emp in self.emp_list:
    　if (emp_no == emp['no']):
        　# 標準出力メッセージに社員番号、社員名、年齢、性別を設定する
        　msg = emp_no + " " + \
            　emp['name'] + \
            　"(" + str(emp['age']) + ") " + \
            　emp['sex']

　　　…
        # 社員存在
        flg_exist = True
        # 繰り返しを抜ける
        break
　# 社員番号が不在の場合 

　if (not flg_exist):

　    …

######################################################################## 社員情報#                                                Copyrint 2026 Precede.#######################################################################import datetimeimport enumimport jsonimport osclass ErrMsg(enum.StrEnum):    ''' エラーメッセージ        Args:            enum.StrEnum : 文字列列挙クラス        Returns:            None    '''    # 「社員リストが見つかりません」    LIST_NOT_FOUND = "No employee list."    # 「社員リストへの登録がありません」    LIST_EMPTY = "No one is registered on the employee list."    # 「社員番号がありません」    EMPLOYEE_NO_INVALID = "The employee number is invalid."    # 「社員番号が不正です」    EMPLOYEE_NO_NOT_FOUND = "Employee number not found."    # 「管理者に問い合わせてください」    UNKNOW = "Please contact your system administrator."class Employee:    ''' 社員情報        Args:            None        Returns:            None    '''    def __init__(self):        ''' コンストラクタ            Args:                self : 自分自身            Returns:                None        '''        # エラーコード        self.err_msg: ErrMsg = None        # 社員リストファイル名        self.inp_filename: str = "emplist.json"        # ログファイル        self.log_filename: str = "employee.log"        # 社員リストファイルが存在する場合        if (os.path.exists(self.inp_filename)):            # 社員リストファイルが空の場合            if (os.path.getsize(self.inp_filename) == 0):                # エラーメッセージに「社員リストへの登録がありません」を設定する                self.err_msg = ErrMsg.LIST_EMPTY            # 社員リストファイルが空でない場合            else:                # 社員リストファイルを開く                with open(self.inp_filename, "r", encoding="utf-8") as fn:                    # 社員情報テーブルに格納する                    self.emp_list: dict = json.load(fn)['data']        # 社員リストファイルが存在しない場合        else:            # エラーメッセージに「社員リストが見つかりません」を設定する            self.err_msg = ErrMsg.LIST_NOT_FOUND        return    def output(self, emp_no: str = None):        ''' 社員情報を標準出力する            Args:                self   : 自分自身                emp_no : 社員番号            Returns:                None        '''        # エラーメッセージが設定されてない場合        if (self.err_msg is None):            # 標準出力メッセージ初期化            msg: str = ""            # 社員不在            flg_exist: bool = False            # 社員番号が数値文字列、かつ、４桁の場合            if (emp_no.isdigit() and (len(emp_no) == 4)):                for emp in self.emp_list:                    if (emp_no == emp['no']):                        # 標準出力メッセージに社員番号、社員名、年齢、性別を設定する                        msg = emp_no + " " + \                            emp['name'] + \                            "(" + str(emp['age']) + ") " + \                            emp['sex']                        # 趣味特技なし                        flg_hobby_skill: bool = False                        # 趣味が登録されている場合                        if ('hobby' in emp):                            # "標準出力メッセージに<趣味:xxx"を追加                            msg += " <趣味:" + emp['hobby']                            # 趣味特技あり                            flg_hobby_skill = True                        # 特技が登録されている場合                        if ('skill' in emp):                            # 趣味が登録されてない場合                            if (not flg_hobby_skill):                                # 標準出力メッセージに"<"を追加                                msg += " <"                            # 趣味が登録されている場合                            else:                                # 標準出力メッセージに"/"を追加                                msg += "/"                            # 標準出力メッセージに"趣味:xxx"を追加                            msg += "特技:" + emp['skill']                            # 趣味特技あり                            flg_hobby_skill = True                        # 趣味特技ありの場合                        if (flg_hobby_skill):                            # 標準出力メッセージに">"を追加                            msg += ">"                        # 社員存在                        flg_exist = True                        # 繰り返しを抜ける                        break                # 社員番号が不在の場合                if (not flg_exist):                    # 標準出力メッセージに「社員番号がありません」を設定する                    msg = ErrMsg.EMPLOYEE_NO_NOT_FOUND            # 社員番号が数値文字列以外、または、４桁でない場合            else:                # 標準出力メッセージに「社員番号が不正です」を設定する                msg = ErrMsg.EMPLOYEE_NO_INVALID            # 社員番号を標準出力する            print(emp_no)            # 社員情報を標準出力する            print(msg)            # ログ出力する            self.output_log(msg, emp_no)        # エラーメッセージが設定されている場合        else:            # 「管理者に問い合わせてください」を標準出力する            print(ErrMsg.UNKNOW)            # エラーメッセージをログ出力する            self.output_log("%s(%s)" % (ErrMsg.UNKNOW, self.err_msg))        return    def output_log(self, outp: str, inp: str = None):        ''' ログ出力する            Args:                self : 自分自身                inp  : 入力情報                outp : 出力情報            Returns:                None        '''        # ログファイルが存在し、書き込み不可の場合        if (os.path.exists(self.log_filename) and           (not os.access(self.log_filename, os.W_OK))):            # 何もしない            pass        # ログファイルが存在しない、あるいは書き込み可能な場合        else:            # ログファイルを開く            with open(self.log_filename, "a", encoding="utf-8") as self.fn:                # 現在時刻を取得する                now_time = datetime.datetime.now()                # 取得した現在時刻を出力の型式に変換する                tm = now_time.strftime("%Y/%m/%d %H:%M:%S")                # 入力情報が設定されてない場合                if (inp is None):                    # ログファイルに現在時刻、出力情報を出力する                    self.fn.write("%s %s\n" % (tm, outp))                # 入力情報が設定されている場合                else:                    # ログファイルに現在時刻、入力情報、出力情報を出力する                    self.fn.write("%s %s: %s\n" % (tm, inp, outp))        return

　※JSONファイルに変更した際の修正以外にも手を加えていますが、説明は割愛

　　させていただきます

テストファイルもきれいにしてみました

unittestを行うときは初期化処理（__init__）を記述するとエラーになります

代替としてsetUpメソッドが用意されているので、オーバーライドしてください

※「オーバーライドしてください」の意味は

　「unittest.TestCaseのではなく自分のを使いたいから、setUpという同じ関数名を

　作ってください」です

主だった変更内容はそのくらいです

######################################################################## 社員情報テスト#                                                Copyrint 2026 Precede.#######################################################################import osimport shutilimport statimport unittestfrom myproject.employee import Employeeclass TestEmployee(unittest.TestCase):    ''' 社員情報テスト        Args:            unittest.TestCase : テストケースクラス        Returns:            None    '''    def setUp(self):        ''' 初期化処理(unittestでは__init__の代替となっている)            Args:                self : 自分自身            Returns:                None        '''        # 社員リストファイル        self.inp_filename: str = "emplist.json"        # コピー元の社員リストファイル        self.src_inp_filename: str = "tests/emplist.json"        # コピー元の社員リストファイル（空ファイル）        self.src_inp_empty_filename: str = "tests/emplist_empty.json"        # ログファイル        self.log_filename: str = "employee.log"    def test_01_emlist_not_exist(self):        ''' 社員リストファイルがない場合            Args:                self : 自分自身            Returns:                None        '''        # 社員リストファイルが存在する場合        if (os.path.exists(self.inp_filename)):            # 社員リストファイルを削除する            os.remove(self.inp_filename)        # ログファイルが存在する場合        if (os.path.exists(self.log_filename)):            # ログファイルの読み取り専用を解除する            os.chmod(path=self.log_filename, mode=stat.S_IWRITE)            # ログファイルを削除する            os.remove(self.log_filename)        # 社員クラスインスタンス生成        employee = Employee()        # 社員番号0001        employee.output("0001")    def test_02_emplist_empty(self):        ''' 社員リストファイルが空の場合            Args:                self : 自分自身            Returns:                None        '''        # コピー元の社員リストファイル（空ファイル）を社員ファイルにコピーする        shutil.copy(self.src_inp_empty_filename, self.inp_filename)        # 社員クラスインスタンス生成        self = Employee()        # 社員番号0001        self.output("0001")    def test_03_argments(self):        ''' 通常動作            Args:                self : 自分自身            Returns:                None        '''        # コピー元の社員リストファイルを社員ファイルにコピーする        shutil.copy(self.src_inp_filename, self.inp_filename)        # 社員クラスインスタンス生成        self = Employee()        # 社員番号に英字が含まれている        self.output("a001")        # 社員番号に記号が含まれている        self.output("000!")        # 社員番号が3桁        self.output("001")        # 社員番号が5桁        self.output("00001")        # 社員番号0001        self.output("0001")        # 社員番号0002        self.output("0002")        # 社員番号0003        self.output("0003")        # 社員番号0004        self.output("0004")        # 社員番号0099        self.output("0099")    def test_04_logfile_readonly(self):        ''' ログファイルが読み取り専用の場合            Args:                self : 自分自身            Returns:                None        '''        # ログファイルを読み取り専用にする        os.chmod(path=self.log_filename, mode=stat.S_IREAD)        # 社員クラスインスタンス生成        self = Employee()        # 社員番号0001        self.output("0001")

私は例外処理については否定的な考えを持っています…

いや、そうではないか…

「例外処理でなくても良い処理」も例外としてしまうことが好きではないのです

例えば、ファイルが無かったときのFileNotFound例外ですが、ファイルを開く前に

ファイルの存在確認をすれば例外は発生しないのです

そして、osモジュールで確認できます（os.path.exists）

でも、例外として取り扱ってほしい場合もあります

例えば、ハードディスクの破損など物理的な要因によりファイルが存在しないと

みなされる場合などが考えられます

この場合は例外が発生してほしいのですが、FileNotFound例外だと、あまり

うれしくないのです

（実際はどのような例外が発生するのかわかりませんが…）

もしかしたら、OS上ではあたかもファイルがあるように見えているかもしれません

（これも実際、どのような見え方になっているのかわかりません）

もし、見えているとしたら「ファイルがない」と言われても対処できないのです

結局のところ、何が言いたいのかと言いますとですね…

プログラムを作成する人が極力、（前述のos.path.existsのように）プログラムの

「通常処理」として、例外処理をプログラムしないのが好みです

そして、理解できない例外の処理はOSとかPython(インタープリター)とかに任せて

しまうのが好みです

私は

「考えられる例外（と言うかエラーとなる状況）は可能な限り考慮して、想定外の

　エラーの場合はプログラムでは捕まえない」

よう心がけています

例えば、演習問題１ではログファイルを開くときに、PermissionError例外を捕まえて

いますが、事前にos.access(self.log_filename, os.W_OK)で書き込みできるかを確認

するよう記述できます

その他の例外は通常、発生しなさそうなので、例外処理を記述しないようにします

そうすると「例外」というあいまいな状況は考えなくてもよいことになります

（OSやPythonに任せてしまおうと考えます）

なぜ、このようなことを言っているのかというと、

例外はいつ、どのような理由で発生するかわからないからです

演習問題１ではログファイルを開くときに、その他の例外（except Exception:）を

記述していますが、ここで捕えた例外がログファイルを開く処理をしたときに発生

する例外とは限らないからです

演習問題１では、ほぼ、ログファイルを開くときに発生すると考えられますが、

もし、データベースからデータを読み込んで、ファイル出力する処理が記述されて

いたとすると、データベースへのアクセスで例外が発生することも考えられます

その場合でもその他の例外（except Exception:）の処理を通ることになります

かと言って、ファイル操作とデータベースのアクセスの例外を別々に記述すると

プログラムが煩雑になりそうですよね

どこまで例外処理を記述すべきかはとても難しいです

（すべての関数やメソッドにtry～exceptを書いたれ！、

　と思ったこともありましたが、それはそれでねぇ…）

ここまで記述しておいてですが、実は正解はありません

例外を利用するのが好きな方もいるでしょうし、いかなる例外が発生しようが、

プログラムを停止してはならないような場合は、先に述べたように、すべての

関数やメソッドに例外処理を記述すべきでしょう

人の考え方は千差万別ですからね…

ご参考までに

「それでは、どこまで確認すればいいの？」いい加減うんざりですよね

「人は間違える生き物」ですからしかたないのです

でも、いろいろと間違えない工夫をしています

単体テストモジュール（unittest）もそうでした

（プログラムも含めて）機械に正確に実行してもらうようにすることで、間違いを

少なくしています

１つのプログラム（演習問題では社員クラス）の確認は終了間近です

最後に残った課題は「単体テストが間違ってないか？」です

「確認項目」は「プログラムの分岐」に着目して作成しました

ということは、「確認項目」が「プログラムの分岐」をすべて通っているかが確認

できれば「確認項目」も正しいことになります

※標準出力、ログファイル出力の内容は目視で確認したということで、勘弁して

　もらいましょう（さもないと、エンドレスになってしまいます）

「プログラムの分岐」を確認することを「カバレッジ測定」といいます

「カバレッジ(coverage)は「適用範囲」と言う意味の単語です」

余談

「カバレッジ測定」によってすべての分岐が通れば良いのですが、必ずしもそうは

ならない場合もあります

今回も「その他の例外」をプログラムしましたが、「その他の例外」を発生させる

要因を確認項目で実現するのは、かなり難しいです（できるかもしれませんが、

まず、発生しないであろう状況に時間を費やすのは現実的ではありません）

※実際の業務では、発生しないであろう例外などはプログラムに記述しない方針に

　してもらうと良いかもしれません

pythonモジュールではカバレッジ測定を実行してくれるモジュールも用意して

あります（本当にすごいですね…）

カバレッジモジュールはインストールすると使えるようになりますが、

Windows11ではセキュリティが強化されているので、インストールできるように

設定を変更しなければなりません

Windowsキーを押すなどして「設定」を選択します

「プライバシーとセキュリティ」を選択します

「Windowsセキュリティ」を選択します

「アプリとブラウザーの利用」を選択します

「スマートアプリコントロールの設定」を選択します

信頼されていないアプリからの保護の設定で「オフ」を選択します

※カバレッジモジュールのインストールが終わったら（必要に応じて）「オン」に

　戻して置くと良いでしょう

VSCodeに戻ってカバレッジモジュールのインストールをします

ターミナルを開いて、以下のコマンドを入力します

　pip install coverage

pipはPythonのパッケージ管理モジュールで「python -m pip」と入力しなくても利用

できるようです

「pip install」でPythonのパッケージ（モジュール）をインストールします

ここではカバレッジ測定ツール(coverage)をインストールします

以下のコマンドを投入してカバレッジ測定をしましょう

　python -m coverage run -m unittest discover -s tests

「python -m」はユニットテストの時と同様で

「pythonでcoverageというモジュールを実行します」という内容になります

coverageにはいくつかのサブコマンドがありrunコマンドでカバレッジ測定を実行

します

runのオプション「-m」で実行するモジュールを指定します

前回実行したunittestモジュールとその引数をそのまま記述すれば良いです

実行結果は.coverageというファイルに保存されます

このファイルはバイナリ型式で出力されていますので、人が読むのには相当な鍛錬が

必要です

（なぜバイナリで出力されているのかは作者に聞かなければわかりませんが

　過去にファイルサイズとかの問題があったのかもしれません）

以下のコマンドでHTML型式に変換してくれます

　python -m coverage html

htmlcovフォルダが作成されました

フォルダ内にあるindex.htmlを右クリックして「プレビューの表示」を選択すると

ファイルの内容が表示されます

社員クラス(employee.py)は98%、

社員クラスのテストモジュール(test_employee.py)は100%

となっていますね

リンクされているので開いてみましょう

画面を大きくして（タブを移動させて）引き延ばしてみてみますと、

緑色で「72 run」、赤色「2 missing」となっています

下のほうにスクロールすると、ログファイルが開けなかったときの例外の処理が

通らなかったことがわかります

この処理を通すのは難しそうです

※テスト報告書のエビデンスにカバレッジ測定結果も添付すべきですが、

　通らなかった箇所については、注釈を付け加えておくのが良いでしょう

　今回の場合は、例えば以下のような注釈が良いでしょう

　「ファイルを追加モードで開くとき、ファイルが存在して書き込み禁止のときの

　　例外は捕えることができるが、それ以外の例外は、通常運用では発生しない

　　（例外を１つでも記述した場合は、その他の例外も記述するという規則に

　　従って記述してある）」　

社員クラスのテストモジュールは100%でしたので、ここでは割愛しています

なお、テストモジュールのカバレッジ結果は不要かもしれません

その場合はomitオプションを指定すると良いでしょう

　python -m coverage run --omit=tests/* -m unittest discover -s tests