はじめに

普段は物流トラックドライバーをしながらPython学習をしている tosane932 です。

僕がPython学習を始めた初期から現在進行形で開発している、

🍞 sales_data_app 🥖

の実際のコードを教材に、Python基礎を学び直しています。

1時限目では、

変数・データ型・比較演算子・if文

を学び直しました。

2時限目では、

リスト・辞書・set・for文

を学び直しました。

3時限目では、

関数・引数・return・関数の呼び出し・型ヒント

を学び直しました。

3時限目では、

def build_sales_prompt(sales_summary: str) -> str:
    return ...

という実コードから、

関数を作る
↓
引数を受け取る
↓
処理する
↓
returnで結果を返す
↓
別の場所から呼び出す

という流れを見ていきました。

でも、ここで一つ気になることがあります。

この、

build_sales_prompt()

という関数は、

prompts.py

という別のファイルにあります。

一方、この関数を実際に使っているのは、

app.py

です。

🐹「あれ？別のファイルにある関数を、どうやってapp.pyから使ってるんだ？」

今回は、そこからスタートします。

📚️ 今回の記事を3行でまとめると

Pythonコードをファイルごとに分けて扱うモジュールと、importの役割を実コードで確認する
処理中に問題が起きたときの例外とは何なのかを学び直す
tryとexceptを使って、想定外の値が来ても処理を分ける仕組みを追う

🐹 今回もモグラくんと学び直します

🐹「3時限目で関数は分かったけど、全部app.pyに書くわけじゃないんだね。」

たしかに。

sales_data_app には、

app.py
prompts.py
models.py
config.py
...

のように、複数のPythonファイルがあります。

1つのファイルに全部書くのではなく、

アプリ本体の処理
AIへ渡す文章を作る処理
データベースの定義
設定

など、役割ごとに分かれています。

そして、別のファイルにある機能を使いたいときに登場するのが、

import

です。

さらに今回は、

try

except

という、これまでとは少し違う形の処理も見ていきます。

🐹「また知らない英単語が増えたぞ……。」

今回も、一つずつ実コードから見ていきます。

🍞 それでは4時限目

今回のテーマ

「モジュール・import・例外・try・exceptとは？」

今回学び直すのは5つです。

📚 今回学ぶ5つ

モジュール：Pythonの処理をまとめたファイル
import：別のモジュールを使えるようにする
例外：処理中に問題が起きたことをPythonが知らせる仕組み
try：例外が起きる可能性のある処理を実行する
except：特定の例外が起きたときの処理を書く

今回は、

別ファイルに処理を分ける
↓
importして使う
↓
処理を実行する
↓
もし問題が起きたら
↓
exceptで別の処理へ進む

という流れとして見ていきます。

1. 📁 モジュールとは？

まずはモジュールです。

Pythonでは、処理を1つのファイルだけに全部書く必要はありません。

例えば、

main.py

とは別に、

message.py

というPythonファイルを作ることもできます。

このようなPythonのコードを書いたファイルは、モジュールとして扱うことができます。

今回の sales_data_app なら、

app.py
prompts.py
models.py
config.py

などがあります。

🍞 3時限目で見たprompts.py

3時限目では、

def build_sales_prompt(sales_summary: str) -> str:
    return f"""
    ...
    {sales_summary}
    ...
    """

という関数を見ました。

この関数が書かれているのは、

prompts.py

です。

ファイル名を見ると、

prompts
↓
プロンプトに関係する処理

と、役割が分かれています。

実際の prompts.py には、

def build_sales_prompt(sales_summary: str) -> str:

というAIへ渡すプロンプトを作る関数があります。

🐹「3時限目では関数ばかり見てたけど、その関数がどのファイルにあるかまではあまり気にしてなかったなぁ。」

こうして見ると、

関数
↓
どこかのPythonファイルに書かれている

Pythonファイル
↓
モジュールとして利用できる

という関係が見えてきます。

図1：画面上ではAIアドバイス機能として見えますが、その裏側ではプロンプトを作る処理をprompts.pyへ分け、app.pyからimportして使っています。

なぜファイルを分けるの？

例えば、すべての処理を、

app.py

だけへ書いていくと、

