pyjsony 0.1.17

JSON superset with relaxed syntax and runtime patching

JSONY

JSONY is a JSON superset and runtime compatibility layer that extends JSON syntax while remaining fully usable as a drop-in replacement via standard library patching.

It is designed for gradual migration of large Python codebases and configuration-heavy systems.

---

Why JSONY

JSON is strict, verbose, and unfriendly to human editing.

JSONY introduces a relaxed syntax while preserving compatibility with Python’s json module via optional runtime patching.

---

Features

• Optional quotes for keys and string values
• Line (//) and block (/* */) comments
• Trailing commas in objects and arrays
• Bare identifiers (foo, bar, null, true, false)
• UTF-8 strict parsing
• Drop-in replacement for Python json via jsonx.patch()
• Deterministic parsing behavior

---

Quick start

1. Patch standard JSON module

import pyjsony

pyjsony.patch()

import json

data = json.loads("""
a: 1,
b: 2,
c: {
    nested: value
}
""")

print(data)

---

2. Direct usage (no patching)

from pyjsony import loads

data = loads("""
obj: {
    foo: bar,
    list: [1, 2, 3]
}
""")

---

Syntax example

// JSONY allows relaxed, human-friendly syntax

config:
{
    host: localhost,
    port: 8080,

    features: [
        logging,
        metrics,
        tracing,
    ]
}

---

Comparison with JSON

Feature	JSON	JSONY
Unquoted keys	❌	✅
Comments	❌	✅
Trailing commas	❌	✅
Bare identifiers	❌	✅
Patch integration	❌	✅

---

Installation

pip

pip install pyjsony

uv

uv add pyjsony

or

uv pip install pyjsony

---

Design goals

• Backwards-compatible superset of JSON syntax
• Seamless migration path for large Python codebases
• Minimal cognitive overhead for configuration files
• Runtime opt-in compatibility via patch()

---

Warning

⚠️ jsony.patch() mutates the global Python json module.

This affects all code in the current runtime process, including dependencies that rely on standard JSON behavior.

Use with care in shared or library-heavy environments.

---

License

BSD2-Clause

---

Statuses