Skip to content
🈸 Pretty printer for maps/structs collections (Elixir)
Branch: master
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
lib Fix String deprecation warnings (#18) May 13, 2018
test Fix structs support (#16) Apr 28, 2017
.credo.exs Improve code 💅 (#17) Jun 19, 2017
.gitignore
.travis.yml Improve code 💅 (#17) Jun 19, 2017
LICENSE Initial commit Oct 12, 2015
README.md Update hex.pm badge to land on hex.pm May 13, 2018
mix.exs Bump version (2.2.2) Jun 19, 2017
mix.lock Improve code 💅 (#17) Jun 19, 2017

README.md

Tabula

Build Status Hex.pm

Tabula can transform a list of maps (structs too, e.g. Ecto models) or Keywords into an ASCII/GitHub Markdown table.

It's a weekend-over-beer-project of mine, loosely based on clojure.pprint.print-table.

Installation

  1. Add Tabula to your list of dependencies in mix.exs:
def deps do
  [{:tabula, "~> 2.1.1"}]
end
  1. Ensure Tabula is started before your application:
def application do
  [applications: [:tabula]]
end

Let's get down to business 🍻

Examples

defmodule Demo do

  use Tabula, style: :github_md

  def run do
    [ %{"name" => "Joe", "age" => 31, "city" => "New York"},
      %{"name" => "Adam", "age" => 33, "city" => "Warsaw"},
      %{"name" => "Yolanda", "age" => 28, "city" => "Berlin"}
    ] |> print_table
  end

end

Demo.run yields:

age | city     | name
--- | -------- | -------
 31 | New York | Joe
 33 | Warsaw   | Adam
 28 | Berlin   | Yolanda

Which renders in GitHub markdown as:

age city name
31 New York Joe
33 Warsaw Adam
28 Berlin Yolanda

Alternatively, you can use the default :org_mode style:

defmodule Demo do

  def run do
    Code.get_docs(Atom, :docs) 
    |> Enum.sort
    |> Enum.map(fn {{function, arity}, _line, _kind, _signature, text} ->
      %{"function" => function,
        "arity"    => arity,
        "text"     => text |> String.split("\n") |> Enum.at(0) }
    end) |> Tabula.print_table
  end

end

So that Demo.run yields:

arity | function      | text
------+---------------+---------------------------------
    1 | :to_char_list | Converts an atom to a char list.
    1 | :to_string    | Converts an atom to a string.

You can specify the columns you want to render. If you wish Tabula to automatically index your rows, you need to provide it with a special # key:

iex(1)> Repo.all(Account) |> Tabula.print_table(only: ["#", :name, :key])

  # | :name    | :key
----+----------+-----------------------------
  1 | Adam     | e1210f10a721485be4ad50604cda
  2 | Thomas   | c0ae1f149298ffded9f41a828cf5

You can use render_table to return an iolist of the rendered data, if you wish not to write to stdout.

Struct values will be printed using their string representation, provided String.Chars is implemented. If in doubt, please consult the tests.

MaybeFutureFeatures

If time permits I would like to implement the following extensions (contributions very much welcome!):

  • ANSI styles, because we all love colored output, don't we?
  • Custom formatters
  • Cell contents wrapping
  • Option to define max table width

Contributors

Adam Rutkowski - https://twitter.com/hq1aerosol

Adrian Gruntkowski - https://twitter.com/adrgrunt

Gian D - https://twitter.com/fusillicode

Wojtek Mach - https://twitter.com/wojtekmach

You can’t perform that action at this time.