ログイン処理
商品登録
売上入力
ダッシュボード
AIアドバイス
プロンプト作成
Guest Demo
...

と、どんどん処理が増えていきます。

そこで、役割によってファイルを分ければ、

app.py
↓
アプリ本体

prompts.py
↓
AIプロンプトを作る処理

models.py
↓
データベースに関係する定義

のように、どこに何があるのか整理しやすくなります。

今回は、

Pythonの処理を別ファイルへ分け、そのファイルをモジュールとして使える

というところまで押さえておきます。

ファイルやパッケージの詳しい仕組みは、また必要になったときに掘り下げます。

2. 📦 `import`とは？

別のファイルに処理を分けても、

その機能を使えなければ意味がありません。

そこで登場するのが、

import

です。

簡単に考えると、

別のモジュールにある機能を、このファイルでも使えるようにする

ために使います。

🍞 sales_data_appの実コード

app.py には、

from prompts import build_sales_prompt

と書かれています。

ここを分けて見てみます。

from prompts
↓
promptsモジュールから

import
↓
取り込む

build_sales_prompt
↓
この関数を

つまり、

prompts.pyにあるbuild_sales_prompt関数を、app.pyでも使えるようにしている

ということです。

🐹「だからapp.pyに関数本体がなくても呼び出せたのか！」

3時限目で見た、

prompt = build_sales_prompt(sales_summary)

というコードにつながりました。

prompts.py

def build_sales_prompt(...):
    ...

        ↓

from prompts import build_sales_prompt

        ↓

app.py

build_sales_prompt(sales_summary)

という流れです。

`import config`という書き方もある

sales_data_app には、もう一つ違う形のimportがあります。

import config

です。

そして、

config.SQLALCHEMY_DATABASE_URI

のように使っています。

先ほどは、

from prompts import build_sales_prompt

でした。

今回は、

import config

です。

見た目が少し違います。

from prompts import build_sales_prompt
↓
promptsから特定の名前を取り込む


import config
↓
configモジュールそのものを取り込む

という違いがあります。

🐹「同じimportでも書き方が違うんだね。」

今回はまず、

import config

と、

from prompts import build_sales_prompt

の2つが実コードで使われていることを確認しておきます。

💡 3時限目と4時限目がつながった

3時限目では、

def build_sales_prompt(...):

という関数を作る側を見ました。

4時限目では、

from prompts import build_sales_prompt

によって、

その関数を別ファイルから使えるようにする

ところまで進みました。

関数を作る
↓
モジュールに置く
↓
importする
↓
別の場所から呼び出す

とつながっています。

3. ⚠️ 例外とは？

ここから少し話が変わります。

プログラムは、いつも想定どおりの値だけを受け取るとは限りません。

例えば、

int("123")

なら、文字列の "123" を整数へ変換できます。

でも、

int("パン")

のように、整数として変換できない文字列が来たらどうなるでしょう？

このように、

処理をそのまま続けられない問題が発生したとき

Pythonでは例外が発生することがあります。

🍞 sales_data_appにも例外への備えがある

商品登録処理では、

year = int(request.form.get("year"))
month = int(request.form.get("month"))

として、

year
month

を整数へ変換しています。

ここは1時限目でも出てきた、

int()

ですね。

🐹「あっ、また1時限目のデータ型が帰ってきた。」

でも、もし整数へ変換できない値だった場合、

そのままでは処理を続けられません。

そこで実際のコードでは、

try:
    year = int(request.form.get("year"))
    month = int(request.form.get("month"))
except (TypeError, ValueError):
    logger.warning("Rejected product update with invalid year or month.")
    return "年月が正しくありません。", 400

となっています。

ここで、

TypeError
ValueError

という名前が出てきました。

これらは、Pythonで発生する例外の種類です。

`ValueError`とは？

例えば、

int("abc")

のように、

intに変換しようとした
↓
でも内容が整数として正しくない

場合には、

ValueError

が発生します。

今回のコードでも、

ValueError

を受け取れるようにしています。

`TypeError`も書かれている

実コードでは、

except (TypeError, ValueError):

となっています。

つまり、

TypeError
または
ValueError

が発生した場合を処理しています。

例えばフォームから値を取得できず、

None

