type-lib 1.0.0

Validation and type constraint library. Declare domain types with invariants enforced at construction. Parse-dont-validate pattern as a first-class citizen. Zero-overhead wrappers with derive macros.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106

[package]
name = "type-lib"
version = "1.0.0"
edition = "2021"
rust-version = "1.75"
readme = "README.md"
license = "Apache-2.0 OR MIT"

authors = [
    "James Gober <me@jamesgober.com>"
]

description = "Validation and type constraint library. Declare domain types with invariants enforced at construction. Parse-dont-validate pattern as a first-class citizen. Zero-overhead wrappers with derive macros."

keywords = [
    "types",
    "validation",
    "newtype",
    "parse",
    "rust"
]

categories = [
    "data-structures",
    "rust-patterns"
]

documentation = "https://docs.rs/type-lib"
repository    = "https://github.com/jamesgober/type-lib"
homepage      = "https://github.com/jamesgober/type-lib"

[package.metadata.docs.rs]
all-features = true
rustdoc-args = ["--cfg", "docsrs"]

[workspace]
members = ["derive"]
resolver = "2"

[lib]
name = "type_lib"
path = "src/lib.rs"

[features]
default = ["std"]
# `std` pulls in `alloc` and adds the `std::error::Error` impl for `ValidationError`.
std = ["alloc"]
# `alloc` enables the length rules for owned `String`/`Vec<T>` values. The core
# `Validator`/`Refined` API and all borrowed-value rules work without it.
alloc = []
# `derive` enables the `#[derive(Validated)]` macro for validated newtypes.
derive = ["dep:type-lib-derive"]

[dependencies]
type-lib-derive = { version = "1.0.0", path = "derive", optional = true }

[dev-dependencies]
# Property-based tests for rule and combinator invariants.
proptest = "1"
# Microbenchmarks for the validation hot path. Default features are disabled to
# keep the dev-dependency tree (and MSRV surface) small.
criterion = { version = "0.5", default-features = false, features = ["cargo_bench_support"] }

# The committed `Cargo.lock` pins this dev-dependency tree to versions that still
# build on the MSRV (Rust 1.75): proptest 1.4, criterion's clap 4.5, tempfile 3.14,
# and half 2.4. Newer releases of these require a newer compiler. These are
# dev-only and never reach published consumers; re-pin with `cargo update -p <crate>
# --precise <ver>` if you bump the MSRV.

[[bench]]
name = "validation"
harness = false

# The examples print output and use owned `String` values, so they require `std`.
# Declaring this keeps `--no-default-features` builds from trying to compile them.
[[example]]
name = "quick_start"
required-features = ["std"]

[[example]]
name = "built_in_rules"
required-features = ["std"]

[[example]]
name = "composing_rules"
required-features = ["std"]

[[example]]
name = "custom_rule"
required-features = ["std"]

[[example]]
name = "derive_newtype"
required-features = ["std", "derive"]

[profile.release]
opt-level = 3
lto = "fat"
codegen-units = 1
strip = "symbols"

[profile.bench]
opt-level = 3
lto = "fat"
codegen-units = 1
debug = true