No project description provided
Project description
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を使って開発する方法
-
以下の環境変数を定義します。
ANNOFAB_USER_ID
ANNOFAB_PASSWORD
ANNOWORK_USER_ID
ANNOWORK_PASSWORD
-
VSCodeのdevcontainerを起動します。
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
annoworkcli-2.4.2.tar.gz
(53.4 kB
view hashes)
Built Distribution
Close
Hashes for annoworkcli-2.4.2-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 9abd790e65a6d48d6872a4a0e5d773cfb684b0ddddb6b53e926b84882682095c |
|
MD5 | 06f2f743bc38c6bbd280845e31c1b7e5 |
|
BLAKE2b-256 | 72dba32f7753424e9ade31cd549fc824b7c4fc8d5f8e04f291c505f10e2859ab |