Metadata-Version: 2.4
Name: jsonlens
Version: 0.1.0
Summary: Inspect and extract JSON structure safely with optional fields and type merging
Author-email: Vishnu A J <whispersofwisdom34@gmail.com>
Project-URL: Homepage, https://github.com/ajvishnu/jsonlens
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# 🔍 jsonlens

**See the structure of any JSON instantly — without exposing sensitive data.**

---

## 🚀 Why jsonlens?

Working with APIs is painful:

- ❌ Huge JSON (1000+ lines)
- ❌ Deep nesting
- ❌ Sensitive data (can't share)

👉 jsonlens solves this.

---

## ✨ Features

- 🔐 Safe: no real data, only structure
- ❓ Optional fields detection (`?`)
- 🔄 Type merging (`int | str`)
- 📦 List compression (`... N more items`)
- ⚡ Fast / Sample / Full modes

---

## 📦 Install

pip install jsonlens

## Usage - Python
from jsonlens import build_structure
import json

data = {
    "users": [
        {"id": 1, "name": "Alice"},
        {"id": 2, "name": "Bob", "email": "bob@mail.com"}
    ]
}

print(json.dumps(build_structure(data), indent=2))

## Output
{
  "users": [
    {
      "id": "int",
      "name": "str",
      "email?": "str"
    }
  ]
}
