# glitr_convert
[](https://hex.pm/packages/glitr_convert)
[](https://hexdocs.pm/glitr_convert/)
**Encode and decode from and to Gleam types effortlessly !**
Define a converter once and encode and decode as much as you want.
## Installation
```sh
gleam add glitr_convert
```
## Usage
```gleam
import gleam/io
import gleam/json
import glitr/convert as c
import glitr/convert/json as glitr_json
pub type Person {
Person(name: String, age: Int)
}
pub fn main() {
let converter =
c.object({
use name <- c.field("name", fn(v: Person) { Ok(v.name) }, c.string())
use age <- c.field("age", fn(v: Person) { Ok(v.age) }, c.int())
c.success(Person(name:, age:))
})
Person("Anna", 21)
|> glitr_json.json_encode(converter)
|> json.to_string
|> io.debug
// '{"name": "Anna", "age": 21}'
"{\"name\": \"Bob\", \"age\": 36}"
|> json.decode(glitr_json.json_decode(converter))
|> io.debug
// Ok(Person("Bob", 36))
}
```
Further documentation can be found at <https://hexdocs.pm/glitr_convert>.
## Features
- Javascript and Erlang targets
- Converters for all basic types (except BitArray)
- Define converters for List, Dict, Result & Option
- Build decoders for custom objects and enums
- Encode and decode to JSON.
## Potential developments
- Add BitArray support
- Add Tuple support
- Add Yaml conversion
Feel free to open PRs and issues if you want more features !
## Development
```sh
gleam run # Run the project
gleam test # Run the tests
```
