Changes between Version 7 and Version 8 of WikiStart

Timestamp:

03/12/06 19:25:39 (7 years ago)

Author:

xi

Comment:

Add the section What implementation should you use?.

WikiStart

@@ -18 +18 @@
 [wiki:PyYAMLLegacy PyYAML Legacy] is the original implementation developed by various authors
 (moved from http://pyyaml.dyndns.org/cgi-bin/trac.cgi).
+
+== What implementation should you use? ==
+
+Read this if you are confused trying to choose a suitable implementation.
+
+ * [wiki:PyYAML PyYAML 3000] is the most promising implementation, but it is still very young.
+   [wiki:PyYAML PyYAML 3000] is a pure Python [http://yaml.org/spec/cvs/current.html YAML 1.1] parser supporting all the features of YAML including Unicode.
+   It does not yet include a YAML emitter.
+   '''Use [wiki:PyYAML PyYAML 3000] if you need a YAML parser and do not need a YAML emitter.''
+   For example, [wiki:PyYAML PyYAML 3000] is excellent for configuration files.
+ * PySyck is a Python binding to the C library [http://whytheluckystiff.net/syck/ Syck].
+   Syck supports [http://yaml.org/spec/history/2004-01-29/2004-01-29.html YAML 1.0] (w/o Unicode) and provides both parser and emitter.
+   '''Use PySyck if you really need a YAML emitter.'''
+   For instance, PySyck may be used as a pickle replacement.
+ * [wiki:PyYAMLLegacy PyYAML Legacy] is an old implementation of YAML parser and emitter for Python. It seems to be abandoned.
+   '''Use [wiki:PyYAMLLegacy PyYAML Legacy] if your project already relies on this code.'''
 
 == To Do ==