のような値を int() に渡した場合などは、想定した型として扱えず TypeError になることがあります。

今回は TypeError と ValueError の細かい違いを完全に覚えるより、

例外にも種類があり、exceptではどの例外を処理するのか指定できる

というところに注目します。

図2：画面では年と月を選択しますが、サーバー側では受け取った値をint()へ変換し、想定外の値が来た場合にも備えています。

4. 🛡️ `try`とは？

次は、

try

です。

実コードをもう一度見てみます。

try:
    year = int(request.form.get("year"))
    month = int(request.form.get("month"))

try の中には、

実行してみる処理

を書きます。

今回なら、

フォームからyearを取得
↓
intへ変換

フォームからmonthを取得
↓
intへ変換

です。

イメージとしては、

try

「まず、この処理をやってみよう」

です。

🐹「tryって、そのまま“試す”って意味なんだね。」

問題が起きなければ？

例えば、

year = "2026"
month = "9"

のように、整数へ変換できる値なら、

int("2026")
int("9")

として処理できます。

その場合は、

try
↓
問題なし
↓
そのまま次の処理へ

と進みます。

tryはif文とは少し違う

ここで、これまで学んだ if 文と比べてみます。

if は、

if month < 1 or month > 12:

のように、

条件がTrueかFalseか

を確認して処理を分けました。

一方、try は、

try:
    month = int(...)

のように、

処理を実行して、その途中で例外が起きるか

を扱っています。

if
↓
条件を見る


try
↓
処理を実行してみる

似ているようで役割が違います。

🐹「if文で全部確認するわけじゃないんだ。」

ここも、実コードを読んでいると違いが見えてきます。

5. 🚑 `except`とは？

try の処理中に例外が発生した場合、

その例外を受け取るのが、

except

です。

実コードでは、

try:
    year = int(request.form.get("year"))
    month = int(request.form.get("month"))
except (TypeError, ValueError):
    logger.warning("Rejected product update with invalid year or month.")
    return "年月が正しくありません。", 400

となっています。

流れにすると、

try
↓
yearとmonthをintへ変換する
↓
成功
↓
そのまま処理を続ける

または、

try
↓
yearとmonthをintへ変換する
↓
TypeError / ValueErrorが発生
↓
except
↓
警告ログを残す
↓
「年月が正しくありません。」
↓
HTTP 400を返す

となります。

🐹「失敗したらアプリがそのまま突っ走るんじゃなくて、別の道へ行くのか。」

そんなイメージで読むと分かりやすそうです。

exceptのカッコは何？

今回のコードでは、

except (TypeError, ValueError):

となっています。

この、

(TypeError, ValueError)

は、

TypeError
または
ValueError

をまとめて指定しています。

つまり、どちらかが起きたら、

except

の中へ進みます。

returnもまた登場

そして except の中には、

return "年月が正しくありません。", 400

があります。

🐹「今度は3時限目のreturn！」

また前の授業につながりました。

例外が起きる
↓
exceptへ入る
↓
return
↓
そこで結果を返して処理を終える

という流れです。

3時限目では、

return

を、

関数から結果を返し、その関数の処理を終える

ものとして学びました。

4時限目の例外処理でも同じ return が使われています。

💡 これまでの授業がまた集まってきた

今回の実コード、

try:
    year = int(request.form.get("year"))
    month = int(request.form.get("month"))
except (TypeError, ValueError):
    return "年月が正しくありません。", 400

を見ると、

int
↓
1時限目：データ型


request.form.get(...)
↓
値を取得する


try / except
↓
4時限目：例外処理


return
↓
3時限目：関数から結果を返す

と、以前学んだものも一緒に使われています。

🔗 5つを全部つなげてみる

今回学んだ、

モジュール
import
例外
try
except

を、実コードの流れとしてつなげてみます。

まず、3時限目で使った関数は、

prompts.py

にあります。

def build_sales_prompt(sales_summary: str) -> str:
    ...

それを、

from prompts import build_sales_prompt

で app.py へ取り込みます。

そして、

build_sales_prompt(...)

として使います。

prompts.py
↓
モジュール

        ↓

from prompts import ...
↓
import

        ↓

app.pyから関数を使う

一方、商品登録では、

