annoworkcli 2.2.2

No project description provided

annowork-cli

AnnoWorkのCLIです。

Requirements

• Python3.8+

Install

$ pip install annoworkcli

Usage

認証情報の設定

.netrc

$HOME/.netrcファイルに以下を記載する。

machine annowork.com
login annowork_user_id
password annowork_password

環境変数

• 環境変数ANNOWORK_USER_ID , ANNOWORK_PASSWORD

annoworkcli annofabコマンドを利用する場合

annoworkcli annofabコマンドはannofabのwebapiにアクセスするため、annofabのwebapiの認証情報を指定する必要があります。

• 環境変数ANNOFAB_USER_ID , ANNOFAB_PASSWORD
• $HOME/.netrcファイル

machine annofab.com
login annofab_user_id
password annofab_password

コマンドの使い方

vagrant@example:~$ annoworkcli -h
usage: annoworkcli [-h] [--version] {account,actual_working_time,annofab,expected_working_time,job,migration,my,organization_member,organization_tag,schedule} ...

Command Line Interface for AnnoFab

positional arguments:
  {account,actual_working_time,annofab,expected_working_time,job,migration,my,organization_member,organization_tag,schedule}
    account             ユーザアカウントに関するサブコマンド

    actual_working_time
                        実績作業時間関係のサブコマンド

    annofab             AnnoFabにアクセスするサブコマンド

    expected_working_time
                        予定稼働時間関係のサブコマンド

    job                 ジョブ関係のサブコマンド

    my                  自分自身に関するサブコマンド

    organization_member
                        組織メンバ関係のサブコマンド

    organization_tag    組織タグ関係のサブコマンド

    schedule            作業計画関係のサブコマンド

optional arguments:
  -h, --help            show this help message and exit

  --version             show program's version number and exit

$ annoworkcli organization_member list -h
usage: annoworkcli organization_member list [-h] [--endpoint_url ENDPOINT_URL | --is_development | --is_staging] -org ORGANIZATION_ID
                                            [-org_tag ORGANIZATION_TAG_ID [ORGANIZATION_TAG_ID ...]] [-o OUTPUT] [-f {csv,json}]

組織メンバの一覧を出力します。無効化されたメンバも出力します。

optional arguments:
  -h, --help            show this help message and exit

  --endpoint_url ENDPOINT_URL
                        AnnoWork WebAPIのエンドポイントを指定します。指定しない場合は'https://annowork.com'です。 (default: None)

  -org ORGANIZATION_ID, --organization_id ORGANIZATION_ID
                        対象の組織ID (default: None)

  -org_tag ORGANIZATION_TAG_ID [ORGANIZATION_TAG_ID ...], --organization_tag_id ORGANIZATION_TAG_ID [ORGANIZATION_TAG_ID ...]
                        指定した組織タグが付与された組織メンバを出力します。 (default: None)

  -o OUTPUT, --output OUTPUT
                        出力先 (default: None)

  -f {csv,json}, --format {csv,json}
                        出力先 (default: csv)

# CSV出力
$ annoworkcli organization_member list -org org -o out.csv
$ cat out.csv
organization_member_id,organization_id,account_id,user_id,username,role,status,created_datetime,updated_datetime,organization_tag_ids,organization_tag_names,inactivated_datetime
12345678-abcd-1234-abcd-1234abcd5678,org,12345678-abcd-1234-abcd-1234abcd5678,alice,Alice,manager,active,2021-11-04T04:27:57.702Z,2021-11-04T04:27:57.702Z,['company_kurusugawa'],['company:来栖川電算'],
...


# CSV出力
$ annoworkcli organization_member list -org org -o out.json -f json
$ cat out.json
[
  {
    "organization_member_id": "12345678-abcd-1234-abcd-1234abcd5678",
    "organization_id": "org",
    "account_id": "12345678-abcd-1234-abcd-1234abcd5678",
    "user_id": "alice",
    "username": "Alice",
    "role": "worker",
    "status": "active",
    "created_datetime": "2021-10-28T06:48:40.077Z",
    "updated_datetime": "2021-11-09T01:07:30.766Z",
    "inactivated_datetime": NaN,
    "organization_tag_ids": [
      "company_kurusugawa",
      "type_monitored"
    ],
    "organization_tag_names": [
      "company:来栖川電算",
      "type:monitored"
    ]
  },
  ...

開発環境に対して操作する場合

$ annoworkcli member list --output foo.csv --is_development 

VSCode Devcontainerを使って開発する方法

1. 以下の環境変数を定義します。

   • ANNOFAB_USER_ID
   • ANNOFAB_PASSWORD
   • ANNOWORK_USER_ID
   • ANNOWORK_PASSWORD

2. VSCodeのdevcontainerを起動します。