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

非マルチプラットフォームなPythonの使い方 for Windows

    私が普段利用しているOSはWindows 11です。

    プログラミング言語については、用途や実行環境によって、次のように使い分けています。

    • C#:Windows向けのデスクトップアプリやコンソールアプリを作成する(.exe)

    • PowerShell:Windows固有の機能を利用するシェルスクリプトを作成する(.ps1)

    • Python:OSに依存しない処理や、Linux環境で動かすスクリプトを作成する(.py)

    • JavaScript:Webなどのマルチプラットフォーム環境向け。ただし、Web系はほとんど扱わないので、普段は使わない(.js)

    Windows 11には、WSL2(Windows Subsystem for Linux 2)という素敵な機能があります。

    私もWSL2にUbuntuを導入しており、そちらではもっぱらPythonを利用しています。

    このように、Windows固有の処理にはC#やPowerShell、マルチプラットフォームを意識した処理やLinux環境ではPythonという使い分けをしています。

    ただ、この使い分けで少々迷うのがPythonです。

    Pythonはマルチプラットフォーム対応のプログラミング言語ですが、Windows固有の機能を利用することもできます。

    例えば、.NET、COM、Win32 APIなどもPythonから呼び出せるようです。

    個人的には、Windows固有の処理ならC#やPowerShellを利用したいところですが、Pythonからどのように扱うのか、使い方くらいは知っておきたいと思います。

    そこで、PythonからWindows固有の機能を利用する方法について、調べてみました。

    1. Pythonから.NETを利用する

    まず気になったのが.NETです。

    普段C#を使っているので、Pythonから.NETのクラスライブラリを利用できれば、Windows向けのプログラムを書く場合にも便利そうです。

    調べてみると、pythonnetというライブラリがありました。

    インストールはpipで行えます。

    python -m pip install pythonnet

    使い方も、それほど難しくなさそうです。

    Windows Formsのメッセージボックスを表示する

    例えば、Windows Formsのメッセージボックスを表示するコードは、次のように書けます。

    import clr
    
    clr.AddReference("System.Windows.Forms")
    
    from System.Windows.Forms import MessageBox
    
    MessageBox.Show(
        "Hello from Python!",
        "Python + .NET"
    )

    clr.AddReference()で.NETのアセンブリを読み込み、その中のクラスをPythonから利用します。

    C#で使い慣れたクラスライブラリをPythonから呼び出せるわけです。

    .NETのクラスライブラリを利用する

    Windows Forms以外にも、.NETには豊富なクラスライブラリがあります。

    例えば、Environmentクラスを使えば、特殊フォルダーのパスを取得できます。

    import clr
    
    from System import Environment
    
    desktop = Environment.GetFolderPath(
        Environment.SpecialFolder.Desktop
    )
    
    print(desktop)

    Pythonの標準ライブラリにも同じような機能はありますが、.NETのクラスライブラリをそのまま利用できるのは魅力です。

    .NET Frameworkと.NET 10

    ただし、少々気になる点もあります。

    Windows上でpythonnetを標準設定のまま利用すると、基本的には従来の.NET Frameworkが使用されます。

    .NET 8や.NET 10などのランタイムを利用する場合には、CoreCLRを指定する必要があります。

    from pythonnet import load
    
    load("coreclr")
    
    import clr

    CoreCLRの指定は、clrをインポートする前に行います。

    もちろん、対応する.NETランタイムの導入や、利用するアセンブリに応じた設定が必要になる場合もあります。

    新しい.NETのWindows FormsやWPFをPythonから利用する方法についても、調べてみる価値がありそうです。

    参考:Python.NET公式ドキュメント

    2. PythonからCOMを利用する

    次に調べたのがCOM(Component Object Model)です。

    Windowsには、COMを通じてさまざまな機能やアプリケーションを操作する仕組みがあります。

    代表的なのがMicrosoft Officeの自動操作です。

    Pythonでは、pywin32というライブラリを利用することでCOMオブジェクトを扱えます。

    python -m pip install pywin32

    WindowsのCOMオブジェクトを利用する

    例えば、Windows Script HostのCOMオブジェクトを取得するには、次のように書きます。

    from win32com.client import Dispatch
    
    shell = Dispatch("WScript.Shell")
    
    desktop = shell.SpecialFolders("Desktop")
    
    print(desktop)

    このコードでは、Windows Script Hostが提供するWScript.Shellを利用して、デスクトップフォルダーのパスを取得します。

    COMオブジェクトを取得してしまえば、そのメソッドやプロパティをPythonから利用できるようです。

    ほかにも、Windowsのショートカットファイルを作成するなど、いろいろな用途が考えられます。

    Microsoft Excelを操作する

    COMの代表的な用途といえば、Microsoft Officeの操作です。

    例えば、Excelを起動して、新しいブックを作成するコードは次のようになります。

    from win32com.client import Dispatch
    
    excel = Dispatch("Excel.Application")
    
    excel.Visible = True
    
    book = excel.Workbooks.Add()
    sheet = book.Worksheets(1)
    
    sheet.Cells(1, 1).Value = "Hello from Python!"

    Microsoft Excelがインストールされ、COM経由で利用できる環境が必要です。

    Pythonにはopenpyxlなど、Excelファイルを直接操作するライブラリもあります。

    一方、COMを利用するとExcelアプリケーションそのものを操作できます。

    COMが使えるなら、Wordやその他のCOM対応アプリケーションも操作できそうです。

    既存のWindowsアプリケーションと連携できるというのは、なかなか便利そうです。

    参考:pywin32

    3. PythonからWin32 APIを利用する

    Windowsの機能を直接利用する方法として、Win32 APIも気になります。

    Pythonには、ctypesという標準ライブラリがあります。

    これはDLLに含まれる関数を呼び出すための仕組みです。

    つまり、WindowsのDLLに含まれるAPIも呼び出せます。

    ctypesでWin32 APIを呼び出す

    例えば、User32.dllのGetCursorPos()を利用すれば、マウスカーソルの位置を取得できます。

    import ctypes
    from ctypes import wintypes
    
    # POINT構造体
    class POINT(ctypes.Structure):
        _fields_ = [
            ("x", wintypes.LONG),
            ("y", wintypes.LONG)
        ]
    
    # DLLを読み込む
    user32 = ctypes.WinDLL(
        "user32",
        use_last_error=True
    )
    
    # 関数の型を定義
    get_cursor_pos = user32.GetCursorPos
    
    get_cursor_pos.argtypes = [
        ctypes.POINTER(POINT)
    ]
    
    get_cursor_pos.restype = wintypes.BOOL
    
    # カーソル位置を取得
    point = POINT()
    
    if get_cursor_pos(ctypes.byref(point)):
        print(point.x, point.y)
    else:
        raise ctypes.WinError(
            ctypes.get_last_error()
        )

    C言語でWin32 APIを利用した経験があれば、見覚えのある構造です。

    構造体を定義し、関数の引数と戻り値の型を指定して呼び出します。

    ctypesはPythonの標準ライブラリなので、追加インストールは必要ありません。

    ただし、C言語の関数を直接呼び出すため、型や構造体の定義には注意が必要です。

    pywin32でもWin32 APIを利用できる

    先ほどのpywin32には、Win32 APIをPythonから使いやすくするためのモジュールも含まれています。

    例えば、同じマウスカーソルの座標取得なら、次のように書けます。

    import win32api
    
    x, y = win32api.GetCursorPos()
    
    print(x, y)

    ずいぶん簡単になりました。

    対応しているAPIであれば、pywin32を利用する方が手軽そうです。

    一方、pywin32が対応していないDLLの関数を呼び出したい場合には、ctypesが選択肢になります。

    Windowsの機能を利用する方法として、この二つは覚えておく価値がありそうです。

    参考:ctypes公式ドキュメント

    4. Pythonの標準ライブラリにもWindows専用の機能がある

    外部ライブラリを調べていましたが、Pythonの標準ライブラリにもWindows専用の機能が用意されています。

    例えば、winregです。

    これはWindowsレジストリを操作するためのモジュールです。

    Windowsレジストリを読み取る

    例えば、エクスプローラーの設定を読み取ってみます。

    import winreg
    
    path = (
        r"Software\Microsoft\Windows"
        r"\CurrentVersion\Explorer\Advanced"
    )
    
    with winreg.OpenKey(
        winreg.HKEY_CURRENT_USER,
        path
    ) as key:
    
        value, _ = winreg.QueryValueEx(
            key,
            "HideFileExt"
        )
    
    print("拡張子を隠す:", bool(value))

    HideFileExtは、エクスプローラーでファイル名の拡張子を非表示にするかどうかを表す設定値です。

    値が存在する環境では、レジストリから設定を読み取れます。

    このように、Pythonの標準ライブラリだけでWindowsレジストリを操作できます。

    ファイルの関連付けを利用する

    os.startfile()という関数もあります。

    import os
    
    os.startfile("sample.txt")

    Windowsでsample.txtが存在し、関連付けが設定されていれば、対応するアプリケーションで開かれます。

    Windowsのエクスプローラーでファイルをダブルクリックする操作に近いものです。

    os自体はマルチプラットフォームなライブラリですが、os.startfile()はWindows専用の機能です。

    このように、Pythonの標準ライブラリにもOS固有の機能が含まれています。

    5. PythonをWindows専用の言語として使うこともできる

    調べてみると、PythonからWindows固有の機能を利用する方法は、思っていた以上に豊富でした。

    今回調べた範囲だけでも、次のような選択肢があります。

    • pythonnet:.NETのクラスライブラリを利用する

    • pywin32:COMやWin32 APIなどを利用する

    • ctypes:DLLの関数を直接呼び出す

    • winreg:Windowsレジストリにアクセスする

    • os:Windows固有のファイル操作などを行う

    これらを組み合わせれば、PythonだけでWindows向けのプログラムを作成することも十分可能そうです。

    さらに、GUIライブラリを利用してデスクトップアプリを作成したり、PyInstallerなどを利用して実行ファイルにまとめたりする方法もあります。

    考えてみれば、Pythonで個人のプログラミング案件をすべてこなすこともできそうです。

    ただ、個人的には、Windows固有の機能を積極的に利用するのであれば、最初からC#やPowerShellを選びたいところです。

    .NETを使うならC#、Windowsの管理作業ならPowerShellという、使い慣れた環境があります。

    また、プログラミング言語には、機能や性能以外にも好みの問題があります。

    言語としての構文が自分の好みに合うかどうかも、重要な選択基準です。

    私の場合、WindowsではC#やPowerShell、WSL2のUbuntuではPythonという使い分けが、今のところ気に入っています。

    とはいえ、Pythonで作成しているスクリプトから、一部分だけWindowsの機能を利用したくなることはありそうです。

    そうした場合に、今回調べた知識が役に立つのでしょう。

    最後に

    今回調べた内容は、なかなか面白そうです。

    特に興味があるのは、Pythonから.NETのクラスライブラリを利用する方法です。

    C#で使い慣れたクラスがPythonからどの程度自然に扱えるのか、気になるところです。

    COMも面白そうです。Windowsのショートカットを作成したり、既存のアプリケーションを操作したりと、いろいろなことができそうです。

    Win32 APIについても、ctypesを使えばDLLの関数を直接呼び出せますし、pywin32なら簡潔に書ける場合もあります。

    調べただけでも、Windows上でPythonができることの多さが見えてきました。

    せっかくですから、今回調べたコードを実際に動かして、どこまで利用できるのか確かめてみたいと思います。

    特に.NET 10と組み合わせた場合の使い勝手には興味があります。

    ライブラリを導入して簡単に呼び出せるものもあれば、環境設定や型の扱いで苦労するものもあるかもしれません。

    実際に試してみれば、PythonでWindows固有の機能を利用する場合の利点や問題点も、もう少し具体的に見えてくるでしょう。

    普段の言語の使い分けを変えるつもりはありませんが、Pythonからこれだけの機能を利用できるとなると、いろいろ試してみたくなります。

    Windows専用のPythonというのも、なかなか奥が深そうです。


    あなたへのおすすめ