Skip to content

docs: Replace deprecated ujson with orjson in client quickstart#12040

Closed
veeceey wants to merge 1 commit intoaio-libs:masterfrom
veeceey:fix/issue-10795-replace-deprecated-ujson
Closed

docs: Replace deprecated ujson with orjson in client quickstart#12040
veeceey wants to merge 1 commit intoaio-libs:masterfrom
veeceey:fix/issue-10795-replace-deprecated-ujson

Conversation

@veeceey
Copy link
Contributor

@veeceey veeceey commented Feb 8, 2026

Summary

Replaces the deprecated ujson library with orjson in the client quickstart documentation.

Problem

The ujson library mentioned in the documentation is now deprecated and in maintenance-only mode. The ujson maintainers recommend migrating to orjson, which is both faster and more secure.

Changes

  • Replaced ujson import and usage example with orjson
  • Updated the note to clarify that:
    • orjson is significantly faster than standard json
    • orjson.dumps() returns bytes instead of str, which works with aiohttp's JSON handling

Related Issues

Closes #10795

Testing

This is a documentation-only change. No code changes were made.

Fixes aio-libs#10795

The ujson library is now in maintenance-only mode and users are
encouraged to migrate to orjson. Updated the client_quickstart.rst
documentation to:
- Replace ujson example with orjson
- Update the note to reflect that orjson is significantly faster
- Clarify that orjson.dumps() returns bytes, which works with aiohttp
@codspeed-hq
Copy link

codspeed-hq bot commented Feb 8, 2026

CodSpeed Performance Report

Merging this PR will not alter performance

Comparing veeceey:fix/issue-10795-replace-deprecated-ujson (7dcf762) with master (d92774f)

Summary

✅ 59 untouched benchmarks

@codecov
Copy link

codecov bot commented Feb 8, 2026

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 98.75%. Comparing base (d92774f) to head (7dcf762).
⚠️ Report is 2 commits behind head on master.
✅ All tests successful. No failed tests found.

Additional details and impacted files
@@            Coverage Diff             @@
##           master   #12040      +/-   ##
==========================================
- Coverage   98.76%   98.75%   -0.01%     
==========================================
  Files         127      127              
  Lines       44667    44667              
  Branches     2372     2372              
==========================================
- Hits        44114    44113       -1     
  Misses        393      393              
- Partials      160      161       +1     
Flag Coverage Δ
CI-GHA 98.61% <ø> (-0.01%) ⬇️
OS-Linux 98.35% <ø> (ø)
OS-Windows 96.71% <ø> (+<0.01%) ⬆️
OS-macOS 97.58% <ø> (-0.01%) ⬇️
Py-3.10.11 97.14% <ø> (+<0.01%) ⬆️
Py-3.10.19 97.62% <ø> (ø)
Py-3.11.14 97.82% <ø> (ø)
Py-3.11.9 97.34% <ø> (-0.01%) ⬇️
Py-3.12.10 97.44% <ø> (ø)
Py-3.12.12 97.92% <ø> (ø)
Py-3.13.11 98.17% <ø> (-0.01%) ⬇️
Py-3.14.2 98.15% <ø> (-0.01%) ⬇️
Py-3.14.3t ?
Py-pypy3.11.13-7.3.20 97.38% <ø> (-0.02%) ⬇️
VM-macos 97.58% <ø> (-0.01%) ⬇️
VM-ubuntu 98.35% <ø> (ø)
VM-windows 96.71% <ø> (+<0.01%) ⬆️

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

@veeceey
Copy link
Contributor Author

veeceey commented Feb 12, 2026

Closing as duplicate of #12041 which has slightly cleaner wording.

@veeceey veeceey closed this Feb 12, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

ujson library mentioned in the documentation is deprecated

1 participant

Comments