wasmtime 20.0.2 → 21.0.1

data/ext/cargo-vendor/libm-0.2.8/src/math/truncf.rs

@@ -0,0 +1,42 @@
+use core::f32;
+
+#[cfg_attr(all(test, assert_no_panic), no_panic::no_panic)]
+pub fn truncf(x: f32) -> f32 {
+    // On wasm32 we know that LLVM's intrinsic will compile to an optimized
+    // `f32.trunc` native instruction, so we can leverage this for both code size
+    // and speed.
+    llvm_intrinsically_optimized! {
+        #[cfg(target_arch = "wasm32")] {
+            return unsafe { ::core::intrinsics::truncf32(x) }
+        }
+    }
+    let x1p120 = f32::from_bits(0x7b800000); // 0x1p120f === 2 ^ 120
+
+    let mut i: u32 = x.to_bits();
+    let mut e: i32 = (i >> 23 & 0xff) as i32 - 0x7f + 9;
+    let m: u32;
+
+    if e >= 23 + 9 {
+        return x;
+    }
+    if e < 9 {
+        e = 1;
+    }
+    m = -1i32 as u32 >> e;
+    if (i & m) == 0 {
+        return x;
+    }
+    force_eval!(x + x1p120);
+    i &= !m;
+    f32::from_bits(i)
+}
+
+// PowerPC tests are failing on LLVM 13: https://github.com/rust-lang/rust/issues/88520
+#[cfg(not(target_arch = "powerpc64"))]
+#[cfg(test)]
+mod tests {
+    #[test]
+    fn sanity_check() {
+        assert_eq!(super::truncf(1.1), 1.0);
+    }
+}

data/ext/cargo-vendor/postcard-1.0.8/.cargo-checksum.json

@@ -0,0 +1 @@
+{"files":{"CHANGELOG.md":"ee8f241004b797af4d358d8e40205a49921eb933200cadb7525aa549ff354320","Cargo.toml":"353f8d002e9f0839ee71b00fec13633bdccb3d1aa3a329bcabfff27ab228c97d","LICENSE-APACHE":"a60eea817514531668d7e00765731449fe14d059d3249e0bc93b36de45f759f2","LICENSE-MIT":"177540cad091a40e8071db310bc3b6115c4e329a92a234609b60c154b008a888","README.md":"f74dbb06448938d8926d28997d603ef6fc6c1265aebbd831cdc26d87a44436f4","spec/LICENSE-CC-BY-SA":"eabab313637aa737f628d37c041393ae257dbd3389f67a4ffb5f32a3ff80831d","spec/book.toml":"5151c0d8e663898db8f1be93feb56dfe2af55821803fbd807589f961d081544f","spec/src/SUMMARY.md":"19a8fe290c6386700efad00e9073c18208d119e83f6d4e447791976896a959e3","spec/src/glossary.md":"ea1449028cfea40ad257c73e52af76386956299670cabddc64f8ac6a838130b4","spec/src/intro.md":"9fcbdedd429ece5db6b146208cc6cc6dcc40b284df325ca8d9b1856c61008186","spec/src/serde-data-model.md":"38dd3628e96649439ed61a631b0c316b9f190355aae0b83857b4ea5abe4bfb03","spec/src/wire-format.md":"4f774c5e7131fcbc03a3407e56a444bf9d85837397d02a2c8a36591d8073ec4c","src/accumulator.rs":"d9d1d7c797466db56aa718641aaa2045aadadc5ced20c5805c674a8b3a84c474","src/de/deserializer.rs":"39f86932bd454e98d916f5dcfd7df0d9f1a4a18efedde307660fffa0132a956f","src/de/flavors.rs":"d7d98f41c01544bdd4de5adbe74ce81b0f0d970ffb80fcfef70ab8d6b452b7e0","src/de/mod.rs":"60f61bec97feac53ef7267379324f489d566d688945d15a60a38568652330e98","src/error.rs":"cc72055220d80ac0643ce9321950f52255c191803df1cf6cf83e7774810f90e7","src/fixint.rs":"b9ccd4c32896cad4907c3b3bb776ba9175cac59c2e21e256874ee475cff40dec","src/lib.rs":"3ac72529168720c04c98a4ce3cbb3ff18ca3c173d33933a5e5af1ed783675ac7","src/max_size.rs":"5210dd845cb838a5ece8c705b42ef9b2ca53655cb3a0fde076a67ed68472e322","src/schema.rs":"9aa17bc42cd4183ab2977ce363d2bef779c08ad8f98692b23d459ff6bd8beb76","src/ser/flavors.rs":"d919f653c6b34137e21615588c1fd51f599736ad99aaadee62d81a4c66b5b636","src/ser/mod.rs":"1de32897c58ad71329a7c568b42174852879e714e705b2a5358aeb627cbfb5b3","src/ser/serializer.rs":"ac661cb1a915caf23c40084201bb16930b11ca9bfabf6d231e70a1f2b5ea31d1","src/varint.rs":"d40e63d0e13752c562f5116da2cbc786f608815a97076f94bf56b701b39120d4","tests/accumulator.rs":"2620178470f4dc33eb2144e1f92c33626276429872ef9303d93b537f8468727d","tests/crc.rs":"7c3fdf2d28e18b777b8200a5c1fd82943e2eaefa8d30b3ddc7dd6b7aa1ff4a95","tests/loopback.rs":"3ec8392b16058d1d523a856ad614c7c5407b04b8c7811c1f91caec0315cf75ac","tests/max_size.rs":"074487dc54725a0b54066b61b663bad75d9e18e0921ec1743ce434563adeb9fd","tests/schema.rs":"de914aaad238ca67b9c67f9410d681dfa5ac237877040a6528fe1537f4a72ae5"},"package":"a55c51ee6c0db07e68448e336cf8ea4131a620edefebf9893e759b2d793420f8"}

