= PyYAML.org - the home of various [http://yaml.org/ YAML] implementations for Python =

== News ==

''2012-12-27'': **Moving to !BitBucket.  Please leave your bug reports there: PyYAML => http://bitbucket.org/xi/pyyaml; LibYAML => http://bitbucket.org/xi/libyaml.**

''2011-05-30'': '''[wiki:PyYAML] 3.10''' is released.

''2011-05-30'': '''[wiki:LibYAML] 0.1.4''' is released.

''2010-11-06'': A captcha is enabled; main project pages are made read-only.

''2010-10-11'': '''[wiki:PyYAML] 3.09''': MS Windows installer for Python 2.7.

''2009-08-31'': '''[wiki:PyYAML] 3.09''' is released.

''2009-08-31'': '''[wiki:LibYAML] 0.1.3''' is released.

''2008-12-31'': '''[wiki:PyYAML] 3.08''' is released (includes '''Python 3''' support).

''2008-12-29'': '''[wiki:PyYAML] 3.07''' is released.

''2008-12-28'': '''[wiki:LibYAML] 0.1.2''' is released.

''2008-10-03'': '''[wiki:PyYAML] 3.06''' is released.

''2008-07-16'': I have installed the plugin ''spam-filter'' for Trac.  If you have any troubles adding
new tickets, please let me know.

''2007-05-31'': '''[wiki:LibYAML] 0.1.1''' is released.

''2007-05-13'': '''[wiki:PyYAML] 3.05''' is released.

''2006-10-20'': '''[wiki:PyYAML] 3.04''' and '''PySyck 0.61.2''': MS Windows installers for Python 2.5.

''2006-08-20'': '''[wiki:PyYAML] 3.04''' is released.

''2006-08-01'': '''[wiki:LibYAML] 0.0.1''' is released.

''2006-06-19'': '''[wiki:PyYAML] 3.03''' is released.

''2006-05-15'': '''[wiki:PyYAML] 3.02''' is released.

''2006-05-07'': '''[wiki:PyYAML] 3.01''' is released.

''2006-03-26'': '''PySyck 0.61.2''' is released.

''2006-03-18'': '''PySyck 0.61.1''' is released.

== PyYAML Documentation ==
Here is the [wiki:PyYAMLDocumentation]
== PyYAML aka PyYAML 3000 ==

[wiki:PyYAML] is the next generation YAML parser and emitter for Python.


== PySyck ==

PySyck is a Python binding to [http://whytheluckystiff.net/syck/ Syck],
a C library for reading and writing YAML in scripting languages.


== PyYAML Legacy aka !PyYaml ==

[wiki:PyYAMLLegacy PyYAML Legacy] is the original implementation developed by various authors.


== LibYAML ==

[wiki:LibYAML] is a YAML parser and emitter written in C.


== What implementation should you use? ==

Check this matrix if you are confused trying to choose a suitable implementation.

|| '''Implementation'''          || '''!PySyck'''       || '''PyYAML'''      || '''PyYAML Legacy'''   || '''LibYAML''' ||
|| ''Status''                    || Mature (abandoned)  || Mature            || Stable (abandoned)    || Beta          ||
|| ''Latest version''            || 0.61                || 3.09              || 0.32 + forks          || 0.1.3         ||
|| ''Language''                  || Python/C extension  || Python            || Python                || C             ||
|| ''Parser''                    || YAML 1.0            || YAML 1.1          || YAML 1.0 (incomplete) || YAML 1.1      ||
|| ''Emitter''                   || YAML 1.0            || YAML 1.1          || YAML 1.0              || YAML 1.1      ||
|| ''Unicode support''           || No                  || Yes               || No                    || Yes           ||

''more...''

== Wiki Topic Index ==

 * [wiki:LibYAML]
 * [wiki:YAMLTagDiscussion]
 * [wiki:YAMLSchemaDiscussion]
 * [wiki:BugsInTheYAMLSpecification]

== To Do ==

 * Fix grammar issues of [wiki:PyYAML PyYAML 3000] according to the discussion on YAML-core and IRC.
 * ~~Write an example program (yaml-highlight) for PyYAML. It should insert tags at the beginning and the end
   of each token and parser event and use YAML for configuration.~~
 * ~~Emitter.~~
 * ~~Release [wiki:PyYAML PyYAML 3000].~~
 * Write a simple "canonical" YAML parser and a paper explaining the method.
 * ~~libyaml3000 (SoC proposal).~~
 * support for yaml bytecode.

== YAML mailling list ==

There is no specific PyYAML mailling list, there is a general [http://sourceforge.net/mailarchive/forum.php?forum_name=yaml-core yaml mailling list] on sourceforge.

== Thanks ==

Thank to Tim Parkin of [http://www.pollenation.net/] for the domain name and the logo design.


== Trac Starting Points ==

 * TracGuide --  Built-in Documentation
 * [http://projects.edgewall.com/trac/ The Trac project] -- Trac Open Source Project
 * [http://projects.edgewall.com/trac/wiki/TracFaq Trac FAQ] -- Frequently Asked Questions
 * TracSupport --  Trac Support

For a complete list of local wiki pages, see TitleIndex.

Trac is brought to you by [http://www.edgewall.com/ Edgewall Software],
providing professional Linux and software development services to clients
worldwide. Visit http://www.edgewall.com/ for more information.