Add docs about PyYAML's 1024 character limitations for simple keys (#33459)

Fixes #33389
This commit is contained in:
Nicole Thomas 2016-05-24 09:12:21 -06:00 committed by Mike Place
parent 3b12f396b4
commit 00f9090928

View File

@ -340,3 +340,13 @@ string with quotes:
ValueError: month must be in 1..12 ValueError: month must be in 1..12
>>> yaml.safe_load('"4017-16-20"') >>> yaml.safe_load('"4017-16-20"')
'4017-16-20' '4017-16-20'
Keys Limited to 1024 Characters
===============================
Simple keys are limited to a single line and cannot be longer that 1024 characters.
This is a limitation from PyYaml, as seen in a comment in `PyYAML's code`_, and
applies to anything parsed by YAML in Salt.
.. _PyYAML's code: http://pyyaml.org/browser/pyyaml/trunk/lib/yaml/scanner.py#L91