Serde YML

https://docs.rs/crate/serde_yml/latest
Admin
A robust Rust library that simplifies the serialization and deserialization of Rust data structures...
Tokens:6,377
Snippets:69
Trust Score:9.7
Update:3 months ago
Show doc for...
Tokens:
Raw
### Install serde_yml dependency

Source: https://docs.rs/crate/serde_yml/latest

Add the shim to your Cargo.toml to maintain compatibility during migration.

```toml
[dependencies]
serde_yml = "0.0.13"
```

--------------------------------

### Build Environment and Execution Logs

Source: https://docs.rs/crate/serde_yml/latest/builds/3405834/x86_64-unknown-linux-gnu.txt

Displays the rustc version, docs.rs version, and the full cargo command executed to generate documentation for the crate.

```text
# rustc version
rustc 1.98.0-nightly (d1fc603d1 2026-05-26)


# docs.rs version
docsrs 0.0.0 (f16e33f3e6ac9fc9e4413728c5dd1b2ba1c6b799 2026-05-23 )


# build log
[INFO] running `Command { std: "docker" "exec" "-e" "SOURCE_DIR=/opt/rustwide/workdir" "-e" "CARGO_HOME=/opt/rustwide/cargo-home" "-e" "RUSTUP_HOME=/opt/rustwide/rustup-home" "-e" "CARGO_TARGET_DIR=/opt/rustwide/target" "-e" "DOCS_RS=1" "-w" "/opt/rustwide/workdir" "--user" "1001:1001" "5a0d14af2b39a230df5005ed8afbc21b37483804923d6d3bff80e231ea90b126" "/opt/rustwide/cargo-home/bin/cargo" "+nightly" "rustdoc" "--lib" "-Zrustdoc-map" "--all-features" "--config" "build.rustdocflags=[\"--cfg\", \"docsrs\", \"--cfg\", \"docsrs\", \"-Z\", \"unstable-options\", \"--emit=invocation-specific\", \"--resource-suffix\", \"-20260526-1.98.0-nightly-d1fc603d1\", \"--static-root-path\", \"/-/rustdoc.static/\", \"--cap-lints\", \"warn\", \"--extern-html-root-takes-precedence\"]" "--offline" "-Zunstable-options" "--config=doc.extern-map.registries.crates-io=\"https://docs.rs/{pkg_name}/{version}/x86_64-unknown-linux-gnu\"" "-Zrustdoc-scrape-examples" "-j6" "--target" "x86_64-unknown-linux-gnu", kill_on_drop: false }`
[INFO] [stderr] warning: Rustdoc did not scrape the following examples because they require dev-dependencies: example, migration
[INFO] [stderr]     If you want Rustdoc to scrape these examples, then add `doc-scrape-examples = true`
[INFO] [stderr]     to the [[example]] target configuration of at least one example.
[INFO] [stderr] warning: target filter specified, but no targets matched; this is a no-op
[INFO] [stderr]  Documenting serde_yml v0.0.13 (/opt/rustwide/workdir)
[INFO] [stderr]     Finished `dev` profile [unoptimized + debuginfo] target(s) in 0.58s
[INFO] [stderr]    Generated /opt/rustwide/target/x86_64-unknown-linux-gnu/doc/serde_yml/index.html
[INFO] running `Command { std: "docker" "inspect" "5a0d14af2b39a230df5005ed8afbc21b37483804923d6d3bff80e231ea90b126", kill_on_drop: false }`
```

--------------------------------

### Migrate to noyalib

Source: https://docs.rs/crate/serde_yml/latest

Update dependencies and import paths to use noyalib with serde-yaml compatibility features.

```toml
-[dependencies]
-serde_yml = "0.0"
+[dependencies]
+noyalib = { version = "0.0.5", features = ["compat-serde-yaml"] }
```

```rust
-use serde_yml::{from_str, to_string, Value};
+use noyalib::compat::serde_yaml::{from_str, to_string, Value};
```

--------------------------------

### Verify security fix

Source: https://docs.rs/crate/serde_yml/latest

Use cargo commands to update the dependency and verify the removal of vulnerable components.

```bash
$ cargo update -p serde_yml --precise 0.0.13
$ cargo audit
# RUSTSEC-2025-0068 no longer flagged for serde_yml — the
# vulnerable surface is not present in 0.0.13.
$ cargo tree -p serde_yml | grep libyml
# (no output — libyml is not in the dependency graph)
```

--------------------------------

### Cargo.toml configuration for serde_yml

Source: https://docs.rs/crate/serde_yml/latest/source/Cargo.toml.orig

Defines the package metadata, dependencies, and build profiles for the deprecated serde_yml crate.

