Skip to main content

iidict

English | 中文

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

安装

pip install iidict

用法

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


English

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

Install

pip install iidict

Usage

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

Metadata

Release files for iidict 0.0.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for iidict 0.0.3
File Size Uploaded Provenance Actions
iidict-0.0.3.tar.gz 9.2 kB Without provenance Details for iidict-0.0.3.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for iidict 0.0.3
File Interpreter ABI Platform Actions
iidict-0.0.3-py3-none-any.whl Python 3 none any Details for iidict-0.0.3-py3-none-any.whl

Total release size: 18.5 kB

Release files / iidict-0.0.3.tar.gz

Download URL iidict-0.0.3.tar.gz
Size 9.2 kB
Tags Source
SHA-256 checksum
How to use checksums
b234f0f687d639c559198e40868cc3cfe2d953452031247690913218fd7e2344
BLAKE2b-256 checksum
How to use checksums
a438828a1c3278989786d71fe35d25798d60ad763924b9ccc85b21324001992c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.10.11

Release files / iidict-0.0.3-py3-none-any.whl

Download URL iidict-0.0.3-py3-none-any.whl
Size 9.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
a96feb226454bc704f762696f46231c7f0bb71a1905727c7c5ad3d2d494235c4
BLAKE2b-256 checksum
How to use checksums
f1eacc23bb5d3719d8a613a767a1df9b078be0357f9d452be65d79945adfba7a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.10.11

Security for iidict 0.0.3

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page