covalence 0.1.0.dev6__tar.gz → 0.1.0.dev7__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 (176) hide show
  1. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/Cargo.lock +115 -19
  2. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/Cargo.toml +19 -18
  3. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/PKG-INFO +47 -5
  4. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/README.md +46 -4
  5. covalence-0.1.0.dev7/crates/lib/config/Cargo.toml +28 -0
  6. covalence-0.1.0.dev7/crates/lib/config/README.md +72 -0
  7. covalence-0.1.0.dev7/crates/lib/config/src/lib.rs +131 -0
  8. covalence-0.1.0.dev7/crates/lib/config/tests/config.rs +210 -0
  9. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/python/Cargo.toml +2 -0
  10. covalence-0.1.0.dev7/crates/python/LICENSE-APACHE +202 -0
  11. covalence-0.1.0.dev7/crates/python/LICENSE-CC0 +121 -0
  12. covalence-0.1.0.dev7/crates/python/LICENSE-MIT +21 -0
  13. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/python/README.md +46 -4
  14. covalence-0.1.0.dev7/crates/python/src/config.rs +203 -0
  15. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/python/src/lib.rs +2 -0
  16. covalence-0.1.0.dev7/crates/python/tests/test_config.py +154 -0
  17. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/python/tests/test_docs.py +14 -0
  18. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/python/tests/test_package.py +2 -0
  19. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/python/tests/typed_usage.py +17 -0
  20. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/python/covalence/THIRD-PARTY-LICENSES.md +474 -17
  21. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/python/covalence/__init__.py +3 -0
  22. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/python/covalence/_native.pyi +2 -0
  23. covalence-0.1.0.dev7/python/covalence/config.py +17 -0
  24. covalence-0.1.0.dev7/python/covalence/config.pyi +85 -0
  25. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/LICENSE-APACHE +0 -0
  26. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/LICENSE-CC0 +0 -0
  27. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/LICENSE-MIT +0 -0
  28. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/blob/trait/Cargo.toml +0 -0
  29. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/blob/trait/LICENSE-APACHE +0 -0
  30. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/blob/trait/LICENSE-CC0 +0 -0
  31. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/blob/trait/LICENSE-MIT +0 -0
  32. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/blob/trait/README.md +0 -0
  33. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/blob/trait/src/lib.rs +0 -0
  34. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/blob/trait/tests/blob.rs +0 -0
  35. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/blob/trait/tests/common/mod.rs +0 -0
  36. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/blob/trait/tests/fact.rs +0 -0
  37. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/cas/kv/Cargo.toml +0 -0
  38. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/cas/kv/LICENSE-APACHE +0 -0
  39. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/cas/kv/LICENSE-CC0 +0 -0
  40. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/cas/kv/LICENSE-MIT +0 -0
  41. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/cas/kv/src/lib.rs +0 -0
  42. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/cas/kv/tests/kv.rs +0 -0
  43. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/cas/memory/Cargo.toml +0 -0
  44. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/cas/memory/LICENSE-APACHE +0 -0
  45. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/cas/memory/LICENSE-CC0 +0 -0
  46. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/cas/memory/LICENSE-MIT +0 -0
  47. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/cas/memory/src/lib.rs +0 -0
  48. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/cas/memory/tests/memory.rs +0 -0
  49. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/cas/sqlite/Cargo.toml +0 -0
  50. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/cas/sqlite/LICENSE-APACHE +0 -0
  51. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/cas/sqlite/LICENSE-CC0 +0 -0
  52. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/cas/sqlite/LICENSE-MIT +0 -0
  53. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/cas/sqlite/src/lib.rs +0 -0
  54. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/cas/sqlite/tests/sqlite.rs +0 -0
  55. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/cas/trait/Cargo.toml +0 -0
  56. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/cas/trait/LICENSE-APACHE +0 -0
  57. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/cas/trait/LICENSE-CC0 +0 -0
  58. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/cas/trait/LICENSE-MIT +0 -0
  59. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/cas/trait/src/lib.rs +0 -0
  60. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/cas/trait/tests/trait.rs +0 -0
  61. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/kv/memory/Cargo.toml +0 -0
  62. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/kv/memory/LICENSE-APACHE +0 -0
  63. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/kv/memory/LICENSE-CC0 +0 -0
  64. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/kv/memory/LICENSE-MIT +0 -0
  65. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/kv/memory/src/lib.rs +0 -0
  66. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/kv/memory/tests/memory.rs +0 -0
  67. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/kv/s3/Cargo.toml +0 -0
  68. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/kv/s3/LICENSE-APACHE +0 -0
  69. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/kv/s3/LICENSE-CC0 +0 -0
  70. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/kv/s3/LICENSE-MIT +0 -0
  71. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/kv/s3/src/lib.rs +0 -0
  72. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/kv/s3/src/read.rs +0 -0
  73. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/kv/s3/src/write.rs +0 -0
  74. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/kv/s3/tests/aws.rs +0 -0
  75. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/kv/s3/tests/kv.rs +0 -0
  76. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/kv/trait/Cargo.toml +0 -0
  77. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/kv/trait/LICENSE-APACHE +0 -0
  78. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/kv/trait/LICENSE-CC0 +0 -0
  79. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/kv/trait/LICENSE-MIT +0 -0
  80. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/kv/trait/src/lib.rs +0 -0
  81. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/kv/trait/tests/atomic.rs +0 -0
  82. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/lib/cid/Cargo.toml +0 -0
  83. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/lib/cid/LICENSE-APACHE +0 -0
  84. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/lib/cid/LICENSE-CC0 +0 -0
  85. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/lib/cid/LICENSE-MIT +0 -0
  86. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/lib/cid/README.md +0 -0
  87. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/lib/cid/src/dasl.rs +0 -0
  88. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/lib/cid/src/fact.rs +0 -0
  89. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/lib/cid/src/git.rs +0 -0
  90. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/lib/cid/src/lib.rs +0 -0
  91. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/lib/cid/src/multicodec.rs +0 -0
  92. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/lib/cid/src/o256.rs +0 -0
  93. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/lib/cid/src/storage.rs +0 -0
  94. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/lib/cid/tests/cid.rs +0 -0
  95. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/lib/cid/tests/fact.rs +0 -0
  96. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/lib/cid/tests/git.rs +0 -0
  97. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/lib/cid/tests/o256.rs +0 -0
  98. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/lib/cid/tests/shattered/1.bin +0 -0
  99. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/lib/cid/tests/shattered/2.bin +0 -0
  100. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/lib/cid/tests/shattered/README.md +0 -0
  101. {covalence-0.1.0.dev6/crates/lib/dasl → covalence-0.1.0.dev7/crates/lib/config}/LICENSE-APACHE +0 -0
  102. {covalence-0.1.0.dev6/crates/lib/dasl → covalence-0.1.0.dev7/crates/lib/config}/LICENSE-CC0 +0 -0
  103. {covalence-0.1.0.dev6/crates/lib/dasl → covalence-0.1.0.dev7/crates/lib/config}/LICENSE-MIT +0 -0
  104. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/lib/dasl/Cargo.toml +0 -0
  105. {covalence-0.1.0.dev6/crates/lib/data → covalence-0.1.0.dev7/crates/lib/dasl}/LICENSE-APACHE +0 -0
  106. {covalence-0.1.0.dev6/crates/lib/data → covalence-0.1.0.dev7/crates/lib/dasl}/LICENSE-CC0 +0 -0
  107. {covalence-0.1.0.dev6/crates/lib/data → covalence-0.1.0.dev7/crates/lib/dasl}/LICENSE-MIT +0 -0
  108. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/lib/dasl/README.md +0 -0
  109. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/lib/dasl/src/drisl.rs +0 -0
  110. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/lib/dasl/src/event.rs +0 -0
  111. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/lib/dasl/src/json.rs +0 -0
  112. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/lib/dasl/src/lib.rs +0 -0
  113. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/lib/dasl/tests/codec.rs +0 -0
  114. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/lib/dasl/tests/events.rs +0 -0
  115. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/lib/dasl/tests/fact.rs +0 -0
  116. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/lib/dasl/tests/fixtures/LICENSE +0 -0
  117. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/lib/dasl/tests/fixtures/README.md +0 -0
  118. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/lib/dasl/tests/fixtures/cid.json +0 -0
  119. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/lib/dasl/tests/fixtures/concat.json +0 -0
  120. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/lib/dasl/tests/fixtures/floats.json +0 -0
  121. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/lib/dasl/tests/fixtures/indefinite.json +0 -0
  122. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/lib/dasl/tests/fixtures/integer_range.json +0 -0
  123. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/lib/dasl/tests/fixtures/map_keys.json +0 -0
  124. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/lib/dasl/tests/fixtures/numeric_reduction.json +0 -0
  125. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/lib/dasl/tests/fixtures/short_form.json +0 -0
  126. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/lib/dasl/tests/fixtures/simple.json +0 -0
  127. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/lib/dasl/tests/fixtures/tags.json +0 -0
  128. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/lib/dasl/tests/fixtures/utf8.json +0 -0
  129. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/lib/dasl/tests/fixtures.rs +0 -0
  130. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/lib/dasl/tests/json.rs +0 -0
  131. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/lib/dasl/tests/vectors/README.md +0 -0
  132. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/lib/dasl/tests/vectors/cid-vectors.jsonl +0 -0
  133. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/lib/dasl/tests/vectors/dasl-vectors.jsonl +0 -0
  134. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/lib/dasl/tests/vectors.rs +0 -0
  135. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/lib/data/Cargo.toml +0 -0
  136. {covalence-0.1.0.dev6/crates/lib/error → covalence-0.1.0.dev7/crates/lib/data}/LICENSE-APACHE +0 -0
  137. {covalence-0.1.0.dev6/crates/lib/error → covalence-0.1.0.dev7/crates/lib/data}/LICENSE-CC0 +0 -0
  138. {covalence-0.1.0.dev6/crates/lib/error → covalence-0.1.0.dev7/crates/lib/data}/LICENSE-MIT +0 -0
  139. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/lib/data/src/lib.rs +0 -0
  140. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/lib/error/Cargo.toml +0 -0
  141. {covalence-0.1.0.dev6/crates/lib/python → covalence-0.1.0.dev7/crates/lib/error}/LICENSE-APACHE +0 -0
  142. {covalence-0.1.0.dev6/crates/lib/python → covalence-0.1.0.dev7/crates/lib/error}/LICENSE-CC0 +0 -0
  143. {covalence-0.1.0.dev6/crates/lib/python → covalence-0.1.0.dev7/crates/lib/error}/LICENSE-MIT +0 -0
  144. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/lib/error/src/lib.rs +0 -0
  145. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/lib/python/Cargo.toml +0 -0
  146. {covalence-0.1.0.dev6/crates/lib/rand → covalence-0.1.0.dev7/crates/lib/python}/LICENSE-APACHE +0 -0
  147. {covalence-0.1.0.dev6/crates/lib/rand → covalence-0.1.0.dev7/crates/lib/python}/LICENSE-CC0 +0 -0
  148. {covalence-0.1.0.dev6/crates/lib/rand → covalence-0.1.0.dev7/crates/lib/python}/LICENSE-MIT +0 -0
  149. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/lib/python/src/lib.rs +0 -0
  150. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/lib/rand/Cargo.toml +0 -0
  151. {covalence-0.1.0.dev6/crates/lib/serde → covalence-0.1.0.dev7/crates/lib/rand}/LICENSE-APACHE +0 -0
  152. {covalence-0.1.0.dev6/crates/lib/serde → covalence-0.1.0.dev7/crates/lib/rand}/LICENSE-CC0 +0 -0
  153. {covalence-0.1.0.dev6/crates/lib/serde → covalence-0.1.0.dev7/crates/lib/rand}/LICENSE-MIT +0 -0
  154. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/lib/rand/src/lib.rs +0 -0
  155. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/lib/serde/Cargo.toml +0 -0
  156. {covalence-0.1.0.dev6/crates/lib/sqlite → covalence-0.1.0.dev7/crates/lib/serde}/LICENSE-APACHE +0 -0
  157. {covalence-0.1.0.dev6/crates/lib/sqlite → covalence-0.1.0.dev7/crates/lib/serde}/LICENSE-CC0 +0 -0
  158. {covalence-0.1.0.dev6/crates/lib/sqlite → covalence-0.1.0.dev7/crates/lib/serde}/LICENSE-MIT +0 -0
  159. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/lib/serde/src/lib.rs +0 -0
  160. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/lib/sqlite/Cargo.toml +0 -0
  161. {covalence-0.1.0.dev6/crates/python → covalence-0.1.0.dev7/crates/lib/sqlite}/LICENSE-APACHE +0 -0
  162. {covalence-0.1.0.dev6/crates/python → covalence-0.1.0.dev7/crates/lib/sqlite}/LICENSE-CC0 +0 -0
  163. {covalence-0.1.0.dev6/crates/python → covalence-0.1.0.dev7/crates/lib/sqlite}/LICENSE-MIT +0 -0
  164. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/lib/sqlite/src/lib.rs +0 -0
  165. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/python/about.md.hbs +0 -0
  166. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/python/about.toml +0 -0
  167. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/python/src/errors.rs +0 -0
  168. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/python/src/streams/download.rs +0 -0
  169. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/python/src/streams/mod.rs +0 -0
  170. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/python/src/streams/upload/tests.rs +0 -0
  171. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/python/src/streams/upload.rs +0 -0
  172. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/python/tests/test_api.py +0 -0
  173. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/python/tests/test_bounded_io.py +0 -0
  174. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/crates/python/tests/test_stubs.py +0 -0
  175. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/pyproject.toml +0 -0
  176. {covalence-0.1.0.dev6 → covalence-0.1.0.dev7}/python/covalence/py.typed +0 -0
