chameleon-data 0.1.1__tar.gz

chameleon_data-0.1.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 hidariutiwa
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

chameleon_data-0.1.1/PKG-INFO

@@ -0,0 +1,117 @@
+Metadata-Version: 2.4
+Name: chameleon-data
+Version: 0.1.1
+Summary: Interactive CLI to mask columns of CSV/TSV/XLSX files with Faker-generated fake data
+Keywords: cli,faker,masking,anonymize,csv,excel
+Author: hidariutiwa
+Author-email: hidariutiwa <hidariutiwa22@gmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Environment :: Console
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Utilities
+Requires-Dist: faker>=40.43.0
+Requires-Dist: openpyxl>=3.1.5
+Requires-Dist: pandas>=3.1.0
+Requires-Dist: pydantic>=2.14.1
+Requires-Dist: questionary>=2.1.1
+Requires-Dist: rich>=15.0.0
+Requires-Python: >=3.11
+Project-URL: Repository, https://github.com/hidariutiwa/chameleon-data
+Description-Content-Type: text/markdown
+
+# chameleon-data
+
+CSV / TSV / XLSX ファイルの列を選んで、[Faker](https://faker.readthedocs.io/) で生成したダミーデータに置き換える対話型 CLI です。結果は元と同じ形式で保存されます。
+
+## インストール
+
+Python 3.11 以上が必要です。
+
+```bash
+# CLI ツールとしてインストール (おすすめ)
+uv tool install chameleon-data
+
+# インストールせずに 1 回だけ実行
+uvx --from chameleon-data chameleon -f data.csv
+
+# 他プロジェクトの依存として追加
+uv add chameleon-data
+pip install chameleon-data
+```
+
+最新の開発版は GitHub から直接インストールできます。
+
+```bash
+uv tool install git+https://github.com/hidariutiwa/chameleon-data
+```
+
+GitHub 版で特定のバージョンに固定したい場合は `git+https://github.com/hidariutiwa/chameleon-data@<tag or commit>` のように指定します。
+
+アップデート / アンインストール:
+
+```bash
+uv tool upgrade chameleon-data
+uv tool uninstall chameleon-data
+```
+
+## 使い方
+
+```bash
+chameleon -f data.csv                 # data_masked.csv に保存
+chameleon -f data.xlsx -o out.xlsx    # 出力先を指定
+chameleon -f data.tsv -l en_US -s 42  # ロケールとシードを指定
+```
+
+| オプション | 説明 |
+| --- | --- |
+| `-f`, `--filepath` | 入力ファイル (必須)。`.csv` / `.tsv` / `.xlsx` |
+| `-o`, `--output` | 出力ファイル。デフォルトは `<ファイル名>_masked.<拡張子>` |
+| `-l`, `--language` | Faker のロケール。デフォルトは `ja_JP` |
+| `-s`, `--seed` | 乱数シード。指定すると毎回同じ結果になります |
+| `-v`, `--version` | バージョンを表示 |
+
+実行すると、マスクする列をチェックボックスで選び、列ごとに置き換え方を選択します。
+
+| 種類 | 内容 |
+| --- | --- |
+| `masking` | すべての文字を `*` に置き換え (文字数は維持) |
+| `full_name` / `first_name` / `last_name` | 氏名 |
+| `full_address` | 住所 |
+| `zipcode` | 郵便番号 |
+| `phone_number` | 電話番号 |
+
+同じ値は同じダミー値に置き換わるため、行同士の対応関係は保たれます。空セルは空のままです。
+
+### サンプルデータ
+
+```bash
+chameleon-example   # ./example/example.csv にサンプルを生成
+chameleon -f example/example.csv
+```
+
+## 開発
+
+[uv](https://docs.astral.sh/uv/) を使います。
+
+```bash
+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)。
+
+```bash
+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

chameleon_data-0.1.1/README.md

@@ -0,0 +1,94 @@
+# chameleon-data
+
+CSV / TSV / XLSX ファイルの列を選んで、[Faker](https://faker.readthedocs.io/) で生成したダミーデータに置き換える対話型 CLI です。結果は元と同じ形式で保存されます。
+
+## インストール
+
+Python 3.11 以上が必要です。
+
+```bash
+# CLI ツールとしてインストール (おすすめ)
+uv tool install chameleon-data
+
+# インストールせずに 1 回だけ実行
+uvx --from chameleon-data chameleon -f data.csv
+
+# 他プロジェクトの依存として追加
+uv add chameleon-data
+pip install chameleon-data
+```
+
+最新の開発版は GitHub から直接インストールできます。
+
+```bash
+uv tool install git+https://github.com/hidariutiwa/chameleon-data
+```
+
+GitHub 版で特定のバージョンに固定したい場合は `git+https://github.com/hidariutiwa/chameleon-data@<tag or commit>` のように指定します。
+
+アップデート / アンインストール:
+
+```bash
+uv tool upgrade chameleon-data
+uv tool uninstall chameleon-data
+```
+
+## 使い方
+
+```bash
+chameleon -f data.csv                 # data_masked.csv に保存
+chameleon -f data.xlsx -o out.xlsx    # 出力先を指定
+chameleon -f data.tsv -l en_US -s 42  # ロケールとシードを指定
+```
+
+| オプション | 説明 |
+| --- | --- |
+| `-f`, `--filepath` | 入力ファイル (必須)。`.csv` / `.tsv` / `.xlsx` |
+| `-o`, `--output` | 出力ファイル。デフォルトは `<ファイル名>_masked.<拡張子>` |
+| `-l`, `--language` | Faker のロケール。デフォルトは `ja_JP` |
+| `-s`, `--seed` | 乱数シード。指定すると毎回同じ結果になります |
+| `-v`, `--version` | バージョンを表示 |
+
+実行すると、マスクする列をチェックボックスで選び、列ごとに置き換え方を選択します。
+
+| 種類 | 内容 |
+| --- | --- |
+| `masking` | すべての文字を `*` に置き換え (文字数は維持) |
+| `full_name` / `first_name` / `last_name` | 氏名 |
+| `full_address` | 住所 |
+| `zipcode` | 郵便番号 |
+| `phone_number` | 電話番号 |
+
+同じ値は同じダミー値に置き換わるため、行同士の対応関係は保たれます。空セルは空のままです。
+
+### サンプルデータ
+
+```bash
+chameleon-example   # ./example/example.csv にサンプルを生成
+chameleon -f example/example.csv
+```
+
+## 開発
+
+[uv](https://docs.astral.sh/uv/) を使います。
+
+```bash
+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)。
+
+```bash
+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

chameleon_data-0.1.1/pyproject.toml

@@ -0,0 +1,45 @@
+[project]
+name = "chameleon-data"
+version = "0.1.1"
+description = "Interactive CLI to mask columns of CSV/TSV/XLSX files with Faker-generated fake data"
+readme = "README.md"
+requires-python = ">=3.11"
+license = "MIT"
+license-files = ["LICENSE"]
+keywords = [
+    "cli",
+    "faker",
+    "masking",
+    "anonymize",
+    "csv",
+    "excel",
+]
+classifiers = [
+    "Environment :: Console",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Topic :: Utilities",
+]
+dependencies = [
+    "faker>=40.43.0",
+    "openpyxl>=3.1.5",
+    "pandas>=3.1.0",
+    "pydantic>=2.14.1",
+    "questionary>=2.1.1",
+    "rich>=15.0.0",
+]
+
+[[project.authors]]
+name = "hidariutiwa"
+email = "hidariutiwa22@gmail.com"
+
+[project.urls]
+Repository = "https://github.com/hidariutiwa/chameleon-data"
+
+[project.scripts]
+chameleon = "chameleon_data.main:main"
+chameleon-example = "chameleon_data.main:create_example"
+
+[build-system]
+requires = ["uv_build>=0.11.14,<0.12.0"]
+build-backend = "uv_build"

chameleon_data-0.1.1/pyproject.toml.orig

@@ -0,0 +1,37 @@
+[project]
+name = "chameleon-data"
+version = "0.1.1"
+description = "Interactive CLI to mask columns of CSV/TSV/XLSX files with Faker-generated fake data"
+readme = "README.md"
+authors = [
+    { name = "hidariutiwa", email = "hidariutiwa22@gmail.com" }
+]
+requires-python = ">=3.11"
+license = "MIT"
+license-files = ["LICENSE"]
+keywords = ["cli", "faker", "masking", "anonymize", "csv", "excel"]
+classifiers = [
+    "Environment :: Console",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Topic :: Utilities",
+]
+dependencies = [
+    "faker>=40.43.0",
+    "openpyxl>=3.1.5",
+    "pandas>=3.1.0",
+    "pydantic>=2.14.1",
+    "questionary>=2.1.1",
+    "rich>=15.0.0",
+]
+
+[project.urls]
+Repository = "https://github.com/hidariutiwa/chameleon-data"
+
+[build-system]
+requires = ["uv_build>=0.11.14,<0.12.0"]
+build-backend = "uv_build"
+
+[project.scripts]
+chameleon = "chameleon_data.main:main"
+chameleon-example = "chameleon_data.main:create_example"

chameleon_data-0.1.1/src/chameleon_data/__init__.py

@@ -0,0 +1,2 @@
+def hello() -> str:
+    return "Hello from chameleon-data!"

chameleon_data-0.1.1/src/chameleon_data/main.py

@@ -0,0 +1,190 @@
+import sys
+from argparse import ArgumentParser
+from collections.abc import Callable
+from importlib.metadata import version
+from pathlib import Path
+
+import pandas as pd
+import questionary
+from faker import Faker
+from rich.console import Console
+from pydantic import BaseModel
+
+
+class ExampleData(BaseModel):
+    no: int
+    first_name: str
+    last_name: str
+    zipcode: str
+    address: str
+    phone_number: str
+
+
+ALLOWED_SUFFIXES = (".csv", ".tsv", ".xlsx")
+
+console = Console()
+
+
+def fake_address(fake: Faker) -> str:
+    # prefecture, chome, etc. exist only in the ja_JP provider
+    if not hasattr(fake, "prefecture"):
+        return fake.address().replace("\n", " ")
+    return f"{fake.prefecture()}{fake.city()}{fake.chome()}{fake.gou()}{fake.ban()}{fake.building_name()}{fake.building_number()}"
+
+
+FAKE_GENERATORS: dict[str, Callable[[Faker], str]] = {
+    "full_name": lambda fake: f"{fake.last_name()} {fake.first_name()}",
+    "first_name": lambda fake: fake.first_name(),
+    "last_name": lambda fake: fake.last_name(),
+    "full_address": fake_address,
+    "zipcode": lambda fake: fake.zipcode(),
+    "phone_number": lambda fake: fake.phone_number(),
+}
+
+FAKE_TYPES = ["masking", *FAKE_GENERATORS]
+
+
+def read_table(path: Path) -> pd.DataFrame:
+    match path.suffix:
+        case ".csv":
+            return pd.read_csv(path, dtype=str)
+        case ".tsv":
+            return pd.read_csv(path, sep="\t", dtype=str)
+        case ".xlsx":
+            return pd.read_excel(path, dtype=str)
+    raise ValueError(f"{path.suffix} is not allowed.")
+
+
+def write_table(df: pd.DataFrame, path: Path) -> None:
+    match path.suffix:
+        case ".csv":
+            df.to_csv(path, index=False)
+        case ".tsv":
+            df.to_csv(path, sep="\t", index=False)
+        case ".xlsx":
+            df.to_excel(path, index=False)
+        case _:
+            raise ValueError(f"{path.suffix} is not allowed.")
+
+
+def mask_column(series: pd.Series, fake_type: str, fake: Faker) -> pd.Series:
+    # same original value -> same replacement, so relations between rows are kept
+    replaced: dict[str, str] = {}
+
+    def replace(value: str) -> str:
+        if pd.isna(value):
+            return value
+        if value not in replaced:
+            if fake_type == "masking":
+                replaced[value] = "*" * len(value)
+            else:
+                replaced[value] = FAKE_GENERATORS[fake_type](fake)
+        return replaced[value]
+
+    return series.map(replace)
+
+
+def exit_with_error(message: str) -> None:
+    console.print(message, style="red bold")
+    sys.exit(1)
+
+
+def main() -> None:
+    parser = ArgumentParser(
+        prog="chameleon",
+        description="mask columns of csv/tsv/xlsx file with fake data.",
+    )
+    parser.add_argument(
+        "-v", "--version", action="version", version=version("chameleon-data")
+    )
+    parser.add_argument(
+        "-f",
+        "--filepath",
+        required=True,
+        help="filepath read file. allowed format: csv, tsv, xlsx",
+    )
+    parser.add_argument(
+        "-o",
+        "--output",
+        help="filepath to save masked file. default: <filename>_masked.<suffix>",
+    )
+    parser.add_argument(
+        "-l",
+        "--language",
+        default="ja_JP",
+        help="language of fake data. default: ja_JP",
+    )
+    parser.add_argument(
+        "-s",
+        "--seed",
+        type=int,
+        help="you need same data everytimes, set seed any number.",
+    )
+    args = parser.parse_args()
+
+    input_path = Path(args.filepath).resolve()
+    if args.output:
+        output_path = Path(args.output).resolve()
+    else:
+        output_path = input_path.with_stem(f"{input_path.stem}_masked")
+
+    for path in (input_path, output_path):
+        if path.suffix not in ALLOWED_SUFFIXES:
+            exit_with_error(f"{path.suffix} is not allowed.")
+    if not input_path.exists():
+        exit_with_error(f"{input_path} is not found.")
+
+    df = read_table(input_path)
+
+    headers = list(df.columns)
+    mask_columns = questionary.checkbox("select masking columns", headers).ask()
+    if mask_columns is None:
+        sys.exit(1)
+    if not mask_columns:
+        exit_with_error("no columns selected.")
+
+    fake_types = {}
+    for column in mask_columns:
+        fake_type = questionary.select(f"type of {column}", FAKE_TYPES).ask()
+        if fake_type is None:
+            sys.exit(1)
+        fake_types[column] = fake_type
+
+    fake = Faker(args.language)
+    if args.seed is not None:
+        Faker.seed(args.seed)
+
+    for column, fake_type in fake_types.items():
+        df[column] = mask_column(df[column], fake_type, fake)
+
+    write_table(df, output_path)
+    console.print(f"save masked file: {output_path}", style="cyan bold")
+
+
+def create_example() -> None:
+    Faker.seed(223)
+    fake = Faker("ja_JP")
+
+    persons = [
+        ExampleData(
+            no=i + 1,
+            first_name=fake.first_name(),
+            last_name=fake.last_name(),
+            zipcode=fake.zipcode(),
+            address=fake_address(fake),
+            phone_number=fake.phone_number(),
+        )
+        for i in range(10)
+    ]
+
+    df = pd.DataFrame([p.model_dump() for p in persons])
+    df = df.set_index("no")
+    print(df)
+
+    example_dir = Path(Path.cwd(), "example")
+    Path.mkdir(example_dir, exist_ok=True)
+    example_path = Path(example_dir, "example.csv")
+
+    df.to_csv(example_path)
+    console.print(f"save example csv: {example_path}", style="cyan bold")
+    console.print(f"try it! -> chameleon -f {example_path}", style="cyan bold")