インストール#

前提条件#

  • xlwings (Open Source) は Excelのインストール を前提としているため、 WindowsmacOS でしか動作しません。また、macOSでは現時点ではUDFをサポートしていません。

  • xlwings PRO offers additional features:
    • File Reader (new in v0.28.0): Linux上でも動作し、Excelのインストールは不要です。

    • xlwings Server (new in v0.26.0): Linux上でも動作し、Python のローカル インストールは必要ありません。WindowsとmacOSのデスクトップExcelだけではなく、Web上のExcel、Google Sheetsでも動作します。

  • xlwings requires at least Python 3.8.

古いバージョンのPythonをサポートするxlwingsのバージョンは次のとおり:

  • Python 3.7: 0.30.9

  • Python 3.6: 0.25.3

  • Python 3.5: 0.19.5

  • Python 2.7: 0.16.6

xlwings Python package#

xlwingsは以下のディストリビューションに含まれます

  • Anaconda (Windows and macOS)

  • WinPython (Windowsのみ) Pythonしか含まれない dot バージョンを 使用しない こと

Pythonを初めて使う場合や、xlwingsのインストールでトラブルが起きる場合には、上記いずれかのディストリビューションの利用を強く推奨します。それ以外には、pipを使ってインストールすることもできます:

pip install xlwings

もしくはcondaで:

conda install xlwings

公式のcondaからインストールしたパッケージは少し前にリリースされたバージョンの場合があります。その場合、 conda-forge チャネルを使いましょう(xlwingsがインストール済みなら installupgrade に置き換えて下さい):

conda install -c conda-forge xlwings

xlwings Excel Add-in#

アドインをインストールするには、以下のコマンドを実行します:

xlwings addin install

PythonでExcelの自動化を行う場合はアドインは不要です。また、アドインの代わりに単独のVBAモジュール(スタンドアローンのワークブック)を使うこともできます。詳細は アドインおよび設定 をご覧ください。

注釈

アドインはPythonのパッケージと同じバージョンでなければなりません。xlwingsのパッケージをアップデートした際は、再度 xlwings add install を実行してください。

注釈

macOSで、かつ、アドインの代わりにVBAスタンドアローン モジュールを使っている場合、 $ xlwings runpython install を一度実行する必要があります。

依存関係#

Excelの自動化には、以下の依存関係

  • Windows: pywin32

  • Mac: psutil, appscript

condapip でxlwingsをインストールすれば、依存パッケージも自動的にインストールされます。依存パッケージなしでxlwingsのみをインストールするには、pip install xlwings --no-deps を実行します。

How to activate xlwings PRO#

xlwings PRO を参照してください。

必須ではない依存関係#

  • NumPy

  • pandas

  • Matplotlib

  • Pillow

  • Jinja2 (for xlwings.reports)

これらのパッケージは必須ではありませんが、xlwingsと強力に連携することからインストールを強く推奨します。これらは全てAnacondaに初めからインストールされています。pipの場合、これらを含めてxlwingsをインストールするには、次のようにします:

pip install "xlwings[all]"

アップデート#

xlwingsを最新バージョンにアップデートするには、コマンド プロンプトで以下を実行します:

pip install --upgrade xlwings

もしくは:

conda update -c conda-forge xlwings

ExcelアドインのバージョンはPythonパッケージのバージョンと同期させてください。同期するには、Excelを閉じた上で以下を実行します:

xlwings addin install

アンインストール#

xlwingsをアンインストールするには、初めにアドインをアンインストールしてください。次に、インストールと同じ方法(pipまたはconda)で、xlwingsパッケージをアンインストールしてください。

xlwings addin remove

続いて

pip uninstall xlwings

もしくは:

conda remove xlwings

最後に .xlwings ディレクトリーがホーム フォルダーにあれば、それも削除します。