cityjson-lib 0.5.0

High-level CityJSON 2.0 read/write facade integrating JSON I/O
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

# Operations API

`cityjson_lib::ops` is the home for reusable workflows above the semantic
model.

The current release line ships four helpers:

- `cleanup(&CityModel) -> Result<CityModel>`
- `extract(&CityModel, ids) -> Result<CityModel>`
- `append(&mut CityModel, &CityModel) -> Result<()>`
- `merge(models) -> Result<CityModel>`

## Examples

```rust
use cityjson_lib::{json, ops};

let first = json::from_feature_file("tests/data/v2_0/feature-1.city.json")?;
let second = json::from_feature_file("tests/data/v2_0/feature-2.city.json")?;

let mut merged = ops::merge([first, second])?;
let subset = ops::extract(&merged, ["building-1"])?;
ops::append(&mut merged, &subset)?;
let cleaned = ops::cleanup(&merged)?;
# let _ = cleaned;
# Ok::<(), cityjson_lib::Error>(())
```

## Design Rule

`ops` stays as free functions instead of turning `CityModel` into a large
method bag.

## Implementation Rule

These helpers are part of the stable `cityjson-lib` facade, but the current
JSON-aware implementation is delegated to `cityjson-json`.