{"library":"oslo-serialization","title":"Oslo Serialization Library","description":"The oslo.serialization library, part of the OpenStack Oslo project, provides robust utilities for representing Python objects in transmittable and storable formats like JSON and MessagePack. It aims to offer high-quality, stable, and consistent serialization functionalities for OpenStack and other projects. The library is actively maintained and currently at version 5.9.1.","language":"python","status":"active","last_verified":"Fri May 15","install":{"commands":["pip install oslo-serialization"],"cli":null},"imports":["from oslo_serialization import jsonutils"],"auth":{"required":false,"env_vars":[]},"quickstart":{"code":"from oslo_serialization import jsonutils\nimport datetime\nimport uuid\n\nclass CustomObject:\n    def __init__(self, name, value, created_at=None):\n        self.name = name\n        self.value = value\n        self.id = str(uuid.uuid4())\n        self.created_at = created_at or datetime.datetime.now(datetime.timezone.utc)\n\n    # oslo_serialization.jsonutils.to_primitive will handle this automatically\n    # but for custom types, you might explicitly define how to convert them.\n    # For datetime and UUID, jsonutils has built-in support.\n    def to_dict(self):\n        return {\n            'name': self.name,\n            'value': self.value,\n            'id': self.id,\n            'created_at': self.created_at.isoformat()\n        }\n\n# Example usage\nobj = CustomObject('test_item', 123.45)\n\n# Serialize to JSON string\njson_string = jsonutils.dumps(obj, indent=2)\nprint(f\"Serialized JSON:\\n{json_string}\")\n\n# Deserialize from JSON string\ndata_dict = jsonutils.loads(json_string)\nprint(f\"Deserialized dictionary: {data_dict}\")\n\n# Demonstrate to_primitive (used internally by dumps by default)\nprimitive_data = jsonutils.to_primitive(obj)\nprint(f\"Primitive representation: {primitive_data}\")\n","lang":"python","description":"This quickstart demonstrates how to use `oslo_serialization.jsonutils.dumps` and `loads` to serialize and deserialize a custom Python object. It highlights the automatic handling of types like `datetime` and `UUID` by `jsonutils.to_primitive`, which `dumps` utilizes by default.","tag":null,"tag_description":null,"last_tested":null,"results":[]},"compatibility":{"tag":null,"tag_description":null,"last_tested":"2026-05-15","installed_version":"5.8.0","pypi_latest":"5.9.1","is_stale":true,"summary":{"python_range":"3.10–3.9","success_rate":100,"avg_install_s":3.4,"avg_import_s":0.24,"wheel_type":"wheel"},"results":[{"runtime":"python:3.10-alpine","python_version":"3.10","os_libc":"alpine (musl)","variant":"oslo-serialization","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":0.24,"mem_mb":7.6,"disk_size":"36.8M"},{"runtime":"python:3.10-slim","python_version":"3.10","os_libc":"slim (glibc)","variant":"oslo-serialization","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":3.2,"import_time_s":0.16,"mem_mb":7.6,"disk_size":"38M"},{"runtime":"python:3.11-alpine","python_version":"3.11","os_libc":"alpine (musl)","variant":"oslo-serialization","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":0.31,"mem_mb":8.4,"disk_size":"40.2M"},{"runtime":"python:3.11-slim","python_version":"3.11","os_libc":"slim (glibc)","variant":"oslo-serialization","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":3.1,"import_time_s":0.29,"mem_mb":8.4,"disk_size":"42M"},{"runtime":"python:3.12-alpine","python_version":"3.12","os_libc":"alpine (musl)","variant":"oslo-serialization","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":0.26,"mem_mb":9.3,"disk_size":"40.7M"},{"runtime":"python:3.12-slim","python_version":"3.12","os_libc":"slim (glibc)","variant":"oslo-serialization","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":3.3,"import_time_s":0.3,"mem_mb":9.3,"disk_size":"42M"},{"runtime":"python:3.13-alpine","python_version":"3.13","os_libc":"alpine (musl)","variant":"oslo-serialization","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":0.27,"mem_mb":9.5,"disk_size":"40.5M"},{"runtime":"python:3.13-slim","python_version":"3.13","os_libc":"slim (glibc)","variant":"oslo-serialization","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":3.3,"import_time_s":0.26,"mem_mb":9.5,"disk_size":"42M"},{"runtime":"python:3.9-alpine","python_version":"3.9","os_libc":"alpine (musl)","variant":"oslo-serialization","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":0.18,"mem_mb":7.3,"disk_size":"39.1M"},{"runtime":"python:3.9-slim","python_version":"3.9","os_libc":"slim (glibc)","variant":"oslo-serialization","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":3.9,"import_time_s":0.17,"mem_mb":7.3,"disk_size":"41M"}]}}