mirror of https://github.com/iv-org/invidious.git synced 2025-11-04 06:08:31 -06:00

Commit the whole ./lib/ folder which stores the Crystal dependencies.
This has a few benefits:

- Allows to build the project without a connection to the Internet
  to retrieve dependencies.
- Makes the project resistant against dependency re-tags which might
  include malicious code.

2019-08-15 01:51:27 +02:00

3.3 KiB

Raw Blame History

Kilt

Generic templating interface for Crystal.

Goal

Simplify developers' lives by abstracting template rendering for multiple template languages.

Supported out of the box

Language	File extensions	Required libraries	Maintainer
ECR	.ecr	none (part of the stdlib)
Mustache	.mustache	crustache	@MakeNowJust
Slang	.slang	slang	@jeromegn
Temel	.temel	temel	@f
Crikey	.crikey	crikey	@domgetter

Installation

Add this to your application's shard.yml:

dependencies:
  kilt:
    github: jeromegn/kilt

  # Any other template languages Crystal shard

Usage

Kilt essentially adds two macros Kilt.embed and Kilt.file, the code is really simple.
Add template language dependencies, as listed in the support table above.

Both macros take a filename and a io_name (the latter defaults to "__kilt_io__")

Example

require "kilt"

# For slang, add:
require "kilt/slang"

# With a Class

class YourView
  Kilt.file("path/to/template.ecr") # Adds a to_s method
end
puts YourView.new.to_s # => <compiled template>


# Embedded

str = Kilt.render "path/to/template.slang"

# or

str = String.build do |__kilt_io__|
  Kilt.embed "path/to/template.slang"
end

puts str # => <compiled template>

Registering your own template engine

Use Kilt.register_engine(extension, embed_command) macro:

require "kilt"

module MyEngine
  macro embed(filename, io_name)
    # ....
  end
end

Kilt.register_engine("myeng", MyEngine.embed)

This can be part of your own my-engine library: in this case it should depend on kilt directly, or this could be a part of adapter library, like: kilt-my-engine, which will depend on both kilt and my-engine.

Contributing

Please contribute your own "adapter" if you create a template language for Crystal that's not yet supported here!

Fork it ( https://github.com/jeromegn/kilt/fork )
Create your feature branch (git checkout -b my-awesome-template-language)
Commit your changes (git commit -am 'Add my-awesome-template-language')
Push to the branch (git push origin my-awesome-template-language)
Create a new Pull Request

Contributors

jeromegn Jerome Gravel-Niquet - creator, maintainer
waterlink Oleksii Fedorov
MakeNowJust TSUYUSATO Kitsune
f Fatih Kadir Akın

3.3 KiB Raw Blame History Unescape Escape