Skip to content

Latest commit

 

History

History
125 lines (85 loc) · 5.09 KB

CHANGELOG.md

File metadata and controls

125 lines (85 loc) · 5.09 KB

Change Log

What's New

  • Update for Xcode 8 beta 6 (Apple Swift version 3.0 (swiftlang-800.0.43.6 clang-800.0.38))
  • Travis-CI integration

SPM Dependency Snippet

.Package(url: "https://github.com/cfilipov/TextTable", Version(1, 0, 0, prereleaseIdentifiers: ["alpha", "4"]))

What's New

  • This release contains breaking changes to the API. This should hopefully be the last major breaking change to the API for a long time.
  • TextTable<T> construction closure now takes an instance of T instead of a Config<T>. Config<T> has been removed completely. Instead of calling column(...) on a Config<T> in the closure, you now return an array of Column instances. See example transition below for details.
  • Fixed: Missing/broken tests.
  • Fixed: Latex tabular environment contains incorrect alignments.
  • Fixed: Handle optional values in mapping.
  • Fixed: FancyGrid using pipe symbol instead of unicode drawing character for header separator.
  • All columns are now left-aligned by default (instead of right-aligning the first column by default).
  • TextTableFormatter has been renamed to TextTableStyle to avoid confusion with the Foundation Formatters class. All references to the word "format" when referring to the type of table rendered have bee changed to "style".
  • The TextTableStyle protocol (formerly TextTableFormatter ) is now simplified. All methods in TextTableStyle are now static, no state is maintained in TextTableStyle. The methods have also been consolidated (row instead of beginRow, endRow, content, beginColumn, etc...).
  • TextTable<T> and all the internal types are now value types instead of classes.
  • All built-in styles are case-less enums so they cannot be accidentally instantiated.

Known Issues

  • Very little effort has but put into performance optimizations. String utilities in particular.
  • It should be possible to create columns without headers, but this hasn't been tested and likely doesn't work yet.

Transitioning

Before:

let table = TextTable<Person> { t in
    t.column("Name") { $0.name }
    t.column("Age") { $0.age }
    t.column("Birthday") { $0.birhtday }
}

After:

let table = TextTable<Person> {
    [Column("Name" <- $0.name),
     Column("Age" <- $0.age),
     Column("Birthday" <- $0.birhtday)]
}

SPM Dependency Snippet

.Package(url: "https://github.com/cfilipov/TextTable", Version(1, 0, 0, prereleaseIdentifiers: ["alpha", "3"]))

What's New

  • Column truncation support. There is now an optional truncate: argument to width.
  • Added some documentation.

Known Issues

  • Very little effort has but put into performance optimizations.
  • It should be possible to create columns without headers, but this hasn't been tested and likely doesn't work yet.

SPM Dependency Snippet

.Package(url: "https://github.com/cfilipov/TextTable", Version(1, 0, 0, prereleaseIdentifiers: ["alpha", "2"]))

What's New

  • Support for center alignment.
  • If all columns have explicit width, then width calculations are skipped.
  • Escape strings in certain formats (HTML & Latex, for example).
  • Fixed: TextTable config persists calculated column widths. This results in widths getting stuck from the first call to print or string(for:).

Known Issues

  • Very little effort has but put into performance optimizations.
  • It should be possible to create columns without headers, but this hasn't been tested and likely doesn't work yet.

SPM Dependency Snippet

.Package(url: "https://github.com/cfilipov/TextTable", Version(1, 0, 0, prereleaseIdentifiers: ["alpha", "1"]))

What's New

  • Breaking change: completely re-written API. No more conforming to a protocol, instead a TextTable class is used in a similar way to NSFormatter. This offers much more flexibility.
  • Many more output formats. Similar to what you get from Python's tabulate lib.

Known Issues

  • No attempt at optimizing performance has been made yet. Even when widths are provided, an expensive calculation is still performed.
  • No escaping is being done. None of the formatters even attempt to sanitize the input strings.
  • Center alignment not supported. This will result in a fatalError().
  • It should be possible to create columns without headers, but this hasn't been tested and likely doesn't work yet.

SPM Dependency Snippet

.Package(url: "https://github.com/cfilipov/TextTable", Version(1, 0, 0, prereleaseIdentifiers: ["alpha", "0"]))

Initial release.