Python 業務自動化 | 基礎自動化：コマンドラインからPythonを実行する

Python自動化の基礎と、コマンドラインからPythonを実行する流れ

Python自動化を始めるとき、多くの方が最初に気になるのは「何を自動化できるのか」ですが、実はそれと同じくらい大切なのが「コマンドラインからPythonを実行できること」です。なぜなら、自動化は単にコードを書くことではなく、必要なタイミングでプログラムを動かし、結果を確認し、修正し、また実行することの繰り返しだからです。

特に初心者の方にとっては、エディタにコードを書くだけではまだ半分です。実際にコマンドラインからPythonファイルを実行し、その場で結果やエラーを確認できるようになることで、初めて自動化の入口に立てます。この記事では、Python自動化の基本的な考え方から、コマンドラインの意味、実行方法、よくあるつまずき、簡単な自動化例、そして安全に使うための注意点までを、順を追って丁寧に解説します。

まず理解したい、Python自動化とは何か

Python自動化とは、人が手で何度も行っている作業をPythonに任せることです。たとえば、毎日同じ形式のファイルを整理する、CSVを読み込んで集計する、決まった文章を整形する、特定のフォルダ内を確認する、といった処理は自動化と相性が良いです。

ここで重要なのは、自動化とは「複雑なことをすること」ではなく、「繰り返し発生する手順をプログラムに置き換えること」だという点です。初心者の方は、自動化という言葉から大がかりな仕組みを想像しがちですが、実際には小さな作業から始めるほうが学びやすいです。

たとえば、次のような作業はPython自動化の入門としてとても良い題材です。

• 特定のフォルダにあるファイル一覧を表示する
• ファイル名の一部をまとめて変更する
• CSVファイルから数値を読み取って合計する
• ログファイルに実行結果を書き出す
• 毎回同じメッセージを整形して出力する

このような処理は一見地味ですが、変数、繰り返し、条件分岐、ファイル操作、エラー確認といった自動化の基礎がしっかり詰まっています。

コマンドラインとは何かを初心者向けに理解する

コマンドラインは、文字でコンピュータに命令する場所です

コマンドラインとは、キーボードで命令文を入力してコンピュータを操作する画面のことです。WindowsではコマンドプロンプトやPowerShell、macOSやLinuxではターミナルと呼ばれることが多いです。

普段はマウスでアイコンをクリックして操作することが多いですが、プログラミングや自動化では、文字で直接命令を出す方法がとても重要です。なぜなら、Pythonファイルを実行したり、現在いるフォルダを確認したり、実行結果を読み取ったりする作業が、コマンドラインで非常にやりやすいからです。

初心者の方は「黒い画面が怖い」と感じることがありますが、最初に覚える命令は多くありません。むしろ、自動化を学ぶうえでは、コマンドラインの基本に慣れることが大きな近道になります。

コマンドラインが重要な理由

Python自動化では、コードを書いた後に実行し、表示された結果やエラーを見て修正する、という流れを何度も繰り返します。このときコマンドラインを使えると、動作確認がとても速くなります。

• Pythonファイルをすぐ実行できる
• エラー内容をその場で確認できる
• どのフォルダで作業しているか把握できる
• 複数のスクリプトを使い分けやすい
• あとから自動実行の設定につなげやすい

つまり、コマンドラインは単なる実行手段ではなく、自動化の土台です。最初のうちに慣れておくと、その後の学習がかなり楽になります。

Pythonをコマンドラインから実行するまでの準備

Pythonがインストールされているか確認する

最初に行うべきことは、Pythonがパソコンに入っているか確認することです。Python本体がなければ、どんなコードも実行できません。確認はコマンドラインで行います。

python --version

または、環境によっては次のように入力します。

python3 --version

これでPythonのバージョンが表示されれば、基本的な準備はできています。もし「コマンドが見つからない」と表示される場合は、Pythonのインストールが済んでいないか、パス設定が通っていない可能性があります。

ここで大切なのは、インストールしたつもりでも必ず確認することです。初心者の方は、エディタにPython拡張機能を入れたことでPython本体も準備できたと誤解しやすいですが、エディタとPython本体は別物です。コードを書く道具と、コードを実行する本体は分けて考える必要があります。

作業用フォルダを決める

