pip を使用して Axe DevTools Python をインストールする

Deque の Agora アーティファクトリポジトリを通じて Axe DevTools Python にアクセスし、インストールします

Axe DevTools をダウンロードするには、開発運用部門が提供するレジストリのアクセス手順に従う必要があります。これらの手順は、この例とは異なる場合があります。このガイドでは、Deque の Agora Artifactory インスタンスから直接インストールする方法を示しており、そのためには Agora の認証情報が必要です。このpip.conf例ファイルは、Deque の Agora から Axe DevTools をダウンロードするための依存関係を設定する手順を案内します。

Axe DevTools Python パッケージをインストールする前に、pipを設定して Deque の Agora からパッケージを検索する必要があります。そのためには、特定の場所に設定ファイルを配置する必要があります。

Unix と macOS では、設定ファイルは~/.pip/pip.confに配置されています。Windows では、設定ファイルは~\pip\pip.iniに配置されています。

設定ファイルの内容は以下のようにしてください:

[global]
extra-index-url = https://<USERNAME>:<IDENTITY_TOKEN>@agora.dequecloud.com/artifactory/api/pypi/devtools-python/simple

ここで、<USERNAME>と<IDENTITY_TOKEN>はあなたの Agora 認証情報に置き換えられます。ユーザー名は、Agora にログインに使用するメールアドレスになります。アイデンティティトークンは、Agora にログインし、右上隅のウェルカムバナーをクリックし、プロフィールページからアイデンティティトークンを生成をクリックすることで生成できます。アイデンティティトークンを作成し、クリップボードにコピーする手順に従ってください。Agora のログイン認証情報がない場合は、Deque の担当者にお問い合わせください。また、ユーザー名とアイデンティティトークンは URL に挿入されるので、特殊文字は URL エンコードする必要があることも忘れないでください（例：‘@‘は‘%40‘に置き換えます）。

これで Axe DevTools Python パッケージをインストールできます。requirements.txt内にリストするか、setup.pyのinstall_requires内でリストするか、あるいは単純なpip installを使うか、どのように依存関係をインストールするにしても、パッケージを取得できるはずです。

例えば、Axe DevTools API パッケージをインストールするには、次のコマンドを使用します:

pip install axe-devtools-api

あなたの使用に応じて、他の Axe DevTools Python パッケージが必要になる場合があります。Axe DevTools RobotとBehaveの場合は、pip install axe-devtools-robotやpip install axe-devtools-behaveするだけで済みますが、Axe DevTools unittestの場合は、別々にpip install axe-devtools-unittestとpip install axe-devtools-apiする必要があります。Axe DevTools Python と他の自動テストフレームワークを使用するには、API および Selenium パッケージが必要です。

次のステップ

パッケージが正しくインストールされたことを確認するには、pythonインタープリターを開いて次の操作を行います:

$ python
Python 3.6.9 (default, Jul 17 2020, 12:50:27)
[GCC 8.4.0] on linux
Type "help", "copyright", "credits" or "license" for more information.
>>> import axe_devtools_api
>>> print(dir(axe_devtools_api))
['Axe', 'ReportConfiguration', '__builtins__', '__cached__', '__doc__', '__file__', '__loader__', '__name__', '__package__', '__path__', '__spec__', 'axe', 'report_configuration']

ここで、axe_devtools_apiはインストールするパッケージに置き換えます。

詳細なドキュメントについては、パッケージ固有のページを参照してください。