backlog-exporter 0.6.0 → 0.7.0

package/README.md

@@ -15,12 +15,17 @@ Backlog のデータをエクスポートするためのコマンドラインツ
 * [Wikiのエクスポート](#wikiのエクスポート)
 * [ドキュメントのエクスポート](#ドキュメントのエクスポート)
 * [課題・Wiki・ドキュメントの一括エクスポート](#課題wikiドキュメントの一括エクスポート)
+* [特定のデータタイプのみをエクスポート（onlyフラグ）](#特定のデータタイプのみをエクスポートonlyフラグ)
+* [特定のデータタイプを除外してエクスポート（excludeフラグ）](#特定のデータタイプを除外してエクスポートexcludeフラグ)
 * [データの更新](#データの更新)
 * [npxを使った課題のエクスポート](#npxを使った課題のエクスポート)
 * [npxを使ったデータの更新](#npxを使ったデータの更新)
 * [課題のエクスポート](#課題のエクスポート)
 * [基本的な使用方法](#基本的な使用方法)
 * [出力先を指定](#出力先を指定)
+* [Markdownファイル名を課題キーにする](#markdownファイル名を課題キーにする)
+* [課題キーでフォルダを作成する](#課題キーでフォルダを作成する)
+* [課題キーでフォルダを作成し、Markdownファイル名も課題キーにする](#課題キーでフォルダを作成しmarkdownファイル名も課題キーにする)
 * [Wiki のエクスポート](#wiki-のエクスポート)
 * [基本的な使用方法](#基本的な使用方法)
 * [出力先を指定](#出力先を指定)
@@ -31,6 +36,12 @@ Backlog のデータをエクスポートするためのコマンドラインツ
 * [課題・Wiki・ドキュメント の一括エクスポート](#課題wikiドキュメント-の一括エクスポート)
 * [基本的な使用方法](#基本的な使用方法)
 * [出力先を指定](#出力先を指定)
+* [特定のデータタイプのみをエクスポート（onlyフラグ）](#特定のデータタイプのみをエクスポートonlyフラグ)
+* [特定のデータタイプを除外してエクスポート（excludeフラグ）](#特定のデータタイプを除外してエクスポートexcludeフラグ)
+* [課題とWikiのみをエクスポート](#課題とwikiのみをエクスポート)
+* [ドキュメントのみをエクスポート](#ドキュメントのみをエクスポート)
+* [ドキュメント以外（課題とWiki）をエクスポート](#ドキュメント以外課題とwikiをエクスポート)
+* [課題以外（WikiとDocuments）をエクスポート](#課題以外wikiとdocumentsをエクスポート)
 * [データの更新](#データの更新)
 * [カレントディレクトリとそのサブディレクトリのデータを更新](#カレントディレクトリとそのサブディレクトリのデータを更新)
 * [指定したディレクトリとそのサブディレクトリのデータを更新](#指定したディレクトリとそのサブディレクトリのデータを更新)
@@ -66,7 +77,7 @@ $ npm install -g backlog-exporter
 $ backlog-exporter COMMAND
 running command...
 $ backlog-exporter (--version)
-backlog-exporter/0.6.0 linux-x64 node-v24.2.0
+backlog-exporter/0.7.0 linux-x64 node-v24.4.1
 $ backlog-exporter --help [COMMAND]
 USAGE
   $ backlog-exporter COMMAND
@@ -99,6 +110,12 @@ $ backlog-exporter document --domain example.backlog.jp --projectIdOrKey PROJECT
 # 課題・Wiki・ドキュメントの一括エクスポート
 $ backlog-exporter all --domain example.backlog.jp --projectIdOrKey PROJECT_KEY --apiKey YOUR_API_KEY --output ./backlog-data
 
+# 特定のデータタイプのみをエクスポート（onlyフラグ）
+$ backlog-exporter all --domain example.backlog.jp --projectIdOrKey PROJECT_KEY --apiKey YOUR_API_KEY --only issues,wiki
+
+# 特定のデータタイプを除外してエクスポート（excludeフラグ）
+$ backlog-exporter all --domain example.backlog.jp --projectIdOrKey PROJECT_KEY --apiKey YOUR_API_KEY --exclude documents
+
 # データの更新
 $ backlog-exporter update
 ```
@@ -123,6 +140,15 @@ $ backlog-exporter issue --domain example.backlog.jp --projectIdOrKey PROJECT_KE
 
 # 出力先を指定
 $ backlog-exporter issue --domain example.backlog.jp --projectIdOrKey PROJECT_KEY --apiKey YOUR_API_KEY --output ./issues
+
+# Markdownファイル名を課題キーにする
+$ backlog-exporter issue --domain example.backlog.jp --projectIdOrKey PROJECT_KEY --apiKey YOUR_API_KEY --issueKeyFileName
+
+# 課題キーでフォルダを作成する
+$ backlog-exporter issue --domain example.backlog.jp --projectIdOrKey PROJECT_KEY --apiKey YOUR_API_KEY --issueKeyFolder
+
+# 課題キーでフォルダを作成し、Markdownファイル名も課題キーにする
+$ backlog-exporter issue --domain example.backlog.jp --projectIdOrKey PROJECT_KEY --apiKey YOUR_API_KEY --issueKeyFileName --issueKeyFolder
 ```
 
 エクスポートされた課題は、指定したディレクトリ内に Markdown ファイルとして保存されます。ファイル名は課題のキーに基づいて自動的に生成されます。
@@ -132,21 +158,23 @@ $ backlog-exporter issue --domain example.backlog.jp --projectIdOrKey PROJECT_KE
 課題のエクスポートでは、Backlogのカスタム属性も含めて出力されます：
 
 ### 対応している値の型
+
 - **プリミティブ値**: 文字列、数値などの単純な値
 - **配列値**: 複数選択のカスタム属性（カンマ区切りで表示）
 - **オブジェクト値**: 単一選択のカスタム属性（name または value プロパティを使用）
 
 ### 表示形式
+
 カスタム属性はMarkdownテーブル形式で表示され、改行やパイプ文字も適切に処理されます：
 
 ```markdown
 ## カスタム属性
 
-| 属性名 | 値 |
-|--------|----| 
-| 工数（エンジニア） | 3 |
-| 担当チーム | フロントエンド, バックエンド |
-| 詳細 | 実装内容<br>- 機能A<br>- 機能B |
+| 属性名             | 値                             |
+| ------------------ | ------------------------------ |
+| 工数（エンジニア） | 3                              |
+| 担当チーム         | フロントエンド, バックエンド   |
+| 詳細               | 実装内容<br>- 機能A<br>- 機能B |
 ```
 
 # Wiki のエクスポート
@@ -183,10 +211,12 @@ $ backlog-exporter document --domain example.backlog.jp --projectIdOrKey PROJECT
 ドキュメントは **ツリー構造を保持** してエクスポートされます：
 
 ### ディレクトリ構造の保持
+
 - Backlogのドキュメントツリーの階層構造がそのままローカルディレクトリ構造として再現されます
 - フォルダはディレクトリとして作成され、ドキュメントはMarkdownファイルとして保存されます
 
 ### 出力例
+
 ```
 documents/
 ├── プロジェクト概要/
@@ -203,6 +233,7 @@ documents/
 ```
 
 ### 特徴
+
 - **階層構造の完全再現**: Backlogのフォルダ階層がそのまま保持されます
 - **重複処理の防止**: 同じドキュメントが複数回処理されることを防ぎます
 - **ファイル名の自動サニタイズ**: 不正な文字を自動的に除去して安全なファイル名を生成します
@@ -220,10 +251,46 @@ $ backlog-exporter all --domain example.backlog.jp --projectIdOrKey PROJECT_KEY
 
 # 出力先を指定
 $ backlog-exporter all --domain example.backlog.jp --projectIdOrKey PROJECT_KEY --apiKey YOUR_API_KEY --output ./backlog-data
+
+# 特定のデータタイプのみをエクスポート（onlyフラグ）
+$ backlog-exporter all --domain example.backlog.jp --projectIdOrKey PROJECT_KEY --apiKey YOUR_API_KEY --only issues,wiki
+
+# 特定のデータタイプを除外してエクスポート（excludeフラグ）
+$ backlog-exporter all --domain example.backlog.jp --projectIdOrKey PROJECT_KEY --apiKey YOUR_API_KEY --exclude documents
 ```
 
 一括エクスポートでは、課題は`issues`ディレクトリに、Wiki は`wiki`ディレクトリに、ドキュメントは`documents`ディレクトリに保存されます。
 
+## エクスポート対象の制御
+
+`all`コマンドでは、以下のフラグを使用してエクスポート対象を制御できます：
+
+### --only フラグ
+
+特定のデータタイプのみをエクスポートします。カンマ区切りで複数指定可能です。
+
+```sh
+# 課題とWikiのみをエクスポート
+$ backlog-exporter all --domain example.backlog.jp --projectIdOrKey PROJECT_KEY --only issues,wiki
+
+# ドキュメントのみをエクスポート
+$ backlog-exporter all --domain example.backlog.jp --projectIdOrKey PROJECT_KEY --only documents
+```
+
+### --exclude フラグ
+
+特定のデータタイプを除外してエクスポートします。カンマ区切りで複数指定可能です。
+
+```sh
+# ドキュメント以外（課題とWiki）をエクスポート
+$ backlog-exporter all --domain example.backlog.jp --projectIdOrKey PROJECT_KEY --exclude documents
+
+# 課題以外（WikiとDocuments）をエクスポート
+$ backlog-exporter all --domain example.backlog.jp --projectIdOrKey PROJECT_KEY --exclude issues
+```
+
+**注意**: `--only`と`--exclude`フラグは同時に使用できません。どちらか一方を使用してください。
+
 # データの更新
 
 `update`コマンドを使用すると、既存のエクスポートデータを最新の状態に更新できます。このコマンドは、ディレクトリ内の`backlog-settings.json`ファイルを探索し、見つかったディレクトリでデータを更新します。
@@ -256,10 +323,7 @@ $ backlog-exporter update --apiKey YOUR_API_KEY
 # コマンド
 
 <!-- commands -->
-* [`backlog-exporter all`](#backlog-exporter-all)
-* [`backlog-exporter document`](#backlog-exporter-document)
 * [`backlog-exporter help [COMMAND]`](#backlog-exporter-help-command)
-* [`backlog-exporter issue`](#backlog-exporter-issue)
 * [`backlog-exporter plugins`](#backlog-exporter-plugins)
 * [`backlog-exporter plugins add PLUGIN`](#backlog-exporter-plugins-add-plugin)
 * [`backlog-exporter plugins:inspect PLUGIN...`](#backlog-exporter-pluginsinspect-plugin)
@@ -270,72 +334,6 @@ $ backlog-exporter update --apiKey YOUR_API_KEY
 * [`backlog-exporter plugins uninstall [PLUGIN]`](#backlog-exporter-plugins-uninstall-plugin)
 * [`backlog-exporter plugins unlink [PLUGIN]`](#backlog-exporter-plugins-unlink-plugin)
 * [`backlog-exporter plugins update`](#backlog-exporter-plugins-update)
-* [`backlog-exporter update [DIRECTORY]`](#backlog-exporter-update-directory)
-* [`backlog-exporter wiki`](#backlog-exporter-wiki)
-
-## `backlog-exporter all`
-
-Backlogから課題・Wiki・ドキュメントを取得してMarkdownファイルとして保存する
-
-```
-USAGE
-  $ backlog-exporter all --domain <value> --projectIdOrKey <value> [--apiKey <value>] [-m <value>] [-o
-    <value>]
-
-FLAGS
-  -m, --maxCount=<value>        [default: 5000] 一度に取得する課題の最大数（デフォルト: 5000）
-  -o, --output=<value>          出力ディレクトリパス
-      --apiKey=<value>          Backlog API key (環境変数 BACKLOG_API_KEY からも自動読み取り可能)
-      --domain=<value>          (required) Backlog domain (e.g. example.backlog.jp)
-      --projectIdOrKey=<value>  (required) Backlog project ID or key
-
-DESCRIPTION
-  Backlogから課題・Wiki・ドキュメントを取得してMarkdownファイルとして保存する
-
-EXAMPLES
-  $ backlog-exporter all --domain example.backlog.jp --projectIdOrKey PROJECT_KEY --apiKey YOUR_API_KEY
-  課題・Wiki・ドキュメントをMarkdownファイルとして保存する
-
-  $ backlog-exporter all --domain example.backlog.jp --projectIdOrKey PROJECT_KEY --apiKey YOUR_API_KEY --output ./my-project
-  指定したディレクトリに課題・Wiki・ドキュメントを保存する
-
-  $ backlog-exporter all --domain example.backlog.jp --projectIdOrKey PROJECT_KEY --apiKey YOUR_API_KEY --maxCount 1000
-  最大1000件の課題を取得する（デフォルトは5000件）
-```
-
-_See code: [src/commands/all/index.ts](https://github.com/ShuntaToda/backlog-exporter/blob/v0.6.0/src/commands/all/index.ts)_
-
-## `backlog-exporter document`
-
-Backlogからドキュメントを取得してMarkdownファイルとして保存する
-
-```
-USAGE
-  $ backlog-exporter document --domain <value> --projectIdOrKey <value> [--apiKey <value>] [--keyword <value>]
-    [-o <value>]
-
-FLAGS
-  -o, --output=<value>          出力ディレクトリパス
-      --apiKey=<value>          Backlog API key (環境変数 BACKLOG_API_KEY からも自動読み取り可能)
-      --domain=<value>          (required) Backlog domain (e.g. example.backlog.jp)
-      --keyword=<value>         検索キーワード
-      --projectIdOrKey=<value>  (required) Backlog project ID or key
-
-DESCRIPTION
-  Backlogからドキュメントを取得してMarkdownファイルとして保存する
-
-EXAMPLES
-  $ backlog-exporter document --domain example.backlog.jp --projectIdOrKey PROJECT_KEY --apiKey YOUR_API_KEY
-  ドキュメントをMarkdownファイルとして保存する
-
-  $ backlog-exporter document --domain example.backlog.jp --projectIdOrKey PROJECT_KEY --apiKey YOUR_API_KEY --output ./my-documents
-  指定したディレクトリにドキュメントを保存する
-
-  $ backlog-exporter document --domain example.backlog.jp --projectIdOrKey PROJECT_KEY --apiKey YOUR_API_KEY --keyword 仕様書
-  キーワード「仕様書」を含むドキュメントのみを取得する
-```
-
-_See code: [src/commands/document/index.ts](https://github.com/ShuntaToda/backlog-exporter/blob/v0.6.0/src/commands/document/index.ts)_
 
 ## `backlog-exporter help [COMMAND]`
 
@@ -357,42 +355,6 @@ DESCRIPTION
 
 _See code: [@oclif/plugin-help](https://github.com/oclif/plugin-help/blob/v6.2.26/src/commands/help.ts)_
 
-## `backlog-exporter issue`
-
-Backlogから課題を取得してMarkdownファイルとして保存する
-
-```
-USAGE
-  $ backlog-exporter issue --domain <value> --projectIdOrKey <value> [--apiKey <value>] [-m <value>] [-o
-    <value>] [--statusId <value>]
-
-FLAGS
-  -m, --maxCount=<value>        [default: 5000] 一度に取得する課題の最大数（デフォルト: 5000）
-  -o, --output=<value>          出力ディレクトリパス
-      --apiKey=<value>          Backlog API key (環境変数 BACKLOG_API_KEY からも自動読み取り可能)
-      --domain=<value>          (required) Backlog domain (e.g. example.backlog.jp)
-      --projectIdOrKey=<value>  (required) Backlog project ID or key
-      --statusId=<value>        ステータスID（カンマ区切りで複数指定可能）
-
-DESCRIPTION
-  Backlogから課題を取得してMarkdownファイルとして保存する
-
-EXAMPLES
-  $ backlog-exporter issue --domain example.backlog.jp --projectIdOrKey PROJECT_KEY --apiKey YOUR_API_KEY
-  課題をMarkdownファイルとして保存する
-
-  $ backlog-exporter issue --domain example.backlog.jp --projectIdOrKey PROJECT_KEY --apiKey YOUR_API_KEY --output ./my-issues
-  指定したディレクトリに課題を保存する
-
-  $ backlog-exporter issue --domain example.backlog.jp --projectIdOrKey PROJECT_KEY --apiKey YOUR_API_KEY --statusId 1,2,3
-  指定したステータスIDの課題のみを取得する
-
-  $ backlog-exporter issue --domain example.backlog.jp --projectIdOrKey PROJECT_KEY --apiKey YOUR_API_KEY --maxCount 10000
-  最大10000件の課題を取得する（デフォルトは5000件）
-```
-
-_See code: [src/commands/issue/index.ts](https://github.com/ShuntaToda/backlog-exporter/blob/v0.6.0/src/commands/issue/index.ts)_
-
 ## `backlog-exporter plugins`
 
 List installed plugins.
@@ -682,73 +644,6 @@ DESCRIPTION
 ```
 
 _See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/v5.4.34/src/commands/plugins/update.ts)_
-
-## `backlog-exporter update [DIRECTORY]`
-
-Backlogから最新データを取得して更新する
-
-```
-USAGE
-  $ backlog-exporter update [DIRECTORY] [--apiKey <value>] [--documentsOnly] [--domain <value>] [-f]
-    [--issuesOnly] [--projectIdOrKey <value>] [--wikisOnly]
-
-ARGUMENTS
-  DIRECTORY  更新対象のディレクトリ（設定ファイルが保存されている場所）
-
-FLAGS
-  -f, --force                   確認プロンプトをスキップする
-      --apiKey=<value>          Backlog API key (環境変数 BACKLOG_API_KEY からも自動読み取り可能)
-      --documentsOnly           ドキュメントのみを更新する
-      --domain=<value>          Backlog domain (e.g. example.backlog.jp)
-      --issuesOnly              課題のみを更新する
-      --projectIdOrKey=<value>  Backlog project ID or key
-      --wikisOnly               Wikiのみを更新する
-
-DESCRIPTION
-  Backlogから最新データを取得して更新する
-
-EXAMPLES
-  $ backlog-exporter update
-  カレントディレクトリの設定を使用して更新する
-
-  $ backlog-exporter update --force
-  確認プロンプトをスキップする
-
-  $ backlog-exporter update --apiKey YOUR_API_KEY --domain example.backlog.jp --projectIdOrKey PROJECT_KEY
-  指定したパラメータで更新する（設定ファイルが存在する場合は上書きされます）
-
-  $ backlog-exporter update ./my-project
-  指定したディレクトリの設定を使用して更新する
-```
-
-_See code: [src/commands/update/index.ts](https://github.com/ShuntaToda/backlog-exporter/blob/v0.6.0/src/commands/update/index.ts)_
-
-## `backlog-exporter wiki`
-
-Backlogから Wiki を取得してMarkdownファイルとして保存する
-
-```
-USAGE
-  $ backlog-exporter wiki --domain <value> --projectIdOrKey <value> [--apiKey <value>] [-o <value>]
-
-FLAGS
-  -o, --output=<value>          出力ディレクトリパス
-      --apiKey=<value>          Backlog API key (環境変数 BACKLOG_API_KEY からも自動読み取り可能)
-      --domain=<value>          (required) Backlog domain (e.g. example.backlog.jp)
-      --projectIdOrKey=<value>  (required) Backlog project ID or key
-
-DESCRIPTION
-  Backlogから Wiki を取得してMarkdownファイルとして保存する
-
-EXAMPLES
-  $ backlog-exporter wiki --domain example.backlog.jp --projectIdOrKey PROJECT_KEY --apiKey YOUR_API_KEY
-  Wikiをダウンロードする
-
-  $ backlog-exporter wiki --domain example.backlog.jp --projectIdOrKey PROJECT_KEY --apiKey YOUR_API_KEY --output ./my-project
-  指定したディレクトリにWikiを保存する
-```
-
-_See code: [src/commands/wiki/index.ts](https://github.com/ShuntaToda/backlog-exporter/blob/v0.6.0/src/commands/wiki/index.ts)_
 <!-- commandsstop -->
 
 # 出力形式
@@ -772,12 +667,12 @@ _See code: [src/commands/wiki/index.ts](https://github.com/ShuntaToda/backlog-ex
 
 ## カスタム属性
 
-| 属性名 | 値 |
-|--------|----| 
-| 工数（エンジニア） | 3 |
-| 工数（PPO） | なし |
-| 担当チーム | フロントエンド, バックエンド |
-| 詳細 | 実装内容<br>- 機能A<br>- 機能B |
+| 属性名             | 値                             |
+| ------------------ | ------------------------------ |
+| 工数（エンジニア） | 3                              |
+| 工数（PPO）        | なし                           |
+| 担当チーム         | フロントエンド, バックエンド   |
+| 詳細               | 実装内容<br>- 機能A<br>- 機能B |
 
 ## 詳細
 
@@ -836,10 +731,12 @@ Backlog の書式がそのまま保持されます。
 Backlog の書式がそのまま保持されます。
 
 ## 添付ファイル
+
 - **資料.pdf** (1024.5 KB) - 作成者: 山田太郎, 作成日時: 2023/01/01 10:00:00
 - **画像.png** (256.3 KB) - 作成者: 佐藤次郎, 作成日時: 2023/01/01 10:30:00
 
 ## タグ
+
 - 仕様書
 - 設計書
 ```
@@ -854,3 +751,13 @@ Backlog の書式がそのまま保持されます。
 - **キーワード検索**: ドキュメントの検索キーワード対応
 - **差分更新**: 前回の更新以降に変更されたデータのみを更新
 - **カスタム属性対応**: 課題のカスタム属性をテーブル形式で表示（配列・オブジェクト・プリミティブ値に対応）
+
+## 開発への貢献
+
+backlog-exporterはオープンソースプロジェクトです。バグ報告、機能提案、プルリクエストなど、あらゆる形での貢献を歓迎しています。
+
+詳しくは [CONTRIBUTING.md](docs/CONTRIBUTING.md) をご覧ください。
+
+## ライセンス
+
+このプロジェクトは[MIT License](LICENSE)の下で公開されています。