自動化を始めるときは、専用の作業フォルダを作ることを強くおすすめします。デスクトップ上でもドキュメントフォルダ内でも構いませんが、どこに何のファイルを置いているのか分からなくなると、学習効率が一気に下がります。

たとえば、python_automation_practice のようなフォルダを作り、その中に練習用ファイルをまとめます。これは単なる整理整頓ではなく、安全のためにも重要です。重要な既存ファイルが混ざっている場所で自動化を試すと、誤操作による上書きや削除の危険があるからです。

コマンドラインでフォルダを移動する

Pythonファイルを実行するには、そのファイルがあるフォルダへコマンドラインで移動する必要があります。これには cd という命令を使います。

cd フォルダ名

たとえば、デスクトップ上の作業フォルダに移動するイメージです。実際のパスは環境によって異なりますが、考え方としては「これから実行したいPythonファイルが置いてある場所へ移動する」と覚えるとわかりやすいです。

なお、今どこにいるのか分からなくなったときは、Windowsなら cd、macOSやLinuxなら pwd で現在位置を確認できます。初心者の方は、ファイルが見つからない原因の多くが「別のフォルダにいる」ことなので、ここは特に丁寧に確認してください。

最初のPythonファイルを作って実行する

まずは1行だけのコードで成功体験を作る

最初から長いコードを書く必要はありません。まずは、Pythonファイルを作り、コマンドラインから実行し、結果が表示されるという流れを体験することが大切です。たとえば、次のようなコードを書きます。

# 画面にメッセージを表示する最初のサンプルです
print("Pythonをコマンドラインから実行できました")

# 画面にメッセージを表示する最初のサンプルです
print("Pythonをコマンドラインから実行できました")

この内容を hello.py という名前で保存します。そしてコマンドラインでそのフォルダに移動したあと、次のように実行します。

python hello.py

環境によっては次のように実行することもあります。

python3 hello.py

文字が表示されれば成功です。この段階では、まだ自動化らしいことはしていませんが、とても重要な一歩です。ここで「ファイルを保存する」「コマンドラインで移動する」「Pythonで実行する」「結果を確認する」という一連の流れが身につきます。

コマンドライン実行でよくあるミス

初心者の方が最初によく遭遇するミスはいくつかあります。

• ファイル名を間違えている
• 拡張子が .py になっていない
• Pythonファイルがあるフォルダに移動していない
• python ではなく python3 が必要な環境である
• ファイル保存が完了していない

特に多いのは、エディタ上ではファイルが見えているのに、コマンドラインでは別の場所にいるケースです。プログラムが悪いのではなく、実行場所が違うだけで失敗していることは珍しくありません。エラーが出たら、まず「今どのフォルダにいるか」「実行したいファイルは本当にそこにあるか」を確認してください。

コマンドライン実行を前提にした、自動化の基本の考え方

自動化は、手作業の流れを小さな命令に分けることです

Python自動化では、いきなりコードを書くのではなく、まず手作業を言葉で分解することが大切です。たとえば「フォルダ内のテキストファイルを数えたい」という作業なら、次のように分けられます。

• 対象フォルダを決める
• フォルダ内の一覧を取得する
• 1つずつファイルを確認する
• .txt で終わるものだけ数える
• 合計件数を表示する

このように考えられると、Pythonコードに落とし込みやすくなります。初心者の方は、コードそのものよりも、処理を分解する力を意識して伸ばしたほうが、結果的に自動化が得意になります。

入力、処理、出力で考える

自動化スクリプトは、多くの場合「入力」「処理」「出力」で整理できます。

• 入力：ファイル、フォルダ、ユーザーが与える値
• 処理：数える、変換する、集計する、移動する
• 出力：画面表示、ファイル保存、ログ記録

この枠組みで考えると、コードの構造が見えやすくなります。特にコマンドライン実行では、結果が文字で表示されることが多いため、出力を分かりやすくすることが重要です。

例題1 コマンドラインから実行できる最小の自動化

フォルダ内のファイル一覧を表示する

最初の例題として、指定したフォルダの中にあるファイルやフォルダの名前を表示する自動化を作ってみます。これはシンプルですが、実務でも非常によく使う考え方です。ファイル操作の入口としても優秀です。

