前提条件: Node.jsをインストールして、以下のコマンドでインストールしてください:
npm install -g github-csv-toolsインストール後、githubCsvTools --help で使用方法を確認するか、以下を参照してください。
エクスポート・インポートの手順:
現在、タイトル、本文、ラベル、ステータス(クローズ済み・オープン)、マイルストーンをインポートできます。入力形式の例についてはtestフォルダを参照してください。
githubCsvTools myFile.csvgithubCsvTools| オプション | デフォルト値 | 備考 |
|---|---|---|
| -f, --exportFileName | YYYY-MM-DD-hh-mm-ss-issues.csv | エクスポートするCSVファイル名 |
| -a, --exportAttributes | number, title, labels, state, assignees, milestone, comments, created_at, updated_at, closed_at, body | エクスポートする属性(列)のカンマ区切りリスト** |
| -c, --exportComments | なし | エクスポートにコメントを含める。--exportAttributesと組み合わせて使用する場合、idを含める必要があります |
| -e, --exportAll | なし | GitHub APIから取得可能なすべての値をエクスポート。含めない場合、GitHubのインポートと互換性があることが確認済みの属性のサブセット(上記の--exportAttributesを参照)がエクスポートに含まれます |
** exportAttributesの利用可能なオプションのリストには、GitHub API Exportのすべてのオプションが含まれます。子オブジェクトの値は「ドット」を使用して参照できます - たとえば、ユーザーのavatar_urlはuser.avatar_urlでアクセスできます。
すべての操作において、ツールはGitHubトークンの入力を求めます。このトークンを取得するには:
- https://github.com/settings/tokens にアクセス
- 「Generate New Token」をクリック
repoにチェックを入れる- ツールがトークンを求めた際に、提供されたトークンをコピー&ペーストする
| オプション | 備考 |
|---|---|
| -V, --version | バージョン番号を出力 |
| -g, --github_enterprise | GitHub EnterpriseのURL。https://your-internal-githubenterprise.com/api/v3 (注意:末尾の /api/v3を忘れないでください) |
| -t, --token | GitHubトークン。https://github.com/settings/tokens |
| -o, --organization | リポジトリが存在するユーザーまたは組織のスラッグ。 例: /myOrg/my-repoの場合、この値はmyOrgになります |
| -r, --repository | リポジトリ名(スラッグ) 例: /myOrg/my-repoの場合、この値はmy-repoになります |
| --csvDelimiter | CSV区切り文字(デフォルトは',') |
| -v, --verbose | 追加のログ情報を含める |
| -h, --help | すべてのオプションとヘルプを表示 |
- リポジトリをクローンする
- リポジトリディレクトリに移動し、
npm install -gを実行する
CHANGELOG.mdを参照
このソフトウェアはrepoio.comでダウンロード・インストール不要で使用できます。
