@rse/nunjucks-cli 1.5.3 → 1.6.0

package/Dockerfile

@@ -10,7 +10,7 @@ ARG         IMAGE_RELEASE=20240311
 ARG         IMAGE_ALIAS=latest
 
 #   derive image from a certain base image
-FROM        node:20.11-alpine3.18
+FROM        node:24-alpine3.21
 
 #   add additional build tools
 RUN         apk update && \

package/README.md

@@ -98,7 +98,7 @@ Hello, world!
 License
 -------
 
-Copyright © 2019-2024 Dr. Ralf S. Engelschall (http://engelschall.com/)
+Copyright © 2019-2025 Dr. Ralf S. Engelschall (http://engelschall.com/)
 
 Permission is hereby granted, free of charge, to any person obtaining
 a copy of this software and associated documentation files (the

package/eslint.mjs

@@ -0,0 +1,65 @@
+/*
+**  nunjucks -- Nunjucks Template Rendering Command-Line Interface
+**  Copyright (c) 2019-2025 Dr. Ralf S. Engelschall <http://engelschall.com>
+**  Licensed under MIT <http://spdx.org/licenses/MIT.html>
+*/
+
+import pluginJs      from "@eslint/js"
+import pluginStd     from "neostandard"
+import pluginN       from "eslint-plugin-n"
+import pluginImport  from "eslint-plugin-import"
+import pluginPromise from "eslint-plugin-promise"
+import globals       from "globals"
+
+export default [
+    pluginJs.configs.recommended,
+    ...pluginStd({
+        ignores: pluginStd.resolveIgnoresFromGitignore()
+    }),
+    {
+        plugins: {
+            "n":       pluginN,
+            "import":  pluginImport,
+            "promise": pluginPromise
+        },
+        files:   [ "**/*.js" ],
+        ignores: [ "dst/" ],
+        languageOptions: {
+            ecmaVersion: 2022,
+            sourceType:  "module",
+            globals: {
+                ...globals.browser,
+                ...globals.node,
+                ...globals.commonjs,
+                ...globals.worker,
+                ...globals.serviceworker
+            }
+        },
+        rules: {
+            "curly":                                              "off",
+            "require-atomic-updates":                             "off",
+            "dot-notation":                                       "off",
+            "no-labels":                                          "off",
+            "no-useless-constructor":                             "off",
+            "no-dupe-class-members":                              "off",
+
+            "@stylistic/indent":                                  [ "error", 4, { SwitchCase: 1 } ],
+            "@stylistic/linebreak-style":                         [ "error", "unix" ],
+            "@stylistic/semi":                                    [ "error", "never" ],
+            "@stylistic/operator-linebreak":                      [ "error", "after", { overrides: { "&&": "before", "||": "before", ":": "after" } } ],
+            "@stylistic/brace-style":                             [ "error", "stroustrup", { allowSingleLine: true } ],
+            "@stylistic/quotes":                                  [ "error", "double" ],
+
+            "@stylistic/no-multi-spaces":                         "off",
+            "@stylistic/no-multiple-empty-lines":                 "off",
+            "@stylistic/key-spacing":                             "off",
+            "@stylistic/object-property-newline":                 "off",
+            "@stylistic/space-in-parens":                         "off",
+            "@stylistic/array-bracket-spacing":                   "off",
+            "@stylistic/lines-between-class-members":             "off",
+            "@stylistic/multiline-ternary":                       "off",
+            "@stylistic/quote-props":                             "off"
+        }
+    }
+]
+

package/nunjucks.1

@@ -1,4 +1,4 @@
-.TH "NUNJUCKS" "1" "August 2023" "" ""
+.TH "NUNJUCKS" "1" "June 2025" "" ""
 .SH "NAME"
 \fBnunjucks\fR - Template Rendering Engine
 .SH "SYNOPSIS"
@@ -14,21 +14,21 @@ The following top-level options and arguments exist:
 .IP \(bu 4
 \[lB]\fB-h\fR|\fB--help\fR\[rB] Show usage help.
 .IP \(bu 4
-\[lB]\fB-V\fR|\fB--version\fR\[rB] show program version information.
+\[lB]\fB-V\fR|\fB--version\fR\[rB] Show program version information.
 .IP \(bu 4
-\[lB]\fB-c\fR|\fB--config\fR \fIconfig-file\fR\[rB] load Nunjucks configuration YAML file.
+\[lB]\fB-c\fR|\fB--config\fR \fIconfig-file\fR\[rB] Load Nunjucks configuration YAML file.
 .IP \(bu 4
-\[lB]\fB-C\fR|\fB--option\fR \fIkey\fR=\fIvalue\fR\[rB] set Nunjucks configuration option.
+\[lB]\fB-C\fR|\fB--option\fR \fIkey\fR=\fIvalue\fR\[rB] Set Nunjucks configuration option.
 .IP \(bu 4
-\[lB]\fB-d\fR|\fB--defines\fR \fIcontext-file\fR\[rB] load context definition YAML file.
+\[lB]\fB-d\fR|\fB--defines\fR \fIcontext-file\fR\[rB] Load context definition YAML file. Can occur multiple times.
 .IP \(bu 4
-\[lB]\fB-D\fR|\fB--define\fR \fIkey\fR=\fIvalue\fR\[rB] set context definition key/value.
+\[lB]\fB-D\fR|\fB--define\fR \fIkey\fR=\fIvalue\fR\[rB] Set context definition key/value. Can occur multiple times.
 .IP \(bu 4
-\[lB]\fB-e\fR|\fB--extension\fR \fImodule-name\fR\[rB] load Nunjucks JavaScript extension module (installed via NPM).
+\[lB]\fB-e\fR|\fB--extension\fR \fImodule-name\fR\[rB] Load Nunjucks JavaScript extension module (installed via NPM).
 .IP \(bu 4
-\[lB]\fB-o\fR|\fB--output\fR \fIoutput-file\fR|\fB-\fR\[rB] save output file (or stdout).
+\[lB]\fB-o\fR|\fB--output\fR \fIoutput-file\fR|\fB-\fR\[rB] Save output file (or stdout).
 .IP \(bu 4
-\[lB]\fB<input-file>\fR|\fB-\fR\[rB] load input file (or stdin).
+\[lB]\fB<input-file>\fR|\fB-\fR\[rB] Load input file (or stdin).
 .RE 0
 
 .SH "EXAMPLE"

package/nunjucks.js

@@ -1,26 +1,26 @@
 #!/usr/bin/env node
 /*
 **  nunjucks -- Nunjucks Template Rendering Command-Line Interface
-**  Copyright (c) 2019-2024 Dr. Ralf S. Engelschall <http://engelschall.com>
+**  Copyright (c) 2019-2025 Dr. Ralf S. Engelschall <http://engelschall.com>
 **  Licensed under MIT <http://spdx.org/licenses/MIT.html>
 */
 
-/*  own information  */
-const my        = require("./package.json")
-
 /*  internal requirements  */
-const fs        = require("node:fs")
-const path      = require("node:path")
+import fs          from "node:fs"
+import path        from "node:path"
 
 /*  external requirements  */
-const commander = require("commander")
-const chalk     = require("chalk")
-const jsYAML    = require("js-yaml")
-const nunjucks  = require("nunjucks")
-const deepmerge = require("deepmerge")
+import { Command } from "commander"
+import chalk       from "chalk"
+import jsYAML      from "js-yaml"
+import nunjucks    from "nunjucks"
+import deepmerge   from "deepmerge"
+
+/*  load my own information  */
+const my = JSON.parse(await fs.promises.readFile(new URL("./package.json", import.meta.url)))
 
 /*  parse command-line arguments  */
-const program = new commander.Command()
+const program = new Command()
 program.name("nunjucks")
     .description("Nunjucks Template Rendering Command-Line Interface")
     .showHelpAfterError("hint: use option --help for usage information")
@@ -47,7 +47,7 @@ if (argv.help) {
 if (argv.version) {
     console.log(`${my.name} ${my.version} (Node.js ${process.versions.node}, Nunjucks: ${my.dependencies.nunjucks})`)
     console.log(`${my.description}`)
-    console.log(`Copyright (c) 2019-2024 ${my.author.name} <${my.author.url}>`)
+    console.log(`Copyright (c) 2019-2025 ${my.author.name} <${my.author.url}>`)
     console.log(`Licensed under ${my.license} <http://spdx.org/licenses/${my.license}.html>`)
     process.exit(0)
 }

package/package.json

@@ -1,8 +1,8 @@
 {
     "name":                       "@rse/nunjucks-cli",
     "publishConfig":              { "access": "public" },
-    "version":                    "1.5.3",
-    "stdver":                     "1.5.3-GA",
+    "version":                    "1.6.0",
+    "stdver":                     "1.6.0-GA",
     "description":                "Nunjucks Template Rendering Command-Line Interface",
     "author": {
         "name":                   "Dr. Ralf S. Engelschall",
@@ -21,26 +21,28 @@
         "nunjucks":               "nunjucks.js"
     },
     "man":                        "nunjucks.1",
+    "type":                       "module",
     "dependencies": {
         "nunjucks":               "3.2.4",
-        "chalk":                  "4.1.0",
-        "commander":              "12.1.0",
+        "chalk":                  "5.4.1",
+        "commander":              "14.0.0",
         "js-yaml":                "4.1.0",
         "deepmerge":              "4.3.1"
     },
     "devDependencies": {
-        "eslint":                 "8.57.0",
-        "eslint-config-standard": "17.1.0",
-        "eslint-plugin-promise":  "6.2.0",
-        "eslint-plugin-import":   "2.29.1",
-        "eslint-plugin-node":     "11.1.0",
+        "eslint":                 "9.28.0",
+        "@eslint/js":             "9.28.0",
+        "neostandard":            "0.12.1",
+        "eslint-plugin-promise":  "7.2.1",
+        "eslint-plugin-import":   "2.31.0",
+        "eslint-plugin-n":        "17.19.0",
+        "globals":                "16.2.0",
         "remark-cli":             "12.0.1",
         "remark":                 "15.0.1",
         "remark-man":             "9.0.0"
     },
-    "upd":                        [ "!chalk" ],
     "scripts": {
-        "lint":                   "eslint --config eslint.yaml nunjucks.js",
+        "lint":                   "eslint --config eslint.mjs nunjucks.js",
         "man":                    "remark --quiet --use remark-man --output nunjucks.1 nunjucks.md",
         "test":                   "echo 'Hello, {{who}}!' | node nunjucks.js -D who=world -"
     }

package/eslint.yaml

@@ -1,51 +0,0 @@
-##
-##  nunjucks -- Nunjucks Template Rendering Command-Line Interface
-##  Copyright (c) 2019-2024 Dr. Ralf S. Engelschall <http://engelschall.com>
-##  Licensed under MIT <http://spdx.org/licenses/MIT.html>
-##
-
----
-
-extends:
-    - eslint:recommended
-    - eslint-config-standard
-
-parserOptions:
-    ecmaVersion: 12
-    sourceType:  module
-    ecmaFeatures:
-        jsx:     false
-
-env:
-    browser:       false
-    node:          true
-    mocha:         false
-    commonjs:      true
-    worker:        false
-    serviceworker: false
-
-globals:
-    process:       true
-
-rules:
-    #   modified rules
-    indent:                              [ "error", 4, { "SwitchCase": 1 } ]
-    linebreak-style:                     [ "error", "unix" ]
-    semi:                                [ "error", "never" ]
-    operator-linebreak:                  [ "error", "after", { "overrides": { "&&": "before", "||": "before", ":": "after" } } ]
-    brace-style:                         [ "error", "stroustrup", { "allowSingleLine": true } ]
-    quotes:                              [ "error", "double" ]
-
-    #   disabled rules
-    no-multi-spaces:                     off
-    no-multiple-empty-lines:             off
-    key-spacing:                         off
-    object-property-newline:             off
-    curly:                               off
-    space-in-parens:                     off
-    array-bracket-spacing:               off
-    require-atomic-updates:              off
-    dot-notation:                        off
-    no-whitespace-before-property:       off
-    lines-between-class-members:         off
-