Eta

<p align="center"> <img align="center" width="50%" src="https://github.com/bgub/eta/assets/25597854/041dbe34-883b-459b-8607-c787815c441a"> </p> <h1 align="center" style="text-align: center; width: fit-content; margin-left: auto; margin-right: auto;">eta (η)</h1> <p align="center"> <a href="https://eta.js.org">Documentation</a> - <a href="https://discord.gg/27gGncJYE2">Chat</a> - <a href="https://eta.js.org/playground">Playground</a> </p> <span align="center">

</span> <span align="center">

You're viewing the source for Eta v4

</span>

Summary

Eta is a lightweight and blazing fast embedded JS templating engine that works inside Node, Deno, and the browser. It's written in TypeScript and emphasizes great performance, configurability, and small bundle size.

🎯 Built with ts-base — A TypeScript library starter template featuring Biome, Vitest, tsdown, and automated releases. Check out ts-base for a modern TypeScript project setup!

🌟 Features

• 📦 0 dependencies
• 💡 Only ~3.5 KB minzipped
• ⚡️ Written in TypeScript
• ✨ Deno support (+ Node and browser)
• 🚀 Super Fast
• 🔧 Configurable
  • Plugins, custom delimiters, caching
• 🔨 Powerful
  • Precompilation, partials, async
  • Layout support!
• 🔥 Reliable
  • Better quotes/comments support
    • ex. <%= someval + "string %>" %> compiles correctly, while it fails with doT or EJS
  • Great error reporting
• ⚡️ Exports ES Modules
• 📝 Easy template syntax

Get Started

For more thorough documentation, visit https://eta.js.org

Install Eta

npm install eta

In the root of your project, create templates/simple.eta

Hi <%= it.name %>!

Then, in your JS file:

import { Eta } from "eta";
// or use https://jsr.io/@bgub/eta

const eta = new Eta({ views: path.join(__dirname, "templates") });

// Render a template

const res = eta.render("./simple", { name: "Ben" });
console.log(res); // Hi Ben!

FAQs

<details> <summary> <b>Where did Eta's name come from?</b> </summary>

"Eta" means tiny in Esperanto. Plus, it can be used as an acronym for all sorts of cool phrases: "ECMAScript Template Awesomeness", "Embedded Templating Alternative", etc....

Additionally, Eta is a letter of the Greek alphabet (it stands for all sorts of cool things in various mathematical fields, including efficiency) and is three letters long (perfect for a file extension).

</details> <br />

Integrations

<details> <summary> <b>Visual Studio Code</b> </summary>

@shadowtime2000 created eta-vscode.

</details> <details> <summary> <b>ESLint</b> </summary>

eslint-plugin-eta was created to provide an ESLint processor so you can lint your Eta templates.

</details> <details> <summary> <b>Webpack</b> </summary>

Currently there is no official Webpack integration but @clshortfuse shared the loader he uses:

{
  loader: 'html-loader',
  options: {
    preprocessor(content, loaderContext) {
      return eta.render(content, {}, { filename: loaderContext.resourcePath });
    },
  },
}

</details> <details> <summary> <b>Node-RED</b> </summary>

To operate with Eta templates in Node-RED: @ralphwetzel/node-red-contrib-eta

<img width="150" alt="image" src="https://user-images.githubusercontent.com/16342003/160198427-2a69ff10-e8bf-4873-9d99-2929a584ccc8.png"> </details> <details> <summary> <b>Koa</b> </summary>

To render Eta templates in Koa web framework: @cedx/koa-eta

</details> <details> <summary> <b>Vite</b> </summary>

To use Eta templates in your Vite project: @rinoshiyo/vite-plugin-eta

</details> <br />

Projects using eta

• Docusaurus v2: open-source documentation framework that uses Eta to generate a SSR build
• swagger-typescript-api: Open source typescript api codegenerator from Swagger. Uses Eta as codegenerator by templates
• html-bundler-webpack-plugin: Webpack plugin make easily to bundle HTML pages from templates, source styles and scripts
• SmartDeno: SmartDeno is an easy to setup web template using Deno & Oak
• stc: OpenAPI (Swagger) and Apifox documentation converted to api. Use eta templates to generate code.
• Add yours!

Contributors

Made with ❤️ by bgub and many wonderful contributors. Contributions of any kind are welcome!

Credits

• Async support, file handling, and error formatting were based on code from EJS, which is licensed under the Apache-2.0 license. Code was modified and refactored to some extent.
• Syntax and some parts of compilation are heavily based off EJS, Nunjucks, and doT.