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

🔰オブジェクト指向にチャレンジ💫制作編 第002講【導入編】フォルダーと仮想環境を整え、商品情報を表示しよう

    【今回の完成目標――この制作物専用の環境で商品を表示する】

    ミカ「教授、前回の商品は表示できました。商品名も、コーヒー豆から紅茶へ変更しました。」
    教授「今回は、そのプログラムを引き継ぎます。まず制作物専用のPython環境を用意し、商品名・価格・在庫を変数で扱う形へ進めましょう。」
    ミカ「仮想環境という名前が、少し大げさに聞こえます。」
    教授「役割は、制作物ごとに使う道具を整理することです。名前の迫力に負けず、一つずつ操作しましょう。」

    今回は、仮想環境を作り、その環境で商品情報を表示できる状態まで完成させます。

    完成時の表示は、次のとおりです。

    商品名:紅茶
    価格:1200円
    在庫:5個

    ミカ「表示は前回と同じですね。」
    教授「はい。今回は、使うPython環境を明確にし、表示に使うデータへ名前を付けます。画面の見た目が同じでも、コードの扱い方が一歩進みます。」

    本講もWindows 11とVS Codeを使います。Python本体とMicrosoftのPython拡張機能は、第001講で準備済みとして進めます。

    【前回のフォルダーとmain.pyを引き継ごう】

    VS Codeの「ファイル」→「フォルダーを開く」で、前回作成したunit01-productを開いてください。保存場所は、「ドキュメント」の中のoop-practice、その中のunit01-productでした。

    今回も、同じunit01-productとmain.pyを使います。 講義が変わるたびに、新しい制作フォルダーを作る必要はありません。

    前回の演習まで終えている場合、main.pyは次の状態です。

    print("商品名:紅茶")
    print("価格:1200円")
    print("在庫:5個")

    ミカ「前回の完成品を、そのまま育てるのですね。」
    教授「そうです。まず、左側にmain.pyが見えているか確認しましょう。今回変更するファイルは、この一つです。」

    まだ商品名が「コーヒー豆」の場合は、「紅茶」へ変更して保存してください。本講では、前回の演習後の状態にそろえて説明します。

    【仮想環境とは何か――制作物ごとに道具を分ける】

    Pythonの仮想環境は、制作物ごとに、追加するパッケージとそのバージョンを分けて管理するための環境です。

    パッケージとは、ほかの人が用意した機能を、自分のプログラムから使えるようにまとめたものです。

    ミカ「すでにPythonをインストールしたのに、どうして分けるのですか。」
    教授「複数の制作物で、必要な道具のバージョンが異なることがあるからです。ある制作物のために更新した道具が、別の制作物では合わなくなる場合があります。」
    ミカ「みんなで一つの工具箱を使っていると、中身を入れ替えた影響が広がるのですね。」
    教授「そのイメージです。制作物ごとに分けると、必要な組み合わせを管理しやすくなります。」

    仮想環境は、インストール済みのPythonを基に作ります。今回も、第001講で用意したPythonを使います。Python 3.14.7 documentation

    今回の表示プログラムは、Pythonに最初からある機能だけで動きます。追加パッケージの導入は、実際に必要になったときに行います。

    【VS Codeから仮想環境を作ろう】

    unit01-productを開いた状態で、次の順に操作してください。

    ① Ctrl+Shift+Pを押し、コマンドパレットを開きます。
    ② Python: Create Environmentを検索して選びます。日本語表示では「Python: 環境の作成」などと表示されます。
    ③ 環境の種類でVenvを選びます。
    ④ 第001講で使ったPythonを選びます。たとえば、既存のPython 3.12や、新しく導入したPython 3.14です。
    ⑤ 環境名を尋ねられた場合は、.venvにします。
    ⑥ 追加パッケージや依存関係の選択が表示された場合は、今回は選択せずに進み、作成の完了を待ちます。

    作成が完了すると、unit01-productの中に.venvフォルダーができます。 画面によって質問の数や表記が異なる場合がありますが、選ぶ内容は「Venv」「使用するPython」「環境名.venv」です。code.visualstudio.com

    ミカ「.venvの最初の点も、名前の一部ですか。」
    教授「はい。半角の点を含めて.venvです。仮想環境の保存先として、よく使われる名前です。」

    すでにこのunit01-productの中に、今回使う.venvを作成済みの場合は、次の確認へ進んでください。

    【main.pyと.venvの置き場所を確認しよう】

    VS Codeのエクスプローラーで、unit01-productの直下に、main.pyと.venvが並んでいる状態を確認します。

    main.pyは、自分で書くプログラムです。これからも、このファイルを編集します。.venvは、Pythonの実行環境や追加パッケージを管理するためのフォルダーです。

    ミカ「.venvを開くと、いろいろなファイルが入っています。」
    教授「Pythonが用意した環境用のファイルです。Windowsでは、Scriptsの中に、この環境で使うpython.exeがあります。」
    ミカ「main.pyも、そこに入れるのですか。」
    教授「main.pyは、.venvの外に置きます。自分の制作物と、作り直せる実行環境を分けておきましょう。」

    自分で書いたコードは、.venvの中へ保存しません。 仮想環境は必要に応じて再作成するものなので、制作物をその中へ入れないことが大切です。Python 3.14.7 documentation

    【VS Codeで使うPythonを.venvへ切り替えよう】

    仮想環境を作ったら、VS Codeがそれを使うように選択します。

    ① main.pyを開きます。
    ② Ctrl+Shift+Pを押します。
    ③ Python: Select Interpreterを選びます。
    ④ 今回のunit01-product内の.venvにあるPythonを選びます。

    候補の表示で、.venvという名前や、今回のフォルダー内の.venv\Scripts\python.exeを確認してください。Pythonのバージョンが同じでも、別の制作物の環境を選ばないよう、場所を確認します。

    ミカ「Python 3.12という候補が、複数出ることもあるのですね。」
    教授「あります。数字だけで判断せず、今回作った.venvのPythonを選びましょう。」

    選んだ環境は、VS CodeからのPython実行などに使われます。仮想環境を作ることと、実行に使う環境を選ぶことを、セットで確認してください。 code.visualstudio.com

    【仮想環境のPythonで、前回のコードを実行しよう】

    VS Codeの「ターミナル」→「新しいターミナル」を選びます。前回から開いたままのターミナルがある場合は、ごみ箱のアイコンで終了してから、新しく開きます。

    通常、VS Codeは新しいターミナルで選択した環境を有効化します。有効化とは、ターミナルでpythonと入力したときに、その仮想環境のPythonを使うようにすることです。入力行の先頭に(.venv)が付く場合もあります。code.visualstudio.com

    今回は、使うPythonを明示して動作を確かめます。PowerShellの現在の場所がunit01-productであることを確認してから、次の命令を入力してください。場所はGet-Locationで確認できます。

    .\.venv\Scripts\python.exe main.py

    この命令は、「今回の.venvにあるPythonで、main.pyを実行してください」という意味です。先頭の.\は「現在のフォルダーから」という指定です。

    ミカ「使うPythonを、名前だけでなく場所まで指定しているのですね。」
    教授「はい。この命令で前回の3行が表示できれば、仮想環境のPythonで動かせたことを確認できます。」

    この実行方法では、仮想環境を有効化するスクリプトを先に実行する必要はありません。(.venv)の表示が出ていなくても、指定した環境のPythonを使えます。Python 3.14.7 documentation

    先に前回のコードが動くことを確かめてから、商品情報の書き方を変更します。 この順序なら、環境設定と新しいコードのどちらで困っているのかを切り分けやすくなります。

    【商品情報を変数へ分けよう】

    ミカ「専用の環境でも、紅茶の情報が表示できました。」
    教授「では、商品情報へ名前を付けましょう。今回は、商品名・価格・在庫を三つの変数で扱います。」
    ミカ「変数とは何ですか。」
    教授「Pythonでは、値を参照するために付ける名前と考えてください。たとえば、紅茶という文字列にproduct_nameという名前を付けます。」

    変数を使うと、同じ値を、その名前で参照できます。

    今回は、次の名前を使います。

    ・product_name:商品名を参照する名前。
    ・price:価格を参照する名前。
    ・stock:在庫数を参照する名前。

    product_nameの_は、半角のアンダースコアです。複数の単語をつなぎ、名前を読みやすくしています。

    【main.pyを商品データと表示処理に分けて書き換えよう】

    変更するのは、unit01-product直下のmain.pyです。 前回の3行を、次のコードへ置き換えてください。前回のコードの下へ、そのまま追加するのではなく、ファイル全体をこの内容にそろえます。

    product_name = "紅茶"
    price = 1200
    stock = 5
    print(f"商品名:{product_name}")
    print(f"価格:{price}円")
    print(f"在庫:{stock}個")

    入力後、Ctrl+Sで保存します。上の3行が商品データの準備、下の3行が表示処理です。途中の空行は、二つの役割を見分けやすくするために入れています。

    ミカ「同じ表示なのに、コードは増えましたね。」
    教授「今回は、データに名前を付け、表示の書き方と分けました。価格を変更するときは、上のpriceを見る。表示する単位を変えるときは、下の表示処理を見る。修正する場所が分かりやすくなります。」

    【一行ずつ解説――変数へ値を代入する】

    最初の3行を読みます。

    product_name = "紅茶"
    price = 1200
    stock = 5

    1行目のproduct_name = "紅茶"は、文字列"紅茶"をproduct_nameへ代入しています。代入は、右側の値を、左側の名前で参照できるようにする操作です。

    ミカ「数学の『左辺と右辺は等しい』とは、役割が違うのですね。」
    教授「はい。ここでの=は代入です。右側で用意した値を、左側の名前と結び付けます。」

    2行目のprice = 1200は、整数の1200をpriceへ代入します。引用符で囲んでいないので、数値として扱えます。円という単位は、表示するときに付けます。

    3行目のstock = 5は、整数の5をstockへ代入します。こちらも数値です。

    ミカ「前回は『価格:1200円』という文章を丸ごと表示していました。」
    教授「今回は、価格のデータを整数で持ちます。表示のときに、説明の文字や単位と組み合わせます。」

    文字列と数値では、できる処理が異なります。 価格や在庫を数値で持つことが、後で計算や判定を行うための準備になります。

    【一行ずつ解説――f文字列で値を表示する】

    続いて、表示する3行を読みます。

    print(f"商品名:{product_name}")
    print(f"価格:{price}円")
    print(f"在庫:{stock}個")

    ミカ「引用符の前に、fが増えました。」
    教授「これは、f文字列という書き方です。文字列の中の{ }へ、変数の値などを埋め込めます。」

    f"文章{変数名}"と書くと、{変数名}の部分に、その変数が参照する値を表示用に組み込めます。 Python 3.14.7 documentation

    最初の行では、{product_name}に商品名が組み込まれ、「商品名:紅茶」という文字列をprintへ渡します。

    次の行では、{price}に価格が組み込まれ、その後ろへ「円」が付きます。priceが1200なら、「価格:1200円」と表示されます。

    最後の行では、{stock}に在庫数が組み込まれ、その後ろへ「個」が付きます。stockが5なら、「在庫:5個」と表示されます。

    ミカ「数値を、表示するときだけ文章に組み込むのですね。」
    教授「そのとおりです。表示しても、priceやstockが参照する値は整数のままです。」

    fは引用符の外側、{ }は引用符の内側です。波括弧も半角で入力してください。

    【保存して実行し、データの流れを確認しよう】

    Ctrl+Sで保存し、先ほどの命令で再実行してください。VS Codeで今回の.venvを選択済みなら、前回と同じ「Run Python File」からも実行できます。

    商品名:紅茶
    価格:1200円
    在庫:5個

    今回のコードは、次の順に動きます。

    ① 商品名・価格・在庫の値を、それぞれの変数へ代入する。
    ② f文字列で、変数の値を表示用の文章へ組み込む。
    ③ printが、その文章をターミナルへ表示する。

    ミカ「値を準備する場所と、表示する場所が分かれました。」
    教授「はい。今回は、商品データをコードに書いて用意しています。実行するたびに上から処理されるので、値を変更したら保存して再実行しましょう。」

    【オブジェクト指向へのつながり――商品の情報を意識する】

    ミカ「今回の変数も、オブジェクト指向につながるのですか。」
    教授「つながります。まず、商品がどんな情報を持つのかを整理できました。商品名、価格、在庫。この三つが、今回扱う商品の情報です。」
    ミカ「いまは、三つの変数が別々にありますね。」
    教授「そうです。今後、それらの商品情報と、関連する処理をどのようにまとめるかを学んでいきます。」

    今回は、商品の情報を名前付きで扱えるようにする段階です。 独自の商品クラスを作る前に、扱うデータと、そのデータを使う処理を読み取れるようにしておきましょう。

    なお、仮想環境は実行環境や追加パッケージを管理する仕組みです。オブジェクト指向のクラス構造とは目的が異なります。

    【よくある間違い――環境とコードを分けて確認する】

    ① .venvのPythonが候補に出ない
    開いているフォルダーがunit01-productか、その中に.venvができているかを確認します。作成が完了しているのに表示されない場合は、VS Codeを開き直し、Python: Select Interpreterで選び直します。

    ② 実行コマンドで「見つからない」と表示される
    Get-Locationで現在の場所を確認します。現在の場所がunit01-productで、その直下にmain.pyと.venvがある必要があります。VS Codeで正しいフォルダーを開き、ターミナルを作り直して確認してください。

    ③ Activate.ps1の実行が禁止されていると表示される
    PowerShellで、仮想環境を有効化するスクリプトが実行できなかった状態です。仮想環境が作成済みなら、本講の.\.venv\Scripts\python.exe main.pyで、環境のPythonを直接指定して実行できます。

    ④ 商品名ではなく、{product_name}と表示される
    引用符の前のfが抜けていないか確認します。通常の文字列では、波括弧の中も文字として表示されます。print(f"商品名:{product_name}")に直してください。

    ⑤ NameErrorが表示される
    変数名の綴りと、処理の順序を確認します。product_nameとproduct_nemeは別の名前です。また、変数を使う表示処理より前に、その変数へ値を代入してください。

    ミカ「動かないときに、全部を一度に書き直さなくてよいのですね。」
    教授「まず環境の問題か、コードの問題かを確かめます。そのうえで、エラーが示す場所を見ていきましょう。」

    【演習――価格を1500円へ変更しよう】

    演習は一題です。商品の価格を1200円から1500円へ変更してください。

    条件は、次のとおりです。

    ・商品名は「紅茶」、在庫は5個のままにする。
    ・変更するのは、価格の値を準備している一行だけにする。
    ・下の3行のprintは変更しない。
    ・保存して再実行し、価格が変わったことを確認する。

    完成結果は、次のとおりです。

    商品名:紅茶
    価格:1500円
    在庫:5個

    【演習の解説】

    変更するのは、main.pyの2行目です。

    price = 1500

    ミカ「表示するコードを書き換えなくても、価格が変わりました。」
    教授「再実行したとき、f文字列がpriceの値を使って、表示する文章を作るからです。」

    値を用意する場所を変更すれば、その値を使う表示へ反映できます。 今回は、このつながりを自分で確かめることが大切です。

    演習後のmain.pyは、価格が1500の状態で保存してください。次回は、この状態を引き継ぎます。

    【今回の完成確認】

    ・unit01-productの直下に、main.pyと.venvがある。
    ・VS Codeで、今回の.venvのPythonを選択できた。
    ・仮想環境のPythonを指定して、main.pyを実行できた。
    ・商品名を文字列、価格と在庫を整数として用意できた。
    ・f文字列で商品情報を表示できた。
    ・価格を変更し、再実行した表示へ反映できた。

    【これだけは覚える――今回の三つの要点】

    ・仮想環境は制作物ごとに用意し、そのPythonを選んで使う。自分のコードは.venvの外へ置く。
    ・名前 = 値で代入すると、その名前で値を参照できる。
    ・f"文章{変数名}"で、変数の値を表示する文章へ組み込める。

    ミカ「フォルダーも、使うPythonも、商品のデータも、置き場所と役割が分かってきました。」
    教授「その理解を、次の制作でも使いましょう。名前と役割が分かると、コードを読むときにも、直すときにも手がかりになります。」

    【次回への引継ぎ】

    次回は、**「制作編 第003講 商品情報を返す関数を作り、仕事をひとまとまりにしよう」**です。今回のunit01-product、.venv、そして価格を1500へ変更したmain.pyを引き継ぎます。

    商品情報を表示用の文章へ整える処理を、名前の付いた関数へまとめていきます。

    あなたへのおすすめ