Pythonの`platform`ライブラリ徹底解説！ 💻 OS・バージョン・ハードウェア情報を自在に取得

最も基本的なOSの種類（カーネル名）を取得するには `platform.system()` を使います。

import platform

os_name = platform.system()
print(f"OS名: {os_name}")

実行結果例:

• Windows: OS名: Windows
• macOS: OS名: Darwin (macOSの基盤となっているコアシステムの名称)
• Linux: OS名: Linux

この関数は、OSごとに処理を分岐させたい場合に非常に便利です。例えば、ファイルパスの区切り文字 (`\` or `/`) や利用可能なシステムコマンドがOSによって異なる場合に役立ちます。

OSのリリースバージョン（例: Windows 10の`10`、macOS Venturaの`22.6.0`、Ubuntu 22.04の`5.15.0-76-generic`）を取得します。

import platform

os_release = platform.release()
print(f"OSリリース: {os_release}")

実行結果例:

• Windows 10: OSリリース: 10
• macOS Ventura: OSリリース: 22.6.0
• Linux (Ubuntu 22.04): OSリリース: 5.15.0-101-generic

特定のOSバージョン以上でないと利用できないAPIや機能を使いたい場合に、この情報でチェックできます。

`platform.release()` よりも詳細なバージョン情報を取得します。OSによって返される情報の形式は異なります。

import platform

os_version = platform.version()
print(f"OSバージョン: {os_version}")

実行結果例:

• Windows 10: OSバージョン: 10.0.19045
• macOS Ventura: OSバージョン: Darwin Kernel Version 22.6.0: Wed Jul 5 22:21:56 PDT 2023; root:xnu-8796.141.3~6/RELEASE_ARM64_T8112
• Linux (Ubuntu 22.04): OSバージョン: #114-Ubuntu SMP Tue Oct 10 15:01:06 UTC 2023

デバッグログや環境報告などで、より詳細な情報が必要な場合に有用です。

これまで見てきたようなOS情報を、人間が読みやすい形式でまとめた文字列を返します。`aliased` や `terse` といった引数で出力形式を調整できます。

import platform

# 基本的な情報
platform_info = platform.platform()
print(f"プラットフォーム情報 (標準): {platform_info}")

# エイリアスを使用 (例: Linuxディストリビューション名など)
platform_info_aliased = platform.platform(aliased=True)
print(f"プラットフォーム情報 (エイリアス): {platform_info_aliased}")

# 簡潔な情報 (OS名とバージョンのみなど)
platform_info_terse = platform.platform(terse=True)
print(f"プラットフォーム情報 (簡潔): {platform_info_terse}")

実行結果例 (macOS Ventura):

• 標準: プラットフォーム情報 (標準): macOS-13.6.1-arm64-arm-64bit
• エイリアス: プラットフォーム情報 (エイリアス): macOS-13.6.1-arm64-arm-64bit (macOSでは変化なし)
• 簡潔: プラットフォーム情報 (簡潔): macOS-13.6.1

ログ出力やシステム情報の表示に適しています。`terse=True` はクロスプラットフォームでOS名とバージョンだけを取得したい場合に便利です。

Unixライクなシステム (Linux, macOSなど) で、より詳細なシステム情報を取得します。`uname` コマンドの結果に似た情報が、名前付きタプル (`uname_result`) で返されます。Windowsでも動作しますが、一部の情報は固定値や推測値になります。

import platform

uname_info = platform.uname()
print(uname_info)
print(f"  System: {uname_info.system}")
print(f"  Node Name: {uname_info.node}")
print(f"  Release: {uname_info.release}")
print(f"  Version: {uname_info.version}")
print(f"  Machine: {uname_info.machine}")
print(f"  Processor: {uname_info.processor}") # processor は uname にはないが、platform.uname()では追加されている

実行結果例 (Linux):

uname_result(system='Linux', node='my-linux-box', release='5.15.0-101-generic', version='#114-Ubuntu SMP Tue Oct 10 15:01:06 UTC 2023', machine='x86_64', processor='x86_64')
  System: Linux
  Node Name: my-linux-box
  Release: 5.15.0-101-generic
  Version: #114-Ubuntu SMP Tue Oct 10 15:01:06 UTC 2023
  Machine: x86_64
  Processor: x86_64

この名前付きタプルを使うことで、各情報に属性名でアクセスでき、コードの可読性が向上します。

特定のOSについて、さらに踏み込んだ情報を取得する関数も用意されています。ただし、これらの関数は対応するOS以外で実行すると、エラーになるか空の結果を返すため、使用前に `platform.system()` などでOSを確認するのが一般的です。

使用例 (Windowsの場合):

import platform

if platform.system() == "Windows":
    win_ver = platform.win32_ver()
    print(f"Windows Release: {win_ver.release}")
    print(f"Windows Version: {win_ver.version}")
    print(f"Service Pack: {win_ver.csd}")
    if hasattr(platform, 'win32_edition'): # Python 3.8+
      print(f"Edition: {platform.win32_edition()}")
else:
    print("Windowsではありません。")

どのPython実装が使われているかを示す文字列を返します。

import platform

impl = platform.python_implementation()
print(f"Python実装: {impl}")

実行結果例:

• CPython (標準実装): Python実装: CPython
• PyPy: Python実装: PyPy
• Jython: Python実装: Jython
• IronPython: Python実装: IronPython

実装によって利用可能な機能やパフォーマンス特性が異なる場合があるため、この情報に基づいて処理を調整することがあります。

Pythonのバージョンを取得する最も一般的な方法です。

• `platform.python_version()`: バージョンを `major.minor.patchlevel` 形式の文字列で返します。
• `platform.python_version_tuple()`: バージョンを `(‘major’, ‘minor’, ‘patchlevel’)` 形式の文字列のタプルで返します。

import platform

version_str = platform.python_version()
version_tuple = platform.python_version_tuple()

print(f"バージョン (文字列): {version_str}")
print(f"バージョン (タプル): {version_tuple}")
print(f"  メジャー: {version_tuple[0]}")
print(f"  マイナー: {version_tuple[1]}")
print(f"  パッチ: {version_tuple[2]}")

実行結果例 (Python 3.11.4):

バージョン (文字列): 3.11.4
バージョン (タプル): ('3', '11', '4')
  メジャー: 3
  マイナー: 11
  パッチ: 4

バージョン番号に基づいて条件分岐を行う場合、タプル形式の方が比較しやすいことがあります。例えば、Python 3.8以上が必要な場合などです。

import platform

if tuple(map(int, platform.python_version_tuple())) >= (3, 8, 0):
    print("Python 3.8以上です。")
else:
    print("Python 3.8未満です。")

なお、`sys` モジュールにも `sys.version` (詳細な文字列) や `sys.version_info` (名前付きタプル、要素は整数) があり、同様の目的で利用できます。どちらを使うかは好みや状況によりますが、`platform` の関数はシンプルなバージョン文字列やタプルが必要な場合に便利です。

より詳細なPythonのビルド情報を取得する関数もあります。通常、これらはデバッグや特定の環境調査で役立ちます。

import platform

print(f"コンパイラ: {platform.python_compiler()}")
print(f"ビルド情報: {platform.python_build()}")
print(f"ブランチ: {platform.python_branch()}")
print(f"リビジョン: {platform.python_revision()}")

実行環境のマシンタイプ（ハードウェアアーキテクチャ）を示す文字列を返します。

import platform

machine_type = platform.machine()
print(f"マシンタイプ: {machine_type}")

実行結果例:

• Intel/AMD 64bit CPU: マシンタイプ: x86_64 or マシンタイプ: AMD64 (Windows)
• ARM 64bit CPU (例: Apple Silicon): マシンタイプ: arm64
• Raspberry Pi (ARM 32bit): マシンタイプ: armv7l

バイナリ配布物の選択や、アーキテクチャ固有のライブラリの利用判定などに使えます。

プロセッサの（人間が判読可能な）名前を返そうと試みます。ただし、この情報は全てのプラットフォームで確実に取得できるとは限りません。取得できない場合は空文字列が返されます。

import platform

processor_info = platform.processor()
if processor_info:
    print(f"プロセッサ: {processor_info}")
else:
    print("プロセッサ情報の取得に失敗しました。")

実行結果例:

• macOS (Apple Silicon): プロセッサ: arm (あまり具体的でないことも)
• Windows (Intel): プロセッサ: Intel64 Family 6 Model 158 Stepping 10, GenuineIntel
• Linux (AMD): プロセッサ: x86_64 (マシンタイプと同じ場合も)
• 取得失敗: プロセッサ情報の取得に失敗しました。

注意: この関数の信頼性はプラットフォームに大きく依存します。CPUの詳細情報が必要な場合は、`psutil` などの外部ライブラリの利用を検討する方が確実な場合があります。

Pythonインタープリタ（または指定された実行可能ファイル）のビットアーキテクチャ（’32bit’ or ’64bit’）と、リンケージフォーマット（例: ‘ELF’, ‘PE’）をタプルで返します。

import platform

arch_info = platform.architecture()
print(f"アーキテクチャ情報: {arch_info}")
print(f"  ビット: {arch_info[0]}")
print(f"  リンケージ: {arch_info[1]}")

実行結果例:

• Linux (64bit): アーキテクチャ情報: ('64bit', 'ELF')
• Windows (64bit): アーキテクチャ情報: ('64bit', 'WindowsPE')
• macOS (Apple Silicon, 64bit): アーキテクチャ情報: ('64bit', '') (リンケージが空の場合も)

32bit環境か64bit環境かを判定するのに役立ちます。ただし、macOSのユニバーサルバイナリなど、複数のアーキテクチャを含む場合があるため、現在のインタープリタのビット数を確実に知りたい場合は `sys.maxsize > 2**32` で判定する方がより信頼できます。

コンピュータのネットワーク名（ホスト名）を返します。完全修飾ドメイン名(FQDN)ではない場合があります。

import platform

host_name = platform.node()
print(f"ホスト名: {host_name}")

実行結果例: ホスト名: my-laptop

ログ記録や分散システムでノードを識別する際に利用できます。