Pythonの構成情報へのアクセス方法｜sysconfigモジュールの使い方を解説

Pythonのインストールに関する構成情報（コンフィギュレーション情報）には、標準ライブラリのsysconfigモジュールを通じてアクセスできます。取得できる情報には、インストール先のパス一覧や、インストールされたプラットフォーム固有の設定変数などが含まれます。

sysconfigモジュールには構成変数へアクセスするための関数が複数用意されています。ここでは、主要な関数の使い方を順に解説します。

sysconfig.get_config_vars()

引数を付けずに呼び出すと、現在のプラットフォームに関連するすべての構成変数を辞書形式で返します。

>>> import sysconfig
>>> sysconfig.get_config_vars()
{'prefix': 'E:\\python37', 'exec_prefix': 'E:\\python37', 'py_version': '3.7.2', 'py_version_short': '3.7', 'py_version_nodot': '37', 'installed_base': 'E:\\python37', 'base': 'E:\\python37', 'installed_platbase': 'E:\\python37', 'platbase': 'E:\\python37', 'projectbase': 'E:\\python37', 'abiflags': '', 'LIBDEST': 'E:\\python37\\Lib', 'BINLIBDEST': 'E:\\python37\\Lib', 'INCLUDEPY': 'E:\\python37\\Include', 'EXT_SUFFIX': '.pyd', 'EXE': '.exe', 'VERSION': '37', 'BINDIR': 'E:\\python37', 'SO': '.pyd', 'userbase': 'C:\\Users\\acer\\AppData\\Roaming\\Python', 'srcdir': 'E:\\python37'}

引数を指定して呼び出すと、指定したキーに対応する値だけをリストで返します。存在しないキーを指定した場合、その位置にはNoneが返されます。

>>> sysconfig.get_config_vars('base','EXE')
['E:\\python37', '.exe']

sysconfig.get_config_var()

この関数は、単一の変数名に対応する値を1つだけ返します。動作はget_config_vars().get(name)と同等で、指定した名前が見つからない場合にはNoneを返します。

>>> sysconfig.get_config_var('VERSION')
'37'
>>> sysconfig.get_config_var('srcdir')
'E:\\python37'

Pythonでは、プラットフォームやインストール時のオプションに応じて異なる「インストールスキーム」が使用されます。現在サポートされているスキームは以下の5種類です。

get_path_names()

sysconfigが現在サポートしているすべてのパス名をタプルとして返します。

>>> sysconfig.get_path_names()
('stdlib', 'platstdlib', 'purelib', 'platlib', 'include', 'scripts', 'data')

各スキームは、一意な識別子を持つ複数のパスから構成されています。それぞれのパス名の意味は次のとおりです。

get_path()

指定したインストールスキームの中から、パス名に対応する実際のインストールパスを返します。

>>> sysconfig.get_path('include')
'E:\\python37\\Include'

get_platform()

現在のプラットフォームを識別する文字列を返します。

>>> sysconfig.get_platform()
'win-amd64'

get_python_version()

「メジャー.マイナー」形式のPythonバージョン番号を文字列として返します（例：'3.7'）。

さらに、sysconfigモジュールをコマンドラインから-mオプション付きで実行すると、構成変数とその値の一覧をまとめて確認できます。

E:\python37>python -m sysconfig
Platform: "win-amd64"
Python version: "3.7"
Current installation scheme: "nt"
Paths:
    data = "E:\python37"
    include = "E:\python37\Include"
    platinclude = "E:\python37\Include"
    platlib = "E:\python37\Lib\site-packages"
    platstdlib = "E:\python37\Lib"
    purelib = "E:\python37\Lib\site-packages"
    scripts = "E:\python37\Scripts"
    stdlib = "E:\python37\Lib"
Variables:
    BINDIR = "E:\python37"
    BINLIBDEST = "E:\python37\Lib"
    EXE = ".exe"
    EXT_SUFFIX = ".pyd"
    INCLUDEPY = "E:\python37\Include"
    LIBDEST = "E:\python37\Lib"
    SO = ".pyd"
    VERSION = "37"
    abiflags = ""
    base = "E:\python37"
    exec_prefix = "E:\python37"
    installed_base = "E:\python37"
    installed_platbase = "E:\python37"
    platbase = "E:\python37"
    prefix = "E:\python37"
    projectbase = "E:\python37"
    py_version = "3.7.2"
    py_version_nodot = "37"
    py_version_short = "3.7"
    srcdir = "E:\python37"
    userbase = "C:\Users\acer\AppData\Roaming\Python"

このようにsysconfigモジュールを活用すれば、Python環境の構成情報をプログラムから簡単に取得できます。ビルドツールやパッケージ管理ツールを開発する際などにぜひ活用してください。