@@ -779,7 +779,7 @@ checksum = "773648b94d0e5d620f64f280777445740e61fe701025087ec8b57f45c791888b"
779
779
 
780
780
  [[package]]
781
781
  name = "covalence-blob-trait"
782
- version = "0.1.0-dev.6"
782
+ version = "0.1.0-dev.7"
783
783
  dependencies = [
784
784
  "covalence-lib-cid",
785
785
  "covalence-lib-data",
@@ -788,7 +788,7 @@ dependencies = [
788
788
 
789
789
  [[package]]
790
790
  name = "covalence-cas-kv"
791
- version = "0.1.0-dev.6"
791
+ version = "0.1.0-dev.7"
792
792
  dependencies = [
793
793
  "blake3",
794
794
  "covalence-cas-trait",
@@ -810,7 +810,7 @@ dependencies = [
810
810
 
811
811
  [[package]]
812
812
  name = "covalence-cas-memory"
813
- version = "0.1.0-dev.6"
813
+ version = "0.1.0-dev.7"
814
814
  dependencies = [
815
815
  "covalence-cas-trait",
816
816
  "covalence-lib-cid",
@@ -821,7 +821,7 @@ dependencies = [
821
821
 
822
822
  [[package]]
823
823
  name = "covalence-cas-sqlite"
824
- version = "0.1.0-dev.6"
824
+ version = "0.1.0-dev.7"
825
825
  dependencies = [
826
826
  "covalence-cas-trait",
827
827
  "covalence-lib-cid",
@@ -836,7 +836,7 @@ dependencies = [
836
836
 
837
837
  [[package]]
838
838
  name = "covalence-cas-trait"
839
- version = "0.1.0-dev.6"
839
+ version = "0.1.0-dev.7"
840
840
  dependencies = [
841
841
  "covalence-lib-cid",
842
842
  "covalence-lib-dasl",
@@ -847,7 +847,7 @@ dependencies = [
847
847
 
848
848
  [[package]]
849
849
  name = "covalence-kv-memory"
850
- version = "0.1.0-dev.6"
850
+ version = "0.1.0-dev.7"
851
851
  dependencies = [
852
852
  "covalence-kv-trait",
853
853
  "covalence-lib-dasl",
@@ -857,7 +857,7 @@ dependencies = [
857
857
 
858
858
  [[package]]
859
859
  name = "covalence-kv-s3"
860
- version = "0.1.0-dev.6"
860
+ version = "0.1.0-dev.7"
861
861
  dependencies = [
862
862
  "aws-config",
863
863
  "aws-credential-types",
@@ -881,7 +881,7 @@ dependencies = [
881
881
 
882
882
  [[package]]
883
883
  name = "covalence-kv-trait"
884
- version = "0.1.0-dev.6"
884
+ version = "0.1.0-dev.7"
885
885
  dependencies = [
886
886
  "covalence-lib-dasl",
887
887
  "covalence-lib-data",
@@ -890,7 +890,7 @@ dependencies = [
890
890
 
891
891
  [[package]]
892
892
  name = "covalence-lib-cid"
893
- version = "0.1.0-dev.6"
893
+ version = "0.1.0-dev.7"
894
894
  dependencies = [
895
895
  "blake3",
896
896
  "covalence-lib-data",
@@ -905,14 +905,25 @@ dependencies = [
905
905
 
906
906
  [[package]]
907
907
  name = "covalence-lib-cli"
908
- version = "0.1.0-dev.6"
908
+ version = "0.1.0-dev.7"
909
909
  dependencies = [
910
910
  "clap",
911
911
  ]
912
912
 
913
+ [[package]]
914
+ name = "covalence-lib-config"
915
+ version = "0.1.0-dev.7"
916
+ dependencies = [
917
+ "covalence-lib-error",
918
+ "covalence-lib-serde",
919
+ "etcetera",
920
+ "tempfile",
921
+ "toml",
922
+ ]
923
+
913
924
  [[package]]
914
925
  name = "covalence-lib-dasl"
915
- version = "0.1.0-dev.6"
926
+ version = "0.1.0-dev.7"
916
927
  dependencies = [
917
928
  "blake3",
918
929
  "covalence-lib-cid",
@@ -927,7 +938,7 @@ dependencies = [
927
938
 
928
939
  [[package]]
929
940
  name = "covalence-lib-data"
930
- version = "0.1.0-dev.6"
941
+ version = "0.1.0-dev.7"
931
942
  dependencies = [
932
943
  "arrayvec",
933
944
  "bytes",
@@ -939,7 +950,7 @@ dependencies = [
939
950
 
940
951
  [[package]]
941
952
  name = "covalence-lib-error"
942
- version = "0.1.0-dev.6"
953
+ version = "0.1.0-dev.7"
943
954
  dependencies = [
944
955
  "miette",
945
956
  "snafu",
@@ -947,14 +958,14 @@ dependencies = [
947
958
 
948
959
  [[package]]
949
960
  name = "covalence-lib-python"
950
- version = "0.1.0-dev.6"
961
+ version = "0.1.0-dev.7"
951
962
  dependencies = [
952
963
  "pyo3",
953
964
  ]
954
965
 
955
966
  [[package]]
956
967
  name = "covalence-lib-rand"
957
- version = "0.1.0-dev.6"
968
+ version = "0.1.0-dev.7"
958
969
  dependencies = [
959
970
  "getrandom 0.3.4",
960
971
  "rand",
@@ -962,21 +973,21 @@ dependencies = [
962
973
 
963
974
  [[package]]
964
975
  name = "covalence-lib-serde"
965
- version = "0.1.0-dev.6"
976
+ version = "0.1.0-dev.7"
966
977
  dependencies = [
967
978
  "serde",
968
979
  ]
969
980
 
970
981
  [[package]]
971
982
  name = "covalence-lib-sqlite"
972
- version = "0.1.0-dev.6"
983
+ version = "0.1.0-dev.7"
973
984
  dependencies = [
974
985
  "rusqlite",
975
986
  ]
976
987
 
977
988
  [[package]]
978
989
  name = "covalence-python"
979
- version = "0.1.0-dev.6"
990
+ version = "0.1.0-dev.7"
980
991
  dependencies = [
981
992
  "blake3",
982
993
  "covalence-blob-trait",
@@ -988,16 +999,18 @@ dependencies = [
988
999
  "covalence-kv-s3",
989
1000
  "covalence-kv-trait",
990
1001
  "covalence-lib-cid",
1002
+ "covalence-lib-config",
991
1003
  "covalence-lib-dasl",
992
1004
  "covalence-lib-data",
993
1005
  "covalence-lib-python",
994
1006
  "pep440_rs",
995
1007
  "tempfile",
1008
+ "toml",
996
1009
  ]
997
1010
 
998
1011
  [[package]]
999
1012
  name = "covalence-tools-glu"
1000
- version = "0.1.0-dev.6"
1013
+ version = "0.1.0-dev.7"
1001
1014
  dependencies = [
1002
1015
  "covalence-lib-cli",
1003
1016
  "covalence-lib-error",
@@ -1172,6 +1185,17 @@ dependencies = [
1172
1185
  "windows-sys 0.61.2",
1173
1186
  ]
1174
1187
 
1188
+ [[package]]
1189
+ name = "etcetera"
1190
+ version = "0.10.0"
1191
+ source = "registry+https://github.com/rust-lang/crates.io-index"
1192
+ checksum = "26c7b13d0780cb82722fd59f6f57f925e143427e4a75313a6c77243bf5326ae6"
1193
+ dependencies = [
1194
+ "cfg-if",
1195
+ "home",
1196
+ "windows-sys 0.59.0",
1197
+ ]
1198
+
1175
1199
  [[package]]
1176
1200
  name = "fallible-iterator"
1177
1201
  version = "0.3.0"
@@ -1410,6 +1434,15 @@ dependencies = [
1410
1434
  "digest 0.11.3",
1411
1435
  ]
1412
1436
 
1437
+ [[package]]
1438
+ name = "home"
1439
+ version = "0.5.12"
1440
+ source = "registry+https://github.com/rust-lang/crates.io-index"
1441
+ checksum = "cc627f471c528ff0c4a49e1d5e60450c8f6461dd6d10ba9dcd3a61d3dff7728d"
1442
+ dependencies = [
1443
+ "windows-sys 0.61.2",
1444
+ ]
1445
+
1413
1446
  [[package]]
1414
1447
  name = "http"
1415
1448
  version = "1.5.0"
@@ -2795,6 +2828,15 @@ dependencies = [
2795
2828
  "zmij",
2796
2829
  ]
2797
2830
 
2831
+ [[package]]
2832
+ name = "serde_spanned"
2833
+ version = "1.1.2"
2834
+ source = "registry+https://github.com/rust-lang/crates.io-index"
2835
+ checksum = "4e7523beb55eece201a2356bee0bbca0d1ab466c14c07703b2e0ee6d42cb0c2c"
2836
+ dependencies = [
2837
+ "serde_core",
2838
+ ]
2839
+
2798
2840
  [[package]]
2799
2841
  name = "serde_urlencoded"
2800
2842
  version = "0.7.1"
@@ -3197,6 +3239,45 @@ dependencies = [
3197
3239
  "tokio",
3198
3240
  ]
3199
3241
 
3242
+ [[package]]
3243
+ name = "toml"
3244
+ version = "1.1.8+spec-1.1.0"
3245
+ source = "registry+https://github.com/rust-lang/crates.io-index"
3246
+ checksum = "20489e00e4d8741d6be680764cc12e270655e375a20d1011e844a9c3379e678d"
3247
+ dependencies = [
3248
+ "indexmap",
3249
+ "serde_core",
3250
+ "serde_spanned",
3251
+ "toml_datetime",
3252
+ "toml_parser",
3253
+ "toml_writer",
3254
+ "winnow",
3255
+ ]
3256
+
3257
+ [[package]]
3258
+ name = "toml_datetime"
3259
+ version = "1.1.2+spec-1.1.0"
3260
+ source = "registry+https://github.com/rust-lang/crates.io-index"
3261
+ checksum = "2b86d767906c6c42421dcba507eb9d203e779497710a47782a224bb871653053"
3262
+ dependencies = [
3263
+ "serde_core",
3264
+ ]
3265
+
3266
+ [[package]]
3267
+ name = "toml_parser"
3268
+ version = "1.1.5+spec-1.1.0"
3269
+ source = "registry+https://github.com/rust-lang/crates.io-index"
3270
+ checksum = "baa693a8032d7e1cada7d0041e96126df243179ff061456783ac7f12bda4744c"
3271
+ dependencies = [
3272
+ "winnow",
3273
+ ]
3274
+
3275
+ [[package]]
3276
+ name = "toml_writer"
3277
+ version = "1.1.3+spec-1.1.0"
3278
+ source = "registry+https://github.com/rust-lang/crates.io-index"
3279
+ checksum = "06bdbd8cfc056b8d2e2e85f29b56a3bdbecb527cef81eb39e3e7b98af4652770"
3280
+
3200
3281
  [[package]]
3201
3282
  name = "tower"
3202
3283
  version = "0.5.3"
@@ -3608,6 +3689,15 @@ dependencies = [
3608
3689
  "windows-targets",
3609
3690
  ]
3610
3691
 
3692
+ [[package]]
3693
+ name = "windows-sys"
3694
+ version = "0.59.0"
3695
+ source = "registry+https://github.com/rust-lang/crates.io-index"
3696
+ checksum = "1e38bc4d79ed67fd075bcc251a1c39b32a1776bbe92e5bef1f0bf1f8c531853b"
3697
+ dependencies = [
3698
+ "windows-targets",
3699
+ ]
3700
+
3611
3701
  [[package]]
3612
3702
  name = "windows-sys"
3613
3703
  version = "0.61.2"
@@ -3681,6 +3771,12 @@ version = "0.52.6"
3681
3771
  source = "registry+https://github.com/rust-lang/crates.io-index"
3682
3772
  checksum = "589f6da84c646204747d1270a2a5661ea66ed1cced2631d546fdfb155959f9ec"
3683
3773
 
3774
+ [[package]]
3775
+ name = "winnow"
3776
+ version = "1.0.4"
3777
+ source = "registry+https://github.com/rust-lang/crates.io-index"
3778
+ checksum = "23b97319f7b8343df12cc98938e5c3eb436064524c8d2b4e30a1d3a36eecdf81"
3779
+
3684
3780
  [[package]]
3685
3781
  name = "wit-bindgen"
3686
3782
  version = "0.57.1"
@@ -1,9 +1,9 @@
1
1
  [workspace]
2
- members = ["crates/lib/error", "crates/lib/serde", "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"]
3
3
  resolver = "3"
4
4
 
5
5
  [workspace.package]
6
- version = "0.1.0-dev.6"
6
+ version = "0.1.0-dev.7"
7
7
  edition = "2024"
8
8
  rust-version = "1.98"
9
9
  license = "CC0-1.0 OR MIT OR Apache-2.0"
@@ -17,22 +17,23 @@ miette = "7.6.0"
17
17
  sha2 = "0.11.0"
18
18
  snafu = "0.9.2"
19
19
  # Published crates, at the workspace version so the set moves together.
20
- covalence-blob-trait = { path = "crates/blob/trait", version = "=0.1.0-dev.6" }
21
- covalence-cas-kv = { path = "crates/cas/kv", version = "=0.1.0-dev.6" }
22
- covalence-cas-memory = { path = "crates/cas/memory", version = "=0.1.0-dev.6" }
23
- covalence-cas-sqlite = { path = "crates/cas/sqlite", version = "=0.1.0-dev.6" }
24
- covalence-cas-trait = { path = "crates/cas/trait", version = "=0.1.0-dev.6" }
25
- covalence-kv-memory = { path = "crates/kv/memory", version = "=0.1.0-dev.6" }
26
- covalence-kv-s3 = { path = "crates/kv/s3", version = "=0.1.0-dev.6" }
27
- covalence-kv-trait = { path = "crates/kv/trait", version = "=0.1.0-dev.6" }
28
- covalence-lib-cid = { path = "crates/lib/cid", version = "=0.1.0-dev.6" }
29
- covalence-lib-cli = { path = "crates/lib/cli", version = "=0.1.0-dev.6" }
30
- covalence-lib-dasl = { path = "crates/lib/dasl", version = "=0.1.0-dev.6" }
31
- covalence-lib-data = { path = "crates/lib/data", version = "=0.1.0-dev.6" }
32
- covalence-lib-error = { path = "crates/lib/error", version = "=0.1.0-dev.6" }
33
- covalence-lib-rand = { path = "crates/lib/rand", version = "=0.1.0-dev.6" }
34
- covalence-lib-serde = { path = "crates/lib/serde", version = "=0.1.0-dev.6" }
35
- covalence-lib-sqlite = { path = "crates/lib/sqlite", version = "=0.1.0-dev.6" }
20
+ covalence-blob-trait = { path = "crates/blob/trait", version = "=0.1.0-dev.7" }
21
+ covalence-cas-kv = { path = "crates/cas/kv", version = "=0.1.0-dev.7" }
22
+ covalence-cas-memory = { path = "crates/cas/memory", version = "=0.1.0-dev.7" }
23
+ covalence-cas-sqlite = { path = "crates/cas/sqlite", version = "=0.1.0-dev.7" }
24
+ covalence-cas-trait = { path = "crates/cas/trait", version = "=0.1.0-dev.7" }
25
+ covalence-kv-memory = { path = "crates/kv/memory", version = "=0.1.0-dev.7" }
26
+ covalence-kv-s3 = { path = "crates/kv/s3", version = "=0.1.0-dev.7" }
27
+ covalence-kv-trait = { path = "crates/kv/trait", version = "=0.1.0-dev.7" }
28
+ covalence-lib-cid = { path = "crates/lib/cid", version = "=0.1.0-dev.7" }
29
+ covalence-lib-cli = { path = "crates/lib/cli", version = "=0.1.0-dev.7" }
30
+ covalence-lib-config = { path = "crates/lib/config", version = "=0.1.0-dev.7" }
31
+ covalence-lib-dasl = { path = "crates/lib/dasl", version = "=0.1.0-dev.7" }
32
+ covalence-lib-data = { path = "crates/lib/data", version = "=0.1.0-dev.7" }
33
+ covalence-lib-error = { path = "crates/lib/error", version = "=0.1.0-dev.7" }
34
+ covalence-lib-rand = { path = "crates/lib/rand", version = "=0.1.0-dev.7" }
35
+ covalence-lib-serde = { path = "crates/lib/serde", version = "=0.1.0-dev.7" }
36
+ covalence-lib-sqlite = { path = "crates/lib/sqlite", version = "=0.1.0-dev.7" }
36
37
 
37
38
  [workspace.lints.rust]
38
39
  unsafe_code = "forbid"
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: covalence
3
- Version: 0.1.0.dev6
3
+ Version: 0.1.0.dev7
4
4
  License-File: LICENSE-APACHE
5
5
  License-File: LICENSE-CC0
6
6
  License-File: LICENSE-MIT
@@ -17,6 +17,8 @@ Project-URL: Repository, https://github.com/hiloopai/covalence
17
17
  Content identifiers (CIDs), DASL values, and content-addressed and key-value
18
18
  stores, from Python.
19
19
 
20
+ `covalence.config` also provides application directories and TOML configuration.
21
+
20
22
  ```pycon
21
23
  >>> from covalence import Cid, Value
22
24
  >>> cid = Cid.of(b"payload", "sha256")
@@ -35,7 +37,7 @@ True
35
37
  ## Install
36
38
 
37
39
  ```sh
38
- pip install covalence==0.1.0.dev6
40
+ pip install covalence==0.1.0.dev7
39
41
  ```
40
42
 
41
43
  - Pre-releases need an exact pin like this one, or `pip install --pre`.
@@ -59,6 +61,46 @@ pip install covalence==0.1.0.dev6
59
61
  - A **CAS** (content-addressed store) keeps bytes and finds them by their
60
62
  CIDs.
61
63
 
64
+ ## Configuration
65
+
66
+ `covalence.config` selects application directories and reads TOML using the
67
+ same Rust implementation as `covalence-lib-config`.
68
+
69
+ ```pycon
70
+ >>> from covalence import config
71
+ >>> str(config.config_dir("example", override_dir="settings"))
72
+ 'settings'
73
+ >>> config.parse('enabled = true\nworkers = 2')
74
+ {'enabled': True, 'workers': 2}
75
+
76
+ ```
77
+
78
+ - `config_dir`, `cache_dir`, `data_dir`, `state_dir` and `runtime_dir` return
79
+ `pathlib.Path`. Each takes an application name and an optional keyword
80
+ `override_dir`. An override is returned unchanged, including relative paths.
81
+ Without an override, names must be a single non-empty directory component;
82
+ `.`, `..`, separators, colons and NUL raise `ValueError`.
83
+ - Unix, including macOS, uses `XDG_CONFIG_HOME`, `XDG_CACHE_HOME`,
84
+ `XDG_DATA_HOME`, `XDG_STATE_HOME` and `XDG_RUNTIME_DIR`, respectively. Unset,
85
+ empty and relative variables fall back to `~/.config`, `~/.cache`,
86
+ `~/.local/share` and `~/.local/state`. Runtime falls back to state.
87
+ - Windows uses roaming application data for config, data, state and runtime,
88
+ and local application data for cache. An unavailable home raises `OSError`.
89
+ - Directory lookups do not create paths or enforce permissions. A runtime
90
+ fallback does not have session lifetime or permission guarantees.
91
+ - `parse(text)` returns a dict. `read(path)` reads a UTF-8 file and returns
92
+ `{}` if it is missing, including a missing parent. `read_required(path)`
93
+ raises `FileNotFoundError` instead, suitable for a user-supplied config path.
94
+ Invalid TOML raises `ValueError`; other read failures raise `OSError`.
95
+ - TOML tables, arrays and scalars become dicts, lists, str, bool, signed 64-bit
96
+ int and float. Date/time values become `datetime.datetime`, `datetime.date`
97
+ or `datetime.time`, retaining offsets and truncating fractions to
98
+ microseconds. Integers outside the signed 64-bit range, and dates Python
99
+ cannot represent, raise `ValueError`.
100
+ - Files are read in full. This API adds no file-size limit, schema validation,
101
+ interpolation, environment expansion or layer merging; callers validate
102
+ their configuration fields. Normal filesystem symlink semantics apply.
103
+
62
104
  ## CIDs, hashes and codecs
63
105
 
64
106
  - `Cid` is any CIDv1 with a digest of at most 64 bytes. `Cid(x)` takes text
@@ -322,16 +364,16 @@ stub; this package writes its stub by hand and checks it against `__doc__`:
322
364
  later) for manylinux_2_28 x86_64 and aarch64 and macOS arm64, and an sdist,
323
365
  and runs `tests/` against each wheel. Pull requests and pushes keep them as
324
366
  workflow artifacts. A release tag must match the workspace version, such as
325
- `0.1.0-dev.6`; the files carry its PEP 440 form, `0.1.0.dev6`:
367
+ `0.1.0-dev.7`; the files carry its PEP 440 form, `0.1.0.dev7`:
326
368
 
327
369
  - `v<version>` attaches them to that GitHub release. In the public
328
370
  `hiloopai/covalence` repository it also publishes them to PyPI, and
329
371
  `.github/workflows/crates.yml` publishes the crates to crates.io.
330
372
  - `python-v<version>` only attaches them to the GitHub release.
331
373
 
332
- To publish `0.1.0-dev.6`:
374
+ To publish `0.1.0-dev.7`:
333
375
 
334
376
  ```sh
335
- git tag v0.1.0-dev.6 && git push origin v0.1.0-dev.6
377
+ git tag v0.1.0-dev.7 && git push origin v0.1.0-dev.7
336
378
  ```
337
379
 
@@ -3,6 +3,8 @@
3
3
  Content identifiers (CIDs), DASL values, and content-addressed and key-value
4
4
  stores, from Python.
5
5
 
6
+ `covalence.config` also provides application directories and TOML configuration.
7
+
6
8
  ```pycon
7
9
  >>> from covalence import Cid, Value
8
10
  >>> cid = Cid.of(b"payload", "sha256")
@@ -21,7 +23,7 @@ True
21
23
  ## Install
22
24
 
23
25
  ```sh
24
- pip install covalence==0.1.0.dev6
26
+ pip install covalence==0.1.0.dev7
25
27
  ```
26
28
 
27
29
  - Pre-releases need an exact pin like this one, or `pip install --pre`.
@@ -45,6 +47,46 @@ pip install covalence==0.1.0.dev6
45
47
  - A **CAS** (content-addressed store) keeps bytes and finds them by their
46
48
  CIDs.
47
49
 
50
+ ## Configuration
51
+
52
+ `covalence.config` selects application directories and reads TOML using the
53
+ same Rust implementation as `covalence-lib-config`.
54
+
55
+ ```pycon
56
+ >>> from covalence import config
57
+ >>> str(config.config_dir("example", override_dir="settings"))
58
+ 'settings'
59
+ >>> config.parse('enabled = true\nworkers = 2')
60
+ {'enabled': True, 'workers': 2}
61
+
62
+ ```
63
+
64
+ - `config_dir`, `cache_dir`, `data_dir`, `state_dir` and `runtime_dir` return
65
+ `pathlib.Path`. Each takes an application name and an optional keyword
66
+ `override_dir`. An override is returned unchanged, including relative paths.
67
+ Without an override, names must be a single non-empty directory component;
68
+ `.`, `..`, separators, colons and NUL raise `ValueError`.
69
+ - Unix, including macOS, uses `XDG_CONFIG_HOME`, `XDG_CACHE_HOME`,
70
+ `XDG_DATA_HOME`, `XDG_STATE_HOME` and `XDG_RUNTIME_DIR`, respectively. Unset,
71
+ empty and relative variables fall back to `~/.config`, `~/.cache`,
72
+ `~/.local/share` and `~/.local/state`. Runtime falls back to state.
73
+ - Windows uses roaming application data for config, data, state and runtime,
74
+ and local application data for cache. An unavailable home raises `OSError`.
75
+ - Directory lookups do not create paths or enforce permissions. A runtime
76
+ fallback does not have session lifetime or permission guarantees.
77
+ - `parse(text)` returns a dict. `read(path)` reads a UTF-8 file and returns
78
+ `{}` if it is missing, including a missing parent. `read_required(path)`
79
+ raises `FileNotFoundError` instead, suitable for a user-supplied config path.
80
+ Invalid TOML raises `ValueError`; other read failures raise `OSError`.
81
+ - TOML tables, arrays and scalars become dicts, lists, str, bool, signed 64-bit
82
+ int and float. Date/time values become `datetime.datetime`, `datetime.date`
83
+ or `datetime.time`, retaining offsets and truncating fractions to
84
+ microseconds. Integers outside the signed 64-bit range, and dates Python
85
+ cannot represent, raise `ValueError`.
86
+ - Files are read in full. This API adds no file-size limit, schema validation,
87
+ interpolation, environment expansion or layer merging; callers validate
88
+ their configuration fields. Normal filesystem symlink semantics apply.
89
+
48
90
  ## CIDs, hashes and codecs
49
91
 
50
92
  - `Cid` is any CIDv1 with a digest of at most 64 bytes. `Cid(x)` takes text
@@ -308,15 +350,15 @@ stub; this package writes its stub by hand and checks it against `__doc__`:
308
350
  later) for manylinux_2_28 x86_64 and aarch64 and macOS arm64, and an sdist,
309
351
  and runs `tests/` against each wheel. Pull requests and pushes keep them as
310
352
  workflow artifacts. A release tag must match the workspace version, such as
311
- `0.1.0-dev.6`; the files carry its PEP 440 form, `0.1.0.dev6`:
353
+ `0.1.0-dev.7`; the files carry its PEP 440 form, `0.1.0.dev7`:
312
354
 
313
355
  - `v<version>` attaches them to that GitHub release. In the public
314
356
  `hiloopai/covalence` repository it also publishes them to PyPI, and
315
357
  `.github/workflows/crates.yml` publishes the crates to crates.io.
316
358
  - `python-v<version>` only attaches them to the GitHub release.
317
359
 
318
- To publish `0.1.0-dev.6`:
360
+ To publish `0.1.0-dev.7`:
319
361
 
320
362
  ```sh
321
- git tag v0.1.0-dev.6 && git push origin v0.1.0-dev.6
363
+ git tag v0.1.0-dev.7 && git push origin v0.1.0-dev.7
322
364
  ```
@@ -0,0 +1,28 @@
1
+ [package]
2
+ name = "covalence-lib-config"
3
+ description = "Application directories and typed TOML configuration"
4
+ version.workspace = true
5
+ edition.workspace = true
6
+ rust-version.workspace = true
7
+ license.workspace = true
8
+ repository.workspace = true
9
+ documentation = "https://docs.rs/covalence-lib-config"
10
+ readme = "README.md"
11
+ keywords = ["configuration", "toml", "xdg"]
12
+ categories = ["config", "filesystem"]
13
+ publish = true
14
+
15
+ [dependencies]
16
+ covalence-lib-error.workspace = true
17
+ covalence-lib-serde.workspace = true
18
+ etcetera = "0.10"
19
+ toml = "1.1"
20
+
21
+ [dev-dependencies]
22
+ tempfile = "3"
23
+
24
+ [package.metadata.docs.rs]
25
+ all-features = true
26
+
27
+ [lints]
28
+ workspace = true
@@ -0,0 +1,72 @@
1
+ # Application directories and TOML configuration
2
+
3
+ `covalence-lib-config` selects application directories and deserializes TOML
4
+ configuration into Rust types. It does not create directories or write files.
5
+
6
+ ```rust
7
+ use std::path::{Path, PathBuf};
8
+ use covalence_lib_config::{config_dir, parse};
9
+ use covalence_lib_serde::Deserialize;
10
+
11
+ #[derive(Debug, PartialEq, Deserialize)]
12
+ #[serde(crate = "covalence_lib_serde::serde", deny_unknown_fields)]
13
+ struct Config {
14
+ name: String,
15
+ }
16
+
17
+ let dir = config_dir("example", Some(PathBuf::from("relative/config")))?;
18
+ assert_eq!(dir, Path::new("relative/config"));
19
+ let config: Config = parse("name = \"example\"")?;
20
+ assert_eq!(config.name, "example");
21
+ # Ok::<(), Box<dyn std::error::Error>>(())
22
+ ```
23
+
24
+ ## Directories
25
+
26
+ `config_dir`, `data_dir`, `cache_dir`, `state_dir` and `runtime_dir` return an explicit
27
+ `override_dir` unchanged, including relative paths. No name or home directory is
28
+ needed in that case. Otherwise, `name` must be one normal directory component:
29
+ empty names, `.`, `..`, separators, colons and NUL are rejected with `Error::Name`.
30
+ This keeps application names from replacing or traversing the selected base.
31
+ Names are not checked against platform-specific reserved filenames.
32
+
33
+ On Unix, including macOS, the functions use the [XDG Base Directory] variables.
34
+ Unset, empty and relative variables are ignored:
35
+
36
+ | Function | Environment variable | Default |
37
+ | --- | --- | --- |
38
+ | `config_dir` | `XDG_CONFIG_HOME` | `~/.config/<name>` |
39
+ | `data_dir` | `XDG_DATA_HOME` | `~/.local/share/<name>` |
40
+ | `cache_dir` | `XDG_CACHE_HOME` | `~/.cache/<name>` |
41
+ | `state_dir` | `XDG_STATE_HOME` | `~/.local/state/<name>` |
42
+ | `runtime_dir` | `XDG_RUNTIME_DIR` | the state directory |
43
+
44
+ On Windows config, data, state and runtime use the roaming application-data
45
+ directory: a nonempty `APPDATA`, then the Windows known-folder API, then
46
+ `AppData/Roaming` under the home directory. The cache uses nonempty
47
+ `LOCALAPPDATA`, then its known-folder API, then `AppData/Local` under the home
48
+ directory. All append `name`.
49
+ The functions report `Error::Home` when the home directory cannot be found.
50
+
51
+ Path selection does not check existence, create directories, canonicalize
52
+ symlinks, enforce permissions or provide an isolation boundary. In particular,
53
+ the runtime fallback does not have the lifetime or permission guarantees of an
54
+ XDG runtime directory; callers creating sockets or sensitive files must enforce
55
+ their own requirements.
56
+
57
+ ## TOML
58
+
59
+ `parse<T>` parses TOML text into any Serde-deserializable type. `read<T>` reads a
60
+ UTF-8 TOML file; a missing file (including a missing parent) returns `T::default()`.
61
+ `read_required<T>` reports missing files as errors, suitable for an explicit
62
+ configuration path from the user.
63
+ Other I/O errors return `Error::Read` with the path and underlying error. Invalid
64
+ TOML or a type mismatch returns `Error::Parse` with the path and parser error.
65
+ `parse` returns the TOML parser error directly.
66
+
67
+ The target Rust type controls defaults, accepted fields and validation. There is
68
+ no interpolation, environment-variable expansion, layer merging, schema
69
+ registry or size limit added by this crate. Reading follows ordinary filesystem
70
+ symlink semantics.
71
+
72
+ [XDG Base Directory]: https://specifications.freedesktop.org/basedir-spec/latest/