try:
    year = int(request.form.get("year"))
    month = int(request.form.get("month"))
except (TypeError, ValueError):
    return "年月が正しくありません。", 400

となっています。

こちらは、

処理を実行する
↓
try

        ↓

問題が起きる可能性がある
↓
例外

        ↓

特定の例外が起きる
↓
except

        ↓

別の処理を行う

という流れです。

🐹「importの話とtry・exceptって、最初は別々に見えたけど……。」

今回のテーマを一言でまとめると、

プログラムを複数の部品に分けて使い、想定外の問題にも備える

という話なのかもしれません。

📸 画面とコードをつなげてみる

利用者から見れば、

商品登録画面で
年と月を選ぶ
↓
登録する

という普通の操作です。

でもその裏側では、

フォームから値を受け取る
↓
intへ変換する
↓
tryで処理する
↓
問題があればexceptへ
↓
適切な応答を返す

という処理があります。

同じようにAIアドバイスも、

ボタンを押す
↓
AIアドバイスが表示される

という一つの機能に見えます。

でもコードを見ると、

prompts.pyに関数がある
↓
app.pyからimportする
↓
関数を呼び出す
↓
AIへ送るプロンプトを作る

という複数のファイルのつながりがあります。

画面だけでは見えなかった処理が、

Pythonの基礎を学び直すことで少しずつ見えるようになってきました。

🚧 現在Guest Demoは開発途中です

現在の sales_data_app は、Guest Demo機能をまだ開発している途中です。

そのため、現時点では読者の方が自由に操作できるデモ環境はまだ公開していません。

Guest Demoが完成したら、

実際に画面を操作する
↓
画面の裏側にある処理を読む
↓
Python基礎とつなげる

という確認も、このシリーズに追加していきたいと思っています。

📝 4時限目まとめ

今回は、sales_data_app の実コードから、

モジュール

Pythonの処理をファイルごとに分けて扱う。

prompts.py
config.py
app.py

import

別のモジュールにある機能を使えるようにする。

from prompts import build_sales_prompt

import config

例外

処理中に問題が起きたことをPythonが知らせる仕組み。

ValueError
TypeError

など、例外にも種類があります。

try

例外が起きる可能性のある処理を実行する。

try:
    year = int(...)

except

指定した例外が起きた場合の処理を書く。

except (TypeError, ValueError):

実際のコードでは、

別ファイルへ処理を分ける
↓
importして使う

そして、

処理を実行する
↓
例外が発生する可能性
↓
try / exceptで対応する

という形で使われています。

そして今回も、

int
if
関数
return

など、これまで学んだPython基礎がまた登場しました。

🤔 自分で確認してみる

最後に、今回の内容を自分でも確認してみます。

Q1

prompts.py のようにPythonコードを書いたファイルは、今回どのように扱ったでしょう？

A. モジュール
B. リスト
C. 引数

🅰️答えを見る

A. モジュール

です。

prompts.py には、AIへ渡すプロンプトを作る関数が書かれています。

Q2

次のコードは何をしているでしょう？

from prompts import build_sales_prompt

🅰️答えを見る

prompts モジュールから、

build_sales_prompt

を取り込み、このファイルから使えるようにしています。

Q3

次の、

import config

と、

from prompts import build_sales_prompt

では、何が違うでしょう？

🅰️答えを見る

import config

では config モジュールを取り込みます。

一方、

from prompts import build_sales_prompt

では、prompts から build_sales_prompt という名前を取り込んでいます。

Q4

次のコードで、

try:
    year = int(request.form.get("year"))

try は何をしているでしょう？

🅰️答えを見る

例外が発生する可能性のある処理を、

まず実行してみる

部分です。

今回の場合は、フォームから受け取った値を int へ変換しています。

Q5

次のコードでは、

except (TypeError, ValueError):

何を指定しているでしょう？

🅰️答えを見る

TypeError
または
ValueError

が発生した場合の処理を指定しています。

Q6

例えば、

int("abc")

のように、整数として変換できない文字列を int() へ渡した場合に発生する可能性がある例外はどれでしょう？

A. ValueError
B. for
C. import

🅰️答えを見る

A. ValueError

です。

Q7

次の処理で例外が起きた場合、

