インストール#
前提条件#
xlwings (Open Source) は Excelのインストール を前提としているため、 Windows と macOS でしか動作しません。また、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は以下のディストリビューションに含まれます
Pythonを初めて使う場合や、xlwingsのインストールでトラブルが起きる場合には、上記いずれかのディストリビューションの利用を強く推奨します。それ以外には、pipを使ってインストールすることもできます:
pip install xlwings
もしくはcondaで:
conda install xlwings
公式のcondaからインストールしたパッケージは少し前にリリースされたバージョンの場合があります。その場合、 conda-forge
チャネルを使いましょう(xlwingsがインストール済みなら install
を upgrade
に置き換えて下さい):
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
conda
か pip
で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
ディレクトリーがホーム フォルダーにあれば、それも削除します。