[WIP] changes for next release 3.11.0

[nlohmann]

This thread collects all changes made since the 3.10.5 (#3238) release.

New features

• Allow to use std::string_view as object keys in at, operator[], value, erase, find, count, and contains to avoid unnecessary allocations.
  • Implement support for string_view (attempt no. 3) #3423
  • How can I use std::string_view as the json_key to "operator []" ? #1529
  • ordered_json doesn't accept keys of types other than string_t (e.g., string_view) #3558
  • Add overloads for more key types to ordered_map and fix ordered_map::erase(first, last) with first == last #3564
• Add support to read and write the UBJSON-derived Binary JData (BJData) format.
  • Support UBJSON-derived Binary JData (BJData) format #3336
  • json:parse_bjdata_fuzzer reaches assertion #3461
  • Handle invalid BJData optimized type, fix #3461 #3463
  • json:parse_bjdata_fuzzer reaches assertion #3475
  • change bjdata ndarray flag to detect negative size, as part of #3475 #3479
  • Updated BJData documentation, #3464 #3493
  • UBSAN error while parsing BJData (Null-dereference) #3491
  • ASAN error while parsing BJData (Heap-buffer-overflow READ 1) #3492
  • UBSAN error while parsing BJData (Invalid-bool-value) #3490
  • Discard optimized containers with negative counts in UBJSON/BJData (#3491,#3492,#3490) #3500
  • prevent ndarray dimension vector from recusive array, nlohmann/json#3500 #3502
  • Binary reader for BJData creates incorrect SAX events #3503
  • Prevent ndarray size vector from recursive use, fix nlohmann/json#3503 #3505
  • ASSERT error while parsing BJData #3513
  • Fix nlohmann/json#3513, explain is_ndarray flag #3514
  • Error when roundtripping BJData #3519
  • Fix ndarray dimension signedness, fix ndarray length overflow (2); add 32bit unit test #3523
  • json:parse_bjdata_fuzzer: ASSERT: ref_stack.back()->is_array() #3541
  • BJData dimension length can not be string_t::npos, fix #3541 #3543

Bug fixes

• fix creation of ordered_json object from initializer list
  • switch from json to ordered_json #3342
  • switch from json to ordered_json #3343
  • Fix ordered_map ctor with initializer_list (fixes #3343) #3370
• fix compilation problems in C++20/GCC 12
  • build failure on upcoming gcc-12: test/src/unit-regression1.cpp:392:22: error: ambiguous overload for 'operator=' #3138
  • Fix C++20/gcc-12 issues (Part 1) #3379
• make iterator satisfy std::incrementable
  • Iterator doesn't satisfy std::incrementable because post-increment may change constness #3331
  • Make iterator operator++/--(int) equality-preserving #3332
• exclude std::any from implicit conversion
  • Error occurred when converting nlohmann::json to std::any #3428
  • Exclude std::any from implicit conversion (fixes #3428) #3437
• fix constraints on from_json() for strings
  • Deserialization: if class is_constructible from std::string wrong from_json overload is being selected, compilation failed #3171
  • Perplexing template deduction failure serialising a 3rd party type using base class #3267
  • Parse to custom class from unordered_json breaks on G++11.2.0 with C++20 #3312
  • Unit tests conversions & items fail to build (Clang <4.0/C++14 only) #3384
  • Fix constraints on from_json() for strings (fixes #3171, #3267, #3312, #3384) #3427
  • Parse to custom class from unordered_json breaks on G++11.2.0 with C++20 #3312
  • Starting with 3.10.4, just adding #include json.hpp causes compile error: `overload resolution selected deleted operator '=' #3620
• Iterators cannot be used with range-v3
  • Iterators cannot be used with range-v3 #3130
  • Fix C++20/gcc-12 issues (Part 2) #3446
• Tests failing when compiling with c++20
  • Tests failing when compiling with c++20 #3207
  • Fix C++20/gcc-12 issues (Part 2) #3446
  • Compilation with -fmodules-ts and use inside of a module #3472
• Comparison of NaN differs between json and float
  • Comparison of NaN differs between json and float #3409
  • Fix C++20/gcc-12 issues (Part 2) #3446
• Re-add value_type detection to distinguish string types
  • ambiguous regression #3204
  • Ambiguous conversion from nlohmann::basic_json<> to custom class. #3333
  • Re-add value_type detection to distinguish string types #3604
  • xwidgets doesn't compile with version >3.10.3 #3602
  • Add regression tests for #3204 and #3333 #3629
• Add operator<<(json_pointer) to fix regression after 3.10.0 release
  • json_pointer__pop_back.cpp example does not compile #3600
  • Add operator<<(json_pointer) #3601
• Fix: Applying JSON patch creates parent object
  • Applying JSON patch creates parent object #3134
  • Fixed patch::add creating non-existent parents. #3199
  • Fix patch::add creating nonexistent parents #3628
• Fixed latest build error in MSVC platform
  • Fixed latest build error in msvc platform #3630

Improvements

• Allow default values for NLOHMANN_DEFINE_TYPE_INTRUSIVE and NLOHMANN_DEFINE_TYPE_NON_INTRUSIVE
  • Allow default values for NLOHMANN_DEFINE_TYPE_INTRUSIVE and NLOHMANN_DEFINE_TYPE_NON_INTRUSIVE #2819
  • Add macros NLOHMANN_DEFINE_TYPE_INTRUSIVE_WITH_DEFAULT and ..._NON_INTRUSIVE_WITH_DEFAULT #3143
• Avoid clash with Arduino defines
  • Avoid clash with Arduino defines #3338
• improve meta() for MSVC
  • Report the right __cplusplus value for MSVC in basic_json meta() #3417
• check if different version of library is already included
  • Add check if different version is also included #3418
• re-template json_pointer on string type
  • Re-template json_pointer on string type #3415
• allow to create booleans from std::vector<bool>::reference
  • Boolean value in array [is it possible?] #3533
  • Add to_json() for std::vector<bool>::reference #3534
• allow to use array types where iterators are pointers
  • Use std::iterator_traits to extract iterator_category #3544
• fix a -Wpragmas warning in GCC <11
  • Use DOCTEST_* compiler macros and suppress pragmas warning #3550
• optimize performance of output vector adapter
  • Optimize output vector adapter write #3569
• add patch_inplace function to apply patches without copying
  • add patch_inplace function #3581
  • Clean up after #3581 #3596
• Use swap by ADL to allow swapping with non-std containers; also improve error messages
  • Use swap() by ADL #3609
• Add versioned, ABI-tagged inline namespace
  • Using versioned namespaces #1539
  • Mixing different JSON_DIAGNOSTICS settings in separately compiled units leads to core #3360
  • Multiple versions causing conflict #3588
  • Add versioned, ABI-tagged inline namespace and namespace macros #3590
• Move UDLs out of global namespace
  • Consider putting the user-defined literals in a namespace #1682
  • Move UDLs out of the global namespace #3605
• Fix ICPC warning 1098:
  • ICPC: warning #1098: the qualifier on this friend declaration is ignored #3632
  • Fix warning #3634

Further Changes

• fix _MSC_VER version to check for std::filesystem
  • fix _MSC_VER version to check for std::filesystem #3240
• remove stringstream usage
  • Replace use of standard IO from error handling #3239
  • Remove stringstream #3244
• add more examples to documentation
  • Complete documentation for 3.11.0 #3464
• improve documentation on supported types of parse and accept
  • Add a function that checks for valid json in a C++ string  #3245
  • Improve documentation InputType and IteratorType #3246
• add documentation on how to parse JSON Lines input
  • Add documentation for JSON Lines #3247
• fix typos
  • Fix typo #3249
  • Fix a typo #3265
  • at.md: fix typo #3426
  • Fix typo in basic_json documentation #3439
  • documents: fix typos in iterators.md #3481
  • Update json.hpp #3499
• add maintainer targets to create source archive
  • Add maintainer targets to create source archive #3289
  • Small release asset for CMake's FetchContent #3255
• add support for Visual Studio 2022
  • .github/workflows/windows.yml: Add support for Visual Studio 2022 #3295
• document parsing to ordered_json
  • Documentation for ordered_json should show proper use of the parse() function. #3325
  • Add note on parsing ordered_json #3326
• fix CITATION.cff
  • Fix CITATION.cff and add automatic validation of your citation metadata #3320
• adjust GitHub Actions CI wrt. windows-latest image (by @falbrechtskirchinger)
  • Fix and update CI #3368
• use FetchContent_MakeAvailable in examples
  • Why not use FetchContent_MakeAvailable()? #3345
  • FetchContent_MakeAvailable #3351
• document requirement of using the same definition of JSON_DIAGNOSTICS in all linked objects
  • Mixing different JSON_DIAGNOSTICS settings in separately compiled units leads to core #3360
  • Add clarification to avoid misunderstanding that cause #3360 #3378
• improve unit tests
  • Improve unit testing (Part 1) #3380
  • Refactor unit tests to use more convenient doctest assertion macros #3393
  • Refactor unit tests to use more convenient doctest assertion macros #3365
  • Refactor unit tests to use more convenient doctest assertion macros (Part 2) #3405
  • Regression test for #3070 is not being run and fails when enabled #3377
  • Restore disabled check for #3070 (except on MSVC) #3421
  • CI: speedup AppVeyor builds by ~30% #3422
• overwork bug template
  • Add proper issue templates #3348
• remove deprecated windows-2016 image
  • CI: windows-2016 has been deprecated; remove jobs #3416
• speed up AppVeyor CI
  • CI: speedup AppVeyor builds by ~30% #3422
• update CI image
  • Update CI image #3420
• add script to test local version in Compiler Explorer
  • Enable rapid testing and development on Compiler Explorer #3456
• use The Pitchfork Layout (PFL)
  • Reorganize directories #3462
• add documentation of macros and runtime assertions
  • Overwork documentation #3444
  • Document which version introduced the macros #3431
• update Cpplint
  • cpplint 1.6.0 #3454
• disable regression test on GCC <8.4
  • Disable regression test for #3070 on GCC <8.4 #3451
• add build step for ICPC to CI
  • Add build step for ICPC (with fixes) #3465
• documented fuzz testing
  • Add documentation how to use fuzzers #3477
  • Document fuzzer usage #3478
• add more Xcode versions to the CI
  • Add more macOS builders #3485
• fix documentation of JSON Pointer
  • json_pointer not functioning as expected from docs #3511
  • Small documentation fixes #3520
• add tests for 32 bit
  • Enable 32bit unit test in CI #3524
  • CI: Enable 32bit unit test #3529
  • CI: Enable 32bit unit test (simplified) #3530
  • CI: Enable 32bit unit test (3) #3532
• change the default value CMake parameter JSON_MultipleHeader to ON to always use the multi-header version unless specified otherwise
  • CI: Enable 32bit unit test (3) #3532
• add option to disable default enum conversions
  • Allow disabling default enum conversions #3536
• fix "JSON_MultipleHeaders" option spelling in CI
  • CI: fix "JSON_MultipleHeaders" option spelling #3555
• more intermediate folders from Visual Studio Code are added to .gitignore
  • Ignore output directory #3572
• increase timeout for Unicode tests
  • unicode4 test consistently fails on RISC-V hardware #3579
  • Enable overriding test properties and set Unicode test timeouts #3580
  • Fix Unicode test timeout (for real this time!) #3614
• add badge for https://repology.org/project/nlohmann-json/versions
  • Add badge for https://repology.org/project/nlohmann-json/versions #3586
• make certain usage patterns more prominent in the README
  • Make certain usage patterns more prominent in the README #3557
• use REUSE licensing framework
  • Use REUSE framework #3546
  • Add license header to new files #3633
  • Prepare 3.11.0 release #3635
• add error message if test suite cannot be found
  • ERROR: ThreadSanitizer: SEGV on unknown address #3584
  • Add error message if test suite cannot be found #3585
• document precondition for parsing from FILE * and add assertion
  • Add assertion if nullptr is passed to parse function #3593
• improve documentation
  • Minor documentation fixes #3592
• add unit test to make sure iterator_input_adapter advances iterators correctly
  • Add unit test to make sure iterator_input_adapter advances iterators correctly #3548
• Add documentation for comparing json and ordered_json
  • ordered_json vs json types comparison #3443
  • Add documentation for comparing json and ordered_json #3599
• About CI runs on newer commits on the same branch
  • Use 'concurrency' in GitHub workflows #3610
• Fix MinGW CI failures
  • Fix MinGW CI failures #3618
• Install .pc and .cmake files to share directory
  • build: install .pc and .cmake files to share/ #3619
• Adjust JSON Pointer examples and add CI step for the examples
  • Adjust JSON Pointer examples #3622
• Disable exceptions on ICPC
  • Disable exceptions on ICPC #3621
• Add a unit test including <windows.h>
  • Add a unit test including windows.h #3631
• Overwork documentation and add more examples
  • More documentation updates for 3.11.0 #3553

[engine5d]

hi, when will be the release 3.11.0 published?

[falbrechtskirchinger]

I'd like to scan through my WIP branches for small things that can/should go into 3.11.0. For example, I'd like to at least include an assertion to deal with #3425/#2649. I'm also aware of a compile issue with -Werror=strict-overflow on GCC 12 newer than the one in the json-ci image.
Slightly bigger things like API parity ("missing" json_pointer overloads) would also be nice.

[nlohmann]

The 3.11.0 release is already way too late. As always, I would like to release more often, but something always comes up...

[falbrechtskirchinger]

I completely understand. I'll make an effort to get the small things (couple of lines each) in over the weekend.

[falbrechtskirchinger]

@nlohmann Did you want to mention the "JSON_MultipleHeader=ON" change (part of #3532) specifically?

[nlohmann]

Thanks, done.

[nlohmann]

@falbrechtskirchinger @gregmarr What would you like to see in the 3.11.0? I am thinking of:

• More documentation updates for 3.11.0 #3553
• Add versioned, ABI-tagged inline namespace and namespace macros #3590

Apart of that, I think we should have a kind of feature-freeze and focus on documentation (and release notes) for a while and get the 3.11.0 finally through the door.

I am traveling next week and should have some time in the first week of August.

What do you think?

[nlohmann]

I'm not alone. This has been discussed in nvie/gitflow#49 and was addressed somehow. Trying to figure out what flag you'd need to set.

Two questions:

• Is the tag's commit now as you expected?
• I realized that the repo's master branch is gone. Is that expected with the newer git-flow?

[nlohmann]

Even worse, my release script fails now. :-/

[falbrechtskirchinger]

Since I don't use git flow myself, I've no idea.

[falbrechtskirchinger]

Oh, and yes. :-) git describe --tags is producing the output I expect.

[nlohmann]

Since I don't use git flow myself, I've no idea.

After the 3.11.1 release, there is still a master branch, so that seems to work now.

[falbrechtskirchinger]

#3199 is another nice-to-have bug fix for 3.11.0. I might update that PR over the weekend since the original author hasn't responded.

[nlohmann]

All planned PRs are merged. Here are my proposed release notes - feedback more than welcome (cc @falbrechtskirchinger @gregmarr). Going to bed now and hoping to get this out tomorrow. Note in GitHub's release page, issues/PRs are just linked with a number and not with icon/title like here.

---

Summary

Version 3.11.0 one of the biggest release (in terms of closed issues and merged pull requests) ever. This version brings:

• String view support for all functions working on object keys (e.g., at or operator[]). This allows to avoid unnecessary allocations.
• BJData as fifth supported binary format beside BSON, CBOR, MessagePack, and UBJSON.
• Better C++20 support to make the library integrate more smoothly to newer code bases.
• Better support for avoiding problems when multiple versions of the library are used in the same project.
• Even better and more extensive documentation and examples.
• More tests for edge cases like 32-bit support, C++20 features, using the library with ICPC, or after including <windows.h>.

All changes are backward-compatible.

💰 Note you can support this project via GitHub sponsors or PayPal.

✨ New Features

• Allow to use std::string_view as object keys in at, operator[], value, erase, find, contains, and count to avoid unnecessary allocations. Implement support for string_view (attempt no. 3) #3423, How can I use std::string_view as the json_key to "operator []" ? #1529, ordered_json doesn't accept keys of types other than string_t (e.g., string_view) #3558, Add overloads for more key types to ordered_map and fix ordered_map::erase(first, last) with first == last #3564
• Add support to read and write the UBJSON-derived Binary JData (BJData) format (see documentation). Support UBJSON-derived Binary JData (BJData) format #3336, json:parse_bjdata_fuzzer reaches assertion #3461, Handle invalid BJData optimized type, fix #3461 #3463, json:parse_bjdata_fuzzer reaches assertion #3475, change bjdata ndarray flag to detect negative size, as part of #3475 #3479, Updated BJData documentation, #3464 #3493, UBSAN error while parsing BJData (Null-dereference) #3491, ASAN error while parsing BJData (Heap-buffer-overflow READ 1) #3492, UBSAN error while parsing BJData (Invalid-bool-value) #3490, Discard optimized containers with negative counts in UBJSON/BJData (#3491,#3492,#3490) #3500, prevent ndarray dimension vector from recusive array, nlohmann/json#3500 #3502, Binary reader for BJData creates incorrect SAX events #3503, Prevent ndarray size vector from recursive use, fix nlohmann/json#3503 #3505, ASSERT error while parsing BJData #3513, Fix nlohmann/json#3513, explain is_ndarray flag #3514, Error when roundtripping BJData #3519, Fix ndarray dimension signedness, fix ndarray length overflow (2); add 32bit unit test #3523, json:parse_bjdata_fuzzer: ASSERT: ref_stack.back()->is_array() #3541, BJData dimension length can not be string_t::npos, fix #3541 #3543

🐛 Bug fixes

• Allow creation of ordered_json objects from initializer lists. switch from json to ordered_json #3342, switch from json to ordered_json #3343, Fix ordered_map ctor with initializer_list (fixes #3343) #3370
• Fix failing tests when compiling with C++20 and add support for operator<=>. Tests failing when compiling with c++20 #3207, Fix C++20/gcc-12 issues (Part 2) #3446, Compilation with -fmodules-ts and use inside of a module #3472
• Fix comparison-related compilation problems in C++20 on GCC 12. build failure on upcoming gcc-12: test/src/unit-regression1.cpp:392:22: error: ambiguous overload for 'operator=' #3138, Fix C++20/gcc-12 issues (Part 1) #3379
• Make iterator satisfy std::incrementable. Iterator doesn't satisfy std::incrementable because post-increment may change constness #3331, Make iterator operator++/--(int) equality-preserving #3332
• Exclude std::any from implicit conversion. Error occurred when converting nlohmann::json to std::any #3428, Exclude std::any from implicit conversion (fixes #3428) #3437
• Fix constraints on from_json() for strings. Deserialization: if class is_constructible from std::string wrong from_json overload is being selected, compilation failed #3171, Perplexing template deduction failure serialising a 3rd party type using base class #3267, Parse to custom class from unordered_json breaks on G++11.2.0 with C++20 #3312, Unit tests conversions & items fail to build (Clang <4.0/C++14 only) #3384, Fix constraints on from_json() for strings (fixes #3171, #3267, #3312, #3384) #3427, Parse to custom class from unordered_json breaks on G++11.2.0 with C++20 #3312, Starting with 3.10.4, just adding #include json.hpp causes compile error: `overload resolution selected deleted operator '=' #3620
• Make iterators usable with range-v3. Iterators cannot be used with range-v3 #3130, Fix C++20/gcc-12 issues (Part 2) #3446
• Fix comparison of NaN values to json to behave like float. Comparison of NaN differs between json and float #3409, Fix C++20/gcc-12 issues (Part 2) #3446
• Add operator<<(json_pointer) to fix regression after 3.10.0 release. json_pointer__pop_back.cpp example does not compile #3600, Add operator<<(json_pointer) #3601
• Fix JSON Patch to not create missing parent objects. Applying JSON patch creates parent object #3134, Fixed patch::add creating non-existent parents. #3199, Fix patch::add creating nonexistent parents #3628
• Re-add value_type detection to distinguish string types (was broken after 3.10.5 release). ambiguous regression #3204, Ambiguous conversion from nlohmann::basic_json<> to custom class. #3333, Re-add value_type detection to distinguish string types #3604, xwidgets doesn't compile with version >3.10.3 #3602, Add regression tests for #3204 and #3333 #3629
• Fix latest build error in MSVC platform (was broken after 3.10.5 release). Fixed latest build error in msvc platform #3630

⚡ Improvements

• Allow default values for NLOHMANN_DEFINE_TYPE_INTRUSIVE and NLOHMANN_DEFINE_TYPE_NON_INTRUSIVE. Allow default values for NLOHMANN_DEFINE_TYPE_INTRUSIVE and NLOHMANN_DEFINE_TYPE_NON_INTRUSIVE #2819, Add macros NLOHMANN_DEFINE_TYPE_INTRUSIVE_WITH_DEFAULT and ..._NON_INTRUSIVE_WITH_DEFAULT #3143
• Avoid clash with Arduino defines. Avoid clash with Arduino defines #3338
• Improve meta output for MSVC. Report the right __cplusplus value for MSVC in basic_json meta() #3417
• Check and warn if different version of library is already included (see JSON_SKIP_LIBRARY_VERSION_CHECK). Add check if different version is also included #3418
• Re-template json_pointer on string type. Re-template json_pointer on string type #3415
• Allow to create booleans from std::vector<bool>::reference. Boolean value in array [is it possible?] #3533, Add to_json() for std::vector<bool>::reference #3534
• Allow to use array types where iterators are pointers. Use std::iterator_traits to extract iterator_category #3544
• Improve performance of writing binary formats to byte vectors. Optimize output vector adapter write #3569
• Add patch_inplace function to apply patches without copying. add patch_inplace function #3581, Clean up after #3581 #3596
• Use swap by ADL to allow swapping with non-std containers and improve error messages. Use swap() by ADL #3609
• Add versioned, ABI-tagged inline namespace (see NLOHMANN_JSON_NAMESPACE) to avoid ABI errors when linking different versions of the library. Using versioned namespaces #1539, Mixing different JSON_DIAGNOSTICS settings in separately compiled units leads to core #3360, Multiple versions causing conflict #3588, Add versioned, ABI-tagged inline namespace and namespace macros #3590
• Move UDLs out of global namespace (see JSON_USE_GLOBAL_UDLS) to avoid ABI errors when linking different versions of the library. Consider putting the user-defined literals in a namespace #1682, Move UDLs out of the global namespace #3605

Warnings

• Fix ICPC warning 1098. ICPC: warning #1098: the qualifier on this friend declaration is ignored #3632, Fix warning #3634
• Fix a -Wpragmas warning in GCC <11. Use DOCTEST_* compiler macros and suppress pragmas warning #3550

🔨 Further Changes

• Fix _MSC_VER version to check for std::filesystem. fix _MSC_VER version to check for std::filesystem #3240
• Remove <sstream> dependency. Replace use of standard IO from error handling #3239, Remove stringstream #3244
• Overwork bug template to systematically request information. Add proper issue templates #3348
• Add script to test local version in Compiler Explorer. Enable rapid testing and development on Compiler Explorer #3456
• Change the default value CMake parameter JSON_MultipleHeader to ON to always use the multi-header version unless specified otherwise. CI: Enable 32bit unit test (3) #3532
• Add option to disable default enum conversions (see JSON_DISABLE_ENUM_SERIALIZATION). Allow disabling default enum conversions #3536
• Add maintainer targets to create source archive json.tar.xz which can be used in FetchContent. Add maintainer targets to create source archive #3289, Small release asset for CMake's FetchContent #3255
• Fix CITATION.cff. Fix CITATION.cff and add automatic validation of your citation metadata #3320
• Use The Pitchfork Layout (PFL). Reorganize directories #3462
• Update Cpplint. cpplint 1.6.0 #3454
• More intermediate folders from Visual Studio Code are added to .gitignore. Ignore output directory #3572
• Add badge for https://repology.org/project/nlohmann-json/versions. Add badge for https://repology.org/project/nlohmann-json/versions #3586
• Use REUSE licensing framework. Use REUSE framework #3546 , Add license header to new files #3633, Prepare 3.11.0 release #3635
• Install .pc and .cmake files to share directory. build: install .pc and .cmake files to share/ #3619

CI

• Add support for Visual Studio 2022., .github/workflows/windows.yml: Add support for Visual Studio 2022 #3295
• Adjust GitHub Actions CI wrt. windows-latest image. Fix and update CI #3368
• Remove deprecated windows-2016 image. CI: windows-2016 has been deprecated; remove jobs #3416
• Speed up AppVeyor CI. CI: speedup AppVeyor builds by ~30% #3422
• Update CI image to check with ICPC, GCC 11 and Clang 14. Update CI image #3420
• Add build step for ICPC to CI. Add build step for ICPC (with fixes) #3465
• Add more Xcode versions (13.3.1, 13.3, 13.2.1, 13.2, and 13.1) to the CI. Add more macOS builders #3485
• Fix "JSON_MultipleHeaders" option spelling in CI. CI: fix "JSON_MultipleHeaders" option spelling #3555
• Increase timeout for Unicode tests. unicode4 test consistently fails on RISC-V hardware #3579, Enable overriding test properties and set Unicode test timeouts #3580, Fix Unicode test timeout (for real this time!) #3614
• Abort CI runs on newer commits on the same branch. Use 'concurrency' in GitHub workflows #3610
• Fix MinGW CI failures. Fix MinGW CI failures #3618
• Disable exceptions on ICPC. Disable exceptions on ICPC #3621

Unit tests

• Improve unit tests. Improve unit testing (Part 1) #3380, Refactor unit tests to use more convenient doctest assertion macros #3393, Refactor unit tests to use more convenient doctest assertion macros #3365, Refactor unit tests to use more convenient doctest assertion macros (Part 2) #3405, Regression test for #3070 is not being run and fails when enabled #3377, Restore disabled check for #3070 (except on MSVC) #3421, CI: speedup AppVeyor builds by ~30% #3422
• Disable regression test on GCC <8.4. Disable regression test for #3070 on GCC <8.4 #3451
• Add tests for 32 bit. Enable 32bit unit test in CI #3524, CI: Enable 32bit unit test #3529, CI: Enable 32bit unit test (simplified) #3530, CI: Enable 32bit unit test (3) #3532
• Add error message if test suite cannot be found. ERROR: ThreadSanitizer: SEGV on unknown address #3584, Add error message if test suite cannot be found #3585
• Add unit test to make sure iterator_input_adapter advances iterators correctly. Add unit test to make sure iterator_input_adapter advances iterators correctly #3548
• Add a unit test including <windows.h>. Add a unit test including windows.h #3631

Documentation and examples

• Add more examples to documentation. Complete documentation for 3.11.0 #3464
• Improve documentation on supported types of parse and accept. Add a function that checks for valid json in a C++ string  #3245, Improve documentation InputType and IteratorType #3246
• Add documentation on how to parse JSON Lines input. Add documentation for JSON Lines #3247
• Fix typos. Fix typo #3249, Fix a typo #3265, at.md: fix typo #3426, Fix typo in basic_json documentation #3439, documents: fix typos in iterators.md #3481, Update json.hpp #3499
• Document parsing to ordered_json. Documentation for ordered_json should show proper use of the parse() function. #3325, Add note on parsing ordered_json #3326
• Use FetchContent_MakeAvailable in examples. Why not use FetchContent_MakeAvailable()? #3345, FetchContent_MakeAvailable #3351
• Document requirement of using the same definition of JSON_DIAGNOSTICS in all linked objects. Mixing different JSON_DIAGNOSTICS settings in separately compiled units leads to core #3360, Add clarification to avoid misunderstanding that cause #3360 #3378
• Document fuzz testing. Add documentation how to use fuzzers #3477, Document fuzzer usage #3478
• Add documentation of macros and runtime assertions. Overwork documentation #3444, Document which version introduced the macros #3431
• Fix documentation of JSON Pointer. json_pointer not functioning as expected from docs #3511, Small documentation fixes #3520
• Make certain usage patterns more prominent in the README. Make certain usage patterns more prominent in the README #3557
• Document precondition for parsing from FILE * and add assertion. Add assertion if nullptr is passed to parse function #3593
• Improve documentation. Minor documentation fixes #3592
• Add documentation for comparing json and ordered_json. ordered_json vs json types comparison #3443, Add documentation for comparing json and ordered_json #3599
• Adjust JSON Pointer examples and add CI step for the examples. Adjust JSON Pointer examples #3622
• Overwork documentation and add more examples. More documentation updates for 3.11.0 #3553

🔥 Deprecated functions

The implicit conversion from JSON Pointers to string (json_pointer::operator string_t) has been deprecated. Use json_pointer::to_string instead.

The following functions have been deprecated in earlier versions and will be removed in the next major version (i.e., 4.0.0):

• Function iterator_wrapper are deprecated. Please use the member function items() instead.
• Functions friend std::istream& operator<<(basic_json&, std::istream&) and friend std::ostream& operator>>(const basic_json&, std::ostream&) are deprecated. Please use friend std::istream& operator>>(std::istream&, basic_json&) and friend operator<<(std::ostream&, const basic_json&) instead.
• Passing iterator pairs or pointer/length pairs to parsing functions (basic_json::parse, basic_json::accept, basic_json::sax_parse, basic_json::from_cbor, basic_json::from_msgpack, basic_json::from_ubjson, basic_json::from_bson) via initializer lists is deprecated. Instead, pass two iterators; for instance, call basic_json::from_cbor(ptr, ptr+len) instead of basic_json::from_cbor({ptr, len}).

All deprecations are annotated with HEDLEY_DEPRECATED_FOR to report which function to use instead.

[falbrechtskirchinger]

Can you please put this up as a Gist? I've quite a few notes.

Or create a PR.

[falbrechtskirchinger]

FYI, you have a bunch of Doxygen links in there that don't work. Some can be replaced, others have no equivalent in the new documentation.

[nlohmann]

I’ll check later. Thanks for reviewing!

[falbrechtskirchinger]

The first pass is done. I've removed the dead Doxygen links and substituted mkdocs ones where possible.

[nlohmann]

Thanks everybody! The 3.11.0 is finally released!!!

[nlohmann]

FYI: #3641