Pythonからコマンドを実行したり、Pythonコードを実行したりする方法【サブプロセスの管理】

この記事では、Pythonのコード内からコマンドプロンプトやターミナルのコマンドを実行したり、Pythonコードを実行する方法を解説します。

これらの実行はサブプロセスとして管理します。

それでは、サブプロセスを起動し、コマンドラインを操作してみましょう!

使用した環境
サブプロセスの起動
非同期で実行する
まとめ

使用した環境

Windows11	Python 3.11.5

サブプロセスの起動

サブプロセスを起動するには、subprocessモジュールのrun()関数を使います。

構文

import subprocess subprocess.run(args, *, stdin=None, input=None, stdout=None, stderr=None, capture_output=False, shell=False, cwd=None, timeout=None, check=False, encoding=None, errors=None, text=None, env=None, universal_newlines=None, **other_popen_kwargs)

戻り値の型

<class 'subprocess.CompletedProcess'>

解説

argsで指定されたコマンドを実行し、コマンドの完了を待ってCompletedProcessインスタンスを返します。argsには文字列あるいはプログラム引数のシーケンスを指定できますが、基本的には引数のシーケンスを渡す方が良いです。

Pythonコードの実行

Pythonコードtest.pyをsubprocess.run()関数を使って実行してみます。test.pyはprint()関数を使ってTESTと出力するだけのモジュールです。

import subprocess # プログラム引数のシーケンス seq = ['python', 'test.py'] # サブプロセスの起動 subprocess.run(seq)

実行結果

TEST

TESTと出力され、test.pyが実行されたのがわかります。もしコマンドライン引数を渡したい場合は以下のようにシーケンスに追加します。

seq = ['python', 'test.py', 'コマンドライン引数1', 'コマンドライン引数2']

コマンドの実行

コマンドをsubprocess.run()関数を使って実行してみます。Windowsの場合、shellの組み込みコマンドを実行するにはshell=Trueとする必要がある。

import subprocess # Unix/Linux seq = ['ls'] subprocess.run(seq) # Windows 組み込み seq = ['dir'] subprocess.run(seq, shell=True) # Windows 外部コマンド seq = ['whoami'] subprocess.run(seq)

オプションやファイル名を指定したい場合はシーケンスに追加します。

seq = ['dir', '/p', '/s']

注意: OSコマンドインジェクション

shell=Trueにすると「OSコマンドインジェクションの脆弱性」を生む可能性があります。できるだけ使わないように注意してください。

どうしても必要な場合は、公式サイトをよく読んでから実装してください。

外部Linkセキュリティで考慮すべき点 - subprocess --- サブプロセス管理 — Python 3.12.0 ドキュメント

また、OSコマンドインジェクションについて理解し、きちんと対策を打っておきましょう!

外部LinkOSコマンドインジェクションの仕組みとその対策 | セキュリティ対策 | CyberSecurityTIMES

非同期で実行する

サブプロセスを非同期で起動するには、subprocess.Popen()コンストラクタを使います。Popenオブジェクトでは、wait()やkill()などのメソッドを呼び出すことができます。

構文

import subprocess subprocess.Popen(args, bufsize=- 1, executable=None, stdin=None, stdout=None, stderr=None, preexec_fn=None, close_fds=True, shell=False, cwd=None, env=None, universal_newlines=None, startupinfo=None, creationflags=0, restore_signals=True, start_new_session=False, pass_fds=(), *, group=None, extra_groups=None, user=None, umask=- 1, encoding=None, errors=None, text=None, pipesize=- 1, process_group=None)

戻り値の型

<class 'subprocess.Popen'>

例としてtest.pyを非同期で実行してみる。test.pyはコマンドライン引数で適当な文字列とインターバルを受け取り、文字列と現在時刻をインターバルだけ待機しながら3回出力する。

import subprocess seq = ['python', 'test.py', 'test1', '1'] p1 = subprocess.Popen(seq) seq = ['python', 'test.py', 'test2', '2'] p2 = subprocess.Popen(seq) p1.wait() p2.wait()

test.py

import datetime as dt import sys import time s = sys.argv[1] interval = float(sys.argv[2]) for i in range(3): print(s, dt.datetime.now()) time.sleep(interval)

実行結果

test1 2023-10-23 16:36:28.532482 test2 2023-10-23 16:36:28.534502 test1 2023-10-23 16:36:29.533592 test1 2023-10-23 16:36:30.534622 test2 2023-10-23 16:36:30.535261 test2 2023-10-23 16:36:32.536604