• Stars
    star
    45
  • Rank 624,037 (Top 13 %)
  • Language
    Crystal
  • License
    MIT License
  • Created over 5 years ago
  • Updated over 3 years ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

Generate JSON objects with a Builder-style DSL, inspired by jbuilder

Jbuilder

Crystal CI GitHub release

Generate JSON objects with a Builder-style DSL, inspired by jbuilder (https://github.com/rails/jbuilder)

Installation

  1. Add the dependency to your shard.yml:

    dependencies:
      jbuilder:
        github: shootingfly/jbuilder
  2. Run shards install

Usage

require "jbuilder"

First, write down the code.

Jbuilder.new do |json|
  json.null nil
  json.code 200
  json.msg "ok"
  json.merge!({"code" => 201})
  json.array! "array1", [1, 1.0, "1"]
  json.array!("array2", [1, 2, 3, 4]) do |json, item|
    json.code item
  end
  json.data do |json|
    json.code 400
    json.array! "array3", [1, 1.0, "1"]
  end
  json.set!("custom_field", %w[1 2])
end.to_json

Then you can see,

{
  "null":null,
  "code":201,
  "msg":"ok",
  "array1":[
    1,
    1.0,
    "1"
  ],
  "array2":[
    {
      "code":1
    },
    {
      "code":2
    },
    {
      "code":3
    },
    {
      "code":4
    }
  ],
  "data":{
    "code":400,
    "array3":[
      1,
      1.0,
      "1"
    ]
  },
  "custom_field":[
    "1",
    "2"
  ]
}

An example using Kemal

https://github.com/shootingfly/kemal-jbuilder-example

Changelog

  • v1.0.0
    • Support Crystal 1.0.0
  • v0.3.0
    • Support Tuple and Named Tuple
    • Support render with layout and child template
  • v0.2.0
    • Support Kilt
  • v0.1.0
    • First Release

Contributing

  1. Fork it (https://github.com/shootingfly/jbuilder/fork)
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create a new Pull Request

Contributors