Eta is a high-performance, server-side template engine that combines the power of Embedded Rust (Tera) with the simplicity of Handlebars. It aims to provide a fast and easy-to-use templating solution for web applications and other server-side projects.

Pros

• High Performance: Eta is built on top of Embedded Rust (Tera), which is known for its speed and efficiency.
• Simplicity: Eta's syntax is inspired by Handlebars, making it easy to learn and use for developers familiar with that ecosystem.
• Flexibility: Eta supports a wide range of features, including partials, layouts, and custom filters, allowing for complex template structures.
• Extensibility: Eta can be easily extended with custom functions and helpers, making it adaptable to various use cases.

Cons

• Rust Dependency: Eta is built using Rust, which may be a barrier for developers who are not familiar with the language.
• Limited Browser Support: Eta is primarily designed for server-side rendering, and may not be the best choice for client-side template rendering in the browser.
• Smaller Community: Compared to more established template engines like Handlebars or Mustache, Eta has a smaller community and ecosystem.
• Learning Curve: While Eta's syntax is inspired by Handlebars, it still has its own unique features and quirks that developers may need to learn.

Code Examples

Here are a few examples of how to use Eta in your code:

Rendering a Simple Template

const eta = require('eta');

const template = `<h1>Hello, <%= it.name %>!</h1>`;
const data = { name: 'John Doe' };

const html = eta.render(template, data);
console.log(html); // Output: <h1>Hello, John Doe!</h1>

Using Partials

const eta = require('eta');

eta.configure({
  views: 'views/', // Specify the directory for partials
});

const template = `
  <h1>Welcome to our website</h1>
  <%~ include('header') %>
  <p>This is the main content.</p>
  <%~ include('footer') %>
`;

const html = eta.render(template, {});
console.log(html);

Defining Custom Filters

const eta = require('eta');

eta.filters.uppercase = (str) => str.toUpperCase();

const template = `<p>The uppercase version of "hello" is <%= it.message | uppercase %>.</p>`;
const data = { message: 'hello' };

const html = eta.render(template, data);
console.log(html); // Output: <p>The uppercase version of "hello" is HELLO.</p>

Asynchronous Rendering

const eta = require('eta');

const template = `
  <h1>Hello, <%= await it.getName() %>!</h1>
  <p>The current time is <%= await it.getTime() %>.</p>
`;

const data = {
  getName: () => Promise.resolve('John Doe'),
  getTime: () => Promise.resolve(new Date().toLocaleString()),
};

const html = await eta.render(template, data);
console.log(html);

Getting Started

To get started with Eta, follow these steps:

1. Install Eta using npm or yarn:

npm install eta

2. Create a new file (e.g., app.js) and import Eta:

const eta = require('eta');

3. Define your template and data:

const template = `<h1>Hello, <%= it.name %>!</h1>`;
const data = { name: 'John Doe' };

4. Render the template:

const html = eta.render(template, data);
console.log(html);

5. (Optional) Configure Eta with custom options:

eta.configure({
  views: 'views/', // Specify the directory for partials
  cache: true, // Enable