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

NAME

tclyaml_changes - TclYAML - Changes

Table Of Contents
Synopsis
Description
Changes
- Changes for version 0.5
Bugs, Ideas, Feedback
Keywords
Category
Copyright

SYNOPSIS

package require Tcl 8.5
package require tclyaml ?0.5?

DESCRIPTION

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

Changes for version 0.5

In detail:

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

All following changes are breaking, versus version 0.4.
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
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.
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.
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.
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.

KEYWORDS

YAML, markup language, serialization