Standardized way of registering custom JSON serializers/deserializers.
Project description
JSON Handler Registry
Standardized way of registering custom JSON serializers/deserializers.
Package json
lacks standard approach to registering custom JSON handlers.
Project json-handler-registry
has been created to solve that issue.
Usage:
Registering your own handlers:
from typing import Optional
from json_handler_registry.registry import JsonHandlerRegistry
from json_handler_registry.encoder import IJsonEncoder, EncodingResult
from json_handler_registry.decoder import IJsonDecoder
# Enable registry:
JsonHandlerRegistry.enable()
# Implement your custom class encoder:
class MyJsonEncoder(IJsonEncoder):
def encodeObject(self, obj: object) -> Optional[EncodingResult]:
"""Convert object to a JSON serializable data.
Or return ``None`` instead.
"""
pass # TODO: Actual implementation goes here!
# Implement your custom class decoder:
class MyJsonDecoder(IJsonDecoder):
def decodeDict(self, dct: dict) -> Optional[object]:
"""Convert dictionary to your type instance.
Or return ``None`` instead.
"""
pass # TODO: Actual implementation goes here!
def decodeStr(self, valueStr: str) -> Optional[object]:
"""Convert string value to your type instance.
Or return ``None`` instead.
"""
pass # TODO: Actual implementation goes here!
# Register your serializer and deserializer:
JsonHandlerRegistry.registerEncoder(MyJsonEncoder())
JsonHandlerRegistry.registerDecoder(MyJsonDecoder())
Serialization & deserialization:
# Using `tunit` package as an example:
import json
from tunit.config import TUnitConfig
from tunit.unit import Seconds
TUnitConfig.registerJsonHandler() # Enables registry and registers handlers.
# JSON serialization:
messageDto = {"delay": Seconds(10)}
messageJson = json.dumps(messageDto)
print(messageJson) # Prints: '{"delay": "10s"}'
# JSON deserialization:
messageJson = '{"delay": "10s"}'
messageDto = json.loads(messageJson)
print(messageDto) # Prints: {'delay': Seconds(10)}
Popular external packages support:
Package maintainers are encouraged to adopt json-handler-registry
in their projects.
However, for now, support for popular packages will be successively provided here.
Support for dataclasses-json
:
from dataclasses import dataclass
from datetime import datetime
from decimal import Decimal
from enum import Enum, auto
from uuid import UUID, uuid4
from dataclasses_json import DataClassJsonMixin
from json_handler_registry.support import PackageSupportManager
class TestEnum(Enum):
Option1 = auto()
Option2 = auto()
Option3 = auto()
@dataclass
class TestDataClass(DataClassJsonMixin):
timestamp: datetime
id: UUID
option: TestEnum
value: Decimal
testData = TestDataClass(
timestamp=datetime.now().astimezone(),
id=uuid4(),
option=TestEnum.Option2,
value=Decimal(7)
)
PackageSupportManager.getPackageSupportConfig('dataclasses-json').enable()
assert TestDataClass.from_json(testData.to_json()) == testData
PackageSupportManager.getPackageSupportConfig('dataclasses-json').disable()
Changelog:
- Version: 1.3.0
- Support for
dataclasses-json
package. - Debug methods for listing registered encoders/decoders.
- Support for
- Version: 1.2.0
- Guard to prevent registry from being easily overridden when enabled.
- Version: 1.1.0
- Registry accepts both type and instance of encoder/decoder.
License
MIT
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Close
Hashes for json-handler-registry-1.3.0.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 907fbd4f795a2035bcfc0fdefe96bbd8e682418093fb7bbfc88cdd28baf4432b |
|
MD5 | de93ee14fdcb6bd370fd52632deae381 |
|
BLAKE2b-256 | 81b2e359ef4e332439d13773114bc411c23b9e3832043dfb8c8b4173bb204a9c |