[ Home | Main Table Of Contents | Table Of Contents | Keyword Index ]
NAME
tclyaml_changes - TclYAML - Changes
Table Of Contents
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:
- bool
- float
- int
- null
- 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
CATEGORY
3rd party library binding
COPYRIGHT
Copyright © 2012-2014, 2021 Andreas Kupries
Copyright © 2012-2014, 2021 Documentation, Andreas Kupries