---
id: ruamel-yaml
version: "0.19.1"
license: MIT
license_treatment: permissive
maintenance: aging
---

# ruamel.yaml — ruamel.yaml is a YAML parser/emitter that supports roundtrip preservation of comments, seq/map flow style, and map key order

License: permissive · Maintenance: aging · Popularity: top 1,000 on PyPI

## Install

pip install ruamel-yaml
uv add ruamel-yaml
poetry add ruamel-yaml

## Description

# ruamel.yaml

`ruamel.yaml` is a YAML 1.2 loader/dumper package for Python.

| | |
| - | - |
| version |0.19.0 |
| updated |2025-01-02 |
| documentation |https://yaml.dev/doc/ruamel.yaml |
| repository |https://sourceforge.net/projects/ruamel-yaml |
| pypi |https://pypi.org/project/ruamel.yaml |


## breaking changes, that may make future uploads to PyPI impossible

*If you are interested in future upgrades of `ruamel.yaml`
please check the [documentation on installing](https://yaml.dev/doc/ruamel.yaml/install/),
since at some point I might not be able to upload a new version to PyPI with updated information.*

`ruamel.yaml` was intentionally named as `yaml` in a namespace `ruamel`. The namespace allows the installation
name to correspond unchanged to how the package is imported, reduces the number of links I have to create
in site-packages of a Python install during development, as well as providing a recognisable set of packages
my company releases to the public. 

However, after uploading version 0.18.7, I got an email from PyPI, about having to change the project name
to `ruamel_yaml` to comply with PEP 625, sometime in the future. The email doesn't say if namespace...

## AI interpretation — verify before relying

ruamel.yaml is a YAML 1.2 parser and emitter that loads and dumps YAML while preserving comments, formatting, key order, and quoting style—useful for configuration files and data interchange where round-trip fidelity matters.

Verdict: ruamel.yaml is a mature, well-maintained YAML parser with strong round-trip preservation and no security vulnerabilities. Its MIT license and low install friction make it a solid choice for configuration and data-interchange tasks. The aging maintenance status and noted future PyPI compliance uncertainty warrant pinning the version in production; users should monitor the project for updates, particularly around the announced namespace package changes.

[View on SkillFed](https://skillfed.io/packages/ruamel-yaml) · [View on PyPI](https://pypi.org/project/ruamel-yaml/)