ejsc-views v1.1.8

EJS Compiler CLI Tool

The EJS Compiler is a CLI tool for compiling .ejs templates into a single JavaScript file. This simplifies including precompiled views in your projects, improving efficiency and maintainability.

Compatibility: Node 16.14.0 and later

Features

• Compiles all .ejs files, including nested ones, into a single JavaScript file.
• Supports detailed compilation logs for debugging and verification.
• Works cross-platform (Windows, macOS, Linux).
• Easy-to-use CLI interface or programmatic integration.

Installation

1. Install Globally

To install globally for CLI usage:

npm install -g ejsc-views

2. Local Installation

For usage in a specific project:

npm install ejsc-views

Usage

Method 1: CLI

Run the compiler directly via the terminal.

Syntax:

ejsc [options]

Options:

Examples:

1. Compile .ejs templates in src/views and save the output in dist/js:

   ejsc --views src/views --output dist/js

2. Compile with detailed logs enabled:

   ejsc --views src/views --output dist/js --details

Method 2: Programmatic Integration

You can integrate the compiler into your Node.js scripts.

Example Code:

import { compile } from "ejs-compile";

const viewsDir = "src/views";
const outputDir = "dist/js";
const details = true; // Enable detailed logs

compile(viewsDir, outputDir, details);

Parameters:

Output

The output is a single JavaScript file containing all compiled .ejs templates. By default, this file is saved as public/js/views.js.

The compiled file includes: 1. Precompiled views as functions. 2. A helper function ejs.views_include for including templates programmatically.