json-fix

What it is and what it does

json-fix is a lightweight patch to Python's built-in `json` module that enables custom serialization behavior for user-defined classes. When you import it, it modifies `json.dumps()` to recognize and call a `__json__()` method on any object, allowing you to define how your class should be converted to JSON-compatible types. This solves the problem of third-party code attempting to serialize your objects without knowing how to handle them—instead of forking their code or catching exceptions, you simply define the serialization logic in your class.

The package provides two mechanisms for controlling serialization: an `override_table` for intercepting specific classes before they check for a `__json__` method, and a `fallback_table` for providing default serialization when neither a `__json__` method nor an override rule exists. Both tables use checker functions as keys, prioritizing the most recently added entry. The patch is described as safe, backwards-compatible, and reversible.

Use it for

• Enable JSON serialization of custom classes without modifying their definition or the calling code that uses json.dumps().
• Intercept serialization of third-party library objects by adding override rules without forking the library.
• Provide a fallback serialization strategy for all objects with a `__dict__` attribute, making arbitrary Python classes JSON-serializable by default.
• Migrate codebases that rely on toJSON() patterns to Python while preserving the same serialization approach.

Worth the install?

AI-flagged interpretation of the facts on this page. Verify before relying on it.

Install

json-fix on PyPI

Before you install

Low install friction with no runtime dependencies. Maintenance status is aging—last release was 295 days ago, though the repository remains active and not archived.

Requires Python 3.6 or later; json_fix must be imported before json.dumps is called on objects you want to serialize.

License in practice

MIT license permits commercial and private use with minimal restrictions; you must include a copy of the license and copyright notice.

Quickstart

pip install json-fix

import json_fix
import json

class MyClass:
    def __json__(self):
        return self.__dict__

obj = MyClass()
print(json.dumps(obj))

Package facts

Evidence: json_fix-1.0.2-py3-none-any.whl

Tags

More Software Development packages

See also jsonable · jsonconversion · json-encoder · orjson · simplejson · jsons · json-numpy · phpserialize · munch · pyion2json