# Chef objects
This library depends upon `chef_api` for most functionality, but
provides a set of models for common Chef objects, such as nodes, roles
and environments.
# Usage
Models implement a version of`try_from()` in the context of [`serde_json`]'s Value
type - which is what is returned by all requests.
```rust
use chef_api::api_client::{ApiClient, Execute};
use chef::models::Node;
let client = ApiClient::from_credentials(None)?;
let node = client.nodes().node("my_node").get()?;
let node: Node = Node::try_from(node)?;
println!("Node name is {}", node.name.unwrap());
```
Once `try_from` is stablised in Rust, we'll switch to that.
## Lists
Many APIs in the Chef Server return a list of items. Models will try to
convert those lists in to `Iterator`s:
```rust
use chef_api::api_client::{ApiClient, Execute};
use chef::models::NodeList;
let client = ApiClient::from_credentials(None)?;
let nodes: NodeList = client.nodes().get()?.into();
for n in nodes {
println!("saw node: {}", n);
}
```