Metadata-Version: 2.5
Name: iidict
Version: 0.0.2
Summary: JSON helpers for the messy cases: sets, datetimes, Decimals, streams.
Project-URL: Homepage, https://pypi.org/project/iidict/
Author-email: lqxnjk <lqxnjk@qq.com>
License: MIT
License-File: LICENSE
Keywords: datetime,decimal,deserialize,json,serialize,stream
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Typing :: Typed
Requires-Python: >=3.10
Description-Content-Type: text/markdown

# iidict

[English](#english) | 中文

处理疑难类型的 JSON 序列化，并能流式读写大文件。

## 安装

```console
pip install iidict
```

## 用法

```python
from datetime import datetime
from decimal import Decimal

from iidict import IIDict

IIDict.dumps({"tags": {"a", "b"}, "at": datetime(2026, 10, 23), "p": Decimal("1.50")})
# '{"tags": ["a", "b"], "at": "2026-10-23 00:00:00", "p": 1.5}'

IIDict.dumps({"a": 1}, n_string=False)   # -> bytes
IIDict.loads('{"a": 1}')                # {'a': 1}

for key, value in IIDict.iter_loads("huge.json"):
    store(key, value)
```

## 说明

`json.dumps` 拒绝 set、datetime、Decimal 和自定义对象，`IIDict.dumps` 先把它们规范化再序列化。`iter_loads` 逐个产出顶层对象的键值对，多 GB 文件不必整份进内存；顶层是数组时抛 `ValueError`，不静默返回空。

## 许可证

MIT

---

<a id="english"></a>
## English

JSON helpers for the messy cases: sets, datetimes, Decimals, streams.

## Install

```console
pip install iidict
```

## Usage

```python
from datetime import datetime
from decimal import Decimal

from iidict import IIDict

IIDict.dumps({"tags": {"a", "b"}, "at": datetime(2026, 10, 23), "p": Decimal("1.50")})
# '{"tags": ["a", "b"], "at": "2026-10-23 00:00:00", "p": 1.5}'

IIDict.dumps({"a": 1}, n_string=False)   # -> bytes
IIDict.loads('{"a": 1}')                # {'a': 1}

for key, value in IIDict.iter_loads("huge.json"):
    store(key, value)
```

## Notes

`json.dumps` refuses sets, datetimes, Decimals and custom objects; `IIDict.dumps` normalizes them first. `iter_loads` yields one key/value pair at a time so a multi-gigabyte file never has to fit in memory. A top-level array raises `ValueError`.

## License

MIT
