covalence 0.1.0.dev8__tar.gz → 0.1.0.dev10__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (201) hide show
  1. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/Cargo.lock +38 -24
  2. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/Cargo.toml +20 -19
  3. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/PKG-INFO +5 -5
  4. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/README.md +4 -4
  5. covalence-0.1.0.dev10/crates/blob/verify/Cargo.toml +35 -0
  6. covalence-0.1.0.dev10/crates/blob/verify/README.md +83 -0
  7. covalence-0.1.0.dev10/crates/blob/verify/src/lib.rs +315 -0
  8. covalence-0.1.0.dev10/crates/blob/verify/src/read.rs +354 -0
  9. covalence-0.1.0.dev10/crates/blob/verify/src/write.rs +188 -0
  10. covalence-0.1.0.dev10/crates/blob/verify/tests/common/mod.rs +87 -0
  11. covalence-0.1.0.dev10/crates/blob/verify/tests/sync.rs +417 -0
  12. covalence-0.1.0.dev10/crates/blob/verify/tests/tokio.rs +258 -0
  13. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/crates/cas/kv/Cargo.toml +1 -0
  14. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/crates/cas/kv/src/brotli.rs +5 -10
  15. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/crates/cas/kv/src/lib.rs +10 -36
  16. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/crates/cas/kv/tests/kv.rs +34 -0
  17. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/crates/cas/sqlite/src/lib.rs +94 -4
  18. covalence-0.1.0.dev10/crates/cas/sqlite/tests/pointer_map.rs +82 -0
  19. covalence-0.1.0.dev10/crates/cas/sqlite/tests/range_io.rs +102 -0
  20. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/crates/kv/s3/src/lib.rs +45 -12
  21. covalence-0.1.0.dev10/crates/kv/s3/src/resolve.rs +447 -0
  22. covalence-0.1.0.dev10/crates/python/LICENSE-APACHE +202 -0
  23. covalence-0.1.0.dev10/crates/python/LICENSE-CC0 +121 -0
  24. covalence-0.1.0.dev10/crates/python/LICENSE-MIT +21 -0
  25. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/crates/python/README.md +4 -4
  26. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/python/covalence/THIRD-PARTY-LICENSES.md +19 -18
  27. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/LICENSE-APACHE +0 -0
  28. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/LICENSE-CC0 +0 -0
  29. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/LICENSE-MIT +0 -0
  30. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/crates/blob/trait/Cargo.toml +0 -0
  31. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/crates/blob/trait/LICENSE-APACHE +0 -0
  32. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/crates/blob/trait/LICENSE-CC0 +0 -0
  33. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/crates/blob/trait/LICENSE-MIT +0 -0
  34. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/crates/blob/trait/README.md +0 -0
  35. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/crates/blob/trait/src/lib.rs +0 -0
  36. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/crates/blob/trait/tests/blob.rs +0 -0
  37. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/crates/blob/trait/tests/common/mod.rs +0 -0
  38. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/crates/blob/trait/tests/fact.rs +0 -0
  39. {covalence-0.1.0.dev8/crates/cas/kv → covalence-0.1.0.dev10/crates/blob/verify}/LICENSE-APACHE +0 -0
  40. {covalence-0.1.0.dev8/crates/cas/kv → covalence-0.1.0.dev10/crates/blob/verify}/LICENSE-CC0 +0 -0
  41. {covalence-0.1.0.dev8/crates/cas/kv → covalence-0.1.0.dev10/crates/blob/verify}/LICENSE-MIT +0 -0
  42. {covalence-0.1.0.dev8/crates/cas/memory → covalence-0.1.0.dev10/crates/cas/kv}/LICENSE-APACHE +0 -0
  43. {covalence-0.1.0.dev8/crates/cas/memory → covalence-0.1.0.dev10/crates/cas/kv}/LICENSE-CC0 +0 -0
  44. {covalence-0.1.0.dev8/crates/cas/memory → covalence-0.1.0.dev10/crates/cas/kv}/LICENSE-MIT +0 -0
  45. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/crates/cas/kv/examples/zstd.rs +0 -0
  46. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/crates/cas/kv/src/deflate.rs +0 -0
  47. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/crates/cas/kv/src/gzip.rs +0 -0
  48. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/crates/cas/kv/src/zstd.rs +0 -0
  49. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/crates/cas/kv/tests/compressed.rs +0 -0
  50. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/crates/cas/kv/tests/features.rs +0 -0
  51. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/crates/cas/kv/tests/http_codings.rs +0 -0
  52. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/crates/cas/memory/Cargo.toml +0 -0
  53. {covalence-0.1.0.dev8/crates/cas/sqlite → covalence-0.1.0.dev10/crates/cas/memory}/LICENSE-APACHE +0 -0
  54. {covalence-0.1.0.dev8/crates/cas/sqlite → covalence-0.1.0.dev10/crates/cas/memory}/LICENSE-CC0 +0 -0
  55. {covalence-0.1.0.dev8/crates/cas/sqlite → covalence-0.1.0.dev10/crates/cas/memory}/LICENSE-MIT +0 -0
  56. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/crates/cas/memory/src/lib.rs +0 -0
  57. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/crates/cas/memory/tests/memory.rs +0 -0
  58. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/crates/cas/sqlite/Cargo.toml +0 -0
  59. {covalence-0.1.0.dev8/crates/cas/trait → covalence-0.1.0.dev10/crates/cas/sqlite}/LICENSE-APACHE +0 -0
  60. {covalence-0.1.0.dev8/crates/cas/trait → covalence-0.1.0.dev10/crates/cas/sqlite}/LICENSE-CC0 +0 -0
  61. {covalence-0.1.0.dev8/crates/cas/trait → covalence-0.1.0.dev10/crates/cas/sqlite}/LICENSE-MIT +0 -0
  62. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/crates/cas/sqlite/tests/sqlite.rs +0 -0
  63. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/crates/cas/trait/Cargo.toml +0 -0
  64. {covalence-0.1.0.dev8/crates/kv/memory → covalence-0.1.0.dev10/crates/cas/trait}/LICENSE-APACHE +0 -0
  65. {covalence-0.1.0.dev8/crates/kv/memory → covalence-0.1.0.dev10/crates/cas/trait}/LICENSE-CC0 +0 -0
  66. {covalence-0.1.0.dev8/crates/kv/memory → covalence-0.1.0.dev10/crates/cas/trait}/LICENSE-MIT +0 -0
  67. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/crates/cas/trait/src/lib.rs +0 -0
  68. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/crates/cas/trait/tests/trait.rs +0 -0
  69. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/crates/kv/memory/Cargo.toml +0 -0
  70. {covalence-0.1.0.dev8/crates/kv/s3 → covalence-0.1.0.dev10/crates/kv/memory}/LICENSE-APACHE +0 -0
  71. {covalence-0.1.0.dev8/crates/kv/s3 → covalence-0.1.0.dev10/crates/kv/memory}/LICENSE-CC0 +0 -0
  72. {covalence-0.1.0.dev8/crates/kv/s3 → covalence-0.1.0.dev10/crates/kv/memory}/LICENSE-MIT +0 -0
  73. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/crates/kv/memory/src/lib.rs +0 -0
  74. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/crates/kv/memory/tests/memory.rs +0 -0
  75. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/crates/kv/s3/Cargo.toml +0 -0
  76. {covalence-0.1.0.dev8/crates/kv/trait → covalence-0.1.0.dev10/crates/kv/s3}/LICENSE-APACHE +0 -0
  77. {covalence-0.1.0.dev8/crates/kv/trait → covalence-0.1.0.dev10/crates/kv/s3}/LICENSE-CC0 +0 -0
  78. {covalence-0.1.0.dev8/crates/kv/trait → covalence-0.1.0.dev10/crates/kv/s3}/LICENSE-MIT +0 -0
  79. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/crates/kv/s3/src/list.rs +0 -0
  80. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/crates/kv/s3/src/read.rs +0 -0
  81. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/crates/kv/s3/src/sign.rs +0 -0
  82. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/crates/kv/s3/src/write.rs +0 -0
  83. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/crates/kv/s3/tests/aws.rs +0 -0
  84. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/crates/kv/s3/tests/kv.rs +0 -0
  85. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/crates/kv/trait/Cargo.toml +0 -0
  86. {covalence-0.1.0.dev8/crates/lib/cid → covalence-0.1.0.dev10/crates/kv/trait}/LICENSE-APACHE +0 -0
  87. {covalence-0.1.0.dev8/crates/lib/cid → covalence-0.1.0.dev10/crates/kv/trait}/LICENSE-CC0 +0 -0
  88. {covalence-0.1.0.dev8/crates/lib/cid → covalence-0.1.0.dev10/crates/kv/trait}/LICENSE-MIT +0 -0
  89. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/crates/kv/trait/src/lib.rs +0 -0
  90. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/crates/kv/trait/tests/atomic.rs +0 -0
  91. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/crates/lib/cid/Cargo.toml +0 -0
  92. {covalence-0.1.0.dev8/crates/lib/config → covalence-0.1.0.dev10/crates/lib/cid}/LICENSE-APACHE +0 -0
  93. {covalence-0.1.0.dev8/crates/lib/config → covalence-0.1.0.dev10/crates/lib/cid}/LICENSE-CC0 +0 -0
  94. {covalence-0.1.0.dev8/crates/lib/config → covalence-0.1.0.dev10/crates/lib/cid}/LICENSE-MIT +0 -0
  95. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/crates/lib/cid/README.md +0 -0
  96. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/crates/lib/cid/src/dasl.rs +0 -0
  97. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/crates/lib/cid/src/fact.rs +0 -0
  98. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/crates/lib/cid/src/git.rs +0 -0
  99. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/crates/lib/cid/src/lib.rs +0 -0
  100. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/crates/lib/cid/src/multicodec.rs +0 -0
  101. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/crates/lib/cid/src/o256.rs +0 -0
  102. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/crates/lib/cid/src/storage.rs +0 -0
  103. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/crates/lib/cid/tests/cid.rs +0 -0
  104. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/crates/lib/cid/tests/fact.rs +0 -0
  105. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/crates/lib/cid/tests/git.rs +0 -0
  106. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/crates/lib/cid/tests/o256.rs +0 -0
  107. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/crates/lib/cid/tests/shattered/1.bin +0 -0
  108. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/crates/lib/cid/tests/shattered/2.bin +0 -0
  109. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/crates/lib/cid/tests/shattered/README.md +0 -0
  110. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/crates/lib/config/Cargo.toml +0 -0
  111. {covalence-0.1.0.dev8/crates/lib/dasl → covalence-0.1.0.dev10/crates/lib/config}/LICENSE-APACHE +0 -0
  112. {covalence-0.1.0.dev8/crates/lib/dasl → covalence-0.1.0.dev10/crates/lib/config}/LICENSE-CC0 +0 -0
  113. {covalence-0.1.0.dev8/crates/lib/dasl → covalence-0.1.0.dev10/crates/lib/config}/LICENSE-MIT +0 -0
  114. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/crates/lib/config/README.md +0 -0
  115. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/crates/lib/config/src/lib.rs +0 -0
  116. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/crates/lib/config/tests/config.rs +0 -0
  117. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/crates/lib/dasl/Cargo.toml +0 -0
  118. {covalence-0.1.0.dev8/crates/lib/data → covalence-0.1.0.dev10/crates/lib/dasl}/LICENSE-APACHE +0 -0
  119. {covalence-0.1.0.dev8/crates/lib/data → covalence-0.1.0.dev10/crates/lib/dasl}/LICENSE-CC0 +0 -0
  120. {covalence-0.1.0.dev8/crates/lib/data → covalence-0.1.0.dev10/crates/lib/dasl}/LICENSE-MIT +0 -0
  121. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/crates/lib/dasl/README.md +0 -0
  122. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/crates/lib/dasl/src/drisl.rs +0 -0
  123. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/crates/lib/dasl/src/event.rs +0 -0
  124. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/crates/lib/dasl/src/json.rs +0 -0
  125. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/crates/lib/dasl/src/lib.rs +0 -0
  126. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/crates/lib/dasl/tests/codec.rs +0 -0
  127. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/crates/lib/dasl/tests/events.rs +0 -0
  128. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/crates/lib/dasl/tests/fact.rs +0 -0
  129. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/crates/lib/dasl/tests/fixtures/LICENSE +0 -0
  130. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/crates/lib/dasl/tests/fixtures/README.md +0 -0
  131. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/crates/lib/dasl/tests/fixtures/cid.json +0 -0
  132. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/crates/lib/dasl/tests/fixtures/concat.json +0 -0
  133. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/crates/lib/dasl/tests/fixtures/floats.json +0 -0
  134. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/crates/lib/dasl/tests/fixtures/indefinite.json +0 -0
  135. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/crates/lib/dasl/tests/fixtures/integer_range.json +0 -0
  136. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/crates/lib/dasl/tests/fixtures/map_keys.json +0 -0
  137. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/crates/lib/dasl/tests/fixtures/numeric_reduction.json +0 -0
  138. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/crates/lib/dasl/tests/fixtures/short_form.json +0 -0
  139. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/crates/lib/dasl/tests/fixtures/simple.json +0 -0
  140. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/crates/lib/dasl/tests/fixtures/tags.json +0 -0
  141. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/crates/lib/dasl/tests/fixtures/utf8.json +0 -0
  142. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/crates/lib/dasl/tests/fixtures.rs +0 -0
  143. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/crates/lib/dasl/tests/json.rs +0 -0
  144. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/crates/lib/dasl/tests/vectors/README.md +0 -0
  145. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/crates/lib/dasl/tests/vectors/cid-vectors.jsonl +0 -0
  146. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/crates/lib/dasl/tests/vectors/dasl-vectors.jsonl +0 -0
  147. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/crates/lib/dasl/tests/vectors.rs +0 -0
  148. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/crates/lib/data/Cargo.toml +0 -0
  149. {covalence-0.1.0.dev8/crates/lib/error → covalence-0.1.0.dev10/crates/lib/data}/LICENSE-APACHE +0 -0
  150. {covalence-0.1.0.dev8/crates/lib/error → covalence-0.1.0.dev10/crates/lib/data}/LICENSE-CC0 +0 -0
  151. {covalence-0.1.0.dev8/crates/lib/error → covalence-0.1.0.dev10/crates/lib/data}/LICENSE-MIT +0 -0
  152. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/crates/lib/data/src/lib.rs +0 -0
  153. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/crates/lib/error/Cargo.toml +0 -0
  154. {covalence-0.1.0.dev8/crates/lib/python → covalence-0.1.0.dev10/crates/lib/error}/LICENSE-APACHE +0 -0
  155. {covalence-0.1.0.dev8/crates/lib/python → covalence-0.1.0.dev10/crates/lib/error}/LICENSE-CC0 +0 -0
  156. {covalence-0.1.0.dev8/crates/lib/python → covalence-0.1.0.dev10/crates/lib/error}/LICENSE-MIT +0 -0
  157. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/crates/lib/error/src/lib.rs +0 -0
  158. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/crates/lib/python/Cargo.toml +0 -0
  159. {covalence-0.1.0.dev8/crates/lib/rand → covalence-0.1.0.dev10/crates/lib/python}/LICENSE-APACHE +0 -0
  160. {covalence-0.1.0.dev8/crates/lib/rand → covalence-0.1.0.dev10/crates/lib/python}/LICENSE-CC0 +0 -0
  161. {covalence-0.1.0.dev8/crates/lib/rand → covalence-0.1.0.dev10/crates/lib/python}/LICENSE-MIT +0 -0
  162. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/crates/lib/python/src/lib.rs +0 -0
  163. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/crates/lib/rand/Cargo.toml +0 -0
  164. {covalence-0.1.0.dev8/crates/lib/serde → covalence-0.1.0.dev10/crates/lib/rand}/LICENSE-APACHE +0 -0
  165. {covalence-0.1.0.dev8/crates/lib/serde → covalence-0.1.0.dev10/crates/lib/rand}/LICENSE-CC0 +0 -0
  166. {covalence-0.1.0.dev8/crates/lib/serde → covalence-0.1.0.dev10/crates/lib/rand}/LICENSE-MIT +0 -0
  167. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/crates/lib/rand/src/lib.rs +0 -0
  168. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/crates/lib/serde/Cargo.toml +0 -0
  169. {covalence-0.1.0.dev8/crates/lib/sqlite → covalence-0.1.0.dev10/crates/lib/serde}/LICENSE-APACHE +0 -0
  170. {covalence-0.1.0.dev8/crates/lib/sqlite → covalence-0.1.0.dev10/crates/lib/serde}/LICENSE-CC0 +0 -0
  171. {covalence-0.1.0.dev8/crates/lib/sqlite → covalence-0.1.0.dev10/crates/lib/serde}/LICENSE-MIT +0 -0
  172. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/crates/lib/serde/src/lib.rs +0 -0
  173. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/crates/lib/sqlite/Cargo.toml +0 -0
  174. {covalence-0.1.0.dev8/crates/python → covalence-0.1.0.dev10/crates/lib/sqlite}/LICENSE-APACHE +0 -0
  175. {covalence-0.1.0.dev8/crates/python → covalence-0.1.0.dev10/crates/lib/sqlite}/LICENSE-CC0 +0 -0
  176. {covalence-0.1.0.dev8/crates/python → covalence-0.1.0.dev10/crates/lib/sqlite}/LICENSE-MIT +0 -0
  177. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/crates/lib/sqlite/src/lib.rs +0 -0
  178. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/crates/python/Cargo.toml +0 -0
  179. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/crates/python/about.md.hbs +0 -0
  180. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/crates/python/about.toml +0 -0
  181. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/crates/python/src/config.rs +0 -0
  182. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/crates/python/src/errors.rs +0 -0
  183. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/crates/python/src/lib.rs +0 -0
  184. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/crates/python/src/streams/download.rs +0 -0
  185. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/crates/python/src/streams/mod.rs +0 -0
  186. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/crates/python/src/streams/upload/tests.rs +0 -0
  187. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/crates/python/src/streams/upload.rs +0 -0
  188. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/crates/python/tests/test_api.py +0 -0
  189. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/crates/python/tests/test_bounded_io.py +0 -0
  190. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/crates/python/tests/test_compression.py +0 -0
  191. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/crates/python/tests/test_config.py +0 -0
  192. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/crates/python/tests/test_docs.py +0 -0
  193. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/crates/python/tests/test_package.py +0 -0
  194. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/crates/python/tests/test_stubs.py +0 -0
  195. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/crates/python/tests/typed_usage.py +0 -0
  196. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/pyproject.toml +0 -0
  197. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/python/covalence/__init__.py +0 -0
  198. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/python/covalence/_native.pyi +0 -0
  199. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/python/covalence/config.py +0 -0
  200. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/python/covalence/config.pyi +0 -0
  201. {covalence-0.1.0.dev8 → covalence-0.1.0.dev10}/python/covalence/py.typed +0 -0
