versa 1.9.0

Versa types and utilities for developing Versa client applications in Rust
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

# Versa Rust Test Suite

This directory contains tests for the versa-rust library, focusing on serialization and deserialization of versioned schemas.

## Running Tests

### With cargo nextest (recommended)
```bash
# Run all tests
cargo nextest run --all-features

# Run with CI profile (less parallelism, more output)
cargo nextest run --all-features --profile ci

# Run specific test file
cargo nextest run basic_types --all-features
```

### With standard cargo test
```bash
cargo test --all-features
```

## Test Structure

- `basic_types.rs` - Tests for basic types like Currency, SchemaVersion, Person, and Metadatum
  - Verifies type conversions and serialization
  - Tests differences between schema versions (e.g., Person type in v2.0.0)

## Schema Versions

The tests cover multiple schema versions:
- **v1.11.0** - Uses string passenger field in flights
- **v2.0.0** - Uses Person object for passenger field with metadata support

## Key Differences Between Versions

### Passenger Field Evolution
- v1.11.0: `passenger: Option<String>`
- v2.0.0: `passenger: Option<Person>` where Person includes:
  - `first_name`, `last_name`, `preferred_first_name`
  - `email`, `phone`
  - `metadata: Vec<Metadatum>`

### Schema Structure
Both versions use the same top-level structure:
```json
{
  "schema_version": "x.x.x",
  "header": { ... },
  "itemization": { ... },
  "payments": [ ... ],
  "footer": { ... }
}
```

## Configuration

Nextest configuration is in `.config/nextest.toml` with profiles for:
- `default` - Standard development testing
- `ci` - Conservative settings for CI environments