termdash/CHANGELOG.md

Changelog

All notable changes to this project are documented here.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

Unreleased

0.7.2 - 25-Feb-2019

Added

• New API for building layouts, a grid.Builder. Allows defining the layout iteratively as repetitive Elements, Rows and Columns.
• Test coverage for data only packages.
• Containers now support margin around them and padding of their content.

Changed

• The Text widget now supports content wrapping on word boundaries.
• The BarChart and SparkLine widgets now have a method that returns the observed value capacity the last time Draw was called.
• Refactoring packages that contained a mix of public and internal identifiers.
• Moving widgetapi out of the internal directory to allow external users to develop their own widgets.

Fixed

• The termdash_test now correctly waits until all subscribers processed events, not just received them.
• Container focus tracker now correctly tracks focus changes in enlarged areas, i.e. when the terminal size increased.
• The BarChart, LineChart and SegmentDisplay widgets now protect against external mutation of the values passed into them by copying the data they receive.

Breaking API changes

The following packages were refactored, no impact is expected as the removed identifiers shouldn't be used externally.

• Functions align.Text and align.Rectangle were moved to a new internal/alignfor package.
• Types cell.Cell and cell.Buffer were moved into a new internal/canvas/buffer package.

0.7.1 - 24-Feb-2019

Fixed

• Some of the packages that were moved into internal are required externally. This release makes them available again.

Changed

Breaking API changes

• The draw.LineStyle enum was refactored into its own package linestyle.LineStyle. Users will have to replace:

  • draw.LineStyleNone -> linestyle.None
  • draw.LineStyleLight -> linestyle.Light
  • draw.LineStyleDouble -> linestyle.Double
  • draw.LineStyleRound -> linestyle.Round

0.7.0 - 24-Feb-2019

Added

New widgets

• The Button widget.

Improvements to documentation

• Clearly marked the public API surface by moving private packages into internal directory.
• Started a GitHub wiki for Termdash.

Improvements to the LineChart widget

• The LineChart widget can display X axis labels in vertical orientation.
• The LineChart widget allows the user to specify a custom scale for the Y axis.
• The LineChart widget now has an option that disables scaling of the X axis. Useful for applications that want to continuously feed data and make them "roll" through the linechart.
• The LineChart widget now has a method that returns the observed capacity of the LineChart the last time Draw was called.
• The LineChart widget now supports zoom of the content triggered by mouse events.

Improvements to the Text widget

• The Text widget now has a Write option that atomically replaces the entire text content.

Improvements to the infrastructure

• A function that draws text vertically.
• A non-blocking event distribution system that can throttle repetitive events.
• Generalized mouse button FSM for use in widgets that need to track mouse button clicks.

Changed

• Termbox is now initialized in 256 color mode by default.
• The infrastructure now uses the non-blocking event distribution system to distribute events to subscribers. Each widget is now an individual subscriber.
• The infrastructure now throttles event driven screen redraw rather than redrawing for each input event.
• Widgets can now specify the scope at which they want to receive keyboard and mouse events.

Breaking API changes

High impact

• The constructors of all the widgets now also return an error so that they can validate the options. This is a breaking change for the following widgets: BarChart, Gauge, LineChart, SparkLine, Text. The callers will have to handle the returned error.

Low impact

• The container package no longer exports separate methods to receive Keyboard and Mouse events which were replaced by a Subscribe method for the event distribution system. This shouldn't affect users as the removed methods aren't needed by container users.
• The widgetapi.Options struct now uses an enum instead of a boolean when widget specifies if it wants keyboard or mouse events. This only impacts development of new widgets.

Fixed

• The LineChart widget now correctly determines the Y axis scale when multiple series are provided.
• Lint issues in the codebase, and updated Travis configuration so that golint is executed on every run.
• Termdash now correctly starts in locales like zh_CN.UTF-8 where some of the characters it uses internally can have ambiguous width.

0.6.1 - 12-Feb-2019

Fixed

• The LineChart widget now correctly places custom labels.

0.6.0 - 07-Feb-2019

Added

• The SegmentDisplay widget.
• A CHANGELOG.
• New line styles for borders.

Changed

• Better recordings of the individual demos.

Fixed

• The LineChart now has an option to change the behavior of the Y axis from zero anchored to adaptive.
• Lint errors reported on the Go report card.
• Widgets now correctly handle a race when new user data are supplied between calls to their Options() and Draw() methods.

0.5.0 - 21-Jan-2019

Added

• Draw primitives for drawing circles.
• The Donut widget.

Fixed

• Bugfixes in the braille canvas.
• Lint errors reported on the Go report card.
• Flaky behavior in termdash_test.

0.4.0 - 15-Jan-2019

Added

• 256 color support.
• Variable size container splits.
• A more complete demo of the functionality.

Changed

• Updated documentation and README.

0.3.0 - 13-Jan-2019

Added

• Primitives for drawing lines.
• Implementation of a Braille canvas.
• The LineChart widget.

0.2.0 - 02-Jul-2018

Added

• The SparkLine widget.
• The BarChart widget.
• Manually triggered redraw.
• Travis now checks for presence of licence headers.

Fixed

• Fixing races in termdash_test.

0.1.0 - 13-Jun-2018

Added

• Documentation of the project and its goals.
• Drawing infrastructure.
• Testing infrastructure.
• The Gauge widget.
• The Text widget.