Skip to main content

ruamel.yaml

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

Starting with version 0.15.0 the way YAML files are loaded and dumped is changing. See the API doc for details. Currently existing functionality will throw a warning before being changed/removed. For production systems you should pin the version being used with ``ruamel.yaml<=0.15``. There might be bug fixes in the 0.14 series, but new functionality is likely only to be available via the new API.

If your package uses ruamel.yaml and is not listed on PyPI, drop me an email, preferably with some infomormation on how you use the package (or a link to bitbucket/github) and I’ll keep you informed when the status of the API is stable enough to make the transition.

https://readthedocs.org/projects/yaml/badge/?version=stable

ChangeLog

0.15.8 (2017-06-15):
  • allow plug-in install via install ruamel.yaml[jinja2]

0.15.7 (2017-06-14):
  • add plug-in mechanism for load/dump pre resp. post-processing

0.15.6 (2017-06-10):
  • a set() with duplicate elements now throws error in rt loading

  • support for toplevel column zero literal/folded scalar in explicit documents

0.15.5 (2017-06-08):
  • repeat load() on a single YAML() instance would fail.

0.15.4 (2017-06-08):
  • transform parameter on dump that expects a function taking a string and returning a string. This allows transformation of the output before it is written to stream. This forces creation of the complete output in memory!

  • some updates to the docs

0.15.3 (2017-06-07):
  • No longer try to compile C extensions on Windows. Compilation can be forced by setting the environment variable RUAMEL_FORCE_EXT_BUILD to some value before starting the pip install.

0.15.2 (2017-06-07):
  • update to conform to mypy 0.511: mypy –strict

0.15.1 (2017-06-07):
  • duplicate keys in mappings generate an error (in the old API this change generates a warning until 0.16)

  • dependecy on ruamel.ordereddict for 2.7 now via extras_require

0.15.0 (2017-06-04):
  • it is no allowed to pass in a pathlib.Path as “stream” parameter to all load/dump functions

  • passing in a non-supported object (e.g. a string) as “stream” will result in a much more meaningful YAMLStreamError.

  • assigning a normal string value to an existing CommentedMap key or CommentedSeq element will result in a value cast to the previous value’s type if possible.

  • added YAML class for new API

0.14.12 (2017-05-14):
  • fix for issue 119, deepcopy not returning subclasses (reported and PR by Constantine Evans <cevans@evanslabs.org>)

0.14.11 (2017-05-01):
  • fix for issue 103 allowing implicit documents after document end marker line (...) in YAML 1.2

0.14.10 (2017-04-26):
  • fix problem with emitting using cyaml

0.14.9 (2017-04-22):
0.14.8 (2017-04-19):
  • fix Text not available on 3.5.0 and 3.5.1, now proactively setting version guards on all files (reported by João Paulo Magalhães)

0.14.7 (2017-04-18):
  • round trip of integers (decimal, octal, hex, binary) now preserve leading zero(s) padding and underscores. Underscores are presumed to be at regular distances (i.e. 0o12_345_67 dumps back as 0o1_23_45_67 as the space from the last digit to the underscore before that is the determining factor).

0.14.6 (2017-04-14):
  • binary, octal and hex integers are now preserved by default. This was a known deficiency. Working on this was prompted by the issue report (112) from devnoname120, as well as the additional experience with .replace() on scalarstring classes.

  • fix issues 114: cannot install on Buildozer (reported by mixmastamyk). Setting env. var RUAMEL_NO_PIP_INSTALL_CHECK will suppress pip-check.

0.14.5 (2017-04-04):
  • fix issue 109: None not dumping correctly at top level (reported by Andrea Censi)

  • fix issue 110: .replace on Preserved/DoubleQuoted/SingleQuoted ScalarString would give back “normal” string (reported by sandres23)

0.14.4 (2017-03-31):
  • fix readme

0.14.3 (2017-03-31):
0.14.2 (2017-03-23):
  • fix for old default pip on Ubuntu 14.04 (reported by Sébastien Maccagnoni-Munch)

0.14.1 (2017-03-22):
  • fix Text not available on 3.5.0 and 3.5.1 (reported by Charles Bouchard-Légaré)

0.14.0 (2017-03-21):
  • updates for mypy –strict

  • preparation for moving away from inheritance in Loader and Dumper, calls from e.g. the Representer to the Serializer.serialize() are now done via the attribute .serializer.serialize(). Usage of .serialize() outside of Serializer will be deprecated soon

  • some extra tests on main.py functions

0.13.14 (2017-02-12):
  • fix for issue 97: clipped block scalar followed by empty lines and comment would result in two CommentTokens of which the first was dropped. (reported by Colm O’Connor)

0.13.13 (2017-01-28):
  • fix for issue 96: prevent insertion of extra empty line if indented mapping entries are separated by an empty line (reported by Derrick Sawyer)

0.13.11 (2017-01-23):
  • allow ‘:’ in flow style scalars if not followed by space. Also don’t quote such scalar as this is no longer necessary.

  • add python 3.6 manylinux wheel to PyPI