import os

# 指定したフォルダの中身を表示する関数です
def show_files(folder_path):
    # フォルダが存在するか確認します
    if not os.path.exists(folder_path):
        print("指定したフォルダが見つかりません")
        return

    # フォルダ内の一覧を取得します
    items = os.listdir(folder_path)

    # 中身を1つずつ表示します
    for item in items:
        print(item)

# メイン処理です
def main():
    # 調べたいフォルダを指定します
    folder_path = "."

    # フォルダ内の一覧を表示します
    show_files(folder_path)

# このファイルを直接実行したときだけmain関数を動かします
if __name__ == "__main__":
    main()

import os

# 指定したフォルダの中身を表示する関数です
def show_files(folder_path):
    # フォルダが存在するか確認します
    if not os.path.exists(folder_path):
        print("指定したフォルダが見つかりません")
        return

    # フォルダ内の一覧を取得します
    items = os.listdir(folder_path)

    # 中身を1つずつ表示します
    for item in items:
        print(item)

# メイン処理です
def main():
    # 調べたいフォルダを指定します
    folder_path = "."

    # フォルダ内の一覧を表示します
    show_files(folder_path)

# このファイルを直接実行したときだけmain関数を動かします
if __name__ == "__main__":
    main()

このコードをたとえば list_files.py という名前で保存し、コマンドラインで次のように実行します。

python list_files.py

"." は「現在いるフォルダ」を表します。つまり、このスクリプトを実行した場所の中身を調べる、という意味です。コマンドラインの現在位置とPythonの処理対象がつながるため、コマンドラインに慣れる練習としても役立ちます。

この例題で深く理解したいこと

このスクリプトは短いですが、自動化の重要な基本が含まれています。特に大切なのは、いきなり処理せず、まず対象が存在するか確認している点です。初心者の方は結果を急いでしまいがちですが、実際の自動化では「対象があるか」「条件を満たしているか」を先に確認するコードがとても重要です。

自動化は、正しい対象に対してだけ正しい処理を行うことに価値があります。確認なしに動かすコードは、たとえ短くても危険です。

例題2 コマンドライン引数を使って、外から値を渡す

コマンドライン引数とは何か

コマンドラインからPythonを実行する大きな利点の1つは、実行時に追加の値を渡せることです。これをコマンドライン引数と呼びます。たとえば、毎回コードを書き換えなくても、「今日はこのフォルダを対象にする」と実行時に指定できます。

これは自動化を実用に近づける大事な考え方です。コード本体は共通のまま、対象だけを変えられるようになるからです。

引数を受け取るサンプル

import os
import sys

# 引数で受け取ったフォルダの中身を表示する関数です
def show_files(folder_path):
    # フォルダが存在するか確認します
    if not os.path.exists(folder_path):
        print("指定したフォルダが見つかりません")
        return

    # 一覧を取得して表示します
    for item in os.listdir(folder_path):
        print(item)

def main():
    # 引数の数を確認します
    if len(sys.argv) < 2:
        print("使い方: python script.py フォルダパス")
        return

    # 1つ目の引数をフォルダパスとして受け取ります
    folder_path = sys.argv[1]

    # 指定されたフォルダの中身を表示します
    show_files(folder_path)

if __name__ == "__main__":
    main()

import os
import sys

# 引数で受け取ったフォルダの中身を表示する関数です
def show_files(folder_path):
    # フォルダが存在するか確認します
    if not os.path.exists(folder_path):
        print("指定したフォルダが見つかりません")
        return

    # 一覧を取得して表示します
    for item in os.listdir(folder_path):
        print(item)

def main():
    # 引数の数を確認します
    if len(sys.argv) < 2:
        print("使い方: python script.py フォルダパス")
        return

    # 1つ目の引数をフォルダパスとして受け取ります
    folder_path = sys.argv[1]

    # 指定されたフォルダの中身を表示します
    show_files(folder_path)

if __name__ == "__main__":
    main()

このコードを script.py として保存した場合、次のように実行できます。

python script.py .

または、特定のフォルダを指定するなら、そのパスを渡します。これにより、1つのスクリプトを使い回せるようになります。

なぜ引数が重要なのか

