term-guard 0.0.2

A Rust data validation library providing Deequ-like capabilities without Spark dependencies
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

# term-guard

Core library for the Term data validation framework.

## Overview

`term-guard` is the main library crate that provides all the data validation functionality for Term. It includes:

- **Constraints** - Over 30 built-in validation rules
- **Validation Engine** - High-performance constraint evaluation
- **Data Sources** - Support for files, cloud storage, and databases
- **Query Optimization** - Intelligent constraint batching
- **Telemetry** - Built-in observability with OpenTelemetry

## Documentation

- [API Documentation](https://docs.rs/term-guard)
- [Constraints Reference](../docs/reference/constraints.md)
- [Getting Started Tutorial](../docs/tutorials/01-getting-started.md)

## Usage

Add to your `Cargo.toml`:

```toml
[dependencies]
term-guard = "0.0.1"
```

Basic example:

```rust
use term_guard::prelude::*;

#[tokio::main]
async fn main() -> Result<()> {
    let ctx = SessionContext::new();
    ctx.register_csv("data", "data.csv", CsvReadOptions::new()).await?;
    
    let suite = ValidationSuite::builder("validation")
        .check(
            Check::builder("quality")
                .is_complete("id")
                .is_unique("email")
                .build()
        )
        .build();
    
    let results = suite.run(&ctx).await?;
    Ok(())
}
```

## Features

- `default` - Core functionality with file support
- `cloud-storage` - AWS S3, Google Cloud Storage, Azure Blob support
- `telemetry` - OpenTelemetry integration
- `test-utils` - Utilities for testing (TPC-H data generation)

## Project Structure

```
term-guard/
├── src/
│   ├── constraints/    # Validation constraints
│   ├── core/          # Core types (Suite, Check, Result)
│   ├── formatters/    # Result formatting
│   ├── sources/       # Data source connectors
│   └── lib.rs         # Library entry point
├── tests/             # Integration tests
└── benches/          # Performance benchmarks
```

## Development

Run tests:
```bash
cargo test
```

Run benchmarks:
```bash
cargo bench
```

## License

MIT License - see [LICENSE](../LICENSE) for details.