{"id":45897572,"url":"https://github.com/bluedynamics/zodb-json-codec","last_synced_at":"2026-02-27T21:26:41.092Z","repository":{"id":337019352,"uuid":"1151521778","full_name":"bluedynamics/zodb-json-codec","owner":"bluedynamics","description":"Fast pickle-to-JSON transcoder for ZODB, implemented in Rust via PyO3.","archived":false,"fork":false,"pushed_at":"2026-02-22T01:05:50.000Z","size":270,"stargazers_count":3,"open_issues_count":0,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-02-22T09:19:50.180Z","etag":null,"topics":["pickle","plone","zodb","zope"],"latest_commit_sha":null,"homepage":"https://pypi.org/project/zodb-json-codec","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bluedynamics.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-02-06T15:15:34.000Z","updated_at":"2026-02-22T01:04:48.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/bluedynamics/zodb-json-codec","commit_stats":null,"previous_names":["bluedynamics/zodb-json-codec"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/bluedynamics/zodb-json-codec","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bluedynamics%2Fzodb-json-codec","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bluedynamics%2Fzodb-json-codec/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bluedynamics%2Fzodb-json-codec/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bluedynamics%2Fzodb-json-codec/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bluedynamics","download_url":"https://codeload.github.com/bluedynamics/zodb-json-codec/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bluedynamics%2Fzodb-json-codec/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29914918,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-27T19:37:42.220Z","status":"ssl_error","status_checked_at":"2026-02-27T19:37:41.463Z","response_time":57,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["pickle","plone","zodb","zope"],"created_at":"2026-02-27T21:26:40.624Z","updated_at":"2026-02-27T21:26:41.084Z","avatar_url":"https://github.com/bluedynamics.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# zodb-json-codec\n\nFast pickle-to-JSON transcoder for ZODB, implemented in Rust via PyO3.\n\nConverts ZODB pickle records into human-readable, JSONB-queryable JSON\nwhile maintaining full roundtrip fidelity. Designed as the codec layer for\n[zodb-pgjsonb](https://github.com/bluedynamics/zodb-pgjsonb), a PostgreSQL\nJSONB storage backend for ZODB.\n\n**Key capabilities:**\n\n- Full roundtrip fidelity: encode to JSON and back produces identical pickle bytes\n- Human-readable JSON with compact type markers (`@dt`, `@ref`, `@kv`, ...)\n- JSONB-queryable output for PostgreSQL\n- Faster than CPython's C pickle extension on most operations\n- GIL released during Rust phases for multi-threaded Python\n- Escape hatch (`@pkl`) ensures any pickle data roundtrips safely\n\n## Installation\n\n```bash\npip install zodb-json-codec\n```\n\nFor building from source, see the\n[documentation](https://bluedynamics.github.io/zodb-json-codec/how-to/build-from-source.html).\n\n## Quick Example\n\n```python\nimport zodb_json_codec\n\n# ZODB records (two concatenated pickles: class + state)\nrecord = zodb_json_codec.decode_zodb_record(data)\n# -\u003e {\"@cls\": [\"myapp.models\", \"Document\"], \"@s\": {\"title\": \"Hello\", ...}}\ndata = zodb_json_codec.encode_zodb_record(record)\n\n# Standalone pickle \u003c-\u003e JSON string\njson_str = zodb_json_codec.pickle_to_json(pickle_bytes)\npickle_bytes = zodb_json_codec.json_to_pickle(json_str)\n```\n\n## Documentation\n\nFull documentation is available at\n**https://bluedynamics.github.io/zodb-json-codec/**\n\n- [Tutorials](https://bluedynamics.github.io/zodb-json-codec/tutorials/) — Getting started, working with ZODB records\n- [How-To Guides](https://bluedynamics.github.io/zodb-json-codec/how-to/) — Install, integrate, benchmark, build from source\n- [Reference](https://bluedynamics.github.io/zodb-json-codec/reference/) — Python API, JSON format, BTree format, project structure\n- [Explanation](https://bluedynamics.github.io/zodb-json-codec/explanation/) — Architecture, performance, optimization journal, security\n\n## Source Code and Contributions\n\nThe source code is managed in a Git repository, with its main branches hosted on GitHub.\nIssues can be reported there too.\n\nWe'd be happy to see many forks and pull requests to make this package even better.\nWe welcome AI-assisted contributions, but expect every contributor to fully understand and be able to explain the code they submit.\nPlease don't send bulk auto-generated pull requests.\n\nMaintainers are Jens Klein and the BlueDynamics Alliance developer team.\nWe appreciate any contribution and if a release on PyPI is needed, please just contact one of us.\nWe also offer commercial support if any training, coaching, integration or adaptations are needed.\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbluedynamics%2Fzodb-json-codec","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbluedynamics%2Fzodb-json-codec","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbluedynamics%2Fzodb-json-codec/lists"}