Release Notes (v0.20)

[jolanglinais]

Tasks

• This will track and construct the overall release notes for this repo in relation to the v0.20 project

Release Notes:

Ergo v0.20 Wiki

Documentation:

Techdocs Ergo

Related Issues:

• Cicero Issue 412

[jeromesimeon]

Some initial release notes can be found here: https://github.com/accordproject/ergo/wiki/v-0.20.0

[jolanglinais]

Working Release Notes:

🦋

This v0.20 release is focused on overhauling the following Accord Project technologies:

• Dynamic Templates
  • Template Syntax
• Markdown Support
  • Markdown Syntax
  • Markdown Transformations

It also includes newly supported enums for Ergo, as well as bug fixes.

Note: This release requires changes to application and template code ...

🚀 New Features

• Ability to embed Ergo expressions within your templates
• A more consistent and generalizable syntax

Language

• #392: New string template syntax `This is text with {{% expression %}} and more text` (@jeromesimeon)
• Add support for enumerated values #3: Support for enumerated values, with proper typing and pattern matching support (@jeromesimeon)
• Expression sub-language for modifying state #143: Expression sublanguage for modifying state (@jeromesimeon)
• #<Issue/PR>: Markdown support (headings, lists, emphasis, etc) (@jeromesimeon)
• #<Issue/PR>: List parsing and generation support (@jeromesimeon)

Standard Library

• #<Issue/PR>: New encode and decode functions (@jeromesimeon)
• #<Issue/PR>: New format function for DateTime (@jeromesimeon)
• #<Issue/PR>: New getOptions function which returns global static options for the compiler (e.g., wrapVariables) (@jeromesimeon)

🐛 Bug Fixes

• Magical Mystery Now #642: now is no longer a magic variable (@jeromesimeon)
• Can the toString() function format numbers according to their type? #575: toString now properly format numeric values based on their types (@jeromesimeon)
• Allow qualified names for function calls, variable access, contract instantiation #465: Constants are now properly imported and scoped, and can be accessed using an explicit namespace (@jeromesimeon)
• Inheritance hierarchy not generated in JavaScript Cicero backend #644: Cicero target properly includes type hierarchy (@jeromesimeon)
• Type soundness bug in pattern matching against a type name #645: Type soundness of match expression (@jeromesimeon)

[jolanglinais]

Ergo v0.20 🦋

This release is focused on overhauling the following Accord Project technologies:

• Dynamic Templates
  • Template Syntax
• Markdown Support
  • Markdown Syntax
  • Markdown Transformations

It also includes newly supported enums for Ergo, a way to set a specific field in the state of your contract, as well as bug fixes.

Note: This release requires changes to application and template code ...

🚀 New Language Features

• #392: String template syntax `This is text with {{% expression %}} and more text` (@jeromesimeon)
• Add support for enumerated values #3: Support for enumerated values, with proper typing and pattern matching support (@jeromesimeon)
• Expression sub-language for modifying state #143: Expression sublanguage for modifying state (@jeromesimeon)

🛰 New Command Line

A and improved command line for Ergo which better aligns with the rest of the Accord Project Cicero #425

ergo <command>

Commands:
  ergo draft       create a contract text from data
  ergo trigger     send a request to the contract
  ergo invoke      invoke a clause of the contract
  ergo initialize  initialize the state for a contract
  ergo compile     compile a contract

Options:
  --help         Show help                                             [boolean]
  --version      Show version number                                   [boolean]
  --verbose, -v                                                 [default: false]

📚 Standard Library

• New encode and decode functions for URI encoding
• New format function for DateTime
• New getOptions function which returns global static options for the compiler

⚙️ Compiler

• Disallow multiple definitions of the same name #303: Redefining a constant is now a compiler warning (@jeromesimeon)

🏗 Build

• Switch to Node 10 + READMEs alignment #688: Ergo and CI now run on Node.js v10 (@jeromesimeon)
• Q*cert upgrade & new built-in operators #623: Upgrade to Q*cert 1.4.1 (@jeromesimeon)
• Fixes and build for Windows #690: Improved Windows support (@jeromesimeon)

🐛 Bug Fixes

• Magical Mystery Now #642: now is no longer a magic variable (@jeromesimeon)
• Can the toString() function format numbers according to their type? #575: toString now properly format numeric values based on their types (@jeromesimeon)
• Allow qualified names for function calls, variable access, contract instantiation #465: Constants are now properly imported and scoped, and can be accessed using an explicit namespace (@jeromesimeon)
• Inheritance hierarchy not generated in JavaScript Cicero backend #644: Cicero target properly includes type hierarchy (@jeromesimeon)
• Type soundness bug in pattern matching against a type name #645: Type soundness of match expression (@jeromesimeon)
• Escaped quotes in Ergo string are output with a spurious \ #665: String with escaped characters are properly printed in REPL without an extra \