初心者の段階では、コードの中に対象フォルダを直接書いても学習はできます。ただし、そのままだと使い回しに弱くなります。引数を使えば、同じプログラムをさまざまな対象に適用できるため、実用性が一気に高まります。

さらに、あとで自動実行やバッチ処理を組むときにも、引数を受け取れる設計は非常に役立ちます。つまり、引数は単なる便利機能ではなく、再利用しやすい自動化の基礎です。

例題3 コマンドラインからCSV集計を実行する

現場で役立つ形に少し近づける

次に、コマンドラインからCSVファイルを指定して、金額の合計を計算する例を見てみます。これは、コマンドライン実行、自動化、データ処理の3つをまとめて学べる良い題材です。

import csv
import os
import sys

# CSVファイルのprice列を合計する関数です
def calculate_total(csv_file_path):
    # 合計を入れる変数です
    total = 0

    # CSVファイルを開きます
    with open(csv_file_path, mode="r", encoding="utf-8") as file:
        # 1行ずつ辞書形式で読み込みます
        reader = csv.DictReader(file)

        # 各行のpriceを合計します
        for row in reader:
            total += int(row["price"])

    # 合計値を返します
    return total

def main():
    # 引数が足りない場合は使い方を表示します
    if len(sys.argv) < 2:
        print("使い方: python total_csv.py CSVファイル名")
        return

    # 引数からCSVファイル名を受け取ります
    csv_file_path = sys.argv[1]

    # ファイルの存在を確認します
    if not os.path.exists(csv_file_path):
        print("指定したCSVファイルが見つかりません")
        return

    # 合計を計算します
    total = calculate_total(csv_file_path)

    # 結果を表示します
    print(f"合計金額は {total} 円です")

if __name__ == "__main__":
    main()

import csv
import os
import sys

# CSVファイルのprice列を合計する関数です
def calculate_total(csv_file_path):
    # 合計を入れる変数です
    total = 0

    # CSVファイルを開きます
    with open(csv_file_path, mode="r", encoding="utf-8") as file:
        # 1行ずつ辞書形式で読み込みます
        reader = csv.DictReader(file)

        # 各行のpriceを合計します
        for row in reader:
            total += int(row["price"])

    # 合計値を返します
    return total

def main():
    # 引数が足りない場合は使い方を表示します
    if len(sys.argv) < 2:
        print("使い方: python total_csv.py CSVファイル名")
        return

    # 引数からCSVファイル名を受け取ります
    csv_file_path = sys.argv[1]

    # ファイルの存在を確認します
    if not os.path.exists(csv_file_path):
        print("指定したCSVファイルが見つかりません")
        return

    # 合計を計算します
    total = calculate_total(csv_file_path)

    # 結果を表示します
    print(f"合計金額は {total} 円です")

if __name__ == "__main__":
    main()

このスクリプトを total_csv.py として保存し、次のように実行します。

python total_csv.py sales.csv

この形にしておくと、別のCSVにも使い回せます。つまり、コードを毎回書き換える必要がなくなり、実際の業務に近い使い方ができるようになります。

重要な注意点を深掘りする

このようなCSV処理では、サンプル通りのきれいなデータだけが来るとは限りません。現実には、空欄、文字列混入、列名の違い、文字コードの不一致などがよく起こります。初心者の方が最初に覚えておきたいのは、「見本どおりのデータだけを前提にしない」ということです。

自動化は、人の代わりに大量の処理をするからこそ、想定外の入力に弱いと問題が大きくなります。そのため、実用的なコードでは、正常系だけでなく異常系も意識することが重要です。

少し安全にしたCSV集計版

import csv
import os
import sys

# CSVファイルのprice列を安全に合計する関数です
def calculate_total(csv_file_path):
    # 合計を初期化します
    total = 0

    # ファイルを開きます
    with open(csv_file_path, mode="r", encoding="utf-8") as file:
        # 辞書形式で読み込みます
        reader = csv.DictReader(file)

        # 1行ずつ処理します
        for row in reader:
            # price列の値を取得します
            price_text = row.get("price", "").strip()

            # 空欄はスキップします
            if price_text == "":
                print("空欄のpriceをスキップしました")
                continue

            # 数値に変換できる場合のみ加算します
            try:
                total += int(price_text)
            except ValueError:
                print(f"数値ではない値をスキップしました: {price_text}")

    return total