```toml
[package]
authors = ["Serde YML Contributors"]
categories = ["encoding", "parser-implementations"]
description = """
DEPRECATED — `serde_yml` is unmaintained. This release is a thin compatibility shim that forwards every call to `noyalib` (a pure-Rust, `#![forbid(unsafe_code)]` YAML library). Please migrate to `noyalib`.
"""
documentation = "https://docs.rs/serde_yml/"
edition = "2021"
homepage = "https://github.com/sebastienrousseau/noyalib"
keywords = ["yaml", "serde", "deprecated", "noyalib"]
license = "MIT OR Apache-2.0"
name = "serde_yml"
readme = "README.md"
repository = "https://github.com/sebastienrousseau/serde_yml"
# Bumped from 1.56 — `noyalib` requires Rust 1.85+ (edition 2024).
# Users who cannot move past 1.56 should stay on `serde_yml = "=0.0.12"`.
rust-version = "1.85.0"
version = "0.0.13"
include = [
    "/Cargo.toml",
    "/LICENSE-APACHE",
    "/LICENSE-MIT",
    "/MIGRATION.md",
    "/README.md",
    "/examples/**",
    "/src/**",
    "/tests/**",
]

[dependencies]
# `noyalib` is the actively-maintained pure-Rust YAML library that
# this shim forwards every call to. The `compat-serde-yaml` feature
# exposes a name-for-name surface that this crate re-exports under
# its own historical public path — no double-parsing, no extra
# allocations, no archived advisory chain pulled in transitively.
noyalib = { version = "0.0.5", default-features = false, features = ["std", "compat-serde-yaml"] }
serde = "1.0.204"

[dev-dependencies]
serde = { version = "1.0.204", features = ["derive"] }
serde_derive = "1.0.204"
indoc = "2.0.5"

[features]
default = []

[lib]
name = "serde_yml"
path = "src/lib.rs"

[package.metadata.docs.rs]
all-features = true
rustdoc-args = ["--cfg", "docsrs"]
targets = ["x86_64-unknown-linux-gnu"]

[profile.release]
codegen-units = 1
lto = true
opt-level = 3
panic = "abort"
strip = "symbols"
```

--------------------------------

### Migrate dependencies to serde-saphyr

Source: https://docs.rs/crate/serde_yml/latest/source/MIGRATION.md

Update Cargo.toml to replace serde_yml with serde-saphyr.

```diff
-[dependencies]
-serde_yml = "0.0"
+[dependencies]
+serde-saphyr = "0.0"
```

--------------------------------

### Cargo.toml Configuration

Source: https://docs.rs/crate/serde_yml/latest/source/Cargo.toml

The automatically generated Cargo.toml file for the serde_yml crate, detailing dependencies and build settings.

```toml
# THIS FILE IS AUTOMATICALLY GENERATED BY CARGO
#
# When uploading crates to the registry Cargo will automatically
# "normalize" Cargo.toml files for maximal compatibility
# with all versions of Cargo and also rewrite `path` dependencies
# to registry (e.g., crates.io) dependencies.
#
# If you are reading this file be aware that the original Cargo.toml
# will likely look very different (and much more reasonable).
# See Cargo.toml.orig for the original contents.

[package]
edition = "2021"
rust-version = "1.85.0"
name = "serde_yml"
version = "0.0.13"
authors = ["Serde YML Contributors"]
build = false
include = [
    "/Cargo.toml",
    "/LICENSE-APACHE",
    "/LICENSE-MIT",
    "/MIGRATION.md",
    "/README.md",
    "/examples/**",
    "/src/**",
    "/tests/**",
]
autolib = false
autobins = false
autoexamples = false
autotests = false
autobenches = false
description = """
DEPRECATED — `serde_yml` is unmaintained. This release is a thin compatibility shim that forwards every call to `noyalib` (a pure-Rust, `#![forbid(unsafe_code)]` YAML library). Please migrate to `noyalib`.
"""
homepage = "https://github.com/sebastienrousseau/noyalib"
documentation = "https://docs.rs/serde_yml/"
readme = "README.md"
keywords = [
    "yaml",
    "serde",
    "deprecated",
    "noyalib",
]
categories = [
    "encoding",
    "parser-implementations",
]
license = "MIT OR Apache-2.0"
repository = "https://github.com/sebastienrousseau/serde_yml"

[package.metadata.docs.rs]
all-features = true
rustdoc-args = [
    "--cfg",
    "docsrs",
]
targets = ["x86_64-unknown-linux-gnu"]

[features]
default = []

[lib]
name = "serde_yml"
path = "src/lib.rs"

[[example]]
name = "example"
path = "examples/example.rs"

[[example]]
name = "migration"
path = "examples/migration.rs"

[[test]]
name = "shim"
path = "tests/shim.rs"

[dependencies.noyalib]
version = "0.0.5"
features = [
    "std",
    "compat-serde-yaml",
]
default-features = false

[dependencies.serde]
version = "1.0.204"

[dev-dependencies.indoc]
version = "2.0.5"

[dev-dependencies.serde]
version = "1.0.204"
features = ["derive"]

[dev-dependencies.serde_derive]
version = "1.0.204"

[profile.release]
opt-level = 3
lto = true
codegen-units = 1
panic = "abort"
strip = "symbols"
```

--------------------------------

### Migrate dependencies to noyalib

Source: https://docs.rs/crate/serde_yml/latest/source/MIGRATION.md

Update Cargo.toml to replace serde_yml with noyalib using the compat-serde-yaml feature.

```diff
-[dependencies]
-serde_yml = "0.0"
+[dependencies]
+noyalib = { version = "0.0.5", features = ["compat-serde-yaml"] }
```

--------------------------------

### Serialize and Deserialize YAML with serde_yml

Source: https://docs.rs/crate/serde_yml/latest

Demonstrates basic usage of serde_yml for converting between Rust structs and YAML strings. Requires the serde crate with Serialize and Deserialize derives.

```rust
#![allow(deprecated)]
use serde::{Deserialize, Serialize};

#[derive(Debug, Serialize, Deserialize, PartialEq)]
struct Config {
    name: String,
    port: u16,
}

fn main() -> serde_yml::Result<()> {
    let yaml = "name: myapp\nport: 8080\n";
    let cfg: Config = serde_yml::from_str(yaml)?;
    let back = serde_yml::to_string(&cfg)?;
    let round: Config = serde_yml::from_str(&back)?;
    assert_eq!(cfg, round);
    Ok(())
}
```

--------------------------------

### Migrate to yaml-rust2

Source: https://docs.rs/crate/serde_yml/latest

Update dependencies and usage to accommodate the low-level Yaml enum AST instead of serde-based deserialization.

```toml
-[dependencies]
-serde_yml = "0.0"
+[dependencies]
+yaml-rust2 = "0.9"
```

```rust
-use serde_yml::{from_str, Value};
-let v: Value = serde_yml::from_str(yaml)?;
+use yaml_rust2::YamlLoader;
+let docs = YamlLoader::load_from_str(yaml)?;
+let v = &docs[0];
```

--------------------------------

### Migrate to serde-saphyr

Source: https://docs.rs/crate/serde_yml/latest

Update dependencies and imports for typed-only deserialization. Note that serde-saphyr does not support the Value type.

```toml
-[dependencies]
-serde_yml = "0.0"
+[dependencies]
+serde-saphyr = "0.0"
```

```rust
-use serde_yml::from_str;
+use serde_saphyr::from_str;
 let cfg: MyConfig = from_str(yaml)?;
```

--------------------------------

### Update imports for noyalib

Source: https://docs.rs/crate/serde_yml/latest/source/MIGRATION.md

Adjust existing imports to point to the noyalib compatibility layer.

```diff
-use serde_yml::{from_str, to_string, Value};
+use noyalib::compat::serde_yaml::{from_str, to_string, Value};
```

```rust
use noyalib::compat::serde_yaml as serde_yml;
```

--------------------------------

### Update imports for serde-saphyr

Source: https://docs.rs/crate/serde_yml/latest/source/MIGRATION.md

Replace serde_yml imports with serde-saphyr for typed deserialization.

```diff
-use serde_yml::from_str;
+use serde_saphyr::from_str;
 let cfg: MyConfig = from_str(yaml)?;
```

--------------------------------

### Update dependencies for yaml-rust2 migration

Source: https://docs.rs/crate/serde_yml/latest/source/MIGRATION.md

Replace the serde_yml dependency with yaml-rust2 in your Cargo.toml file.

```diff
-[dependencies]
-serde_yml = "0.0"
+[dependencies]
+yaml-rust2 = "0.9"
```

--------------------------------

### Migrate parsing logic to yaml-rust2

Source: https://docs.rs/crate/serde_yml/latest/source/MIGRATION.md

Replace serde_yml parsing calls with yaml-rust2's YamlLoader, noting that it returns a custom AST rather than a serde-compatible value.

```diff
-use serde_yml::from_str;
-let v: serde_yml::Value = serde_yml::from_str(yaml)?;
+use yaml_rust2::YamlLoader;
+let docs = YamlLoader::load_from_str(yaml)?;
+let v = &docs[0];
```

--------------------------------

### VCS Info Line Numbers

Source: https://docs.rs/crate/serde_yml/latest/source/.cargo_vcs_info.json

Line numbers associated with the VCS information file.

```text
1
2
3
4
5
6
```

--------------------------------

### VCS JSON Metadata

Source: https://docs.rs/crate/serde_yml/latest/source/.cargo_vcs_info.json

JSON object containing the git commit SHA1 and the path within the version control system.

```json
{
  "git": {
    "sha1": "2bdacd595e59e69832df963bd3b411a6854dfb64"
  },
  "path_in_vcs": ""
}
```
Tokens:
Raw