@@ -817,19 +817,32 @@ checksum = "773648b94d0e5d620f64f280777445740e61fe701025087ec8b57f45c791888b"
817
817
 
818
818
  [[package]]
819
819
  name = "covalence-blob-trait"
820
- version = "0.1.0-dev.8"
820
+ version = "0.1.0-dev.10"
821
821
  dependencies = [
822
822
  "covalence-lib-cid",
823
823
  "covalence-lib-data",
824
824
  "covalence-lib-error",
825
825
  ]
826
826
 
827
+ [[package]]
828
+ name = "covalence-blob-verify"
829
+ version = "0.1.0-dev.10"
830
+ dependencies = [
831
+ "blake3",
832
+ "covalence-lib-cid",
833
+ "covalence-lib-error",
834
+ "sha2",
835
+ "tempfile",
836
+ "tokio",
837
+ ]
838
+
827
839
  [[package]]
828
840
  name = "covalence-cas-kv"
829
- version = "0.1.0-dev.8"
841
+ version = "0.1.0-dev.10"
830
842
  dependencies = [
831
843
  "blake3",
832
844
  "brotli",
845
+ "covalence-blob-verify",
833
846
  "covalence-cas-trait",
834
847
  "covalence-kv-memory",
835
848
  "covalence-kv-s3",
@@ -851,7 +864,7 @@ dependencies = [
851
864
 
852
865
  [[package]]
853
866
  name = "covalence-cas-memory"
854
- version = "0.1.0-dev.8"
867
+ version = "0.1.0-dev.10"
855
868
  dependencies = [
856
869
  "covalence-cas-trait",
857
870
  "covalence-lib-cid",
@@ -862,7 +875,7 @@ dependencies = [
862
875
 
863
876
  [[package]]
864
877
  name = "covalence-cas-prolly"
865
- version = "0.1.0-dev.8"
878
+ version = "0.1.0-dev.10"
866
879
  dependencies = [
867
880
  "covalence-cas-memory",
868
881
  "covalence-cas-trait",
@@ -876,7 +889,7 @@ dependencies = [
876
889
 
877
890
  [[package]]
878
891
  name = "covalence-cas-sqlite"
879
- version = "0.1.0-dev.8"
892
+ version = "0.1.0-dev.10"
880
893
  dependencies = [
881
894
  "covalence-cas-trait",
882
895
  "covalence-lib-cid",
@@ -891,7 +904,7 @@ dependencies = [
891
904
 
892
905
  [[package]]
893
906
  name = "covalence-cas-trait"
894
- version = "0.1.0-dev.8"
907
+ version = "0.1.0-dev.10"
895
908
  dependencies = [
896
909
  "covalence-lib-cid",
897
910
  "covalence-lib-dasl",
@@ -902,7 +915,7 @@ dependencies = [
902
915
 
903
916
  [[package]]
904
917
  name = "covalence-kv-memory"
905
- version = "0.1.0-dev.8"
918
+ version = "0.1.0-dev.10"
906
919
  dependencies = [
907
920
  "covalence-kv-trait",
908
921
  "covalence-lib-dasl",
@@ -912,7 +925,7 @@ dependencies = [
912
925
 
913
926
  [[package]]
914
927
  name = "covalence-kv-s3"
915
- version = "0.1.0-dev.8"
928
+ version = "0.1.0-dev.10"
916
929
  dependencies = [
917
930
  "aws-config",
918
931
  "aws-credential-types",
@@ -939,7 +952,7 @@ dependencies = [
939
952
 
940
953
  [[package]]
941
954
  name = "covalence-kv-trait"
942
- version = "0.1.0-dev.8"
955
+ version = "0.1.0-dev.10"
943
956
  dependencies = [
944
957
  "covalence-lib-dasl",
945
958
  "covalence-lib-data",
@@ -948,7 +961,7 @@ dependencies = [
948
961
 
949
962
  [[package]]
950
963
  name = "covalence-lean-cache"
951
- version = "0.1.0-dev.8"
964
+ version = "0.1.0-dev.10"
952
965
  dependencies = [
953
966
  "covalence-cas-kv",
954
967
  "covalence-cas-memory",
@@ -981,13 +994,14 @@ dependencies = [
981
994
 
982
995
  [[package]]
983
996
  name = "covalence-lean-kernel-checker"
984
- version = "0.1.0-dev.8"
997
+ version = "0.1.0-dev.10"
985
998
  dependencies = [
986
999
  "blake3",
987
1000
  "covalence-cas-kv",
988
1001
  "covalence-cas-prolly",
989
1002
  "covalence-cas-sqlite",
990
1003
  "covalence-cas-trait",
1004
+ "covalence-kv-memory",
991
1005
  "covalence-kv-s3",
992
1006
  "covalence-kv-trait",
993
1007
  "covalence-lib-cid",
@@ -1003,7 +1017,7 @@ dependencies = [
1003
1017
 
1004
1018
  [[package]]
1005
1019
  name = "covalence-lean-ltar"
1006
- version = "0.1.0-dev.8"
1020
+ version = "0.1.0-dev.10"
1007
1021
  dependencies = [
1008
1022
  "covalence-lib-error",
1009
1023
  "serde_json",
@@ -1013,7 +1027,7 @@ dependencies = [
1013
1027
 
1014
1028
  [[package]]
1015
1029
  name = "covalence-lib-cid"
1016
- version = "0.1.0-dev.8"
1030
+ version = "0.1.0-dev.10"
1017
1031
  dependencies = [
1018
1032
  "blake3",
1019
1033
  "covalence-lib-data",
@@ -1028,14 +1042,14 @@ dependencies = [
1028
1042
 
1029
1043
  [[package]]
1030
1044
  name = "covalence-lib-cli"
1031
- version = "0.1.0-dev.8"
1045
+ version = "0.1.0-dev.10"
1032
1046
  dependencies = [
1033
1047
  "clap",
1034
1048
  ]
1035
1049
 
1036
1050
  [[package]]
1037
1051
  name = "covalence-lib-config"
1038
- version = "0.1.0-dev.8"
1052
+ version = "0.1.0-dev.10"
1039
1053
  dependencies = [
1040
1054
  "covalence-lib-error",
1041
1055
  "covalence-lib-serde",
@@ -1046,7 +1060,7 @@ dependencies = [
1046
1060
 
1047
1061
  [[package]]
1048
1062
  name = "covalence-lib-dasl"
1049
- version = "0.1.0-dev.8"
1063
+ version = "0.1.0-dev.10"
1050
1064
  dependencies = [
1051
1065
  "blake3",
1052
1066
  "covalence-lib-cid",
@@ -1061,7 +1075,7 @@ dependencies = [
1061
1075
 
1062
1076
  [[package]]
1063
1077
  name = "covalence-lib-data"
1064
- version = "0.1.0-dev.8"
1078
+ version = "0.1.0-dev.10"
1065
1079
  dependencies = [
1066
1080
  "arrayvec",
1067
1081
  "bytes",
@@ -1073,7 +1087,7 @@ dependencies = [
1073
1087
 
1074
1088
  [[package]]
1075
1089
  name = "covalence-lib-error"
1076
- version = "0.1.0-dev.8"
1090
+ version = "0.1.0-dev.10"
1077
1091
  dependencies = [
1078
1092
  "miette",
1079
1093
  "snafu",
@@ -1081,14 +1095,14 @@ dependencies = [
1081
1095
 
1082
1096
  [[package]]
1083
1097
  name = "covalence-lib-python"
1084
- version = "0.1.0-dev.8"
1098
+ version = "0.1.0-dev.10"
1085
1099
  dependencies = [
1086
1100
  "pyo3",
1087
1101
  ]
1088
1102
 
1089
1103
  [[package]]
1090
1104
  name = "covalence-lib-rand"
1091
- version = "0.1.0-dev.8"
1105
+ version = "0.1.0-dev.10"
1092
1106
  dependencies = [
1093
1107
  "getrandom 0.3.4",
1094
1108
  "rand",
@@ -1096,21 +1110,21 @@ dependencies = [
1096
1110
 
1097
1111
  [[package]]
1098
1112
  name = "covalence-lib-serde"
1099
- version = "0.1.0-dev.8"
1113
+ version = "0.1.0-dev.10"
1100
1114
  dependencies = [
1101
1115
  "serde",
1102
1116
  ]
1103
1117
 
1104
1118
  [[package]]
1105
1119
  name = "covalence-lib-sqlite"
1106
- version = "0.1.0-dev.8"
1120
+ version = "0.1.0-dev.10"
1107
1121
  dependencies = [
1108
1122
  "rusqlite",
1109
1123
  ]
1110
1124
 
1111
1125
  [[package]]
1112
1126
  name = "covalence-python"
1113
- version = "0.1.0-dev.8"
1127
+ version = "0.1.0-dev.10"
1114
1128
  dependencies = [
1115
1129
  "blake3",
1116
1130
  "covalence-blob-trait",
@@ -1133,7 +1147,7 @@ dependencies = [
1133
1147
 
1134
1148
  [[package]]
1135
1149
  name = "covalence-tools-glu"
1136
- version = "0.1.0-dev.8"
1150
+ version = "0.1.0-dev.10"
1137
1151
  dependencies = [
1138
1152
  "covalence-lib-cli",
1139
1153
  "covalence-lib-error",
@@ -1,9 +1,9 @@
1
1
  [workspace]
2
- members = ["crates/lib/error", "crates/lib/serde", "crates/lib/config", "crates/lib/data", "crates/lib/python", "crates/python", "crates/lib/cid", "crates/lib/sqlite", "crates/lib/dasl", "crates/cas/trait", "crates/cas/memory", "crates/lib/rand", "crates/cas/sqlite", "crates/kv/trait", "crates/kv/memory", "crates/kv/s3", "crates/cas/kv", "crates/blob/trait"]
2
+ members = ["crates/lib/error", "crates/lib/serde", "crates/lib/config", "crates/lib/data", "crates/lib/python", "crates/python", "crates/lib/cid", "crates/lib/sqlite", "crates/lib/dasl", "crates/cas/trait", "crates/cas/memory", "crates/lib/rand", "crates/cas/sqlite", "crates/kv/trait", "crates/kv/memory", "crates/kv/s3", "crates/cas/kv", "crates/blob/trait", "crates/blob/verify"]
3
3
  resolver = "3"
4
4
 
5
5
  [workspace.package]
6
- version = "0.1.0-dev.8"
6
+ version = "0.1.0-dev.10"
7
7
  edition = "2024"
8
8
  rust-version = "1.98"
9
9
  license = "CC0-1.0 OR MIT OR Apache-2.0"
@@ -18,23 +18,24 @@ sha2 = "0.11.0"
18
18
  snafu = "0.9.2"
19
19
  zstd = "0.13"
20
20
  # Published crates, at the workspace version so the set moves together.
21
- covalence-blob-trait = { path = "crates/blob/trait", version = "=0.1.0-dev.8" }
22
- covalence-cas-kv = { path = "crates/cas/kv", version = "=0.1.0-dev.8" }
23
- covalence-cas-memory = { path = "crates/cas/memory", version = "=0.1.0-dev.8" }
24
- covalence-cas-sqlite = { path = "crates/cas/sqlite", version = "=0.1.0-dev.8" }
25
- covalence-cas-trait = { path = "crates/cas/trait", version = "=0.1.0-dev.8" }
26
- covalence-kv-memory = { path = "crates/kv/memory", version = "=0.1.0-dev.8" }
27
- covalence-kv-s3 = { path = "crates/kv/s3", version = "=0.1.0-dev.8" }
28
- covalence-kv-trait = { path = "crates/kv/trait", version = "=0.1.0-dev.8" }
29
- covalence-lib-cid = { path = "crates/lib/cid", version = "=0.1.0-dev.8" }
30
- covalence-lib-cli = { path = "crates/lib/cli", version = "=0.1.0-dev.8" }
31
- covalence-lib-config = { path = "crates/lib/config", version = "=0.1.0-dev.8" }
32
- covalence-lib-dasl = { path = "crates/lib/dasl", version = "=0.1.0-dev.8" }
33
- covalence-lib-data = { path = "crates/lib/data", version = "=0.1.0-dev.8" }
34
- covalence-lib-error = { path = "crates/lib/error", version = "=0.1.0-dev.8" }
35
- covalence-lib-rand = { path = "crates/lib/rand", version = "=0.1.0-dev.8" }
36
- covalence-lib-serde = { path = "crates/lib/serde", version = "=0.1.0-dev.8" }
37
- covalence-lib-sqlite = { path = "crates/lib/sqlite", version = "=0.1.0-dev.8" }
21
+ covalence-blob-trait = { path = "crates/blob/trait", version = "=0.1.0-dev.10" }
22
+ covalence-blob-verify = { path = "crates/blob/verify", version = "=0.1.0-dev.10", default-features = false }
23
+ covalence-cas-kv = { path = "crates/cas/kv", version = "=0.1.0-dev.10" }
24
+ covalence-cas-memory = { path = "crates/cas/memory", version = "=0.1.0-dev.10" }
25
+ covalence-cas-sqlite = { path = "crates/cas/sqlite", version = "=0.1.0-dev.10" }
26
+ covalence-cas-trait = { path = "crates/cas/trait", version = "=0.1.0-dev.10" }
27
+ covalence-kv-memory = { path = "crates/kv/memory", version = "=0.1.0-dev.10" }
28
+ covalence-kv-s3 = { path = "crates/kv/s3", version = "=0.1.0-dev.10" }
29
+ covalence-kv-trait = { path = "crates/kv/trait", version = "=0.1.0-dev.10" }
30
+ covalence-lib-cid = { path = "crates/lib/cid", version = "=0.1.0-dev.10" }
31
+ covalence-lib-cli = { path = "crates/lib/cli", version = "=0.1.0-dev.10" }
32
+ covalence-lib-config = { path = "crates/lib/config", version = "=0.1.0-dev.10" }
33
+ covalence-lib-dasl = { path = "crates/lib/dasl", version = "=0.1.0-dev.10" }
34
+ covalence-lib-data = { path = "crates/lib/data", version = "=0.1.0-dev.10" }
35
+ covalence-lib-error = { path = "crates/lib/error", version = "=0.1.0-dev.10" }
36
+ covalence-lib-rand = { path = "crates/lib/rand", version = "=0.1.0-dev.10" }
37
+ covalence-lib-serde = { path = "crates/lib/serde", version = "=0.1.0-dev.10" }
38
+ covalence-lib-sqlite = { path = "crates/lib/sqlite", version = "=0.1.0-dev.10" }
38
39
 
39
40
  [workspace.lints.rust]
40
41
  unsafe_code = "forbid"
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: covalence
3
- Version: 0.1.0.dev8
3
+ Version: 0.1.0.dev10
4
4
  License-File: LICENSE-APACHE
5
5
  License-File: LICENSE-CC0
6
6
  License-File: LICENSE-MIT
@@ -37,7 +37,7 @@ True
37
37
  ## Install
38
38
 
39
39
  ```sh
40
- pip install covalence==0.1.0.dev8
40
+ pip install covalence==0.1.0.dev10
41
41
  ```
42
42
 
43
43
  - Pre-releases need an exact pin like this one, or `pip install --pre`.
@@ -411,16 +411,16 @@ stub; this package writes its stub by hand and checks it against `__doc__`:
411
411
  later) for manylinux_2_28 x86_64 and aarch64 and macOS arm64, and an sdist,
412
412
  and runs `tests/` against each wheel. Pull requests and pushes keep them as
413
413
  workflow artifacts. A release tag must match the workspace version, such as
414
- `0.1.0-dev.8`; the files carry its PEP 440 form, `0.1.0.dev8`:
414
+ `0.1.0-dev.10`; the files carry its PEP 440 form, `0.1.0.dev10`:
415
415
 
416
416
  - `v<version>` attaches them to that GitHub release. In the public
417
417
  `hiloopai/covalence` repository it also publishes them to PyPI, and
418
418
  `.github/workflows/crates.yml` publishes the crates to crates.io.
419
419
  - `python-v<version>` only attaches them to the GitHub release.
420
420
 
421
- To publish `0.1.0-dev.8`:
421
+ To publish `0.1.0-dev.10`:
422
422
 
423
423
  ```sh
424
- git tag v0.1.0-dev.8 && git push origin v0.1.0-dev.8
424
+ git tag v0.1.0-dev.10 && git push origin v0.1.0-dev.10
425
425
  ```
426
426
 
@@ -23,7 +23,7 @@ True
23
23
  ## Install
24
24
 
25
25
  ```sh
26
- pip install covalence==0.1.0.dev8
26
+ pip install covalence==0.1.0.dev10
27
27
  ```
28
28
 
29
29
  - Pre-releases need an exact pin like this one, or `pip install --pre`.
@@ -397,15 +397,15 @@ stub; this package writes its stub by hand and checks it against `__doc__`:
397
397
  later) for manylinux_2_28 x86_64 and aarch64 and macOS arm64, and an sdist,
398
398
  and runs `tests/` against each wheel. Pull requests and pushes keep them as
399
399
  workflow artifacts. A release tag must match the workspace version, such as
400
- `0.1.0-dev.8`; the files carry its PEP 440 form, `0.1.0.dev8`:
400
+ `0.1.0-dev.10`; the files carry its PEP 440 form, `0.1.0.dev10`:
401
401
 
402
402
  - `v<version>` attaches them to that GitHub release. In the public
403
403
  `hiloopai/covalence` repository it also publishes them to PyPI, and
404
404
  `.github/workflows/crates.yml` publishes the crates to crates.io.
405
405
  - `python-v<version>` only attaches them to the GitHub release.
406
406
 
407
- To publish `0.1.0-dev.8`:
407
+ To publish `0.1.0-dev.10`:
408
408
 
409
409
  ```sh
410
- git tag v0.1.0-dev.8 && git push origin v0.1.0-dev.8
410
+ git tag v0.1.0-dev.10 && git push origin v0.1.0-dev.10
411
411
  ```
@@ -0,0 +1,35 @@
1
+ [package]
2
+ name = "covalence-blob-verify"
3
+ description = "Byte streams checked against an expected length and digest"
4
+ version.workspace = true
5
+ edition.workspace = true
6
+ rust-version.workspace = true
7
+ license.workspace = true
8
+ repository.workspace = true
9
+ readme = "README.md"
10
+ documentation = "https://docs.rs/covalence-blob-verify"
11
+ keywords = ["checksum", "streaming", "sha256", "blake3", "integrity"]
12
+ categories = ["cryptography"]
13
+ publish = true
14
+
15
+ [features]
16
+ default = ["tokio"]
17
+ # `AsyncRead` and `AsyncWrite` for the reader and writer.
18
+ tokio = ["dep:tokio"]
19
+
20
+ [dependencies]
21
+ blake3.workspace = true
22
+ covalence-lib-cid.workspace = true
23
+ covalence-lib-error.workspace = true
24
+ sha2.workspace = true
25
+ tokio = { version = "1", default-features = false, optional = true }
26
+
27
+ [dev-dependencies]
28
+ tempfile = "3"
29
+ tokio = { version = "1", features = ["fs", "io-util", "macros", "rt", "time"] }
30
+
31
+ [package.metadata.docs.rs]
32
+ all-features = true
33
+
34
+ [lints]
35
+ workspace = true
@@ -0,0 +1,83 @@
1
+ # covalence-blob-verify
2
+
3
+ Byte streams checked against an expected size and digest, in constant memory.
4
+
5
+ A caller that knows how long a stream should be and what it should hash to
6
+ wraps the stream's reader or writer. The wrapper passes bytes through, hashes
7
+ them as they go, and fails the stream if it is too long, too short or has
8
+ another digest.
9
+
10
+ ## Terms
11
+
12
+ - A digest is the 32-byte output of a hash function over the whole stream:
13
+ [SHA-256](https://csrc.nist.gov/pubs/fips/180-4/upd1/final) or
14
+ [BLAKE3](https://github.com/BLAKE3-team/BLAKE3-specs), as named by
15
+ `HashFn` from `covalence-lib-cid`.
16
+ - `Expected` is a size in bytes, a hash function and a digest.
17
+ - `Verified` is proof that a stream had exactly the expected size and digest.
18
+ Only a check that has seen every byte makes one.
19
+
20
+ ## Pieces
21
+
22
+ - `Verifier`: the check alone, with no I/O. Feed it bytes in order, then ask
23
+ it to finish.
24
+ - `VerifyingReader`: reads exactly the expected bytes from another reader,
25
+ and withholds the last byte until they pass the check.
26
+ - `VerifyingWriter`: passes bytes on to another writer, refusing any past
27
+ the expected size; the caller checks once every byte is written.
28
+ - `Cancel`: a flag that stops a reader or writer before its next read or
29
+ write.
30
+
31
+ Readers and writers implement `std::io::Read` and `Write` and, with the
32
+ default `tokio` feature, Tokio's `AsyncRead` and `AsyncWrite`.
33
+
34
+ ## What is guaranteed, and what the caller does
35
+
36
+ Read these limits before relying on the reader or writer:
37
+
38
+ - **The reader is not zero-unverified-byte publication.** It returns every
39
+ byte but the last as it arrives, before the check. A consumer that
40
+ forwards or stores bytes as they come has already passed on all but one
41
+ unverified byte when the check fails.
42
+ - **The caller stages, checks, then commits.** Write to a destination nobody
43
+ reads yet, such as a temporary file or an open multipart upload, and make
44
+ it visible only after `verified()` returns proof. On any error, discard it.
45
+ - **Extra bytes are found only with `require_eof`.** Without it, the reader
46
+ stops at the expected size and leaves any further bytes in the source
47
+ unread and unchecked. Use `require_eof` whenever the source should end
48
+ there, such as an HTTP body or a file.
49
+ - **Blocked I/O needs an outer timeout.** `Cancel` and deadlines are checked
50
+ between reads and writes, never during one. Give the source or sink its
51
+ own timeouts, or, with Tokio, wrap the future in `tokio::time::timeout`;
52
+ dropping the future stops it.
53
+
54
+ The reader guarantees:
55
+
56
+ - A consumer that waits for every expected byte never gets them unless they
57
+ passed the check. The last byte comes only after the digest matches and,
58
+ with `require_eof`, the source has ended.
59
+ - An empty expected stream has no byte to withhold. It is checked by the
60
+ first read into a non-empty buffer, which fails or returns 0, but
61
+ `read_exact` of nothing and `take(0)` never read. Callers that may expect
62
+ zero bytes read until 0 is returned, or check `verified()` before
63
+ committing.
64
+ - It never reads past the expected size, except one read to see that the
65
+ source ended, with `require_eof`.
66
+ - It holds at most one byte of the stream and reads only when it is read
67
+ from, so a slow consumer slows the producer.
68
+
69
+ The writer guarantees that the inner writer is never given bytes past the
70
+ expected size. It cannot hold bytes back: the inner writer has every byte
71
+ before the check.
72
+
73
+ The caller is also responsible for authorization, ownership, retries and
74
+ retention. A failed check is not retried here; whether the source can be
75
+ read again, for example before a signed URL expires, is for the caller to
76
+ decide.
77
+
78
+ ## Errors
79
+
80
+ Readers and writers return `Error` inside `std::io::Error`; `Error::of`
81
+ gets it back. After a check fails or a stream is stopped, every later read or
82
+ write fails with the same error. Errors from the wrapped reader or writer
83
+ pass through unchanged.