toml 0.15.0 copy "toml: ^0.15.0" to clipboard
toml: ^0.15.0 copied to clipboard

Parser and encoder for TOML v1.0.0 (Tom's Obvious, Minimal Language) configuration files.

Changelog #

0.15.0 #

  • Dart 3.2 is now required.
  • Upgraded dependencies.

0.14.0 #

  • Dart 2.18 is now required.
  • Upgraded dependencies.
  • Added TomlDocument.loadSync to load TOML documents synchronously. This new method is not supported on the web.

0.13.1 #

  • Downgraded meta dependency from ^1.8.0 to ^1.7.0 for compatibility with Flutter 3.0.1.

0.13.0 #

  • Dart 2.17 is now required.
  • Upgraded dependencies.
  • Removed dependency on package:quiver in favor of package:collection and Dart 2.14's Object.hash and Object.hashAll methods.

0.12.0 #

  • Dart 2.13 is now required.
  • Upgraded dependencies.
  • Added support for 1.0.0 compliant version of toml-test test suite.
  • Fixed parsing of multi-line literal and multi-line basic strings with up to two (unescaped) double quotes or single quotes before the closing delimiter.
  • Fixed immutability of AST. The AST is intended to be immutable, but List properties of the AST were only ungrowable not unmodifiable.

0.11.0 #

  • Disallowed non-scalar Unicode values when encoding (multiline) basic strings.
    • Added TomlBasicString.canEncode and TomlMultilineBasicString.canEncode.
    • The constructors of TomlBasicString and TomlMultilineBasicString methods throw an ArgumentError if a string cannot be encoded.
    • The TomlBasicString.escape and TomlMultilineBasicString.escape methods throw a TomlInvalidEscapeSequenceException if a string cannot be encoded.
  • Fixed hashCode and operator == of some AST nodes.
    • Two TomlDocuments with equal expressions now have the same hash codes.
    • Two TomlPartialTimes with equal fractional seconds now have the same hash code.
    • Two TomlFloats that both represent a nan value are now considered equal.
  • Added TomlSimpleKey.from factory method.
  • Allowed leading and trailing whitespace in TomlKey.parse.
  • Fixed TomlKey.parentKey for TomlKey.topLevel.
  • Removed unused getter TomlArray.itemTypes.
  • Removed redundant TomlKeyVisitor interface.
  • Improved error messages.
  • Upgraded dependencies.

0.10.0 #

  • Added support for null-safety.
    • Dart 2.12 is now required.

0.9.1 #

  • Fixed pretty-printing of Windows line endings in multiline basic strings. The \r in a \r\n sequence is not escaped anymore. A carriage return that is not followed by a line feed is still escaped.
  • Fixed parsing of multiline basic strings with Windows newlines. A \r\n sequence caused a runtime type error in previous releases because it was represented as a List instead of a String internally.

0.9.0 #

  • Updated to v1.0.0 of the TOML specification.
    • Allowed leading zeros in exponent part.
    • Allowed heterogeneous arrays.
    • Disallowed tables created by dotted key/value pairs to be redefined in [table] form and vice versa.

0.8.0 #

  • Updated to v0.5.0 of the TOML specification.
    • Added binary, octal and hexadecimal integer notation.
    • Added special floating point values inf and nan.
    • Added offset date-times, local date-times, local dates and local times.
      • The decoder produces TomlOffsetDateTime, TomlLocalDateTime, TomlLocalDate or TomlLocalTime values. There are methods to map TomlOffsetDateTime to a DateTime. To convert the other values to DateTimes, missing information such as date, time or offset has to be provided by the application.
      • UTC and local DateTimes are now encoded as offset date-times.
  • Added support for BigInts.

0.7.0 #

This is a major update that does not only bring along many changes to the internal architecture of the library but also to its public interface.

  • Removed the TomlParser class. Use TomlDocument.parse and TomlDocument.toMap instead.
  • In preparation to support TOML v0.5.0 in an upcoming version of the library, the parser is now based on TOML's official ABNF.
  • Removed the TomlEncoder class. Use TomlDocument.fromMap and TomlDocument.toString instead.
  • Removed the toml.decoder and toml.encoder libraries. You should always use the toml library instead.
  • Removed the toml.loader library as well as the toml.loader.* libraries. Use TomlDocument.load instead. In order to implement a custom loading mechanism, use TomlDocument.parse instead.
  • Removed the yaml dependency. JSON and YAML documents cannot be loaded with this package anymore.
  • Renamed TomlEncodable to TomlEncodableValue and toToml to toTomlValue.
  • Added TomlEncodableKey interface. Objects that implement this interface are allowed to be used as keys in hash maps instead of strings. Their toTomlKey method must return a TomlEncodeableKey itself or a string that can be used as a TOML key. By default toTomlKey is implemented via toTomlValue.

0.6.1 #

  • Upgraded dependencies.

0.6.0 #

  • Upgraded to Dart 2.

0.5.1 #

  • Upgraded dependencies.

0.5.0 #

  • Removed deprecated use*ConfigLoader functions.
  • Improved testing and added support for BurntSushi's toml-test suite.

0.4.0 #

  • Removed deprecated toml.browser and toml.server libraries.
  • Dropped support for dart_config. There is now a custom ConfigLoader interface with two default implementations.
  • The use*ConfigLoader functions are still available for backward compatibility, but are deprecated and will be removed in the next release. Each of the ConfigLoader implementations has a static use method which you should use instead.

0.3.0 #

  • Introduced new toml.loader library.
  • The toml.browser and toml.server libraries are now deprecated and will be removed in the next release. Use the new toml.loader library instead.

0.2.0 #

  • Updated to v0.4.0 of the TOML specification.
  • Added bare/quoted keys.
  • Added inline table syntax.
  • Allowed underscores in numbers.
  • Removed forward slash as an escapable character.

0.1.1 #

  • Fixed links and markdown.

0.1.0 #

  • Initial version, implements v0.3.1 of the TOML specification.
pub points


unverified uploader

Parser and encoder for TOML v1.0.0 (Tom's Obvious, Minimal Language) configuration files.

Repository (GitHub)
View/report issues


API reference




collection, meta, petitparser


Packages that depend on toml