data/ext/cargo-vendor/postcard-1.0.8/CHANGELOG.md

@@ -0,0 +1,141 @@
+# Changelog
+
+Changes will be described here.
+
+## 1.0.8 -> Unreleased
+
+* None yet!
+
+## 1.0.7 -> 1.0.8
+
+* Add IO traits support by @xgroleau in https://github.com/jamesmunns/postcard/pull/91
+
+## 1.0.6 -> 1.0.7
+
+* Fix off-by-one in varint size calculation by @Palladinium in https://github.com/jamesmunns/postcard/pull/111
+* Add specific error for Crc errors by @CBJamo in https://github.com/jamesmunns/postcard/pull/112
+
+## 1.0.5 -> 1.0.6
+
+* Add cfg information to docs by @dtolnay in https://github.com/jamesmunns/postcard/pull/108
+
+## 1.0.4 -> 1.0.5
+
+* improved documentation of the cobs decoding by @gutzchi in https://github.com/jamesmunns/postcard/pull/97
+* Fix strict provenance use of pointers by @jamesmunns in https://github.com/jamesmunns/postcard/pull/100
+* Introduces CRCs by @huntc in https://github.com/jamesmunns/postcard/pull/98
+* Format with rustfmt to eliminate trailing whitespaces by @dtolnay in https://github.com/jamesmunns/postcard/pull/104
+* Fix documentation of re-exports that have dedicated doc comment by @dtolnay in https://github.com/jamesmunns/postcard/pull/107
+
+## New Contributors
+
+* @gutzchi made their first contribution in https://github.com/jamesmunns/postcard/pull/97
+
+**Full Changelog**: https://github.com/jamesmunns/postcard/compare/v1.0.4...v1.0.5
+
+## 1.0.3 -> 1.0.4
+
+* fix cobs accumulator out-of-bounds index when data is 1 byte too long ([PR#90])
+* Move cobs accumulator tests into a `cfg(test)` module
+
+[PR#90]: https://github.com/jamesmunns/postcard/pull/90
+
+## 1.0.2 -> 1.0.3
+
+* PhantomData's T doesn't need MaxSize impl ([PR#87])
+* Add function for computing the postcard serialized size of a value. ([PR#86])
+* Fix typos & encoding example in wire doc ([PR#83])
+* Optimize varint decode ([PR#62])
+* Bump postcard-derive version ([PR#74])
+* add std::string::String and alloc::string::String ([PR#76])
+* Make fixints usable through serde field attributes instead of wrappers ([PR#69])
+* Add support for 16-bit and 8-bit architectures ([PR#64])
+* Add feed_ref to cobs_accumulator ([PR#70])
+* Add a link to doc.rs documentation in README ([PR#72])
+
+[PR#87]: https://github.com/jamesmunns/postcard/pull/87
+[PR#86]: https://github.com/jamesmunns/postcard/pull/86
+[PR#83]: https://github.com/jamesmunns/postcard/pull/83
+[PR#62]: https://github.com/jamesmunns/postcard/pull/62
+[PR#74]: https://github.com/jamesmunns/postcard/pull/74
+[PR#76]: https://github.com/jamesmunns/postcard/pull/76
+[PR#69]: https://github.com/jamesmunns/postcard/pull/69
+[PR#64]: https://github.com/jamesmunns/postcard/pull/64
+[PR#70]: https://github.com/jamesmunns/postcard/pull/70
+[PR#72]: https://github.com/jamesmunns/postcard/pull/72
+
+## 1.0.1 -> 1.0.2
+
+* Correct exporting of experimental Schema proc macro ([PR#73])
+
+[PR#73]: https://github.com/jamesmunns/postcard/pull/73
+
+## 1.0.0 -> 1.0.1
+
+* [Fixed deserialization] of `i128`, which was using the "new style" varint serialization, but the incorrect, "old style" fixed deserialization.
+    * This is considered a defect, and not a breaking change, as it brings the code back in line with the specification behavior.
+    * Version 1.0.0 will be yanked due to this defect.
+
+[Fixed deserialization]: https://github.com/jamesmunns/postcard/commit/70ea33a1ac7f82632697f4578002267eaf9095f5
+
+## 1.0.0-alpha.4 -> 1.0.0
+
+* Added experimental derive features
+* Made Flavor fields private again
+* Optimized varint encoding
+* Use crate `Result` for `Flavor`s
+
+## 1.0.0-alpha.3 -> 1.0.0-alpha.4
+
+* Updated the signature of deserialization `Flavor` trait
+* Added documentation and tests
+* Removed the `Encoder` wrapper type to better match serialization and deserialization types
+* Renamed `ser_flavor::Flavor::release` to `finalize` for consistency
+* Re-organized some public items and modules
+* Made `Error` non-exhaustive
+* Added a `fixint` type to avoid varints
+
+## 1.0.0-alpha.2 -> 1.0.0-alpha.3
+
+* Moved back to `cobs` from `postcard-cobs`
+    * This fixed a number of upstream issues, including removal of panicking branches
+* Improved documentation and code examples
+* Corrected the behavior of `take_from_cobs`
+* Added support for serializing `Debug`/`Display` representation strings via serde's `collect_str` method (and removed the panic)
+
+## 1.0.0-alpha.1 -> 1.0.0-alpha.2
+
+* Re-exposed fields of the Flavor constructors, made various flavors impl `Default`
+* No breaking changes vs `1.0.0-alpha.1`.
+
+## 0.7.3 -> 1.0.0-alpha.1
+
+* WARNING: This includes a BREAKING wire change from postcard v0.x.y! Please ensure
+    all devices using postcard are recompiled with the newest version!
+* added `#[inline]` to many functions, increasing performance
+* All unsigned integers u16-u128 are varint encoded
+* All signed integers i16-i128 are zigzag + varint encoded
+* Serialization flavors have been tweaked slightly, with the `Slice` flavor now faster
+* Introduction of Deserialization flavors
+* Please report any bugs upstream as we prepare for the v1.0.0 release!
+
+## 0.7.2 -> 0.7.3
+
+* Added optional [`defmt`](https://crates.io/crates/defmt) support with the `use-defmt` feature.
+* Improved docs
+
+## 0.7.1 -> 0.7.2
+
+* Changed the `CobsAccumulator::new()` into a const fn.
+
+## 0.7.0 -> 0.7.1
+
+* Added the `CobsAccumulator` type for accumulating COBS encoded data for deserialization.
+
+## 0.6.x -> 0.7.0
+
+* Updated `heapless` dependency to `v0.7.0`, which added support for const-generic sized buffers.
+
+## Prior to 0.7.0
+
+* No changelog information added yet.

data/ext/cargo-vendor/postcard-1.0.8/Cargo.toml

@@ -0,0 +1,100 @@
+# THIS FILE IS AUTOMATICALLY GENERATED BY CARGO
+#
+# When uploading crates to the registry Cargo will automatically
+# "normalize" Cargo.toml files for maximal compatibility
+# with all versions of Cargo and also rewrite `path` dependencies
+# to registry (e.g., crates.io) dependencies.
+#
+# If you are reading this file be aware that the original Cargo.toml
+# will likely look very different (and much more reasonable).
+# See Cargo.toml.orig for the original contents.
+
+[package]
+edition = "2018"
+name = "postcard"
+version = "1.0.8"
+authors = ["James Munns <james@onevariable.com>"]
+description = "A no_std + serde compatible message library for Rust"
+documentation = "https://docs.rs/postcard/"
+readme = "README.md"
+keywords = [
+    "serde",
+    "cobs",
+    "framing",
+]
+categories = [
+    "embedded",
+    "no-std",
+]
+license = "MIT OR Apache-2.0"
+repository = "https://github.com/jamesmunns/postcard"
+
+[package.metadata.docs.rs]
+all-features = true
+rustdoc-args = [
+    "--cfg",
+    "doc_cfg",
+]
+
+[dependencies.cobs]
+version = "0.2.3"
+default-features = false
+
+[dependencies.const_format]
+version = "0.2.24"
+optional = true
+
+[dependencies.crc]
+version = "3.0.1"
+optional = true
+
+[dependencies.defmt]
+version = "0.3"
+optional = true
+
+[dependencies.embedded-io]
+version = "0.4"
+optional = true
+
+[dependencies.heapless]
+version = "0.7.0"
+features = ["serde"]
+optional = true
+default-features = false
+
+[dependencies.paste]
+version = "1.0.12"
+optional = true
+
+[dependencies.postcard-derive]
+version = "0.1.1"
+optional = true
+
+[dependencies.serde]
+version = "1.0.100"
+features = ["derive"]
+default-features = false
+
+[features]
+alloc = [
+    "serde/alloc",
+    "embedded-io/alloc",
+]
+default = ["heapless-cas"]
+experimental-derive = [
+    "postcard-derive",
+    "const_format",
+]
+heapless-cas = [
+    "heapless",
+    "heapless/cas",
+]
+use-crc = [
+    "crc",
+    "paste",
+]
+use-defmt = ["defmt"]
+use-std = [
+    "serde/std",
+    "alloc",
+]

data/ext/cargo-vendor/postcard-1.0.8/LICENSE-APACHE

@@ -0,0 +1,201 @@
+                              Apache License
+                        Version 2.0, January 2004
+                     http://www.apache.org/licenses/
+
+TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+1. Definitions.
+
+   "License" shall mean the terms and conditions for use, reproduction,
+   and distribution as defined by Sections 1 through 9 of this document.
+
+   "Licensor" shall mean the copyright owner or entity authorized by
+   the copyright owner that is granting the License.
+
+   "Legal Entity" shall mean the union of the acting entity and all
+   other entities that control, are controlled by, or are under common
+   control with that entity. For the purposes of this definition,
+   "control" means (i) the power, direct or indirect, to cause the
+   direction or management of such entity, whether by contract or
+   otherwise, or (ii) ownership of fifty percent (50%) or more of the
+   outstanding shares, or (iii) beneficial ownership of such entity.
+
+   "You" (or "Your") shall mean an individual or Legal Entity
+   exercising permissions granted by this License.
+
+   "Source" form shall mean the preferred form for making modifications,
+   including but not limited to software source code, documentation
+   source, and configuration files.
+
+   "Object" form shall mean any form resulting from mechanical
+   transformation or translation of a Source form, including but
+   not limited to compiled object code, generated documentation,
+   and conversions to other media types.
+
+   "Work" shall mean the work of authorship, whether in Source or
+   Object form, made available under the License, as indicated by a
+   copyright notice that is included in or attached to the work
+   (an example is provided in the Appendix below).
+
+   "Derivative Works" shall mean any work, whether in Source or Object
+   form, that is based on (or derived from) the Work and for which the
+   editorial revisions, annotations, elaborations, or other modifications
+   represent, as a whole, an original work of authorship. For the purposes
+   of this License, Derivative Works shall not include works that remain
+   separable from, or merely link (or bind by name) to the interfaces of,
+   the Work and Derivative Works thereof.
+
+   "Contribution" shall mean any work of authorship, including
+   the original version of the Work and any modifications or additions
+   to that Work or Derivative Works thereof, that is intentionally
+   submitted to Licensor for inclusion in the Work by the copyright owner
+   or by an individual or Legal Entity authorized to submit on behalf of
+   the copyright owner. For the purposes of this definition, "submitted"
+   means any form of electronic, verbal, or written communication sent
+   to the Licensor or its representatives, including but not limited to
+   communication on electronic mailing lists, source code control systems,
+   and issue tracking systems that are managed by, or on behalf of, the
+   Licensor for the purpose of discussing and improving the Work, but
+   excluding communication that is conspicuously marked or otherwise
+   designated in writing by the copyright owner as "Not a Contribution."
+
+   "Contributor" shall mean Licensor and any individual or Legal Entity
+   on behalf of whom a Contribution has been received by Licensor and
+   subsequently incorporated within the Work.
+
+2. Grant of Copyright License. Subject to the terms and conditions of
+   this License, each Contributor hereby grants to You a perpetual,
+   worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+   copyright license to reproduce, prepare Derivative Works of,
+   publicly display, publicly perform, sublicense, and distribute the
+   Work and such Derivative Works in Source or Object form.
+
+3. Grant of Patent License. Subject to the terms and conditions of
+   this License, each Contributor hereby grants to You a perpetual,
+   worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+   (except as stated in this section) patent license to make, have made,
+   use, offer to sell, sell, import, and otherwise transfer the Work,
+   where such license applies only to those patent claims licensable
+   by such Contributor that are necessarily infringed by their
+   Contribution(s) alone or by combination of their Contribution(s)
+   with the Work to which such Contribution(s) was submitted. If You
+   institute patent litigation against any entity (including a
+   cross-claim or counterclaim in a lawsuit) alleging that the Work
+   or a Contribution incorporated within the Work constitutes direct
+   or contributory patent infringement, then any patent licenses
+   granted to You under this License for that Work shall terminate
+   as of the date such litigation is filed.
+
+4. Redistribution. You may reproduce and distribute copies of the
+   Work or Derivative Works thereof in any medium, with or without
+   modifications, and in Source or Object form, provided that You
+   meet the following conditions:
+
+   (a) You must give any other recipients of the Work or
+       Derivative Works a copy of this License; and
+
+   (b) You must cause any modified files to carry prominent notices
+       stating that You changed the files; and
+
+   (c) You must retain, in the Source form of any Derivative Works
+       that You distribute, all copyright, patent, trademark, and
+       attribution notices from the Source form of the Work,
+       excluding those notices that do not pertain to any part of
+       the Derivative Works; and
+
+   (d) If the Work includes a "NOTICE" text file as part of its
+       distribution, then any Derivative Works that You distribute must
+       include a readable copy of the attribution notices contained
+       within such NOTICE file, excluding those notices that do not
+       pertain to any part of the Derivative Works, in at least one
+       of the following places: within a NOTICE text file distributed
+       as part of the Derivative Works; within the Source form or
+       documentation, if provided along with the Derivative Works; or,
+       within a display generated by the Derivative Works, if and
+       wherever such third-party notices normally appear. The contents
+       of the NOTICE file are for informational purposes only and
+       do not modify the License. You may add Your own attribution
+       notices within Derivative Works that You distribute, alongside
+       or as an addendum to the NOTICE text from the Work, provided
+       that such additional attribution notices cannot be construed
+       as modifying the License.
+
+   You may add Your own copyright statement to Your modifications and
+   may provide additional or different license terms and conditions
+   for use, reproduction, or distribution of Your modifications, or
+   for any such Derivative Works as a whole, provided Your use,
+   reproduction, and distribution of the Work otherwise complies with
+   the conditions stated in this License.
+
+5. Submission of Contributions. Unless You explicitly state otherwise,
+   any Contribution intentionally submitted for inclusion in the Work
+   by You to the Licensor shall be under the terms and conditions of
+   this License, without any additional terms or conditions.
+   Notwithstanding the above, nothing herein shall supersede or modify
+   the terms of any separate license agreement you may have executed
+   with Licensor regarding such Contributions.
+
+6. Trademarks. This License does not grant permission to use the trade
+   names, trademarks, service marks, or product names of the Licensor,
+   except as required for reasonable and customary use in describing the
+   origin of the Work and reproducing the content of the NOTICE file.
+
+7. Disclaimer of Warranty. Unless required by applicable law or
+   agreed to in writing, Licensor provides the Work (and each
+   Contributor provides its Contributions) on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+   implied, including, without limitation, any warranties or conditions
+   of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+   PARTICULAR PURPOSE. You are solely responsible for determining the
+   appropriateness of using or redistributing the Work and assume any
+   risks associated with Your exercise of permissions under this License.
+
+8. Limitation of Liability. In no event and under no legal theory,
+   whether in tort (including negligence), contract, or otherwise,
+   unless required by applicable law (such as deliberate and grossly
+   negligent acts) or agreed to in writing, shall any Contributor be
+   liable to You for damages, including any direct, indirect, special,
+   incidental, or consequential damages of any character arising as a
+   result of this License or out of the use or inability to use the
+   Work (including but not limited to damages for loss of goodwill,
+   work stoppage, computer failure or malfunction, or any and all
+   other commercial damages or losses), even if such Contributor
+   has been advised of the possibility of such damages.
+
+9. Accepting Warranty or Additional Liability. While redistributing
+   the Work or Derivative Works thereof, You may choose to offer,
+   and charge a fee for, acceptance of support, warranty, indemnity,
+   or other liability obligations and/or rights consistent with this
+   License. However, in accepting such obligations, You may act only
+   on Your own behalf and on Your sole responsibility, not on behalf
+   of any other Contributor, and only if You agree to indemnify,
+   defend, and hold each Contributor harmless for any liability
+   incurred by, or claims asserted against, such Contributor by reason
+   of your accepting any such warranty or additional liability.
+
+END OF TERMS AND CONDITIONS
+
+APPENDIX: How to apply the Apache License to your work.
+
+   To apply the Apache License to your work, attach the following
+   boilerplate notice, with the fields enclosed by brackets "[]"
+   replaced with your own identifying information. (Don't include
+   the brackets!)  The text should be enclosed in the appropriate
+   comment syntax for the file format. We also recommend that a
+   file or class name and description of purpose be included on the
+   same "printed page" as the copyright notice for easier
+   identification within third-party archives.
+
+Copyright [yyyy] [name of copyright owner]
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+	http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

data/ext/cargo-vendor/postcard-1.0.8/LICENSE-MIT

@@ -0,0 +1,25 @@
+Copyright (c) 2019 Anthony James Munns
+
+Permission is hereby granted, free of charge, to any
+person obtaining a copy of this software and associated
+documentation files (the "Software"), to deal in the
+Software without restriction, including without
+limitation the rights to use, copy, modify, merge,
+publish, distribute, sublicense, and/or sell copies of
+the Software, and to permit persons to whom the Software
+is furnished to do so, subject to the following
+conditions:
+
+The above copyright notice and this permission notice
+shall be included in all copies or substantial portions
+of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF
+ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED
+TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A
+PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT
+SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR
+IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
+DEALINGS IN THE SOFTWARE.

data/ext/cargo-vendor/postcard-1.0.8/README.md

@@ -0,0 +1,146 @@
+# Postcard
+
+[![Documentation](https://docs.rs/postcard/badge.svg)](https://docs.rs/postcard)
+
+Postcard is a `#![no_std]` focused serializer and deserializer for Serde.
+
+Postcard aims to be convenient for developers in constrained environments, while
+allowing for flexibility to customize behavior as needed.
+
+## Design Goals
+
+1. Design primarily for `#![no_std]` usage, in embedded or other constrained contexts
+2. Support a maximal set of `serde` features, so `postcard` can be used as a drop in replacement
+3. Avoid special differences in code between communication code written for a microcontroller or a desktop/server PC
+4. Be resource efficient - memory usage, code size, developer time, and CPU time; in that order
+5. Allow library users to customize the serialization and deserialization  behavior to fit their bespoke needs
+
+## Format Stability
+
+As of v1.0.0, `postcard` has a documented and stable wire format. More information about this
+wire format can be found in the `spec/` folder of the Postcard repository, or viewed online
+at <https://postcard.jamesmunns.com>.
+
+Work towards the Postcard Specification and portions of the Postcard 1.0 Release
+were sponsored by Mozilla Corporation.
+
+## Variable Length Data
+
+All signed and unsigned integers larger than eight bits are encoded using a [Varint].
+This includes the length of array slices, as well as the discriminant of `enums`.
+
+For more information, see the [Varint] chapter of the wire specification.
+
+[Varint]: https://postcard.jamesmunns.com/wire-format.html#varint-encoded-integers
+
+## Example - Serialization/Deserialization
+
+Postcard can serialize and deserialize messages similar to other `serde` formats.
+
+Using the default `heapless` feature to serialize to a `heapless::Vec<u8>`:
+
+```rust
+use core::ops::Deref;
+use serde::{Serialize, Deserialize};
+use postcard::{from_bytes, to_vec};
+use heapless::Vec;
+
+#[derive(Serialize, Deserialize, Debug, Eq, PartialEq)]
+struct RefStruct<'a> {
+    bytes: &'a [u8],
+    str_s: &'a str,
+}
+let message = "hElLo";
+let bytes = [0x01, 0x10, 0x02, 0x20];
+let output: Vec<u8, 11> = to_vec(&RefStruct {
+    bytes: &bytes,
+    str_s: message,
+}).unwrap();
+
+assert_eq!(
+    &[0x04, 0x01, 0x10, 0x02, 0x20, 0x05, b'h', b'E', b'l', b'L', b'o',],
+    output.deref()
+);
+
+let out: RefStruct = from_bytes(output.deref()).unwrap();
+assert_eq!(
+    out,
+    RefStruct {
+        bytes: &bytes,
+        str_s: message,
+    }
+);
+```
+
+Or the optional `alloc` feature to serialize to an `alloc::vec::Vec<u8>`:
+
+```rust
+use core::ops::Deref;
+use serde::{Serialize, Deserialize};
+use postcard::{from_bytes, to_allocvec};
+extern crate alloc;
+use alloc::vec::Vec;
+
+#[derive(Serialize, Deserialize, Debug, Eq, PartialEq)]
+struct RefStruct<'a> {
+    bytes: &'a [u8],
+    str_s: &'a str,
+}
+let message = "hElLo";
+let bytes = [0x01, 0x10, 0x02, 0x20];
+let output: Vec<u8> = to_allocvec(&RefStruct {
+    bytes: &bytes,
+    str_s: message,
+}).unwrap();
+
+assert_eq!(
+    &[0x04, 0x01, 0x10, 0x02, 0x20, 0x05, b'h', b'E', b'l', b'L', b'o',],
+    output.deref()
+);
+
+let out: RefStruct = from_bytes(output.deref()).unwrap();
+assert_eq!(
+    out,
+    RefStruct {
+        bytes: &bytes,
+        str_s: message,
+    }
+);
+```
+
+## Flavors
+
+`postcard` supports a system called `Flavors`, which are used to modify the way
+postcard serializes or processes serialized data. These flavors act as "plugins" or "middlewares"
+during the serialization or deserialization process, and can be combined to obtain complex protocol formats.
+
+See the documentation of the `ser_flavors` or `de_flavors` modules for more information on usage.
+
+## Setup - `Cargo.toml`
+
+Don't forget to add [the `no-std` subset](https://serde.rs/no-std.html) of `serde` along with `postcard` to the `[dependencies]` section of your `Cargo.toml`!
+
+```toml
+[dependencies]
+postcard = "1.0.0"
+
+# By default, `serde` has the `std` feature enabled, which makes it unsuitable for embedded targets
+# disabling default-features fixes this
+serde = { version = "1.0.*", default-features = false }
+```
+
+## License
+
+Licensed under either of
+
+- Apache License, Version 2.0 ([LICENSE-APACHE](LICENSE-APACHE) or
+  <http://www.apache.org/licenses/LICENSE-2.0>)
+- MIT license ([LICENSE-MIT](LICENSE-MIT) or <http://opensource.org/licenses/MIT>)
+
+at your option.
+
+### Contribution
+
+Unless you explicitly state otherwise, any contribution intentionally submitted
+for inclusion in the work by you, as defined in the Apache-2.0 license, shall be
+dual licensed as above, without any additional terms or conditions.