obographs-dev 0.2.1

Load Obographs data files.
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

# obographs-dev

Crate with definitions of Obographs types and I/O functions.

Typically, the library should be used with `serde` feature enabled
to support parsing Obographs JSON files.

Therefore, the following should be added into `Cargo.toml` file:

```toml
obographs-dev = {version = '0.2.1', features = ["serde"]}
```

> Note: Check `crates.io` for the latest version and update `0.2.1` accordingly.

## Examples

### Create an Obographs type

The Obographs elements can be created programatically.
For instance, the [`obographs::model::Edge`] can be created as:

```rust
use obographs_dev::model::*;

let edge = Edge {
  sub: String::from("http://purl.obolibrary.org/obo/HP_0001250"),
  pred: String::from("is_a"),
  obj: String::from("http://purl.obolibrary.org/obo/HP_0012638"),
  meta: None,
};
```

### Read an Obographs JSON file

With `serde` feature enabled, we can read a JSON file 
into a [`obographs::model::GraphDocument`] by running:

```rust
use obographs_dev::model::GraphDocument;

let toy_hpo_json = "tests/test_data/hp.mini.json";
let graph_document = GraphDocument::from_path(toy_hpo_json).expect("Read graph document from file path");

assert_eq!(graph_document.graphs.len(), 1);
```

## Tests and benches

Run tests with:

```shell
cargo test --features serde
```

The benchmarks can be run with: 

```shell
cargo bench --features serde
```

## Disclaimer

The implementation of the Obographs model is **INCOMPLETE**.
Attributes and components may be missing.