ecom-toon: JSON → TOON Converter

Convert eCommerce JSON to TOON format directly inside VS Code. Save 38–49% LLM tokens on every API call — with zero data loss.

Features

• ✅ Right-click any .json file → Convert JSON → TOON
• ✅ Right-click any .toon file → Convert TOON → JSON
• ✅ Token savings report — see exactly how many tokens you save
• ✅ Batch convert an entire folder at once
• ✅ Roundtrip validation — prove zero data loss
• ✅ Status bar button — convert with one click

Requirements

1. Python 3.10+ installed on your system
2. The ecom-toon project cloned/downloaded on your machine
3. Dependencies installed: poetry install or pip install tiktoken rich

Setup (First Time)

1. Install this extension
2. Open VS Code Settings (Ctrl+,)
3. Search for ecom-toon
4. Set ecom-toon.cliPath to your project folder path:
   • Windows: C:\Users\YourName\ecom-toon-project
   • Mac/Linux: /home/yourname/ecom-toon-project
5. Set ecom-toon.pythonPath if needed (default: python)
   • If python doesn't work, try python3
   • Or use the full path: C:\Python311\python.exe

How to Use

Convert a single JSON file

1. Right-click any .json file in the Explorer panel
2. Click "ecom-toon: Convert JSON → TOON"
3. A .toon file appears next to your JSON file
4. A notification shows your token savings %

Convert back to JSON

1. Right-click any .toon file
2. Click "ecom-toon: Convert TOON → JSON"
3. A -tojson.json file appears

See token savings report

1. Right-click any .json file
2. Click "ecom-toon: Show Token Savings Report"
3. An Output panel opens with full stats

Batch convert a folder

1. Right-click any folder in Explorer
2. Click "ecom-toon: Batch Convert Folder (JSON → TOON)"
3. All .json files in the folder get converted

Validate zero data loss

1. Right-click any .json file
2. Click "ecom-toon: Validate Roundtrip"
3. Confirms JSON → TOON → JSON produces identical output

Settings

What is TOON?

TOON is a compact text format for eCommerce data. It removes JSON's structural overhead (", {, }, :, indentation) while keeping all data intact.

Example:

JSON (1,927 tokens):

{
  "id": 987654321,
  "title": "Sony WH-1000XM5",
  "variants": [
    {
      "id": 111222333,
      "sku": "WH1000XM5-BLK",
      "price": "399.00"
    }
  ]
}

TOON (1,184 tokens — 38.6% fewer):

id,987654321
title,Sony WH-1000XM5
variants[1]{id,sku,price},
  111222333,WH1000XM5-BLK,"399.00"

Token Savings by Catalog Size

License

MIT