https://github.com/giacomocavalieri/glam

✨ A package to help you easily pretty print structured data
https://github.com/giacomocavalieri/glam

pretty-printer

Last synced: about 2 months ago
JSON representation

✨ A package to help you easily pretty print structured data

• Host: GitHub
• URL: https://github.com/giacomocavalieri/glam
• Owner: giacomocavalieri
• License: apache-2.0
• Created: 2023-08-21T21:19:59.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2024-04-26T07:21:21.000Z (8 months ago)
• Last Synced: 2024-10-12T23:30:44.966Z (2 months ago)
• Topics: pretty-printer
• Language: Gleam
• Homepage: https://hexdocs.pm/glam/
• Size: 1.84 MB
• Stars: 33
• Watchers: 2
• Forks: 5
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-gleam - glam - [📚](https://hexdocs.pm/glam/) - A package to help you easily pretty print structured data (Packages / Text)

README

        
![Glam](https://github.com/giacomocavalieri/glam/blob/main/resources/glam_banner.png?raw=true)

[![Package Version](https://img.shields.io/hexpm/v/glam?color=92DCE5)](https://hex.pm/packages/glam)

[![Hex Docs](https://img.shields.io/badge/hex-docs-ffaff3?color=FCC0D2)](https://hexdocs.pm/glam/)

✨ A package to help you easily pretty print structured data

> ⚙️ This package works with both the Erlang and Javascript target

## Installation

To add this package to your Gleam project:

```sh

gleam add glam

```

## Pretty printing

When working with structured data (like JSON, XML, lists, ASTs, ...) it can

be useful to print it in a nice and tidy way.

Of course, one could go the quick and dirty way and just `string.inspect`

the data structure and call it a day.

However, the result would hardly be readable for complex data structures.

On the other hand, handwriting a pretty printing function can be quite

difficult (I sure have spent my fair share of time writing those) and

error-prone: there are a lot of moving pieces to juggle and it's easy for bugs

to sneak in.

A pretty printing package like Glam provides some basic building blocks to

_describe_ the structure of your data and takes care of the heavy lifting of

actually finding the best layout to format the data, gracefully handling line

limits and indentation.

## Getting started

If you want to get started with Glam, a great starting point is the

[learning materials page](https://hexdocs.pm/glam/learning_materials.html)!

There you'll find a lot of step-by-step tutorials that will guide you through

some awesome pretty printers and get you up and running with Glam.

By the end of the tutorials you'll know most of the package's API and you'll

have implemented pretty printers for lists, JSON and error messages:

```gleam

pretty_list(["Gleam", "is", "fun!"])

|> doc.to_string(10) // Fit the list on lines of width 10

// [

//   "Gleam",

//   "is",   

//   "fun!",   

// ]

```

You can also have a look at the

[`examples`](https://github.com/giacomocavalieri/glam/tree/main/src/examples)

folder in the GitHub repo, there you'll also find a JSON pretty printer.

## Contributing

If you think there's any way to improve this package, or if you spot a bug

don't be afraid to open PRs, issues or requests of any kind!

Any contribution is welcome 💜