chameleon-data

CSV / TSV / XLSX ファイルの列を選んで、Faker で生成したダミーデータに置き換える対話型 CLI です。結果は元と同じ形式で保存されます。

インストール

Python 3.11 以上が必要です。

# CLI ツールとしてインストール (おすすめ)
uv tool install chameleon-data

# インストールせずに 1 回だけ実行
uvx --from chameleon-data chameleon -f data.csv

# 他プロジェクトの依存として追加
uv add chameleon-data
pip install chameleon-data

最新の開発版は GitHub から直接インストールできます。

uv tool install git+https://github.com/hidariutiwa/chameleon-data

GitHub 版で特定のバージョンに固定したい場合は git+https://github.com/hidariutiwa/chameleon-data@<tag or commit> のように指定します。

アップデート / アンインストール:

uv tool upgrade chameleon-data
uv tool uninstall chameleon-data

使い方

chameleon -f data.csv                 # data_masked.csv に保存
chameleon -f data.xlsx -o out.xlsx    # 出力先を指定
chameleon -f data.tsv -l en_US -s 42  # ロケールとシードを指定

実行すると、マスクする列をチェックボックスで選び、列ごとに置き換え方を選択します。

同じ値は同じダミー値に置き換わるため、行同士の対応関係は保たれます。空セルは空のままです。

サンプルデータ

chameleon-example   # ./example/example.csv にサンプルを生成
chameleon -f example/example.csv

開発

uv を使います。

uv sync
uv run chameleon -f example/example.csv
uv build   # dist/ に wheel と sdist を作成

リリース

v* タグを push すると GitHub Actions (.github/workflows/publish.yml) が PyPI に公開します (Trusted Publishing)。

uv version --bump patch   # pyproject.toml の version を更新 (minor / major も可)
git commit -am "chore: release v$(uv version --short)"
git tag "v$(uv version --short)"
git push origin main --tags

ライセンス

MIT