def main():
    # 引数が足りない場合は使い方を表示します
    if len(sys.argv) < 2:
        print("使い方: python total_csv.py CSVファイル名")
        return

    # 引数からファイル名を取得します
    csv_file_path = sys.argv[1]

    # ファイルが存在するか確認します
    if not os.path.exists(csv_file_path):
        print("指定したCSVファイルが見つかりません")
        return

    # 合計を計算して表示します
    total = calculate_total(csv_file_path)
    print(f"安全に計算した合計金額は {total} 円です")

if __name__ == "__main__":
    main()

import csv
import os
import sys

# CSVファイルのprice列を安全に合計する関数です
def calculate_total(csv_file_path):
    # 合計を初期化します
    total = 0

    # ファイルを開きます
    with open(csv_file_path, mode="r", encoding="utf-8") as file:
        # 辞書形式で読み込みます
        reader = csv.DictReader(file)

        # 1行ずつ処理します
        for row in reader:
            # price列の値を取得します
            price_text = row.get("price", "").strip()

            # 空欄はスキップします
            if price_text == "":
                print("空欄のpriceをスキップしました")
                continue

            # 数値に変換できる場合のみ加算します
            try:
                total += int(price_text)
            except ValueError:
                print(f"数値ではない値をスキップしました: {price_text}")

    return total

def main():
    # 引数が足りない場合は使い方を表示します
    if len(sys.argv) < 2:
        print("使い方: python total_csv.py CSVファイル名")
        return

    # 引数からファイル名を取得します
    csv_file_path = sys.argv[1]

    # ファイルが存在するか確認します
    if not os.path.exists(csv_file_path):
        print("指定したCSVファイルが見つかりません")
        return

    # 合計を計算して表示します
    total = calculate_total(csv_file_path)
    print(f"安全に計算した合計金額は {total} 円です")

if __name__ == "__main__":
    main()

このように、問題が起きそうな箇所に対策を入れておくと、コードが壊れにくくなります。初心者のうちから「失敗しにくいコード」を意識することは、将来とても大きな差になります。

コマンドライン実行を前提にした基本テンプレート

ここまでの内容を踏まえると、初心者向けには次のようなテンプレートを持っておくと便利です。これは「引数の確認」「対象の存在確認」「処理の実行」「結果表示」という流れをまとめた基本形です。

import os
import sys

# メインの処理を行う関数です
def process_target(target_path):
    # 対象が存在しない場合は中断します
    if not os.path.exists(target_path):
        print("指定した対象が存在しません")
        return

    # 対象がファイルかフォルダかを表示します
    if os.path.isfile(target_path):
        print(f"ファイルを処理します: {target_path}")
    elif os.path.isdir(target_path):
        print(f"フォルダを処理します: {target_path}")
    else:
        print("ファイルでもフォルダでもない対象です")

# 実行開始用の関数です
def main():
    # 引数の数を確認します
    if len(sys.argv) < 2:
        print("使い方: python template.py 対象パス")
        return

    # コマンドライン引数から対象パスを受け取ります
    target_path = sys.argv[1]

    # 処理開始を知らせます
    print("処理を開始します")

    # 実際の処理を行います
    process_target(target_path)

    # 処理終了を知らせます
    print("処理を終了します")

# このファイルが直接実行されたときだけmain関数を動かします
if __name__ == "__main__":
    main()

import os
import sys

# メインの処理を行う関数です
def process_target(target_path):
    # 対象が存在しない場合は中断します
    if not os.path.exists(target_path):
        print("指定した対象が存在しません")
        return

    # 対象がファイルかフォルダかを表示します
    if os.path.isfile(target_path):
        print(f"ファイルを処理します: {target_path}")
    elif os.path.isdir(target_path):
        print(f"フォルダを処理します: {target_path}")
    else:
        print("ファイルでもフォルダでもない対象です")

# 実行開始用の関数です
def main():
    # 引数の数を確認します
    if len(sys.argv) < 2:
        print("使い方: python template.py 対象パス")
        return

    # コマンドライン引数から対象パスを受け取ります
    target_path = sys.argv[1]

    # 処理開始を知らせます
    print("処理を開始します")

    # 実際の処理を行います
    process_target(target_path)

    # 処理終了を知らせます
    print("処理を終了します")

