Q: Does orjson support serializing datetime objects with timezones?

Yes, it serializes datetime objects to RFC 3339 format with timezone support, including options for UTC handling and microsecond omission via flags like OPT_NAIVE_UTC.

Q: How to handle non-string dictionary keys in orjson?

Use the OPT_NON_STR_KEYS flag to serialize keys of types like int, float, or datetime, but note it can create duplicate keys if not careful.

Q: Can orjson read JSON directly from a file?

No, orjson doesn't provide file I/O functions; you must read the file into bytes or a string manually and use loads() for deserialization.

Q: orjson vs other libraries like ujson or simplejson?

orjson benchmarks as the fastest Python JSON library and is more correct by strictly enforcing standards, but check if its limitations like bytes output and no PyPy support fit your needs.

Q: How to serialize numpy arrays with orjson?

Use the OPT_SERIALIZE_NUMPY flag for native serialization of numpy arrays, which is faster than converting to lists first, but requires the array to be a contiguous C array.

Q: What Python versions does orjson support?

It supports CPython 3.10, 3.11, 3.12, 3.13, 3.14, and 3.15, with no support for PyPy, embedded builds, or older versions, so ensure your environment matches.

Question 1

How do I install orjson in my Python project?

Accepted Answer

Install via pip with 'pip install orjson', and specify the version in requirements files like 'orjson >=3.10,<4'. Pre-built wheels are available for common platforms.

Question 2

Does orjson support serializing datetime objects with timezones?

Accepted Answer

Yes, it serializes datetime objects to RFC 3339 format with timezone support, including options for UTC handling and microsecond omission via flags like OPT_NAIVE_UTC.

Question 3

How to handle non-string dictionary keys in orjson?

Accepted Answer

Use the OPT_NON_STR_KEYS flag to serialize keys of types like int, float, or datetime, but note it can create duplicate keys if not careful.

Question 4

Can orjson read JSON directly from a file?

Accepted Answer

No, orjson doesn't provide file I/O functions; you must read the file into bytes or a string manually and use loads() for deserialization.

Question 5

orjson vs other libraries like ujson or simplejson?

Accepted Answer

orjson benchmarks as the fastest Python JSON library and is more correct by strictly enforcing standards, but check if its limitations like bytes output and no PyPy support fit your needs.

Question 6

How to serialize numpy arrays with orjson?

Accepted Answer

Use the OPT_SERIALIZE_NUMPY flag for native serialization of numpy arrays, which is faster than converting to lists first, but requires the array to be a contiguous C array.

Question 7

What Python versions does orjson support?

Accepted Answer

It supports CPython 3.10, 3.11, 3.12, 3.13, 3.14, and 3.15, with no support for PyPy, embedded builds, or older versions, so ensure your environment matches.

orjson

What is orjson?

Overview

Use Cases

Best For

Related Projects

Found a gem we're missing?

Not Ideal For

Pros & Cons

Pros

Cons

Frequently Asked Questions