test_type.py

Overview

`test_type.py` is a comprehensive test suite designed to validate the serialization and deserialization behavior of various Python data types using the `orjson` library. This file leverages the `pytest` testing framework to systematically check correctness, error handling, and edge cases of JSON encoding/decoding operations performed by `orjson`.

The tests ensure that `orjson` correctly handles JSON fragments, invalid JSON, string encoding (including long strings, Unicode, control characters, escapes, emojis), numeric types (integers, floats, special float values like NaN and Infinity), boolean values, `None` (null), lists, tuples, bytes-like objects, and error cases such as unsupported types or invalid surrogate pairs.

Contents

• Class: TestType
  Contains numerous test methods targeting specific Python types and JSON edge cases.

Class Details

class TestType

This class encapsulates all tests related to serialization (`dumps`) and deserialization (`loads`) of Python objects with `orjson`. Each method tests a particular type, value range, or edge case.

Test Methods Summary

Important Implementation Details

• Error Handling:
  Many tests verify that invalid JSON or unsupported data types correctly raise orjson.JSONDecodeError or orjson.JSONEncodeError. This ensures orjson enforces strict JSON compliance.

• String Escaping and Encoding:
  Multiple tests focus on escaping quotes, backslashes, control characters, and handling of Unicode characters including surrogates and emojis. This ensures that serialized JSON strings conform to JSON specification and UTF-8 encoding.

• Large Data Handling:
  Tests with very large strings, lists, and dictionaries ensure that orjson can handle high-volume data without errors or performance degradation.

• Integer Size Restrictions:
  Tests involving the OPT_STRICT_INTEGER option verify that integers outside the 53-bit safe range raise errors, ensuring strict JSON number compliance.

• Special Float Values:
  NaN and Infinity serialize to null as per JSON standard, but appear as errors when loaded from JSON strings.

• Bytes and Byte-like Objects:
  Serialization of bytes objects is not supported and should raise errors, but loading JSON from bytes-like buffers is supported.

Usage Examples

import orjson

# Serialize a Python dict to JSON bytes
data = {"name": "Alice", "age": 30}
json_bytes = orjson.dumps(data)

# Deserialize JSON bytes back to Python dict
obj = orjson.loads(json_bytes)

print(obj)
# Output: {'name': 'Alice', 'age': 30}

The test suite ensures that such common operations and their edge cases are thoroughly validated.

Interaction with Other Parts of the System

• orjson Library:
  This test file directly tests the orjson library's JSON serialization (dumps) and deserialization (loads) functionality.

• pytest Framework:
  Uses pytest for test execution and assertion management including exception testing.

• Standard Python Types:
  Tests cover interaction of orjson with built-in Python types such as str, int, float, bool, list, tuple, None, bytes, bytearray, and memoryview.

• System Modules:
  Uses sys.float_info for floating-point edge case values.

This file is primarily for **testing** and thus interacts indirectly with any system components or user code that rely on `orjson` for JSON processing.

Visual Diagram

classDiagram
    class TestType {
        +test_fragment()
        +test_invalid()
        +test_str()
        +test_str_latin1()
        +test_str_long()
        +test_str_2mib()
        +test_str_very_long()
        +test_str_replacement()
        +test_str_trailing_4_byte()
        +test_str_ascii_control()
        +test_str_escape_quote_0()
        +test_str_escape_quote_1()
        +test_str_escape_quote_2()
        +test_str_escape_quote_3()
        +test_str_escape_quote_4()
        +test_str_escape_quote_5()
        +test_str_escape_quote_6()
        +test_str_escape_quote_7()
        +test_str_escape_quote_8()
        +test_str_escape_quote_multi()
        +test_str_escape_quote_buffer()
        +test_str_escape_backslash_0()
        +test_str_escape_backslash_1()
        +test_str_escape_backslash_2()
        +test_str_escape_backslash_3()
        +test_str_escape_backslash_4()
        +test_str_escape_backslash_5()
        +test_str_escape_backslash_6()
        +test_str_escape_backslash_7()
        +test_str_escape_backslash_8()
        +test_str_escape_backslash_multi()
        +test_str_escape_backslash_buffer()
        +test_str_escape_x32_0()
        +test_str_escape_x32_1()
        +test_str_escape_x32_2()
        +test_str_escape_x32_3()
        +test_str_escape_x32_4()
        +test_str_escape_x32_5()
        +test_str_escape_x32_6()
        +test_str_escape_x32_7()
        +test_str_escape_x32_8()
        +test_str_escape_x32_multi()
        +test_str_escape_x32_buffer()
        +test_str_emoji()
        +test_str_emoji_escape()
        +test_very_long_list()
        +test_very_long_list_pretty()
        +test_very_long_dict()
        +test_very_long_dict_pretty()
        +test_very_long_str_empty()
        +test_very_long_str_empty_pretty()
        +test_very_long_str_not_empty()
        +test_very_long_str_not_empty_pretty()
        +test_very_long_bool()
        +test_very_long_bool_pretty()
        +test_very_long_int()
        +test_very_long_int_pretty()
        +test_very_long_float()
        +test_very_long_float_pretty()
        +test_str_surrogates_loads()
        +test_str_surrogates_dumps()
        +test_bytes_dumps()
        +test_bytes_loads()
        +test_bytearray_loads()
        +test_memoryview_loads()
        +test_bytesio_loads()
        +test_bool()
        +test_bool_true_array()
        +test_bool_false_array()
        +test_none()
        +test_int()
        +test_null_array()
        +test_nan_dumps()
        +test_nan_loads()
        +test_infinity_dumps()
        +test_infinity_loads()
        +test_int_53()
        +test_int_53_exc()
        +test_int_53_exc_usize()
        +test_int_53_exc_128()
        +test_int_64()
        +test_uint_64()
        +test_int_128()
        +test_float()
        +test_float_precision_loads()
        +test_float_precision_dumps()
        +test_float_edge()
        +test_float_notation()
        +test_list()
        +test_tuple()
        +test_object()
    }

Summary

`test_type.py` is a vital testing module that ensures the robustness, compliance, and correctness of JSON serialization and deserialization in the `orjson` library across a wide range of Python types and JSON edge cases. It validates `orjson`'s behavior for typical usage scenarios as well as boundary and error conditions, providing confidence in the library's reliability for JSON processing within larger applications.