[
{
"path": ".github/FUNDING.yml",
"content": "github: dtolnay\n"
},
{
"path": ".github/ISSUE_TEMPLATE/1-problem.md",
"content": "---\nname: Problem\nabout: Something does not seem right\n\n---\n\n\n"
},
{
"path": ".github/ISSUE_TEMPLATE/2-suggestion.md",
"content": "---\nname: Suggestion\nabout: Share how Serde could support your use case better\n\n---\n\n\n"
},
{
"path": ".github/ISSUE_TEMPLATE/3-documentation.md",
"content": "---\nname: Documentation\nabout: Certainly there is room for improvement\n\n---\n\n\n"
},
{
"path": ".github/ISSUE_TEMPLATE/4-other.md",
"content": "---\nname: Anything else!\nabout: Whatever is on your mind\n\n---\n\n\n"
},
{
"path": ".github/workflows/ci.yml",
"content": "name: CI\n\non:\n push:\n pull_request:\n workflow_dispatch:\n schedule: [cron: \"40 1 * * *\"]\n\npermissions:\n contents: read\n\nenv:\n RUSTFLAGS: -Dwarnings\n\njobs:\n test:\n name: Test suite\n runs-on: ubuntu-latest\n timeout-minutes: 45\n steps:\n - uses: actions/checkout@v6\n - uses: dtolnay/rust-toolchain@nightly\n - run: cd test_suite && cargo test --features unstable\n - uses: actions/upload-artifact@v6\n if: always()\n with:\n name: Cargo.lock\n path: Cargo.lock\n continue-on-error: true\n\n windows:\n name: Test suite (windows)\n runs-on: windows-latest\n timeout-minutes: 45\n steps:\n - uses: actions/checkout@v6\n - uses: dtolnay/rust-toolchain@nightly\n - run: cd test_suite && cargo test --features unstable -- --skip ui --exact\n\n stable:\n name: Rust ${{matrix.rust}}\n runs-on: ubuntu-latest\n strategy:\n fail-fast: false\n matrix:\n rust: [stable, beta]\n timeout-minutes: 45\n steps:\n - uses: actions/checkout@v6\n - uses: dtolnay/rust-toolchain@master\n with:\n toolchain: ${{matrix.rust}}\n - run: cd serde && cargo build --features rc\n - run: cd serde && cargo build --no-default-features\n - run: cd test_suite/no_std && cargo build\n\n nightly:\n name: Rust nightly${{matrix.os == 'windows' && ' (windows)' || ''}}\n runs-on: ${{matrix.os}}-latest\n strategy:\n fail-fast: false\n matrix:\n os: [ubuntu, windows]\n timeout-minutes: 45\n steps:\n - uses: actions/checkout@v6\n - uses: dtolnay/rust-toolchain@nightly\n - run: cd serde && cargo build\n - run: cd serde && cargo build --no-default-features\n - run: cd serde && cargo build --no-default-features --features alloc\n - run: cd serde && cargo build --no-default-features --features rc,alloc\n - run: cd serde && cargo build --no-default-features --features unstable\n - run: cd serde_core && cargo test --features rc,unstable\n - run: cd test_suite/no_std && cargo build\n if: matrix.os != 'windows'\n - run: cd serde_derive && cargo check --tests\n env:\n RUSTFLAGS: --cfg exhaustive ${{env.RUSTFLAGS}}\n if: matrix.os != 'windows'\n\n build:\n name: Rust ${{matrix.rust}}\n runs-on: ubuntu-latest\n strategy:\n fail-fast: false\n matrix:\n rust: [1.56.0, 1.60.0]\n timeout-minutes: 45\n steps:\n - uses: actions/checkout@v6\n - uses: dtolnay/rust-toolchain@master\n with:\n toolchain: ${{matrix.rust}}\n - run: sed -i '/\"test_suite\"/d' Cargo.toml\n - run: cd serde && cargo build --features rc\n - run: cd serde && cargo build --no-default-features\n - run: cd serde && cargo build --no-default-features --features alloc\n - run: cd serde && cargo build\n\n derive:\n name: Rust 1.71.0\n runs-on: ubuntu-latest\n timeout-minutes: 45\n steps:\n - uses: actions/checkout@v6\n - uses: dtolnay/rust-toolchain@1.71.0\n - run: |\n sed -i 's/proc-macro2 = { workspace = true/proc-macro2 = { version = \"1\"/' serde_derive*/Cargo.toml\n sed -i 's/quote = { workspace = true/quote = { version = \"1\"/' serde_derive*/Cargo.toml\n sed -i 's/syn = { workspace = true/syn = { version = \"2\"/' serde_derive*/Cargo.toml\n - run: cd serde && cargo check --no-default-features\n - run: cd serde && cargo check\n - run: cd serde_derive && cargo check\n\n minimal:\n name: Minimal versions\n runs-on: ubuntu-latest\n timeout-minutes: 45\n steps:\n - uses: actions/checkout@v6\n - uses: dtolnay/rust-toolchain@nightly\n - run: cargo generate-lockfile -Z minimal-versions\n - run: cargo check --locked --workspace\n\n doc:\n name: Documentation\n runs-on: ubuntu-latest\n timeout-minutes: 45\n env:\n RUSTDOCFLAGS: -Dwarnings\n steps:\n - uses: actions/checkout@v6\n - uses: dtolnay/rust-toolchain@nightly\n - uses: dtolnay/install@cargo-docs-rs\n - run: cargo docs-rs -p serde\n - run: cargo docs-rs -p serde_core\n - run: cargo docs-rs -p serde_derive\n - run: cargo docs-rs -p serde_derive_internals\n\n clippy:\n name: Clippy\n runs-on: ubuntu-latest\n if: github.event_name != 'pull_request'\n timeout-minutes: 45\n steps:\n - uses: actions/checkout@v6\n - uses: dtolnay/rust-toolchain@clippy\n - run: cd serde && cargo clippy --features rc,unstable -- -Dclippy::all -Dclippy::pedantic\n - run: cd serde_core && cargo clippy --features rc,unstable -- -Dclippy::all -Dclippy::pedantic\n - run: cd serde_derive && cargo clippy -- -Dclippy::all -Dclippy::pedantic\n - run: cd serde_derive_internals && cargo clippy -- -Dclippy::all -Dclippy::pedantic\n - run: cd test_suite && cargo clippy --tests --features unstable -- -Dclippy::all -Dclippy::pedantic\n - run: cd test_suite/no_std && cargo clippy -- -Dclippy::all -Dclippy::pedantic\n\n miri:\n name: Miri\n runs-on: ubuntu-latest\n timeout-minutes: 45\n steps:\n - uses: actions/checkout@v6\n - uses: dtolnay/rust-toolchain@miri\n - run: cargo miri setup\n - run: cd serde_core && cargo miri test --features rc,unstable\n env:\n MIRIFLAGS: -Zmiri-strict-provenance\n - run: cd test_suite && cargo miri test --features unstable\n env:\n MIRIFLAGS: -Zmiri-strict-provenance\n\n outdated:\n name: Outdated\n runs-on: ubuntu-latest\n if: github.event_name != 'pull_request'\n timeout-minutes: 45\n steps:\n - uses: actions/checkout@v6\n - uses: dtolnay/rust-toolchain@stable\n - uses: dtolnay/install@cargo-outdated\n - run: cargo outdated --workspace --exit-code 1\n"
},
{
"path": ".gitignore",
"content": "/target/\n/Cargo.lock\n"
},
{
"path": "CONTRIBUTING.md",
"content": "# Contributing to Serde\n\nSerde welcomes contribution from everyone in the form of suggestions, bug\nreports, pull requests, and feedback. This document gives some guidance if you\nare thinking of helping us.\n\n## Submitting bug reports and feature requests\n\nSerde development is spread across lots of repositories, but this serde-rs/serde\nrepository is always a safe choice for opening any issues related to Serde.\n\nWhen reporting a bug or asking for help, please include enough details so that\nthe people helping you can reproduce the behavior you are seeing. For some tips\non how to approach this, read about how to produce a [Minimal, Complete, and\nVerifiable example].\n\n[Minimal, Complete, and Verifiable example]: https://stackoverflow.com/help/mcve\n\nWhen making a feature request, please make it clear what problem you intend to\nsolve with the feature, any ideas for how Serde could support solving that\nproblem, any possible alternatives, and any disadvantages.\n\n## Running the test suite\n\nWe encourage you to check that the test suite passes locally before submitting a\npull request with your changes. If anything does not pass, typically it will be\neasier to iterate and fix it locally than waiting for the CI servers to run\ntests for you.\n\n##### In the [`serde_core`] directory\n\n```sh\n# Test all the example code in Serde documentation\ncargo test\n```\n\n##### In the [`test_suite`] directory\n\n```sh\n# Run the full test suite, including tests of unstable functionality\ncargo +nightly test --features unstable\n```\n\nNote that this test suite currently only supports running on a nightly compiler.\n\n[`serde_core`]: https://github.com/serde-rs/serde/tree/master/serde_core\n[`test_suite`]: https://github.com/serde-rs/serde/tree/master/test_suite\n\n## Conduct\n\nIn all Serde-related forums, we follow the [Rust Code of Conduct]. For\nescalation or moderation issues please contact Erick (erick.tryzelaar@gmail.com)\ninstead of the Rust moderation team.\n\n[Rust Code of Conduct]: https://www.rust-lang.org/policies/code-of-conduct\n"
},
{
"path": "Cargo.toml",
"content": "[workspace]\nmembers = [\n \"serde\",\n \"serde_core\",\n \"serde_derive\",\n \"serde_derive_internals\",\n \"test_suite\",\n]\nresolver = \"2\"\n\n[patch.crates-io]\nserde = { path = \"serde\" }\nserde_core = { path = \"serde_core\" }\nserde_derive = { path = \"serde_derive\" }\n\n[workspace.dependencies]\nproc-macro2 = { version = \"1.0.74\", default-features = false }\nquote = { version = \"1.0.35\", default-features = false }\nsyn = { version = \"2.0.81\", default-features = false }\n"
},
{
"path": "LICENSE-APACHE",
"content": " Apache License\n Version 2.0, January 2004\n http://www.apache.org/licenses/\n\nTERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION\n\n1. Definitions.\n\n \"License\" shall mean the terms and conditions for use, reproduction,\n and distribution as defined by Sections 1 through 9 of this document.\n\n \"Licensor\" shall mean the copyright owner or entity authorized by\n the copyright owner that is granting the License.\n\n \"Legal Entity\" shall mean the union of the acting entity and all\n other entities that control, are controlled by, or are under common\n control with that entity. For the purposes of this definition,\n \"control\" means (i) the power, direct or indirect, to cause the\n direction or management of such entity, whether by contract or\n otherwise, or (ii) ownership of fifty percent (50%) or more of the\n outstanding shares, or (iii) beneficial ownership of such entity.\n\n \"You\" (or \"Your\") shall mean an individual or Legal Entity\n exercising permissions granted by this License.\n\n \"Source\" form shall mean the preferred form for making modifications,\n including but not limited to software source code, documentation\n source, and configuration files.\n\n \"Object\" form shall mean any form resulting from mechanical\n transformation or translation of a Source form, including but\n not limited to compiled object code, generated documentation,\n and conversions to other media types.\n\n \"Work\" shall mean the work of authorship, whether in Source or\n Object form, made available under the License, as indicated by a\n copyright notice that is included in or attached to the work\n (an example is provided in the Appendix below).\n\n \"Derivative Works\" shall mean any work, whether in Source or Object\n form, that is based on (or derived from) the Work and for which the\n editorial revisions, annotations, elaborations, or other modifications\n represent, as a whole, an original work of authorship. For the purposes\n of this License, Derivative Works shall not include works that remain\n separable from, or merely link (or bind by name) to the interfaces of,\n the Work and Derivative Works thereof.\n\n \"Contribution\" shall mean any work of authorship, including\n the original version of the Work and any modifications or additions\n to that Work or Derivative Works thereof, that is intentionally\n submitted to Licensor for inclusion in the Work by the copyright owner\n or by an individual or Legal Entity authorized to submit on behalf of\n the copyright owner. For the purposes of this definition, \"submitted\"\n means any form of electronic, verbal, or written communication sent\n to the Licensor or its representatives, including but not limited to\n communication on electronic mailing lists, source code control systems,\n and issue tracking systems that are managed by, or on behalf of, the\n Licensor for the purpose of discussing and improving the Work, but\n excluding communication that is conspicuously marked or otherwise\n designated in writing by the copyright owner as \"Not a Contribution.\"\n\n \"Contributor\" shall mean Licensor and any individual or Legal Entity\n on behalf of whom a Contribution has been received by Licensor and\n subsequently incorporated within the Work.\n\n2. Grant of Copyright License. Subject to the terms and conditions of\n this License, each Contributor hereby grants to You a perpetual,\n worldwide, non-exclusive, no-charge, royalty-free, irrevocable\n copyright license to reproduce, prepare Derivative Works of,\n publicly display, publicly perform, sublicense, and distribute the\n Work and such Derivative Works in Source or Object form.\n\n3. Grant of Patent License. Subject to the terms and conditions of\n this License, each Contributor hereby grants to You a perpetual,\n worldwide, non-exclusive, no-charge, royalty-free, irrevocable\n (except as stated in this section) patent license to make, have made,\n use, offer to sell, sell, import, and otherwise transfer the Work,\n where such license applies only to those patent claims licensable\n by such Contributor that are necessarily infringed by their\n Contribution(s) alone or by combination of their Contribution(s)\n with the Work to which such Contribution(s) was submitted. If You\n institute patent litigation against any entity (including a\n cross-claim or counterclaim in a lawsuit) alleging that the Work\n or a Contribution incorporated within the Work constitutes direct\n or contributory patent infringement, then any patent licenses\n granted to You under this License for that Work shall terminate\n as of the date such litigation is filed.\n\n4. Redistribution. You may reproduce and distribute copies of the\n Work or Derivative Works thereof in any medium, with or without\n modifications, and in Source or Object form, provided that You\n meet the following conditions:\n\n (a) You must give any other recipients of the Work or\n Derivative Works a copy of this License; and\n\n (b) You must cause any modified files to carry prominent notices\n stating that You changed the files; and\n\n (c) You must retain, in the Source form of any Derivative Works\n that You distribute, all copyright, patent, trademark, and\n attribution notices from the Source form of the Work,\n excluding those notices that do not pertain to any part of\n the Derivative Works; and\n\n (d) If the Work includes a \"NOTICE\" text file as part of its\n distribution, then any Derivative Works that You distribute must\n include a readable copy of the attribution notices contained\n within such NOTICE file, excluding those notices that do not\n pertain to any part of the Derivative Works, in at least one\n of the following places: within a NOTICE text file distributed\n as part of the Derivative Works; within the Source form or\n documentation, if provided along with the Derivative Works; or,\n within a display generated by the Derivative Works, if and\n wherever such third-party notices normally appear. The contents\n of the NOTICE file are for informational purposes only and\n do not modify the License. You may add Your own attribution\n notices within Derivative Works that You distribute, alongside\n or as an addendum to the NOTICE text from the Work, provided\n that such additional attribution notices cannot be construed\n as modifying the License.\n\n You may add Your own copyright statement to Your modifications and\n may provide additional or different license terms and conditions\n for use, reproduction, or distribution of Your modifications, or\n for any such Derivative Works as a whole, provided Your use,\n reproduction, and distribution of the Work otherwise complies with\n the conditions stated in this License.\n\n5. Submission of Contributions. Unless You explicitly state otherwise,\n any Contribution intentionally submitted for inclusion in the Work\n by You to the Licensor shall be under the terms and conditions of\n this License, without any additional terms or conditions.\n Notwithstanding the above, nothing herein shall supersede or modify\n the terms of any separate license agreement you may have executed\n with Licensor regarding such Contributions.\n\n6. Trademarks. This License does not grant permission to use the trade\n names, trademarks, service marks, or product names of the Licensor,\n except as required for reasonable and customary use in describing the\n origin of the Work and reproducing the content of the NOTICE file.\n\n7. Disclaimer of Warranty. Unless required by applicable law or\n agreed to in writing, Licensor provides the Work (and each\n Contributor provides its Contributions) on an \"AS IS\" BASIS,\n WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or\n implied, including, without limitation, any warranties or conditions\n of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A\n PARTICULAR PURPOSE. You are solely responsible for determining the\n appropriateness of using or redistributing the Work and assume any\n risks associated with Your exercise of permissions under this License.\n\n8. Limitation of Liability. In no event and under no legal theory,\n whether in tort (including negligence), contract, or otherwise,\n unless required by applicable law (such as deliberate and grossly\n negligent acts) or agreed to in writing, shall any Contributor be\n liable to You for damages, including any direct, indirect, special,\n incidental, or consequential damages of any character arising as a\n result of this License or out of the use or inability to use the\n Work (including but not limited to damages for loss of goodwill,\n work stoppage, computer failure or malfunction, or any and all\n other commercial damages or losses), even if such Contributor\n has been advised of the possibility of such damages.\n\n9. Accepting Warranty or Additional Liability. While redistributing\n the Work or Derivative Works thereof, You may choose to offer,\n and charge a fee for, acceptance of support, warranty, indemnity,\n or other liability obligations and/or rights consistent with this\n License. However, in accepting such obligations, You may act only\n on Your own behalf and on Your sole responsibility, not on behalf\n of any other Contributor, and only if You agree to indemnify,\n defend, and hold each Contributor harmless for any liability\n incurred by, or claims asserted against, such Contributor by reason\n of your accepting any such warranty or additional liability.\n\nEND OF TERMS AND CONDITIONS\n"
},
{
"path": "LICENSE-MIT",
"content": "Permission is hereby granted, free of charge, to any\nperson obtaining a copy of this software and associated\ndocumentation files (the \"Software\"), to deal in the\nSoftware without restriction, including without\nlimitation the rights to use, copy, modify, merge,\npublish, distribute, sublicense, and/or sell copies of\nthe Software, and to permit persons to whom the Software\nis furnished to do so, subject to the following\nconditions:\n\nThe above copyright notice and this permission notice\nshall be included in all copies or substantial portions\nof the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF\nANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED\nTO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A\nPARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT\nSHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY\nCLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION\nOF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR\nIN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER\nDEALINGS IN THE SOFTWARE.\n"
},
{
"path": "README.md",
"content": "# Serde [![Build Status]][actions] [![Latest Version]][crates.io] [![serde msrv]][Rust 1.56] [![serde_derive msrv]][Rust 1.71]\n\n[Build Status]: https://img.shields.io/github/actions/workflow/status/serde-rs/serde/ci.yml?branch=master\n[actions]: https://github.com/serde-rs/serde/actions?query=branch%3Amaster\n[Latest Version]: https://img.shields.io/crates/v/serde.svg\n[crates.io]: https://crates.io/crates/serde\n[serde msrv]: https://img.shields.io/crates/msrv/serde.svg?label=serde%20msrv&color=lightgray\n[serde_derive msrv]: https://img.shields.io/crates/msrv/serde_derive.svg?label=serde_derive%20msrv&color=lightgray\n[Rust 1.56]: https://blog.rust-lang.org/2021/10/21/Rust-1.56.0/\n[Rust 1.71]: https://blog.rust-lang.org/2023/07/13/Rust-1.71.0/\n\n**Serde is a framework for *ser*ializing and *de*serializing Rust data structures efficiently and generically.**\n\n---\n\nYou may be looking for:\n\n- [An overview of Serde](https://serde.rs)\n- [Data formats supported by Serde](https://serde.rs/#data-formats)\n- [Setting up `#[derive(Serialize, Deserialize)]`](https://serde.rs/derive.html)\n- [Examples](https://serde.rs/examples.html)\n- [API documentation](https://docs.rs/serde)\n- [Release notes](https://github.com/serde-rs/serde/releases)\n\n## Serde in action\n\n\n\nClick to show Cargo.toml.\nRun this code in the playground.\n
\n\n```toml\n[dependencies]\n\n# The core APIs, including the Serialize and Deserialize traits. Always\n# required when using Serde. The \"derive\" feature is only required when\n# using #[derive(Serialize, Deserialize)] to make Serde work with structs\n# and enums defined in your crate.\nserde = { version = \"1.0\", features = [\"derive\"] }\n\n# Each data format lives in its own crate; the sample code below uses JSON\n# but you may be using a different one.\nserde_json = \"1.0\"\n```\n\n \n\n\n```rust\nuse serde::{Deserialize, Serialize};\n\n#[derive(Serialize, Deserialize, Debug)]\nstruct Point {\n x: i32,\n y: i32,\n}\n\nfn main() {\n let point = Point { x: 1, y: 2 };\n\n // Convert the Point to a JSON string.\n let serialized = serde_json::to_string(&point).unwrap();\n\n // Prints serialized = {\"x\":1,\"y\":2}\n println!(\"serialized = {}\", serialized);\n\n // Convert the JSON string back to a Point.\n let deserialized: Point = serde_json::from_str(&serialized).unwrap();\n\n // Prints deserialized = Point { x: 1, y: 2 }\n println!(\"deserialized = {:?}\", deserialized);\n}\n```\n\n## Getting help\n\nSerde is one of the most widely used Rust libraries so any place that Rustaceans\ncongregate will be able to help you out. For chat, consider trying the\n[#rust-questions] or [#rust-beginners] channels of the unofficial community\nDiscord (invite: ), the [#rust-usage] or\n[#beginners] channels of the official Rust Project Discord (invite:\n), or the [#general][zulip] stream in Zulip. For\nasynchronous, consider the [\\[rust\\] tag on StackOverflow][stackoverflow], the\n[/r/rust] subreddit which has a pinned weekly easy questions post, or the Rust\n[Discourse forum][discourse]. It's acceptable to file a support issue in this\nrepo but they tend not to get as many eyes as any of the above and may get\nclosed without a response after some time.\n\n[#rust-questions]: https://discord.com/channels/273534239310479360/274215136414400513\n[#rust-beginners]: https://discord.com/channels/273534239310479360/273541522815713281\n[#rust-usage]: https://discord.com/channels/442252698964721669/443150878111694848\n[#beginners]: https://discord.com/channels/442252698964721669/448238009733742612\n[zulip]: https://rust-lang.zulipchat.com/#narrow/stream/122651-general\n[stackoverflow]: https://stackoverflow.com/questions/tagged/rust\n[/r/rust]: https://www.reddit.com/r/rust\n[discourse]: https://users.rust-lang.org\n\n
\n\n#### License\n\n\nLicensed under either of Apache License, Version\n2.0 or MIT license at your option.\n\n\n
\n\n\nUnless you explicitly state otherwise, any contribution intentionally submitted\nfor inclusion in Serde by you, as defined in the Apache-2.0 license, shall be\ndual licensed as above, without any additional terms or conditions.\n\n"
},
{
"path": "crates-io.md",
"content": "\n\n**Serde is a framework for *ser*ializing and *de*serializing Rust data structures efficiently and generically.**\n\n---\n\nYou may be looking for:\n\n- [An overview of Serde](https://serde.rs)\n- [Data formats supported by Serde](https://serde.rs/#data-formats)\n- [Setting up `#[derive(Serialize, Deserialize)]`](https://serde.rs/derive.html)\n- [Examples](https://serde.rs/examples.html)\n- [API documentation](https://docs.rs/serde)\n- [Release notes](https://github.com/serde-rs/serde/releases)\n\n## Serde in action\n\n```rust\nuse serde::{Deserialize, Serialize};\n\n#[derive(Serialize, Deserialize, Debug)]\nstruct Point {\n x: i32,\n y: i32,\n}\n\nfn main() {\n let point = Point { x: 1, y: 2 };\n\n // Convert the Point to a JSON string.\n let serialized = serde_json::to_string(&point).unwrap();\n\n // Prints serialized = {\"x\":1,\"y\":2}\n println!(\"serialized = {}\", serialized);\n\n // Convert the JSON string back to a Point.\n let deserialized: Point = serde_json::from_str(&serialized).unwrap();\n\n // Prints deserialized = Point { x: 1, y: 2 }\n println!(\"deserialized = {:?}\", deserialized);\n}\n```\n\n## Getting help\n\nSerde is one of the most widely used Rust libraries so any place that Rustaceans\ncongregate will be able to help you out. For chat, consider trying the\n[#rust-questions] or [#rust-beginners] channels of the unofficial community\nDiscord (invite: ), the [#rust-usage]\nor [#beginners] channels of the official Rust Project Discord (invite:\n), or the [#general][zulip] stream in Zulip. For\nasynchronous, consider the [\\[rust\\] tag on StackOverflow][stackoverflow], the\n[/r/rust] subreddit which has a pinned weekly easy questions post, or the Rust\n[Discourse forum][discourse]. It's acceptable to file a support issue in this\nrepo but they tend not to get as many eyes as any of the above and may get\nclosed without a response after some time.\n\n[#rust-questions]: https://discord.com/channels/273534239310479360/274215136414400513\n[#rust-beginners]: https://discord.com/channels/273534239310479360/273541522815713281\n[#rust-usage]: https://discord.com/channels/442252698964721669/443150878111694848\n[#beginners]: https://discord.com/channels/442252698964721669/448238009733742612\n[zulip]: https://rust-lang.zulipchat.com/#narrow/stream/122651-general\n[stackoverflow]: https://stackoverflow.com/questions/tagged/rust\n[/r/rust]: https://www.reddit.com/r/rust\n[discourse]: https://users.rust-lang.org\n"
},
{
"path": "serde/Cargo.toml",
"content": "[package]\nname = \"serde\"\nversion = \"1.0.228\"\nauthors = [\"Erick Tryzelaar \", \"David Tolnay \"]\nbuild = \"build.rs\"\ncategories = [\"encoding\", \"no-std\", \"no-std::no-alloc\"]\ndescription = \"A generic serialization/deserialization framework\"\ndocumentation = \"https://docs.rs/serde\"\nedition = \"2021\"\nhomepage = \"https://serde.rs\"\nkeywords = [\"serde\", \"serialization\", \"no_std\"]\nlicense = \"MIT OR Apache-2.0\"\nreadme = \"crates-io.md\"\nrepository = \"https://github.com/serde-rs/serde\"\nrust-version = \"1.56\"\n\n[dependencies]\nserde_core = { version = \"=1.0.228\", path = \"../serde_core\", default-features = false, features = [\"result\"] }\nserde_derive = { version = \"1\", optional = true, path = \"../serde_derive\" }\n\n[package.metadata.playground]\nfeatures = [\"derive\", \"rc\"]\n\n[package.metadata.docs.rs]\nfeatures = [\"derive\", \"rc\", \"unstable\"]\ntargets = [\"x86_64-unknown-linux-gnu\"]\nrustdoc-args = [\n \"--generate-link-to-definition\",\n \"--generate-macro-expansion\",\n \"--extern-html-root-url=core=https://doc.rust-lang.org\",\n \"--extern-html-root-url=alloc=https://doc.rust-lang.org\",\n \"--extern-html-root-url=std=https://doc.rust-lang.org\",\n]\n\n\n### FEATURES #################################################################\n\n[features]\ndefault = [\"std\"]\n\n# Provide derive(Serialize, Deserialize) macros.\nderive = [\"serde_derive\"]\n\n# Provide impls for common standard library types like Vec and HashMap.\n# Requires a dependency on the Rust standard library.\nstd = [\"serde_core/std\"]\n\n# Provide impls for types that require unstable functionality. For tracking and\n# discussion of unstable functionality please refer to this issue:\n#\n# https://github.com/serde-rs/serde/issues/812\nunstable = [\"serde_core/unstable\"]\n\n# Provide impls for types in the Rust core allocation and collections library\n# including String, Box, Vec, and Cow. This is a subset of std but may\n# be enabled without depending on all of std.\nalloc = [\"serde_core/alloc\"]\n\n# Opt into impls for Rc and Arc. Serializing and deserializing these types\n# does not preserve identity and may result in multiple copies of the same data.\n# Be sure that this is what you want before enabling this feature.\nrc = [\"serde_core/rc\"]\n"
},
{
"path": "serde/build.rs",
"content": "use std::env;\nuse std::fs;\nuse std::path::PathBuf;\nuse std::process::Command;\nuse std::str;\n\nconst PRIVATE: &str = \"\\\n#[doc(hidden)]\npub mod __private$$ {\n #[doc(hidden)]\n pub use crate::private::*;\n}\nuse serde_core::__private$$ as serde_core_private;\n\";\n\n// The rustc-cfg strings below are *not* public API. Please let us know by\n// opening a GitHub issue if your build environment requires some way to enable\n// these cfgs other than by executing our build script.\nfn main() {\n println!(\"cargo:rerun-if-changed=build.rs\");\n\n println!(\"cargo:rustc-cfg=if_docsrs_then_no_serde_core\");\n\n let out_dir = PathBuf::from(env::var_os(\"OUT_DIR\").unwrap());\n let patch_version = env::var(\"CARGO_PKG_VERSION_PATCH\").unwrap();\n let module = PRIVATE.replace(\"$$\", &patch_version);\n fs::write(out_dir.join(\"private.rs\"), module).unwrap();\n\n let minor = match rustc_minor_version() {\n Some(minor) => minor,\n None => return,\n };\n\n if minor >= 77 {\n println!(\"cargo:rustc-check-cfg=cfg(feature, values(\\\"result\\\"))\");\n println!(\"cargo:rustc-check-cfg=cfg(if_docsrs_then_no_serde_core)\");\n println!(\"cargo:rustc-check-cfg=cfg(no_core_cstr)\");\n println!(\"cargo:rustc-check-cfg=cfg(no_core_error)\");\n println!(\"cargo:rustc-check-cfg=cfg(no_core_net)\");\n println!(\"cargo:rustc-check-cfg=cfg(no_core_num_saturating)\");\n println!(\"cargo:rustc-check-cfg=cfg(no_diagnostic_namespace)\");\n println!(\"cargo:rustc-check-cfg=cfg(no_serde_derive)\");\n println!(\"cargo:rustc-check-cfg=cfg(no_std_atomic)\");\n println!(\"cargo:rustc-check-cfg=cfg(no_std_atomic64)\");\n println!(\"cargo:rustc-check-cfg=cfg(no_target_has_atomic)\");\n }\n\n // Current minimum supported version of serde_derive crate is Rust 1.71.\n if minor < 71 {\n println!(\"cargo:rustc-cfg=no_serde_derive\");\n }\n\n // Support for the `#[diagnostic]` tool attribute namespace\n // https://blog.rust-lang.org/2024/05/02/Rust-1.78.0.html#diagnostic-attributes\n if minor < 78 {\n println!(\"cargo:rustc-cfg=no_diagnostic_namespace\");\n }\n}\n\nfn rustc_minor_version() -> Option {\n let rustc = env::var_os(\"RUSTC\")?;\n let output = Command::new(rustc).arg(\"--version\").output().ok()?;\n let version = str::from_utf8(&output.stdout).ok()?;\n let mut pieces = version.split('.');\n if pieces.next() != Some(\"rustc 1\") {\n return None;\n }\n pieces.next()?.parse().ok()\n}\n"
},
{
"path": "serde/src/integer128.rs",
"content": "#[macro_export]\n#[deprecated = \"\nThis macro has no effect on any version of Serde released in the past 2 years.\nIt was used long ago in crates that needed to support Rustc older than 1.26.0,\nor Emscripten targets older than 1.40.0, which did not yet have 128-bit integer\nsupport. These days Serde requires a Rust compiler newer than that so 128-bit\nintegers are always supported.\n\"]\n#[doc(hidden)]\nmacro_rules! serde_if_integer128 {\n ($($tt:tt)*) => {\n $($tt)*\n };\n}\n"
},
{
"path": "serde/src/lib.rs",
"content": "//! # Serde\n//!\n//! Serde is a framework for ***ser***ializing and ***de***serializing Rust data\n//! structures efficiently and generically.\n//!\n//! The Serde ecosystem consists of data structures that know how to serialize\n//! and deserialize themselves along with data formats that know how to\n//! serialize and deserialize other things. Serde provides the layer by which\n//! these two groups interact with each other, allowing any supported data\n//! structure to be serialized and deserialized using any supported data format.\n//!\n//! See the Serde website for additional documentation and\n//! usage examples.\n//!\n//! ## Design\n//!\n//! Where many other languages rely on runtime reflection for serializing data,\n//! Serde is instead built on Rust's powerful trait system. A data structure\n//! that knows how to serialize and deserialize itself is one that implements\n//! Serde's `Serialize` and `Deserialize` traits (or uses Serde's derive\n//! attribute to automatically generate implementations at compile time). This\n//! avoids any overhead of reflection or runtime type information. In fact in\n//! many situations the interaction between data structure and data format can\n//! be completely optimized away by the Rust compiler, leaving Serde\n//! serialization to perform the same speed as a handwritten serializer for the\n//! specific selection of data structure and data format.\n//!\n//! ## Data formats\n//!\n//! The following is a partial list of data formats that have been implemented\n//! for Serde by the community.\n//!\n//! - [JSON], the ubiquitous JavaScript Object Notation used by many HTTP APIs.\n//! - [Postcard], a no\\_std and embedded-systems friendly compact binary format.\n//! - [CBOR], a Concise Binary Object Representation designed for small message\n//! size without the need for version negotiation.\n//! - [YAML], a self-proclaimed human-friendly configuration language that ain't\n//! markup language.\n//! - [MessagePack], an efficient binary format that resembles a compact JSON.\n//! - [TOML], a minimal configuration format used by [Cargo].\n//! - [Pickle], a format common in the Python world.\n//! - [RON], a Rusty Object Notation.\n//! - [BSON], the data storage and network transfer format used by MongoDB.\n//! - [Avro], a binary format used within Apache Hadoop, with support for schema\n//! definition.\n//! - [JSON5], a superset of JSON including some productions from ES5.\n//! - [URL] query strings, in the x-www-form-urlencoded format.\n//! - [Starlark], the format used for describing build targets by the Bazel and\n//! Buck build systems. *(serialization only)*\n//! - [Envy], a way to deserialize environment variables into Rust structs.\n//! *(deserialization only)*\n//! - [Envy Store], a way to deserialize [AWS Parameter Store] parameters into\n//! Rust structs. *(deserialization only)*\n//! - [S-expressions], the textual representation of code and data used by the\n//! Lisp language family.\n//! - [D-Bus]'s binary wire format.\n//! - [FlexBuffers], the schemaless cousin of Google's FlatBuffers zero-copy\n//! serialization format.\n//! - [Bencode], a simple binary format used in the BitTorrent protocol.\n//! - [Token streams], for processing Rust procedural macro input.\n//! *(deserialization only)*\n//! - [DynamoDB Items], the format used by [rusoto_dynamodb] to transfer data to\n//! and from DynamoDB.\n//! - [Hjson], a syntax extension to JSON designed around human reading and\n//! editing. *(deserialization only)*\n//! - [CSV], Comma-separated values is a tabular text file format.\n//!\n//! [JSON]: https://github.com/serde-rs/json\n//! [Postcard]: https://github.com/jamesmunns/postcard\n//! [CBOR]: https://github.com/enarx/ciborium\n//! [YAML]: https://github.com/dtolnay/serde-yaml\n//! [MessagePack]: https://github.com/3Hren/msgpack-rust\n//! [TOML]: https://docs.rs/toml\n//! [Pickle]: https://github.com/birkenfeld/serde-pickle\n//! [RON]: https://github.com/ron-rs/ron\n//! [BSON]: https://github.com/mongodb/bson-rust\n//! [Avro]: https://docs.rs/apache-avro\n//! [JSON5]: https://github.com/callum-oakley/json5-rs\n//! [URL]: https://docs.rs/serde_qs\n//! [Starlark]: https://github.com/dtolnay/serde-starlark\n//! [Envy]: https://github.com/softprops/envy\n//! [Envy Store]: https://github.com/softprops/envy-store\n//! [Cargo]: https://doc.rust-lang.org/cargo/reference/manifest.html\n//! [AWS Parameter Store]: https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-parameter-store.html\n//! [S-expressions]: https://github.com/rotty/lexpr-rs\n//! [D-Bus]: https://docs.rs/zvariant\n//! [FlexBuffers]: https://github.com/google/flatbuffers/tree/master/rust/flexbuffers\n//! [Bencode]: https://github.com/P3KI/bendy\n//! [Token streams]: https://github.com/oxidecomputer/serde_tokenstream\n//! [DynamoDB Items]: https://docs.rs/serde_dynamo\n//! [rusoto_dynamodb]: https://docs.rs/rusoto_dynamodb\n//! [Hjson]: https://github.com/Canop/deser-hjson\n//! [CSV]: https://docs.rs/csv\n\n////////////////////////////////////////////////////////////////////////////////\n\n// Serde types in rustdoc of other crates get linked to here.\n#![doc(html_root_url = \"https://docs.rs/serde/1.0.228\")]\n// Support using Serde without the standard library!\n#![cfg_attr(not(feature = \"std\"), no_std)]\n// Show which crate feature enables conditionally compiled APIs in documentation.\n#![cfg_attr(docsrs, feature(doc_cfg, rustdoc_internals))]\n#![cfg_attr(docsrs, allow(internal_features))]\n// Unstable functionality only if the user asks for it. For tracking and\n// discussion of these features please refer to this issue:\n//\n// https://github.com/serde-rs/serde/issues/812\n#![cfg_attr(all(feature = \"unstable\", docsrs), feature(never_type))]\n#![allow(\n unknown_lints,\n bare_trait_objects,\n deprecated,\n mismatched_lifetime_syntaxes\n)]\n// Ignored clippy and clippy_pedantic lints\n#![allow(\n // clippy bug: https://github.com/rust-lang/rust-clippy/issues/5704\n clippy::unnested_or_patterns,\n // clippy bug: https://github.com/rust-lang/rust-clippy/issues/7768\n clippy::semicolon_if_nothing_returned,\n // not available in our oldest supported compiler\n clippy::empty_enums,\n clippy::type_repetition_in_bounds, // https://github.com/rust-lang/rust-clippy/issues/8772\n // integer and float ser/de requires these sorts of casts\n clippy::cast_possible_truncation,\n clippy::cast_possible_wrap,\n clippy::cast_precision_loss,\n clippy::cast_sign_loss,\n // things are often more readable this way\n clippy::cast_lossless,\n clippy::module_name_repetitions,\n clippy::single_match_else,\n clippy::type_complexity,\n clippy::use_self,\n clippy::zero_prefixed_literal,\n // correctly used\n clippy::derive_partial_eq_without_eq,\n clippy::enum_glob_use,\n clippy::explicit_auto_deref,\n clippy::incompatible_msrv,\n clippy::let_underscore_untyped,\n clippy::map_err_ignore,\n clippy::new_without_default,\n clippy::result_unit_err,\n clippy::wildcard_imports,\n // not practical\n clippy::needless_pass_by_value,\n clippy::similar_names,\n clippy::too_many_lines,\n // preference\n clippy::doc_markdown,\n clippy::elidable_lifetime_names,\n clippy::needless_lifetimes,\n clippy::unseparated_literal_suffix,\n // false positive\n clippy::needless_doctest_main,\n // noisy\n clippy::missing_errors_doc,\n clippy::must_use_candidate,\n)]\n// Restrictions\n#![deny(clippy::question_mark_used)]\n// Rustc lints.\n#![deny(missing_docs, unused_imports)]\n\n////////////////////////////////////////////////////////////////////////////////\n\n#[cfg(feature = \"alloc\")]\nextern crate alloc;\n\n// Rustdoc has a lot of shortcomings related to cross-crate re-exports that make\n// the rendered documentation of serde_core traits in serde more challenging to\n// understand than the equivalent documentation of the same items in serde_core.\n// https://github.com/rust-lang/rust/labels/A-cross-crate-reexports\n// So, just for the purpose of docs.rs documentation, we inline the contents of\n// serde_core into serde. This sidesteps all the cross-crate rustdoc bugs.\n#[cfg(docsrs)]\n#[macro_use]\n#[path = \"core/crate_root.rs\"]\nmod crate_root;\n\n#[cfg(docsrs)]\n#[macro_use]\n#[path = \"core/macros.rs\"]\nmod macros;\n\n#[cfg(not(docsrs))]\nmacro_rules! crate_root {\n () => {\n /// A facade around all the types we need from the `std`, `core`, and `alloc`\n /// crates. This avoids elaborate import wrangling having to happen in every\n /// module.\n mod lib {\n mod core {\n #[cfg(not(feature = \"std\"))]\n pub use core::*;\n #[cfg(feature = \"std\")]\n pub use std::*;\n }\n\n pub use self::core::{f32, f64};\n pub use self::core::{ptr, str};\n\n #[cfg(any(feature = \"std\", feature = \"alloc\"))]\n pub use self::core::slice;\n\n pub use self::core::clone;\n pub use self::core::convert;\n pub use self::core::default;\n pub use self::core::fmt::{self, Debug, Display, Write as FmtWrite};\n pub use self::core::marker::{self, PhantomData};\n pub use self::core::option;\n pub use self::core::result;\n\n #[cfg(all(feature = \"alloc\", not(feature = \"std\")))]\n pub use alloc::borrow::{Cow, ToOwned};\n #[cfg(feature = \"std\")]\n pub use std::borrow::{Cow, ToOwned};\n\n #[cfg(all(feature = \"alloc\", not(feature = \"std\")))]\n pub use alloc::string::{String, ToString};\n #[cfg(feature = \"std\")]\n pub use std::string::{String, ToString};\n\n #[cfg(all(feature = \"alloc\", not(feature = \"std\")))]\n pub use alloc::vec::Vec;\n #[cfg(feature = \"std\")]\n pub use std::vec::Vec;\n\n #[cfg(all(feature = \"alloc\", not(feature = \"std\")))]\n pub use alloc::boxed::Box;\n #[cfg(feature = \"std\")]\n pub use std::boxed::Box;\n }\n\n // None of this crate's error handling needs the `From::from` error conversion\n // performed implicitly by the `?` operator or the standard library's `try!`\n // macro. This simplified macro gives a 5.5% improvement in compile time\n // compared to standard `try!`, and 9% improvement compared to `?`.\n #[cfg(not(no_serde_derive))]\n macro_rules! tri {\n ($expr:expr) => {\n match $expr {\n Ok(val) => val,\n Err(err) => return Err(err),\n }\n };\n }\n\n ////////////////////////////////////////////////////////////////////////////////\n\n pub use serde_core::{\n de, forward_to_deserialize_any, ser, Deserialize, Deserializer, Serialize, Serializer,\n };\n\n // Used by generated code and doc tests. Not public API.\n #[doc(hidden)]\n mod private;\n\n include!(concat!(env!(\"OUT_DIR\"), \"/private.rs\"));\n };\n}\n\ncrate_root!();\n\nmod integer128;\n\n// Re-export #[derive(Serialize, Deserialize)].\n//\n// The reason re-exporting is not enabled by default is that disabling it would\n// be annoying for crates that provide handwritten impls or data formats. They\n// would need to disable default features and then explicitly re-enable std.\n#[cfg(feature = \"serde_derive\")]\nextern crate serde_derive;\n\n/// Derive macro available if serde is built with `features = [\"derive\"]`.\n#[cfg(feature = \"serde_derive\")]\n#[cfg_attr(docsrs, doc(cfg(feature = \"derive\")))]\npub use serde_derive::{Deserialize, Serialize};\n\n#[macro_export]\n#[doc(hidden)]\nmacro_rules! __require_serde_not_serde_core {\n () => {};\n}\n"
},
{
"path": "serde/src/private/de.rs",
"content": "use crate::lib::*;\n\nuse crate::de::value::{BorrowedBytesDeserializer, BytesDeserializer};\nuse crate::de::{\n Deserialize, DeserializeSeed, Deserializer, EnumAccess, Error, IntoDeserializer, VariantAccess,\n Visitor,\n};\n\n#[cfg(any(feature = \"std\", feature = \"alloc\"))]\nuse crate::de::{MapAccess, Unexpected};\n\n#[cfg(any(feature = \"std\", feature = \"alloc\"))]\npub use self::content::{\n content_as_str, Content, ContentDeserializer, ContentRefDeserializer, ContentVisitor,\n EnumDeserializer, InternallyTaggedUnitVisitor, TagContentOtherField,\n TagContentOtherFieldVisitor, TagOrContentField, TagOrContentFieldVisitor, TaggedContentVisitor,\n UntaggedUnitVisitor,\n};\n\npub use crate::serde_core_private::InPlaceSeed;\n\n/// If the missing field is of type `Option` then treat is as `None`,\n/// otherwise it is an error.\npub fn missing_field<'de, V, E>(field: &'static str) -> Result\nwhere\n V: Deserialize<'de>,\n E: Error,\n{\n struct MissingFieldDeserializer(&'static str, PhantomData);\n\n #[cfg_attr(not(no_diagnostic_namespace), diagnostic::do_not_recommend)]\n impl<'de, E> Deserializer<'de> for MissingFieldDeserializer\n where\n E: Error,\n {\n type Error = E;\n\n fn deserialize_any(self, _visitor: V) -> Result\n where\n V: Visitor<'de>,\n {\n Err(Error::missing_field(self.0))\n }\n\n fn deserialize_option(self, visitor: V) -> Result\n where\n V: Visitor<'de>,\n {\n visitor.visit_none()\n }\n\n serde_core::forward_to_deserialize_any! {\n bool i8 i16 i32 i64 i128 u8 u16 u32 u64 u128 f32 f64 char str string\n bytes byte_buf unit unit_struct newtype_struct seq tuple\n tuple_struct map struct enum identifier ignored_any\n }\n }\n\n let deserializer = MissingFieldDeserializer(field, PhantomData);\n Deserialize::deserialize(deserializer)\n}\n\n#[cfg(any(feature = \"std\", feature = \"alloc\"))]\npub fn borrow_cow_str<'de: 'a, 'a, D, R>(deserializer: D) -> Result\nwhere\n D: Deserializer<'de>,\n R: From>,\n{\n struct CowStrVisitor;\n\n #[cfg_attr(not(no_diagnostic_namespace), diagnostic::do_not_recommend)]\n impl<'a> Visitor<'a> for CowStrVisitor {\n type Value = Cow<'a, str>;\n\n fn expecting(&self, formatter: &mut fmt::Formatter) -> fmt::Result {\n formatter.write_str(\"a string\")\n }\n\n fn visit_str(self, v: &str) -> Result\n where\n E: Error,\n {\n Ok(Cow::Owned(v.to_owned()))\n }\n\n fn visit_borrowed_str(self, v: &'a str) -> Result\n where\n E: Error,\n {\n Ok(Cow::Borrowed(v))\n }\n\n fn visit_string(self, v: String) -> Result\n where\n E: Error,\n {\n Ok(Cow::Owned(v))\n }\n\n fn visit_bytes(self, v: &[u8]) -> Result\n where\n E: Error,\n {\n match str::from_utf8(v) {\n Ok(s) => Ok(Cow::Owned(s.to_owned())),\n Err(_) => Err(Error::invalid_value(Unexpected::Bytes(v), &self)),\n }\n }\n\n fn visit_borrowed_bytes(self, v: &'a [u8]) -> Result\n where\n E: Error,\n {\n match str::from_utf8(v) {\n Ok(s) => Ok(Cow::Borrowed(s)),\n Err(_) => Err(Error::invalid_value(Unexpected::Bytes(v), &self)),\n }\n }\n\n fn visit_byte_buf(self, v: Vec) -> Result\n where\n E: Error,\n {\n match String::from_utf8(v) {\n Ok(s) => Ok(Cow::Owned(s)),\n Err(e) => Err(Error::invalid_value(\n Unexpected::Bytes(&e.into_bytes()),\n &self,\n )),\n }\n }\n }\n\n deserializer.deserialize_str(CowStrVisitor).map(From::from)\n}\n\n#[cfg(any(feature = \"std\", feature = \"alloc\"))]\npub fn borrow_cow_bytes<'de: 'a, 'a, D, R>(deserializer: D) -> Result\nwhere\n D: Deserializer<'de>,\n R: From>,\n{\n struct CowBytesVisitor;\n\n #[cfg_attr(not(no_diagnostic_namespace), diagnostic::do_not_recommend)]\n impl<'a> Visitor<'a> for CowBytesVisitor {\n type Value = Cow<'a, [u8]>;\n\n fn expecting(&self, formatter: &mut fmt::Formatter) -> fmt::Result {\n formatter.write_str(\"a byte array\")\n }\n\n fn visit_str(self, v: &str) -> Result\n where\n E: Error,\n {\n Ok(Cow::Owned(v.as_bytes().to_vec()))\n }\n\n fn visit_borrowed_str(self, v: &'a str) -> Result\n where\n E: Error,\n {\n Ok(Cow::Borrowed(v.as_bytes()))\n }\n\n fn visit_string(self, v: String) -> Result\n where\n E: Error,\n {\n Ok(Cow::Owned(v.into_bytes()))\n }\n\n fn visit_bytes(self, v: &[u8]) -> Result\n where\n E: Error,\n {\n Ok(Cow::Owned(v.to_vec()))\n }\n\n fn visit_borrowed_bytes(self, v: &'a [u8]) -> Result\n where\n E: Error,\n {\n Ok(Cow::Borrowed(v))\n }\n\n fn visit_byte_buf(self, v: Vec) -> Result\n where\n E: Error,\n {\n Ok(Cow::Owned(v))\n }\n }\n\n deserializer\n .deserialize_bytes(CowBytesVisitor)\n .map(From::from)\n}\n\n#[cfg(any(feature = \"std\", feature = \"alloc\"))]\nmod content {\n // This module is private and nothing here should be used outside of\n // generated code.\n //\n // We will iterate on the implementation for a few releases and only have to\n // worry about backward compatibility for the `untagged` and `tag` attributes\n // rather than for this entire mechanism.\n //\n // This issue is tracking making some of this stuff public:\n // https://github.com/serde-rs/serde/issues/741\n\n use crate::lib::*;\n\n use crate::de::{\n self, Deserialize, DeserializeSeed, Deserializer, EnumAccess, Expected, IgnoredAny,\n MapAccess, SeqAccess, Unexpected, Visitor,\n };\n use crate::serde_core_private::size_hint;\n pub use crate::serde_core_private::Content;\n\n pub fn content_as_str<'a, 'de>(content: &'a Content<'de>) -> Option<&'a str> {\n match *content {\n Content::Str(x) => Some(x),\n Content::String(ref x) => Some(x),\n Content::Bytes(x) => str::from_utf8(x).ok(),\n Content::ByteBuf(ref x) => str::from_utf8(x).ok(),\n _ => None,\n }\n }\n\n fn content_clone<'de>(content: &Content<'de>) -> Content<'de> {\n match content {\n Content::Bool(b) => Content::Bool(*b),\n Content::U8(n) => Content::U8(*n),\n Content::U16(n) => Content::U16(*n),\n Content::U32(n) => Content::U32(*n),\n Content::U64(n) => Content::U64(*n),\n Content::I8(n) => Content::I8(*n),\n Content::I16(n) => Content::I16(*n),\n Content::I32(n) => Content::I32(*n),\n Content::I64(n) => Content::I64(*n),\n Content::F32(f) => Content::F32(*f),\n Content::F64(f) => Content::F64(*f),\n Content::Char(c) => Content::Char(*c),\n Content::String(s) => Content::String(s.clone()),\n Content::Str(s) => Content::Str(*s),\n Content::ByteBuf(b) => Content::ByteBuf(b.clone()),\n Content::Bytes(b) => Content::Bytes(b),\n Content::None => Content::None,\n Content::Some(content) => Content::Some(Box::new(content_clone(content))),\n Content::Unit => Content::Unit,\n Content::Newtype(content) => Content::Newtype(Box::new(content_clone(content))),\n Content::Seq(seq) => Content::Seq(seq.iter().map(content_clone).collect()),\n Content::Map(map) => Content::Map(\n map.iter()\n .map(|(k, v)| (content_clone(k), content_clone(v)))\n .collect(),\n ),\n }\n }\n\n #[cold]\n fn content_unexpected<'a, 'de>(content: &'a Content<'de>) -> Unexpected<'a> {\n match *content {\n Content::Bool(b) => Unexpected::Bool(b),\n Content::U8(n) => Unexpected::Unsigned(n as u64),\n Content::U16(n) => Unexpected::Unsigned(n as u64),\n Content::U32(n) => Unexpected::Unsigned(n as u64),\n Content::U64(n) => Unexpected::Unsigned(n),\n Content::I8(n) => Unexpected::Signed(n as i64),\n Content::I16(n) => Unexpected::Signed(n as i64),\n Content::I32(n) => Unexpected::Signed(n as i64),\n Content::I64(n) => Unexpected::Signed(n),\n Content::F32(f) => Unexpected::Float(f as f64),\n Content::F64(f) => Unexpected::Float(f),\n Content::Char(c) => Unexpected::Char(c),\n Content::String(ref s) => Unexpected::Str(s),\n Content::Str(s) => Unexpected::Str(s),\n Content::ByteBuf(ref b) => Unexpected::Bytes(b),\n Content::Bytes(b) => Unexpected::Bytes(b),\n Content::None | Content::Some(_) => Unexpected::Option,\n Content::Unit => Unexpected::Unit,\n Content::Newtype(_) => Unexpected::NewtypeStruct,\n Content::Seq(_) => Unexpected::Seq,\n Content::Map(_) => Unexpected::Map,\n }\n }\n\n pub struct ContentVisitor<'de> {\n value: PhantomData>,\n }\n\n impl<'de> ContentVisitor<'de> {\n pub fn new() -> Self {\n ContentVisitor { value: PhantomData }\n }\n }\n\n #[cfg_attr(not(no_diagnostic_namespace), diagnostic::do_not_recommend)]\n impl<'de> DeserializeSeed<'de> for ContentVisitor<'de> {\n type Value = Content<'de>;\n\n fn deserialize(self, deserializer: D) -> Result\n where\n D: Deserializer<'de>,\n {\n deserializer.__deserialize_content_v1(self)\n }\n }\n\n #[cfg_attr(not(no_diagnostic_namespace), diagnostic::do_not_recommend)]\n impl<'de> Visitor<'de> for ContentVisitor<'de> {\n type Value = Content<'de>;\n\n fn expecting(&self, fmt: &mut fmt::Formatter) -> fmt::Result {\n fmt.write_str(\"any value\")\n }\n\n fn visit_bool(self, value: bool) -> Result\n where\n F: de::Error,\n {\n Ok(Content::Bool(value))\n }\n\n fn visit_i8(self, value: i8) -> Result\n where\n F: de::Error,\n {\n Ok(Content::I8(value))\n }\n\n fn visit_i16(self, value: i16) -> Result\n where\n F: de::Error,\n {\n Ok(Content::I16(value))\n }\n\n fn visit_i32(self, value: i32) -> Result\n where\n F: de::Error,\n {\n Ok(Content::I32(value))\n }\n\n fn visit_i64(self, value: i64) -> Result\n where\n F: de::Error,\n {\n Ok(Content::I64(value))\n }\n\n fn visit_u8(self, value: u8) -> Result\n where\n F: de::Error,\n {\n Ok(Content::U8(value))\n }\n\n fn visit_u16(self, value: u16) -> Result\n where\n F: de::Error,\n {\n Ok(Content::U16(value))\n }\n\n fn visit_u32(self, value: u32) -> Result\n where\n F: de::Error,\n {\n Ok(Content::U32(value))\n }\n\n fn visit_u64(self, value: u64) -> Result\n where\n F: de::Error,\n {\n Ok(Content::U64(value))\n }\n\n fn visit_f32(self, value: f32) -> Result\n where\n F: de::Error,\n {\n Ok(Content::F32(value))\n }\n\n fn visit_f64(self, value: f64) -> Result\n where\n F: de::Error,\n {\n Ok(Content::F64(value))\n }\n\n fn visit_char(self, value: char) -> Result\n where\n F: de::Error,\n {\n Ok(Content::Char(value))\n }\n\n fn visit_str(self, value: &str) -> Result\n where\n F: de::Error,\n {\n Ok(Content::String(value.into()))\n }\n\n fn visit_borrowed_str(self, value: &'de str) -> Result\n where\n F: de::Error,\n {\n Ok(Content::Str(value))\n }\n\n fn visit_string(self, value: String) -> Result\n where\n F: de::Error,\n {\n Ok(Content::String(value))\n }\n\n fn visit_bytes(self, value: &[u8]) -> Result\n where\n F: de::Error,\n {\n Ok(Content::ByteBuf(value.into()))\n }\n\n fn visit_borrowed_bytes(self, value: &'de [u8]) -> Result\n where\n F: de::Error,\n {\n Ok(Content::Bytes(value))\n }\n\n fn visit_byte_buf(self, value: Vec) -> Result\n where\n F: de::Error,\n {\n Ok(Content::ByteBuf(value))\n }\n\n fn visit_unit(self) -> Result\n where\n F: de::Error,\n {\n Ok(Content::Unit)\n }\n\n fn visit_none(self) -> Result\n where\n F: de::Error,\n {\n Ok(Content::None)\n }\n\n fn visit_some(self, deserializer: D) -> Result\n where\n D: Deserializer<'de>,\n {\n let v = tri!(ContentVisitor::new().deserialize(deserializer));\n Ok(Content::Some(Box::new(v)))\n }\n\n fn visit_newtype_struct(self, deserializer: D) -> Result\n where\n D: Deserializer<'de>,\n {\n let v = tri!(ContentVisitor::new().deserialize(deserializer));\n Ok(Content::Newtype(Box::new(v)))\n }\n\n fn visit_seq(self, mut visitor: V) -> Result\n where\n V: SeqAccess<'de>,\n {\n let mut vec =\n Vec::::with_capacity(size_hint::cautious::(visitor.size_hint()));\n while let Some(e) = tri!(visitor.next_element_seed(ContentVisitor::new())) {\n vec.push(e);\n }\n Ok(Content::Seq(vec))\n }\n\n fn visit_map(self, mut visitor: V) -> Result\n where\n V: MapAccess<'de>,\n {\n let mut vec =\n Vec::<(Content, Content)>::with_capacity(\n size_hint::cautious::<(Content, Content)>(visitor.size_hint()),\n );\n while let Some(kv) =\n tri!(visitor.next_entry_seed(ContentVisitor::new(), ContentVisitor::new()))\n {\n vec.push(kv);\n }\n Ok(Content::Map(vec))\n }\n\n fn visit_enum(self, _visitor: V) -> Result\n where\n V: EnumAccess<'de>,\n {\n Err(de::Error::custom(\n \"untagged and internally tagged enums do not support enum input\",\n ))\n }\n }\n\n /// This is the type of the map keys in an internally tagged enum.\n ///\n /// Not public API.\n pub enum TagOrContent<'de> {\n Tag,\n Content(Content<'de>),\n }\n\n /// Serves as a seed for deserializing a key of internally tagged enum.\n /// Cannot capture externally tagged enums, `i128` and `u128`.\n struct TagOrContentVisitor<'de> {\n name: &'static str,\n value: PhantomData>,\n }\n\n impl<'de> TagOrContentVisitor<'de> {\n fn new(name: &'static str) -> Self {\n TagOrContentVisitor {\n name,\n value: PhantomData,\n }\n }\n }\n\n #[cfg_attr(not(no_diagnostic_namespace), diagnostic::do_not_recommend)]\n impl<'de> DeserializeSeed<'de> for TagOrContentVisitor<'de> {\n type Value = TagOrContent<'de>;\n\n fn deserialize(self, deserializer: D) -> Result\n where\n D: Deserializer<'de>,\n {\n // Internally tagged enums are only supported in self-describing\n // formats.\n deserializer.deserialize_any(self)\n }\n }\n\n #[cfg_attr(not(no_diagnostic_namespace), diagnostic::do_not_recommend)]\n impl<'de> Visitor<'de> for TagOrContentVisitor<'de> {\n type Value = TagOrContent<'de>;\n\n fn expecting(&self, fmt: &mut fmt::Formatter) -> fmt::Result {\n write!(fmt, \"a type tag `{}` or any other value\", self.name)\n }\n\n fn visit_bool(self, value: bool) -> Result\n where\n F: de::Error,\n {\n ContentVisitor::new()\n .visit_bool(value)\n .map(TagOrContent::Content)\n }\n\n fn visit_i8(self, value: i8) -> Result\n where\n F: de::Error,\n {\n ContentVisitor::new()\n .visit_i8(value)\n .map(TagOrContent::Content)\n }\n\n fn visit_i16(self, value: i16) -> Result\n where\n F: de::Error,\n {\n ContentVisitor::new()\n .visit_i16(value)\n .map(TagOrContent::Content)\n }\n\n fn visit_i32(self, value: i32) -> Result\n where\n F: de::Error,\n {\n ContentVisitor::new()\n .visit_i32(value)\n .map(TagOrContent::Content)\n }\n\n fn visit_i64(self, value: i64) -> Result\n where\n F: de::Error,\n {\n ContentVisitor::new()\n .visit_i64(value)\n .map(TagOrContent::Content)\n }\n\n fn visit_u8(self, value: u8) -> Result\n where\n F: de::Error,\n {\n ContentVisitor::new()\n .visit_u8(value)\n .map(TagOrContent::Content)\n }\n\n fn visit_u16(self, value: u16) -> Result\n where\n F: de::Error,\n {\n ContentVisitor::new()\n .visit_u16(value)\n .map(TagOrContent::Content)\n }\n\n fn visit_u32(self, value: u32) -> Result\n where\n F: de::Error,\n {\n ContentVisitor::new()\n .visit_u32(value)\n .map(TagOrContent::Content)\n }\n\n fn visit_u64(self, value: u64) -> Result\n where\n F: de::Error,\n {\n ContentVisitor::new()\n .visit_u64(value)\n .map(TagOrContent::Content)\n }\n\n fn visit_f32(self, value: f32) -> Result\n where\n F: de::Error,\n {\n ContentVisitor::new()\n .visit_f32(value)\n .map(TagOrContent::Content)\n }\n\n fn visit_f64(self, value: f64) -> Result\n where\n F: de::Error,\n {\n ContentVisitor::new()\n .visit_f64(value)\n .map(TagOrContent::Content)\n }\n\n fn visit_char(self, value: char) -> Result\n where\n F: de::Error,\n {\n ContentVisitor::new()\n .visit_char(value)\n .map(TagOrContent::Content)\n }\n\n fn visit_str(self, value: &str) -> Result\n where\n F: de::Error,\n {\n if value == self.name {\n Ok(TagOrContent::Tag)\n } else {\n ContentVisitor::new()\n .visit_str(value)\n .map(TagOrContent::Content)\n }\n }\n\n fn visit_borrowed_str(self, value: &'de str) -> Result\n where\n F: de::Error,\n {\n if value == self.name {\n Ok(TagOrContent::Tag)\n } else {\n ContentVisitor::new()\n .visit_borrowed_str(value)\n .map(TagOrContent::Content)\n }\n }\n\n fn visit_string(self, value: String) -> Result\n where\n F: de::Error,\n {\n if value == self.name {\n Ok(TagOrContent::Tag)\n } else {\n ContentVisitor::new()\n .visit_string(value)\n .map(TagOrContent::Content)\n }\n }\n\n fn visit_bytes(self, value: &[u8]) -> Result\n where\n F: de::Error,\n {\n if value == self.name.as_bytes() {\n Ok(TagOrContent::Tag)\n } else {\n ContentVisitor::new()\n .visit_bytes(value)\n .map(TagOrContent::Content)\n }\n }\n\n fn visit_borrowed_bytes(self, value: &'de [u8]) -> Result\n where\n F: de::Error,\n {\n if value == self.name.as_bytes() {\n Ok(TagOrContent::Tag)\n } else {\n ContentVisitor::new()\n .visit_borrowed_bytes(value)\n .map(TagOrContent::Content)\n }\n }\n\n fn visit_byte_buf(self, value: Vec) -> Result\n where\n F: de::Error,\n {\n if value == self.name.as_bytes() {\n Ok(TagOrContent::Tag)\n } else {\n ContentVisitor::new()\n .visit_byte_buf(value)\n .map(TagOrContent::Content)\n }\n }\n\n fn visit_unit(self) -> Result\n where\n F: de::Error,\n {\n ContentVisitor::new()\n .visit_unit()\n .map(TagOrContent::Content)\n }\n\n fn visit_none(self) -> Result\n where\n F: de::Error,\n {\n ContentVisitor::new()\n .visit_none()\n .map(TagOrContent::Content)\n }\n\n fn visit_some(self, deserializer: D) -> Result\n where\n D: Deserializer<'de>,\n {\n ContentVisitor::new()\n .visit_some(deserializer)\n .map(TagOrContent::Content)\n }\n\n fn visit_newtype_struct(self, deserializer: D) -> Result\n where\n D: Deserializer<'de>,\n {\n ContentVisitor::new()\n .visit_newtype_struct(deserializer)\n .map(TagOrContent::Content)\n }\n\n fn visit_seq(self, visitor: V) -> Result\n where\n V: SeqAccess<'de>,\n {\n ContentVisitor::new()\n .visit_seq(visitor)\n .map(TagOrContent::Content)\n }\n\n fn visit_map(self, visitor: V) -> Result\n where\n V: MapAccess<'de>,\n {\n ContentVisitor::new()\n .visit_map(visitor)\n .map(TagOrContent::Content)\n }\n\n fn visit_enum(self, visitor: V) -> Result\n where\n V: EnumAccess<'de>,\n {\n ContentVisitor::new()\n .visit_enum(visitor)\n .map(TagOrContent::Content)\n }\n }\n\n /// Used by generated code to deserialize an internally tagged enum.\n ///\n /// Captures map or sequence from the original deserializer and searches\n /// a tag in it (in case of sequence, tag is the first element of sequence).\n ///\n /// Not public API.\n pub struct TaggedContentVisitor {\n tag_name: &'static str,\n expecting: &'static str,\n value: PhantomData,\n }\n\n impl TaggedContentVisitor {\n /// Visitor for the content of an internally tagged enum with the given\n /// tag name.\n pub fn new(name: &'static str, expecting: &'static str) -> Self {\n TaggedContentVisitor {\n tag_name: name,\n expecting,\n value: PhantomData,\n }\n }\n }\n\n #[cfg_attr(not(no_diagnostic_namespace), diagnostic::do_not_recommend)]\n impl<'de, T> Visitor<'de> for TaggedContentVisitor\n where\n T: Deserialize<'de>,\n {\n type Value = (T, Content<'de>);\n\n fn expecting(&self, fmt: &mut fmt::Formatter) -> fmt::Result {\n fmt.write_str(self.expecting)\n }\n\n fn visit_seq(self, mut seq: S) -> Result\n where\n S: SeqAccess<'de>,\n {\n let tag = match tri!(seq.next_element()) {\n Some(tag) => tag,\n None => {\n return Err(de::Error::missing_field(self.tag_name));\n }\n };\n let rest = de::value::SeqAccessDeserializer::new(seq);\n Ok((tag, tri!(ContentVisitor::new().deserialize(rest))))\n }\n\n fn visit_map(self, mut map: M) -> Result\n where\n M: MapAccess<'de>,\n {\n let mut tag = None;\n let mut vec = Vec::<(Content, Content)>::with_capacity(size_hint::cautious::<(\n Content,\n Content,\n )>(map.size_hint()));\n while let Some(k) = tri!(map.next_key_seed(TagOrContentVisitor::new(self.tag_name))) {\n match k {\n TagOrContent::Tag => {\n if tag.is_some() {\n return Err(de::Error::duplicate_field(self.tag_name));\n }\n tag = Some(tri!(map.next_value()));\n }\n TagOrContent::Content(k) => {\n let v = tri!(map.next_value_seed(ContentVisitor::new()));\n vec.push((k, v));\n }\n }\n }\n match tag {\n None => Err(de::Error::missing_field(self.tag_name)),\n Some(tag) => Ok((tag, Content::Map(vec))),\n }\n }\n }\n\n /// Used by generated code to deserialize an adjacently tagged enum.\n ///\n /// Not public API.\n pub enum TagOrContentField {\n Tag,\n Content,\n }\n\n /// Not public API.\n pub struct TagOrContentFieldVisitor {\n /// Name of the tag field of the adjacently tagged enum\n pub tag: &'static str,\n /// Name of the content field of the adjacently tagged enum\n pub content: &'static str,\n }\n\n #[cfg_attr(not(no_diagnostic_namespace), diagnostic::do_not_recommend)]\n impl<'de> DeserializeSeed<'de> for TagOrContentFieldVisitor {\n type Value = TagOrContentField;\n\n fn deserialize(self, deserializer: D) -> Result\n where\n D: Deserializer<'de>,\n {\n deserializer.deserialize_identifier(self)\n }\n }\n\n #[cfg_attr(not(no_diagnostic_namespace), diagnostic::do_not_recommend)]\n impl<'de> Visitor<'de> for TagOrContentFieldVisitor {\n type Value = TagOrContentField;\n\n fn expecting(&self, formatter: &mut fmt::Formatter) -> fmt::Result {\n write!(formatter, \"{:?} or {:?}\", self.tag, self.content)\n }\n\n fn visit_u64(self, field_index: u64) -> Result\n where\n E: de::Error,\n {\n match field_index {\n 0 => Ok(TagOrContentField::Tag),\n 1 => Ok(TagOrContentField::Content),\n _ => Err(de::Error::invalid_value(\n Unexpected::Unsigned(field_index),\n &self,\n )),\n }\n }\n\n fn visit_str(self, field: &str) -> Result\n where\n E: de::Error,\n {\n if field == self.tag {\n Ok(TagOrContentField::Tag)\n } else if field == self.content {\n Ok(TagOrContentField::Content)\n } else {\n Err(de::Error::invalid_value(Unexpected::Str(field), &self))\n }\n }\n\n fn visit_bytes(self, field: &[u8]) -> Result\n where\n E: de::Error,\n {\n if field == self.tag.as_bytes() {\n Ok(TagOrContentField::Tag)\n } else if field == self.content.as_bytes() {\n Ok(TagOrContentField::Content)\n } else {\n Err(de::Error::invalid_value(Unexpected::Bytes(field), &self))\n }\n }\n }\n\n /// Used by generated code to deserialize an adjacently tagged enum when\n /// ignoring unrelated fields is allowed.\n ///\n /// Not public API.\n pub enum TagContentOtherField {\n Tag,\n Content,\n Other,\n }\n\n /// Not public API.\n pub struct TagContentOtherFieldVisitor {\n /// Name of the tag field of the adjacently tagged enum\n pub tag: &'static str,\n /// Name of the content field of the adjacently tagged enum\n pub content: &'static str,\n }\n\n #[cfg_attr(not(no_diagnostic_namespace), diagnostic::do_not_recommend)]\n impl<'de> DeserializeSeed<'de> for TagContentOtherFieldVisitor {\n type Value = TagContentOtherField;\n\n fn deserialize(self, deserializer: D) -> Result\n where\n D: Deserializer<'de>,\n {\n deserializer.deserialize_identifier(self)\n }\n }\n\n #[cfg_attr(not(no_diagnostic_namespace), diagnostic::do_not_recommend)]\n impl<'de> Visitor<'de> for TagContentOtherFieldVisitor {\n type Value = TagContentOtherField;\n\n fn expecting(&self, formatter: &mut fmt::Formatter) -> fmt::Result {\n write!(\n formatter,\n \"{:?}, {:?}, or other ignored fields\",\n self.tag, self.content\n )\n }\n\n fn visit_u64(self, field_index: u64) -> Result\n where\n E: de::Error,\n {\n match field_index {\n 0 => Ok(TagContentOtherField::Tag),\n 1 => Ok(TagContentOtherField::Content),\n _ => Ok(TagContentOtherField::Other),\n }\n }\n\n fn visit_str(self, field: &str) -> Result\n where\n E: de::Error,\n {\n self.visit_bytes(field.as_bytes())\n }\n\n fn visit_bytes(self, field: &[u8]) -> Result\n where\n E: de::Error,\n {\n if field == self.tag.as_bytes() {\n Ok(TagContentOtherField::Tag)\n } else if field == self.content.as_bytes() {\n Ok(TagContentOtherField::Content)\n } else {\n Ok(TagContentOtherField::Other)\n }\n }\n }\n\n /// Not public API\n pub struct ContentDeserializer<'de, E> {\n content: Content<'de>,\n err: PhantomData,\n }\n\n impl<'de, E> ContentDeserializer<'de, E>\n where\n E: de::Error,\n {\n #[cold]\n fn invalid_type(self, exp: &dyn Expected) -> E {\n de::Error::invalid_type(content_unexpected(&self.content), exp)\n }\n\n fn deserialize_integer(self, visitor: V) -> Result\n where\n V: Visitor<'de>,\n {\n match self.content {\n Content::U8(v) => visitor.visit_u8(v),\n Content::U16(v) => visitor.visit_u16(v),\n Content::U32(v) => visitor.visit_u32(v),\n Content::U64(v) => visitor.visit_u64(v),\n Content::I8(v) => visitor.visit_i8(v),\n Content::I16(v) => visitor.visit_i16(v),\n Content::I32(v) => visitor.visit_i32(v),\n Content::I64(v) => visitor.visit_i64(v),\n _ => Err(self.invalid_type(&visitor)),\n }\n }\n\n fn deserialize_float(self, visitor: V) -> Result\n where\n V: Visitor<'de>,\n {\n match self.content {\n Content::F32(v) => visitor.visit_f32(v),\n Content::F64(v) => visitor.visit_f64(v),\n Content::U8(v) => visitor.visit_u8(v),\n Content::U16(v) => visitor.visit_u16(v),\n Content::U32(v) => visitor.visit_u32(v),\n Content::U64(v) => visitor.visit_u64(v),\n Content::I8(v) => visitor.visit_i8(v),\n Content::I16(v) => visitor.visit_i16(v),\n Content::I32(v) => visitor.visit_i32(v),\n Content::I64(v) => visitor.visit_i64(v),\n _ => Err(self.invalid_type(&visitor)),\n }\n }\n }\n\n fn visit_content_seq<'de, V, E>(content: Vec>, visitor: V) -> Result\n where\n V: Visitor<'de>,\n E: de::Error,\n {\n let mut seq_visitor = SeqDeserializer::new(content);\n let value = tri!(visitor.visit_seq(&mut seq_visitor));\n tri!(seq_visitor.end());\n Ok(value)\n }\n\n fn visit_content_map<'de, V, E>(\n content: Vec<(Content<'de>, Content<'de>)>,\n visitor: V,\n ) -> Result\n where\n V: Visitor<'de>,\n E: de::Error,\n {\n let mut map_visitor = MapDeserializer::new(content);\n let value = tri!(visitor.visit_map(&mut map_visitor));\n tri!(map_visitor.end());\n Ok(value)\n }\n\n /// Used when deserializing an internally tagged enum because the content\n /// will be used exactly once.\n #[cfg_attr(not(no_diagnostic_namespace), diagnostic::do_not_recommend)]\n impl<'de, E> Deserializer<'de> for ContentDeserializer<'de, E>\n where\n E: de::Error,\n {\n type Error = E;\n\n fn deserialize_any(self, visitor: V) -> Result\n where\n V: Visitor<'de>,\n {\n match self.content {\n Content::Bool(v) => visitor.visit_bool(v),\n Content::U8(v) => visitor.visit_u8(v),\n Content::U16(v) => visitor.visit_u16(v),\n Content::U32(v) => visitor.visit_u32(v),\n Content::U64(v) => visitor.visit_u64(v),\n Content::I8(v) => visitor.visit_i8(v),\n Content::I16(v) => visitor.visit_i16(v),\n Content::I32(v) => visitor.visit_i32(v),\n Content::I64(v) => visitor.visit_i64(v),\n Content::F32(v) => visitor.visit_f32(v),\n Content::F64(v) => visitor.visit_f64(v),\n Content::Char(v) => visitor.visit_char(v),\n Content::String(v) => visitor.visit_string(v),\n Content::Str(v) => visitor.visit_borrowed_str(v),\n Content::ByteBuf(v) => visitor.visit_byte_buf(v),\n Content::Bytes(v) => visitor.visit_borrowed_bytes(v),\n Content::Unit => visitor.visit_unit(),\n Content::None => visitor.visit_none(),\n Content::Some(v) => visitor.visit_some(ContentDeserializer::new(*v)),\n Content::Newtype(v) => visitor.visit_newtype_struct(ContentDeserializer::new(*v)),\n Content::Seq(v) => visit_content_seq(v, visitor),\n Content::Map(v) => visit_content_map(v, visitor),\n }\n }\n\n fn deserialize_bool(self, visitor: V) -> Result\n where\n V: Visitor<'de>,\n {\n match self.content {\n Content::Bool(v) => visitor.visit_bool(v),\n _ => Err(self.invalid_type(&visitor)),\n }\n }\n\n fn deserialize_i8(self, visitor: V) -> Result\n where\n V: Visitor<'de>,\n {\n self.deserialize_integer(visitor)\n }\n\n fn deserialize_i16(self, visitor: V) -> Result\n where\n V: Visitor<'de>,\n {\n self.deserialize_integer(visitor)\n }\n\n fn deserialize_i32(self, visitor: V) -> Result\n where\n V: Visitor<'de>,\n {\n self.deserialize_integer(visitor)\n }\n\n fn deserialize_i64(self, visitor: V) -> Result\n where\n V: Visitor<'de>,\n {\n self.deserialize_integer(visitor)\n }\n\n fn deserialize_u8(self, visitor: V) -> Result\n where\n V: Visitor<'de>,\n {\n self.deserialize_integer(visitor)\n }\n\n fn deserialize_u16(self, visitor: V) -> Result\n where\n V: Visitor<'de>,\n {\n self.deserialize_integer(visitor)\n }\n\n fn deserialize_u32(self, visitor: V) -> Result\n where\n V: Visitor<'de>,\n {\n self.deserialize_integer(visitor)\n }\n\n fn deserialize_u64(self, visitor: V) -> Result\n where\n V: Visitor<'de>,\n {\n self.deserialize_integer(visitor)\n }\n\n fn deserialize_f32(self, visitor: V) -> Result\n where\n V: Visitor<'de>,\n {\n self.deserialize_float(visitor)\n }\n\n fn deserialize_f64(self, visitor: V) -> Result\n where\n V: Visitor<'de>,\n {\n self.deserialize_float(visitor)\n }\n\n fn deserialize_char(self, visitor: V) -> Result\n where\n V: Visitor<'de>,\n {\n match self.content {\n Content::Char(v) => visitor.visit_char(v),\n Content::String(v) => visitor.visit_string(v),\n Content::Str(v) => visitor.visit_borrowed_str(v),\n _ => Err(self.invalid_type(&visitor)),\n }\n }\n\n fn deserialize_str(self, visitor: V) -> Result\n where\n V: Visitor<'de>,\n {\n self.deserialize_string(visitor)\n }\n\n fn deserialize_string(self, visitor: V) -> Result\n where\n V: Visitor<'de>,\n {\n match self.content {\n Content::String(v) => visitor.visit_string(v),\n Content::Str(v) => visitor.visit_borrowed_str(v),\n Content::ByteBuf(v) => visitor.visit_byte_buf(v),\n Content::Bytes(v) => visitor.visit_borrowed_bytes(v),\n _ => Err(self.invalid_type(&visitor)),\n }\n }\n\n fn deserialize_bytes(self, visitor: V) -> Result\n where\n V: Visitor<'de>,\n {\n self.deserialize_byte_buf(visitor)\n }\n\n fn deserialize_byte_buf(self, visitor: V) -> Result\n where\n V: Visitor<'de>,\n {\n match self.content {\n Content::String(v) => visitor.visit_string(v),\n Content::Str(v) => visitor.visit_borrowed_str(v),\n Content::ByteBuf(v) => visitor.visit_byte_buf(v),\n Content::Bytes(v) => visitor.visit_borrowed_bytes(v),\n Content::Seq(v) => visit_content_seq(v, visitor),\n _ => Err(self.invalid_type(&visitor)),\n }\n }\n\n fn deserialize_option(self, visitor: V) -> Result\n where\n V: Visitor<'de>,\n {\n match self.content {\n Content::None => visitor.visit_none(),\n Content::Some(v) => visitor.visit_some(ContentDeserializer::new(*v)),\n Content::Unit => visitor.visit_unit(),\n _ => visitor.visit_some(self),\n }\n }\n\n fn deserialize_unit(self, visitor: V) -> Result\n where\n V: Visitor<'de>,\n {\n match self.content {\n Content::Unit => visitor.visit_unit(),\n\n // Allow deserializing newtype variant containing unit.\n //\n // #[derive(Deserialize)]\n // #[serde(tag = \"result\")]\n // enum Response {\n // Success(T),\n // }\n //\n // We want {\"result\":\"Success\"} to deserialize into Response<()>.\n Content::Map(ref v) if v.is_empty() => visitor.visit_unit(),\n _ => Err(self.invalid_type(&visitor)),\n }\n }\n\n fn deserialize_unit_struct(\n self,\n _name: &'static str,\n visitor: V,\n ) -> Result\n where\n V: Visitor<'de>,\n {\n match self.content {\n // As a special case, allow deserializing untagged newtype\n // variant containing unit struct.\n //\n // #[derive(Deserialize)]\n // struct Info;\n //\n // #[derive(Deserialize)]\n // #[serde(tag = \"topic\")]\n // enum Message {\n // Info(Info),\n // }\n //\n // We want {\"topic\":\"Info\"} to deserialize even though\n // ordinarily unit structs do not deserialize from empty map/seq.\n Content::Map(ref v) if v.is_empty() => visitor.visit_unit(),\n Content::Seq(ref v) if v.is_empty() => visitor.visit_unit(),\n _ => self.deserialize_any(visitor),\n }\n }\n\n fn deserialize_newtype_struct(\n self,\n _name: &str,\n visitor: V,\n ) -> Result\n where\n V: Visitor<'de>,\n {\n match self.content {\n Content::Newtype(v) => visitor.visit_newtype_struct(ContentDeserializer::new(*v)),\n _ => visitor.visit_newtype_struct(self),\n }\n }\n\n fn deserialize_seq(self, visitor: V) -> Result\n where\n V: Visitor<'de>,\n {\n match self.content {\n Content::Seq(v) => visit_content_seq(v, visitor),\n _ => Err(self.invalid_type(&visitor)),\n }\n }\n\n fn deserialize_tuple(self, _len: usize, visitor: V) -> Result\n where\n V: Visitor<'de>,\n {\n self.deserialize_seq(visitor)\n }\n\n fn deserialize_tuple_struct(\n self,\n _name: &'static str,\n _len: usize,\n visitor: V,\n ) -> Result\n where\n V: Visitor<'de>,\n {\n self.deserialize_seq(visitor)\n }\n\n fn deserialize_map(self, visitor: V) -> Result\n where\n V: Visitor<'de>,\n {\n match self.content {\n Content::Map(v) => visit_content_map(v, visitor),\n _ => Err(self.invalid_type(&visitor)),\n }\n }\n\n fn deserialize_struct(\n self,\n _name: &'static str,\n _fields: &'static [&'static str],\n visitor: V,\n ) -> Result\n where\n V: Visitor<'de>,\n {\n match self.content {\n Content::Seq(v) => visit_content_seq(v, visitor),\n Content::Map(v) => visit_content_map(v, visitor),\n _ => Err(self.invalid_type(&visitor)),\n }\n }\n\n fn deserialize_enum(\n self,\n _name: &str,\n _variants: &'static [&'static str],\n visitor: V,\n ) -> Result\n where\n V: Visitor<'de>,\n {\n let (variant, value) = match self.content {\n Content::Map(value) => {\n let mut iter = value.into_iter();\n let (variant, value) = match iter.next() {\n Some(v) => v,\n None => {\n return Err(de::Error::invalid_value(\n de::Unexpected::Map,\n &\"map with a single key\",\n ));\n }\n };\n // enums are encoded in json as maps with a single key:value pair\n if iter.next().is_some() {\n return Err(de::Error::invalid_value(\n de::Unexpected::Map,\n &\"map with a single key\",\n ));\n }\n (variant, Some(value))\n }\n s @ Content::String(_) | s @ Content::Str(_) => (s, None),\n other => {\n return Err(de::Error::invalid_type(\n content_unexpected(&other),\n &\"string or map\",\n ));\n }\n };\n\n visitor.visit_enum(EnumDeserializer::new(variant, value))\n }\n\n fn deserialize_identifier(self, visitor: V) -> Result