minijinja-js 2.8.0

package/README.md

@@ -0,0 +1,82 @@
+<div align="center">
+  <img src="https://github.com/mitsuhiko/minijinja/raw/main/artwork/logo.png" alt="" width=320>
+  <p><strong>MiniJinja for JavaScript: a powerful template engine</strong></p>
+
+[![License](https://img.shields.io/github/license/mitsuhiko/minijinja)](https://github.com/mitsuhiko/minijinja/blob/main/LICENSE)
+[![Crates.io](https://img.shields.io/crates/d/minijinja.svg)](https://crates.io/crates/minijinja)
+[![rustc 1.63.0](https://img.shields.io/badge/rust-1.63%2B-orange.svg)](https://img.shields.io/badge/rust-1.63%2B-orange.svg)
+[![Documentation](https://docs.rs/minijinja/badge.svg)](https://docs.rs/minijinja)
+
+</div>
+
+`minijinja-js` is an experimental binding of
+[MiniJinja](https://github.com/mitsuhiko/minijinja) to JavaScript.  It has somewhat
+limited functionality compared to the Rust version.  These bindings use
+`wasm-bindgen`.
+
+You might want to use MiniJinja instead of Jinja2 when the full feature set
+of Jinja2 is not required and you want to have the same rendering experience
+of a data set between Rust, Python and JavaScript.
+
+This exposes a bunch of MiniJinja via wasm to the browser, but not all of it.
+
+This package can be useful if you have MiniJinja templates that you want to
+evaluate as a sandbox in a browser for a user or on the backend.  Given the
+overheads that this creates size and performance wise, it would not be wise to
+use this for actual template rendering in the browser.
+
+## Example
+
+Render a template from a string:
+
+```typescript
+import { Environment } from "minijinja-js";
+
+const env = new Environment();
+env.debug = true;
+const result = env.renderStr('Hello {{ name }}!', { name: 'World' });
+console.log(result);
+```
+
+Render a template registered to the engine:
+
+```typescript
+import { Environment } from "minijinja-js";
+
+const env = new Environment();
+env.addTemplate('index.html', 'Hello {{ name }}!');
+const result = env.renderTemplate('index.html', { name: 'World' });
+console.log(result);
+```
+
+Evaluate an expression:
+
+```typescript
+import { Environment } from "minijinja-js";
+
+const env = new Environment();
+const result = env.evalExpr('1 + 1', {});
+console.log(result);
+```
+
+## Known Limitations
+
+There are various limitations with the binding today, some of which can be fixed,
+others probably not so much.  You might run into the following:
+
+* Access of the template engine state from JavaScript is not possible.
+* You cannot register a custom auto escape callback or a finalizer
+* If the engine panics, the WASM runtime corrupts.
+
+## Sponsor
+
+If you like the project and find it useful you can [become a
+sponsor](https://github.com/sponsors/mitsuhiko).
+
+## License and Links
+
+- [Documentation](https://docs.rs/minijinja/)
+- [Examples](https://github.com/mitsuhiko/minijinja/tree/main/examples)
+- [Issue Tracker](https://github.com/mitsuhiko/minijinja/issues)
+- [MiniJinja Playground](https://mitsuhiko.github.io/minijinja-playground/)
+- License: [Apache-2.0](https://github.com/mitsuhiko/minijinja/blob/main/LICENSE)

package/dist/bundler/README.md

@@ -0,0 +1,82 @@
+<div align="center">
+  <img src="https://github.com/mitsuhiko/minijinja/raw/main/artwork/logo.png" alt="" width=320>
+  <p><strong>MiniJinja for JavaScript: a powerful template engine</strong></p>
+
+[![License](https://img.shields.io/github/license/mitsuhiko/minijinja)](https://github.com/mitsuhiko/minijinja/blob/main/LICENSE)
+[![Crates.io](https://img.shields.io/crates/d/minijinja.svg)](https://crates.io/crates/minijinja)
+[![rustc 1.63.0](https://img.shields.io/badge/rust-1.63%2B-orange.svg)](https://img.shields.io/badge/rust-1.63%2B-orange.svg)
+[![Documentation](https://docs.rs/minijinja/badge.svg)](https://docs.rs/minijinja)
+
+</div>
+
+`minijinja-js` is an experimental binding of
+[MiniJinja](https://github.com/mitsuhiko/minijinja) to JavaScript.  It has somewhat
+limited functionality compared to the Rust version.  These bindings use
+`wasm-bindgen`.
+
+You might want to use MiniJinja instead of Jinja2 when the full feature set
+of Jinja2 is not required and you want to have the same rendering experience
+of a data set between Rust, Python and JavaScript.
+
+This exposes a bunch of MiniJinja via wasm to the browser, but not all of it.
+
+This package can be useful if you have MiniJinja templates that you want to
+evaluate as a sandbox in a browser for a user or on the backend.  Given the
+overheads that this creates size and performance wise, it would not be wise to
+use this for actual template rendering in the browser.
+
+## Example
+
+Render a template from a string:
+
+```typescript
+import { Environment } from "minijinja-js";
+
+const env = new Environment();
+env.debug = true;
+const result = env.renderStr('Hello {{ name }}!', { name: 'World' });
+console.log(result);
+```
+
+Render a template registered to the engine:
+
+```typescript
+import { Environment } from "minijinja-js";
+
+const env = new Environment();
+env.addTemplate('index.html', 'Hello {{ name }}!');
+const result = env.renderTemplate('index.html', { name: 'World' });
+console.log(result);
+```
+
+Evaluate an expression:
+
+```typescript
+import { Environment } from "minijinja-js";
+
+const env = new Environment();
+const result = env.evalExpr('1 + 1', {});
+console.log(result);
+```
+
+## Known Limitations
+
+There are various limitations with the binding today, some of which can be fixed,
+others probably not so much.  You might run into the following:
+
+* Access of the template engine state from JavaScript is not possible.
+* You cannot register a custom auto escape callback or a finalizer
+* If the engine panics, the WASM runtime corrupts.
+
+## Sponsor
+
+If you like the project and find it useful you can [become a
+sponsor](https://github.com/sponsors/mitsuhiko).
+
+## License and Links
+
+- [Documentation](https://docs.rs/minijinja/)
+- [Examples](https://github.com/mitsuhiko/minijinja/tree/main/examples)
+- [Issue Tracker](https://github.com/mitsuhiko/minijinja/issues)
+- [MiniJinja Playground](https://mitsuhiko.github.io/minijinja-playground/)
+- License: [Apache-2.0](https://github.com/mitsuhiko/minijinja/blob/main/LICENSE)

package/dist/bundler/minijinja_js.d.ts

@@ -0,0 +1,89 @@
+/* tslint:disable */
+/* eslint-disable */
+type UndefinedBehavior = "strict" | "chainable" | "lenient" | "semi_strct";
+/**
+ * Represents a MiniJinja environment.
+ */
+export class Environment {
+  free(): void;
+  constructor();
+  /**
+   * Registers a new template by name and source.
+   */
+  addTemplate(name: string, source: string): void;
+  /**
+   * Removes a template by name.
+   */
+  removeTemplate(name: string): void;
+  /**
+   * Clears all templates from the environment.
+   */
+  clearTemplates(): void;
+  /**
+   * Renders a registered template by name with the given context.
+   */
+  renderTemplate(name: string, ctx: any): string;
+  /**
+   * Renders a string template with the given context.
+   *
+   * This is useful for one-off template rendering without registering the template.  The
+   * template is parsed and rendered immediately.
+   */
+  renderStr(source: string, ctx: any): string;
+  /**
+   * Like `renderStr` but with a named template for auto escape detection.
+   */
+  renderNamedStr(name: string, source: string, ctx: any): string;
+  /**
+   * Evaluates an expression with the given context.
+   *
+   * This is useful for evaluating expressions outside of templates.  The expression is
+   * parsed and evaluated immediately.
+   */
+  evalExpr(expr: string, ctx: any): any;
+  /**
+   * Registers a filter function.
+   */
+  addFilter(name: string, func: Function): void;
+  /**
+   * Registers a test function.
+   */
+  addTest(name: string, func: Function): void;
+  /**
+   * Enables python compatibility.
+   */
+  enablePyCompat(): void;
+  /**
+   * Registers a value as global.
+   */
+  addGlobal(name: string, value: any): void;
+  /**
+   * Removes a global again.
+   */
+  removeGlobal(name: string): void;
+  /**
+   * Enables or disables debug mode.
+   */
+  debug: boolean;
+  /**
+   * Enables or disables block trimming.
+   */
+  trimBlocks: boolean;
+  /**
+   * Enables or disables the lstrip blocks feature.
+   */
+  lstripBlocks: boolean;
+  /**
+   * Enables or disables keeping of the final newline.
+   */
+  keepTrailingNewline: boolean;
+  /**
+   * Reconfigures the behavior of undefined variables.
+   */
+  undefinedBehavior: UndefinedBehavior;
+  /**
+   * Configures the max-fuel for template evaluation.
+   */
+  get fuel(): number | undefined;
+  set fuel(value: number | null | undefined);
+}

package/dist/bundler/minijinja_js.js

@@ -0,0 +1,4 @@
+import * as wasm from "./minijinja_js_bg.wasm";
+export * from "./minijinja_js_bg.js";
+import { __wbg_set_wasm } from "./minijinja_js_bg.js";
+__wbg_set_wasm(wasm);