0.13.10 (2017-01-22):
  • fix for issue 93, insert spurious blank line before single line comment between indented sequence elements (reported by Alex)

0.13.9 (2017-01-18):
  • fix for issue 92, wrong import name reported by the-corinthian

0.13.8 (2017-01-18):
  • fix for issue 91, when a compiler is unavailable reported by Maximilian Hils

  • fix for deepcopy issue with TimeStamps not preserving ‘T’, reported on StackOverflow Q&A by Quuxplusone

0.13.7 (2016-12-27):
  • fix for issue 85, constructor.py importing unicode_literals caused mypy to fail on 2.7 (reported by Peter Amstutz)

0.13.6 (2016-12-27):
  • fix for issue 83, collections.OrderedDict not representable by SafeRepresenter (reported by Frazer McLean)

0.13.5 (2016-12-25):
  • fix for issue 84, deepcopy not properly working (reported by Peter Amstutz)

0.13.4 (2016-12-05):
  • another fix for issue 82, change to non-global resolver data broke implicit type specification

0.13.3 (2016-12-05):
  • fix for issue 82, deepcopy not working (reported by code monk)

0.13.2 (2016-11-28):
  • fix for comments after empty (null) values (reported by dsw2127 and cokelaer)

0.13.1 (2016-11-22):
  • optimisations on memory usage when loading YAML from large files (py3: -50%, py2: -85%)

0.13.0 (2016-11-20):
  • if load() or load_all() is called with only a single argument (stream or string) a UnsafeLoaderWarning will be issued once. If appropriate you can surpress this warning by filtering it. Explicitly supplying the Loader=ruamel.yaml.Loader argument, will also prevent it from being issued. You should however consider using safe_load(), safe_load_all() if your YAML input does not use tags.

  • allow adding comments before and after keys (based on StackOveflow Q&A by msinn)


For older changes see the file CHANGES

Release files for ruamel.yaml 0.15.8

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for ruamel.yaml 0.15.8
File Size Uploaded
ruamel.yaml-0.15.8.tar.gz 251.3 kB Details

Built distributions (wheels)

Table of built distributions (wheels) for ruamel.yaml 0.15.8
File
ruamel.yaml-0.15.8-cp36-cp36m-manylinux1_x86_64.whl CPython 3.6 CPython 3.6 pymalloc Linux glibc 2.5+ x86-64 Details
ruamel.yaml-0.15.8-cp35-cp35m-manylinux1_x86_64.whl CPython 3.5 CPython 3.5 pymalloc Linux glibc 2.5+ x86-64 Details
ruamel.yaml-0.15.8-cp34-cp34m-manylinux1_x86_64.whl CPython 3.4 CPython 3.4 pymalloc Linux glibc 2.5+ x86-64 Details
ruamel.yaml-0.15.8-cp33-cp33m-manylinux1_x86_64.whl CPython 3.3 CPython 3.3 pymalloc Linux glibc 2.5+ x86-64 Details
ruamel.yaml-0.15.8-cp27-cp27mu-manylinux1_x86_64.whl CPython 2.7 CPython 2.7 pymalloc wide-unicode Linux glibc 2.5+ x86-64 Details
ruamel.yaml-0.15.8-cp27-cp27m-manylinux1_x86_64.whl CPython 2.7 CPython 2.7 pymalloc Linux glibc 2.5+ x86-64 Details

Total release size: 3.5 MB

Release files / ruamel.yaml-0.15.8.tar.gz

Download URL ruamel.yaml-0.15.8.tar.gz
Size 251.3 kB
Tags Source
SHA-256 checksum
How to use checksums
07e9879b9910cbf883a6d87b19cf59da7b866666db5fd3535ecd5ef9af696fb1
BLAKE2b-256 checksum
How to use checksums
239d29ec5160f9be632b077143a55dceb7338b2f18990b3839d88b03a2bb1371
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Release files / ruamel.yaml-0.15.8-cp36-cp36m-manylinux1_x86_64.whl

Download URL ruamel.yaml-0.15.8-cp36-cp36m-manylinux1_x86_64.whl
Size 550.4 kB
Tags CPython 3.6 CPython 3.6 pymalloc Linux glibc 2.5+ x86-64
SHA-256 checksum
How to use checksums
d1d4c912fa81f7545941359bb1e535d7380082ddd4762fd01a3ca1b76d9744cd
BLAKE2b-256 checksum
How to use checksums
458d3d60027fcc29b1d8db62470c8953d991e18521af6b5fe7446141d8de3ed9
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Release files / ruamel.yaml-0.15.8-cp35-cp35m-manylinux1_x86_64.whl

Download URL ruamel.yaml-0.15.8-cp35-cp35m-manylinux1_x86_64.whl
Size 550.3 kB
Tags CPython 3.5 CPython 3.5 pymalloc Linux glibc 2.5+ x86-64
SHA-256 checksum
How to use checksums
37e8889953e08281ea2f09cbf21f0a6f81a259a0d34345d9bfa1e6b03b102b61
BLAKE2b-256 checksum
How to use checksums
2c41852e92b1fcf4692677df349875300bc9f50a29ee8c7d08d21b43016ecf9c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Release files / ruamel.yaml-0.15.8-cp34-cp34m-manylinux1_x86_64.whl

