Skip to main content

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

Project description


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


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)

0.12.18 (2016-11-16):
  • another fix for numpy (re-reported independently by PaulG & Nathanial Burdic)

0.12.17 (2016-11-15):
  • only the RoundTripLoader included the Resolver that supports YAML 1.2 now all loaders do (reported by mixmastamyk)

0.12.16 (2016-11-13):
  • allow dot char (and many others) in anchor name Fix issue 72 (reported by Shalon Wood)

  • Slightly smarter behaviour dumping strings when no style is specified. Single string scalars that start with single quotes or have newlines now are dumped double quoted: “‘abcnklm’” instead of:

0.12.14 (2016-09-21):
  • preserve round-trip sequences that are mapping keys (prompted by stackoverflow question 39595807 from Nowox)

0.12.13 (2016-09-15):
  • Fix for issue #60 representation of CommentedMap with merge keys incorrect (reported by Tal Liron)

0.12.11 (2016-09-06):
  • Fix issue 58 endless loop in scanning tokens (reported by Christopher Lambert)

0.12.10 (2016-09-05):
  • Make previous fix depend on unicode char width (32 bit unicode support is a problem on MacOS reported by David Tagatac)

0.12.8 (2016-09-05):
  • To be ignored Unicode characters were not properly regex matched (no specific tests, PR by Haraguroicha Hsu)

0.12.7 (2016-09-03):
  • fixing issue 54 empty lines with spaces (reported by Alex Harvey)

0.12.6 (2016-09-03):
  • fixing issue 46 empty lines between top-level keys were gobbled (but not between sequence elements, nor between keys in netsted mappings (reported by Alex Harvey)

0.12.5 (2016-08-20):
  • fixing issue 45 preserving datetime formatting (submitted by altuin) Several formatting parameters are preserved with some normalisation:

  • preserve ‘T’, ‘t’ is replaced by ‘T’, multiple spaces between date and time reduced to one.

  • optional space before timezone is removed

  • still using microseconds, but now rounded (.1234567 -> .123457)

  • Z/-5/+01:00 preserved

0.12.4 (2016-08-19):
  • Fix for issue 44: missing preserve_quotes keyword argument (reported by M. Crusoe)

0.12.3 (2016-08-17):
  • correct ‘in’ operation for merged CommentedMaps in round-trip mode (implementation inspired by J.Ngo, but original not working for merges)

  • iteration over round-trip loaded mappings, that contain merges. Also keys(), items(), values() (Py3/Py2) and iterkeys(), iteritems(), itervalues(), viewkeys(), viewitems(), viewvalues() (Py2)

  • reuse of anchor name now generates warning, not an error. Round-tripping such anchors works correctly. This inherited PyYAML issue was brought to attention by G. Coddut (and was long standing suppressing the warning:

    import warnings
    from ruamel.yaml.error import ReusedAnchorWarning
    warnings.simplefilter("ignore", ReusedAnchorWarning)
0.12.2 (2016-08-16):
0.12.0 (2016-08-16):
  • drop support for Python 2.6

  • include initial Type information (inspired by M. Crusoe)

0.11.15 (2016-08-07):
  • Change to prevent FutureWarning in NumPy, as reported by tgehring (“comparison to None will result in an elementwise object comparison in the future”)

0.11.14 (2016-07-06):
  • fix preserve_quotes missing on original Loaders (as reported by Leynos, bitbucket issue 38)

0.11.13 (2016-07-06):
  • documentation only, automated linux wheels

0.11.12 (2016-07-06):
  • added support for roundtrip of single/double quoted scalars using: ruamel.yaml.round_trip_load(stream, preserve_quotes=True)

0.11.0 (2016-02-18):
  • RoundTripLoader loads 1.2 by default (no sexagesimals, 012 octals nor yes/no/on/off booleans

Project details

Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ruamel.yaml-0.13.3.tar.gz (232.5 kB view hashes)

Uploaded Source

Built Distributions

ruamel.yaml-0.13.3-cp35-cp35m-manylinux1_x86_64.whl (534.7 kB view hashes)

Uploaded CPython 3.5m

ruamel.yaml-0.13.3-cp34-cp34m-manylinux1_x86_64.whl (541.3 kB view hashes)

Uploaded CPython 3.4m

ruamel.yaml-0.13.3-cp33-cp33m-manylinux1_x86_64.whl (515.4 kB view hashes)

Uploaded CPython 3.3m

ruamel.yaml-0.13.3-cp27-cp27mu-manylinux1_x86_64.whl (511.3 kB view hashes)

Uploaded CPython 2.7mu

ruamel.yaml-0.13.3-cp27-cp27m-manylinux1_x86_64.whl (511.4 kB view hashes)

Uploaded CPython 2.7m

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page