# sample

`csv_formatter_gui` の動作確認用サンプルです。

## フォルダ構成

- `valid_single/`
  - 正常系の単一ファイル確認用
- `valid_multiple/`
  - 正常系の複数ファイル一括確認用
- `valid_mixed_columns/`
  - 一部ファイルだけ列構成が異なる確認用
- `invalid/`
  - 読込失敗や想定外入力の確認用
- `no_header/`
  - ヘッダーなしCSVの確認用

## ファイル一覧

### `sample.csv`

- ルート直下の簡易サンプル
- 基本的な置換、空白トリム、固定値列追加の確認に使える
- 日本語データかつ、値の中にダブルクォーテーションを含む

### `valid_single/items_basic.csv`

- 単一ファイルでの正常動作用
- 列名変更、不要列削除、正規表現置換、空白トリムの確認向け
- 日本語の列名・値を使い、`"旧ラベル ""特価"""` のような二重引用符エスケープを含む

### `valid_multiple/orders_01.csv`

- 複数ファイル一括処理の1件目
- 受注データ風の内容
- 日本語データかつ、引用符を含むメモ列あり

### `valid_multiple/orders_02.csv`

- 複数ファイル一括処理の2件目
- `orders_01.csv` と同じ列構成で、同一ルールをまとめて適用する確認向け

### `valid_multiple/orders_03.csv`

- 複数ファイル一括処理の3件目
- 空白や記号を含み、置換・トリム確認向け
- `""確認要""` を含むセルがあり、ダブルクォーテーション入りデータの確認向け

### `invalid/not_csv_content.csv`

- 拡張子は `.csv` だが中身はCSV形式ではない想定
- 読込エラーや誤読込時の挙動確認用
- 日本語テキストのみ

### `invalid/broken_rows.csv`

- 行ごとに列数が揃っていない不正CSV
- pandas 読込エラー確認用
- 日本語データで、最終行だけ余分な列を含む

### `invalid/empty.csv`

- 空ファイル
- 読込失敗時のメッセージ確認用

### `valid_mixed_columns/orders_main.csv`

- 列不足がない基準ファイル
- `orders_missing_note.csv` と組み合わせて `スキップ` 集計確認に使う

### `valid_mixed_columns/orders_missing_note.csv`

- `メモ` 列が無いファイル
- ルール適用時に一部ファイルだけ列不足となるケース確認用

### `no_header/items_no_header.csv`

- ヘッダー行が存在しないCSV
- 1行目を列名として扱っても処理継続するかの確認用

## 使い分け例

- Free版確認:
  - `valid_single/` を指定して単一ファイル変換を確認
- Pro版確認:
  - `valid_multiple/` を指定して一括変換を確認
  - `valid_mixed_columns/` を指定して `スキップ` を含む一括変換を確認
- 例外確認:
  - `invalid/` を指定して読込エラー表示を確認
  - `no_header/` を指定してヘッダーなしCSVの扱いを確認