try:
    year = int(request.form.get("year"))
    month = int(request.form.get("month"))
except (TypeError, ValueError):
    return "年月が正しくありません。", 400

最終的にどうなるでしょう？

🅰️答えを見る

TypeError または ValueError が発生すると、

except

の中へ進み、

return "年月が正しくありません。", 400

によってHTTP 400の応答を返します。

🐹 4時限目を終えて

今回は、

モジュール・import・例外・try・except

を学び直しました。

3時限目では、

def build_sales_prompt(...):

を見て、

関数をどう作って、どう呼び出すのか

を学びました。

4時限目では、その関数が、

prompts.py

という別のファイルにあり、

from prompts import build_sales_prompt

によって、

app.py

から使われていることまでつなげることができました。

関数を作る
↓
別のモジュールへ置く
↓
importする
↓
呼び出す

という流れです。

そしてもう一つ、

try:
    ...
except (...):
    ...

から、

処理を実行する
↓
想定外の問題が起きる
↓
例外が発生
↓
exceptで対応する

という流れも見ました。

🐹「コードって、正常に動くときのことだけ書いてるわけじゃないんだね。」

これも今回の学び直しで大事なところだと思います。

アプリを使う側から見ると、

商品を登録できる
AIアドバイスが見られる

という機能に見えます。

でも、その裏側には、

ファイルを分ける
必要な機能をimportする
想定外の値に備える
例外が起きた場合の処理を書く

というコードがあります。

そして今回も、

int
if
関数
return

など、以前学んだ内容がまた登場しました。

新しい基礎を学ぶ
↓
前の授業の基礎がまた出てくる
↓
違う場面で使われている
↓
少しずつつながる

今回もこの繰り返しです。

🐹「4時限目まで来たけど、1時限目で掘った穴がまだ続いてるぞ。」

もちろん、今回も記事を書いただけで、

「例外処理を理解した！」

とは考えません。

これからコードを読んでいて、

import

を見つけたら、

何を取り込んでいるんだろう？
どこで使っているんだろう？

と考える。

try:

を見つけたら、

ここでは何が失敗する可能性があるんだろう？

と考える。

except

を見つけたら、

どんな例外を受け取っているんだろう？
起きたらどうするんだろう？

と考える。

そんな読み方が少しずつできれば、以前より実コードの見え方も変わってきそうです。

まだまだ基礎の学び直しは続きます。

次の時限も、🍞 sales_data_app の実コードを教材にして掘っていきます🐹

📚️ 基礎学習シリーズ

🏫1時限目

「変数・データ型・比較演算子・if文とは？」

🏫2時限目

「リスト・辞書・set・for文とは？」

🏫3時限目

「関数・引数・return・関数の呼び出し・型ヒントとは？」

🏫4時限目

「モジュール・import・例外・try・exceptとは？」

はじめに

📚️ 今回の記事を3行でまとめると

🐹 今回もモグラくんと学び直します

🍞 それでは4時限目

今回のテーマ

📚 今回学ぶ5つ

1. 📁 モジュールとは？

🍞 3時限目で見たprompts.py

なぜファイルを分けるの？

2. 📦 importとは？

🍞 sales_data_appの実コード

import configという書き方もある

💡 3時限目と4時限目がつながった

3. ⚠️ 例外とは？

🍞 sales_data_appにも例外への備えがある

ValueErrorとは？

TypeErrorも書かれている

4. 🛡️ tryとは？

問題が起きなければ？

tryはif文とは少し違う

5. 🚑 exceptとは？

exceptのカッコは何？

returnもまた登場

💡 これまでの授業がまた集まってきた

🔗 5つを全部つなげてみる

📸 画面とコードをつなげてみる

🚧 現在Guest Demoは開発途中です

📝 4時限目まとめ

モジュール

import

例外

try

except

🤔 自分で確認してみる

Q1

Q2

Q3

Q4

Q5

Q6

Q7

🐹 4時限目を終えて

📚️ 基礎学習シリーズ

🏫1時限目

🏫2時限目

🏫3時限目

🏫4時限目

2. 📦 `import`とは？

`import config`という書き方もある

`ValueError`とは？

`TypeError`も書かれている

4. 🛡️ `try`とは？

5. 🚑 `except`とは？