Changes between Version 45 and Version 46 of PyYAMLDocumentation

Timestamp:

11/22/09 16:58:56 (4 years ago)

Author:

Jotaf

Comment:

Added (important IMO) note about explicitly allowing objects to load with safe_load().

PyYAMLDocumentation

@@ -244 +244 @@
 The function '''`yaml.safe_load`''' limits this ability to simple Python objects
 like integers or lists.
+
+A python object can be marked as safe and thus be recognized by '''`yaml.safe_load`'''.
+To do this, derive it from `yaml.YAMLObject` (as explained in section
+'''Constructors, representers, resolvers''') and explicitly set its class property
+`yaml_loader` to `yaml.SafeLoader`.
 
 
@@ -1026 +1031 @@
 `safe_load` recognizes only standard YAML tags and cannot construct an arbitrary Python object.
 
+A python object can be marked as safe and thus be recognized by '''`yaml.safe_load`'''.
+To do this, derive it from `yaml.YAMLObject` (as explained in section
+'''Constructors, representers, resolvers''') and explicitly set its class property
+`yaml_loader` to `yaml.SafeLoader`.
+
 '''`safe_load_all(stream)`''' parses the given `stream` and returns a sequence of Python objects
 corresponding to the documents in the stream. `safe_load_all` recognizes only standard YAML tags