# このファイルが直接実行されたときだけmain関数を動かします
if __name__ == "__main__":
    main()

このテンプレートの良い点は、どの自動化にも応用しやすいことです。対象の受け取り方が整理されており、開始と終了も分かりやすく、存在確認も入っています。初心者の方は、毎回ゼロから書くより、この型をもとに目的に応じて中身を差し替えるほうが学びやすいです。

コマンドライン実行で初心者が特に注意すべきこと

現在地を意識する

コマンドラインでは、今どのフォルダにいるかがとても重要です。エディタ上でファイルを開いていても、コマンドラインの現在地が違えば、そのファイルは見つかりません。これは初心者の方が最もよくつまずくポイントの1つです。

Pythonのコードが間違っているように見えて、実は実行場所が違うだけというケースは本当によくあります。エラーが出たら、まず現在地を確認する習慣をつけてください。

本番ファイルをいきなり触らない

自動化の学習では、ファイル名変更、移動、削除などを試したくなります。しかし、実際の大事なファイルでいきなり試すのは危険です。必ず練習用のフォルダを作り、コピーしたダミーファイルで動作確認をしてください。

特にコマンドライン実行は素早く何度も試せるため、便利な反面、間違ったスクリプトをそのまま何度も動かしてしまうことがあります。速く試せるからこそ、安全確認が必要です。

秘密情報をコードに書かない

今はまだコマンドライン実行の基礎段階でも、今後APIや外部サービスを使うようになると、認証情報を扱うことがあります。このとき、ID、パスワード、APIキーなどをコードに直接書くのは避けるべきです。

自動化スクリプトは共有されたり、バックアップされたり、履歴に残ったりしやすいため、秘密情報が埋め込まれていると漏えいの危険があります。初心者の段階から「秘密情報はコードと分ける」という考え方を持っておくと安全です。

import os

# 環境変数から秘密情報を取得する例です
api_key = os.getenv("MY_API_KEY")

# 値が取得できたか確認します
if api_key:
    print("APIキーを読み込みました")
else:
    print("APIキーが設定されていません")

import os

# 環境変数から秘密情報を取得する例です
api_key = os.getenv("MY_API_KEY")

# 値が取得できたか確認します
if api_key:
    print("APIキーを読み込みました")
else:
    print("APIキーが設定されていません")

このような書き方に慣れておくと、将来より安全な自動化へ進みやすくなります。

学習を進めるときのおすすめの順番

Python自動化とコマンドライン実行を身につけるには、次の順番で進めると理解しやすいです。

• Pythonのインストール確認をする
• コマンドラインを開く
• 作業フォルダへ移動する
• 1行だけのPythonファイルを実行する
• 引数を受け取るスクリプトを作る
• ファイル一覧表示やCSV集計を試す
• エラー時の確認方法に慣れる
• 安全確認を含む自動化に発展させる

この順番には意味があります。最初に実行環境を固め、その後に小さな成功を積み重ねることで、無理なく理解が進みます。いきなり大きな自動化に挑戦するより、短いスクリプトを何本か作るほうが着実です。

まとめ

Python自動化の基礎を学ぶうえで、コマンドラインからPythonを実行できることは欠かせません。コードを書くことと同じくらい、実行し、結果を確認し、エラーを読み取り、修正して再実行する流れが重要だからです。

初心者の方はまず、Pythonが使えるか確認し、作業フォルダを決め、1行のスクリプトをコマンドラインから実行するところから始めると良いです。そこから、フォルダ一覧の表示、引数の受け取り、CSV集計と少しずつ進めることで、自動化の考え方が自然に身につきます。

特に大切なのは、手作業を小さく分解すること、現在のフォルダ位置を意識すること、いきなり重要ファイルを触らないこと、そして安全性を軽視しないことです。自動化は便利ですが、処理が速くなるぶん、ミスも速く広がります。そのため、初心者の段階から確認と安全設計を習慣にすることが重要です。

Python自動化は、難しい裏技ではありません。小さな作業を、順番に、丁寧に、再現できる形へ変えていく技術です。コマンドラインから実行する基本を身につけることで、その第一歩をしっかり踏み出せます。