Not logged in

[ Home | Main Table Of Contents | Table Of Contents | Keyword Index ]


tclyaml_changes - TclYAML - Changes

Table Of Contents


package require Tcl 8.5
package require tclyaml ?0.5?


Welcome to TclYAML, a binding to the C-based libyaml parser library for YAML Ain't Markup Language. This document provides an overview of the changes TclYAML underwent from version to version.


Changes for version 0.5

In detail:

  1. As a non-breaking change, a test suite was added.

    All following changes are breaking, versus version 0.4.

  2. Removed the untyped structure tag scalar. Replaced it with five new tags providing type information:

    1. bool
    2. float
    3. int
    4. null
    5. string
  3. When reading YAML data types are now determined as per the YAML Core Schema rules. And the assumption that quoted values are always strings, and none of the other types.

  4. Read values are now normalized, as per their type. For example, the internally seen value of an integer is always in decimal form, regardless of if it was octal or hex in the input.

  5. On the writing side the new structural tags now exist as pre-defined type converters. The scalar converter is still present, and aliases now to string. In the previous version string aliased to scalar as the only scalar type.

  6. Most styling of scalar values is now automatically determined by their type, and, in case of strings, by the value as well.

Bugs, Ideas, Feedback

This document, and the package it describes, will undoubtedly contain bugs and other problems. Please report such at the TclYAML Tracker. Please also report any ideas for enhancements you may have for either package and/or documentation.


YAML, markup language, serialization


3rd party library binding


Copyright © 2012-2014, 2021 Andreas Kupries
Copyright © 2012-2014, 2021 Documentation, Andreas Kupries