Download URL ruamel.yaml-0.15.8-cp34-cp34m-manylinux1_x86_64.whl
Size 556.8 kB
Tags CPython 3.4 CPython 3.4 pymalloc Linux glibc 2.5+ x86-64
SHA-256 checksum
How to use checksums
1ce6703dd585a39950683cf36b8205dc53c24ae3574ed128a820627812054a4f
BLAKE2b-256 checksum
How to use checksums
13d62424255a2b932fdf725dd8fb594e20a92cfeacd56bfc28cc30d5222dd7e7
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Release files / ruamel.yaml-0.15.8-cp33-cp33m-manylinux1_x86_64.whl

Download URL ruamel.yaml-0.15.8-cp33-cp33m-manylinux1_x86_64.whl
Size 531.0 kB
Tags CPython 3.3 CPython 3.3 pymalloc Linux glibc 2.5+ x86-64
SHA-256 checksum
How to use checksums
6d88a9da959c6dc179d93a3ba64805db52151a8233957946432c308b6d0a489b
BLAKE2b-256 checksum
How to use checksums
52f9551724bf19eefe1ca946f64b1bff5fd6e7f65d199ff72d1219a7e576724f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Release files / ruamel.yaml-0.15.8-cp27-cp27mu-manylinux1_x86_64.whl

Download URL ruamel.yaml-0.15.8-cp27-cp27mu-manylinux1_x86_64.whl
Size 526.8 kB
Tags CPython 2.7 CPython 2.7 pymalloc wide-unicode Linux glibc 2.5+ x86-64
SHA-256 checksum
How to use checksums
2548438acdb87ce04d4298aa84f4d39e61f03a2ffe7b118a08d1a541e50251ad
BLAKE2b-256 checksum
How to use checksums
af822ae534a95f814c63116337c09a8962d8086834df4134bc2b865e62ccb84a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Release files / ruamel.yaml-0.15.8-cp27-cp27m-manylinux1_x86_64.whl

Download URL ruamel.yaml-0.15.8-cp27-cp27m-manylinux1_x86_64.whl
Size 526.8 kB
Tags CPython 2.7 CPython 2.7 pymalloc Linux glibc 2.5+ x86-64
SHA-256 checksum
How to use checksums
341b6c3f10df75aeb5342a1fdff782cdec36e1202dfa86f81d04ca00b1a911e7
BLAKE2b-256 checksum
How to use checksums
f939cb5977706d4f346182ee12d4749a5a3b30432b23f9ff1eff5b49549cf8f1
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Release history Release notifications | RSS feed

0.19.0

2 release files

0.18.7

2 release files

0.18.3

2 release files

0.18.2

2 release files

0.18.1

2 release files

0.18.0

2 release files

0.17.9

2 release files

0.17.7

2 release files

0.17.6

2 release files

0.17.5

2 release files

0.17.2

2 release files

0.17.1

2 release files

0.17.0

2 release files

0.16.9

2 release files

0.16.7

2 release files

0.16.6

2 release files

0.16.5

2 release files

0.16.4

2 release files

0.16.3

2 release files

0.16.2

2 release files

0.16.0

2 release files

0.15.9

7 release files

This release

0.15.8 This release

7 release files

0.15.7

7 release files

0.15.6

7 release files

0.14.9

7 release files

0.14.8

7 release files

0.14.7

7 release files

0.14.6

7 release files

0.14.4

7 release files

0.14.3

7 release files

0.14.2

7 release files

0.14.1

7 release files

0.14.0

7 release files

0.13.9

6 release files

0.13.8

6 release files

0.13.7

6 release files

0.13.6

6 release files

0.13.5

6 release files

0.13.2

6 release files

0.13.1

6 release files

0.13.0

6 release files

0.12.5

6 release files

0.12.4

6 release files

0.12.3

6 release files

0.12.2

6 release files

0.12.1

6 release files

0.12.0

6 release files

0.11.9

5 release files

0.11.7

1 release file

0.11.6

5 release files

0.11.5

1 release file

0.11.3

5 release files

0.11.2

5 release files

0.11.1

5 release files

0.11.0

5 release files

0.10.18

1 release file

0.10.15

1 release file

0.10.9

9 release files

0.10.8

9 release files

0.10.7

9 release files

0.10.6

9 release files

0.10.5

9 release files

0.10

9 release files

0.9.8

9 release files

0.9.7

9 release files

0.9.6

9 release files

0.9.5

9 release files

0.9.4

9 release files

0.9.2

1 release file

0.9.1

1 release file

0.8

1 release file

0.7.2

1 release file

0.7.1

1 release file

0.7

1 release file

0.6.1

1 release file

0.6

1 release file

0.5.1

1 release file

0.5

1 release file

0.4

1 release file

0.3

1 release file

0.2

1 release file

0.1

1 release file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page