https://github.com/febit/wit
A script/template engine implemented in pure Java
https://github.com/febit/wit
java script template
Last synced: 14 days ago
JSON representation
A script/template engine implemented in pure Java
- Host: GitHub
- URL: https://github.com/febit/wit
- Owner: febit
- License: apache-2.0
- Created: 2013-08-09T03:36:35.000Z (over 12 years ago)
- Default Branch: main
- Last Pushed: 2026-04-19T03:57:29.000Z (14 days ago)
- Last Synced: 2026-04-19T05:32:14.220Z (14 days ago)
- Topics: java, script, template
- Language: Java
- Homepage:
- Size: 6.09 MB
- Stars: 50
- Watchers: 10
- Forks: 20
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE.txt
Awesome Lists containing this project
README
Febit Wit
====
[][license]
A script/template engine implemented in pure Java (Java 17+).
## How to use
+ Maven
```xml
org.febit.wit
wit-core
3.0.0
```
+ Gradle
```
implementation 'org.febit.wit:wit-core:3.0.0'
```
+ Config Wit engine, load script and eval:
```java
Wit wit = Wit.builder()
// set DispatchLoader with multiple rules.
.loader(Loaders.dispatch()
// Load script from string content.
.rule("code:", Loaders.string().build())
// Load script from FileSystem with a specific root.
.rule("file:", Loaders.fileSystem()
.root("path/to/local/scripts")
// Enable caching for file system loader.
.cacheEnabled(true)
.build())
// ... add more rules if needed
.build())
.build();
Script script = wit.script("""
code: echo "Hello Wit！";
""");
Context context = script.eval(Vars.empty(), out);
```
+ What happens next:
- `Wit.builder()` / `WitBuilder` assembles the engine with `Loader`, `ParserFactory`, and other extension points.
- `wit.script(...)` resolves the path through `Loader` and creates a cached `ScriptImpl`.
- `ScriptImpl` starts compilation through `ParserFactory` with a `ParseContext`.
- `parser` parses the source and assembles it into `ir.ScriptIR`.
- `script.eval(...)` creates a `RuntimeContext` for the current inputs and output target.
- `ScriptIR.execute(context)` runs the compiled IR.
## Hello Wit
```js
%>Hello Wit!<%
var books;
{
for(book : books) {
%>
${for.iter.index + 1}.《${book.name}》 ￥${book.price}
<%
}
}
{
var func = function(a, b) {
return a + b + arguments[3];
};
echo func("a", "b", "c");
}
{
var map = {
books,
1: 1,
"key2": "value2",
3: 2 + 1
};
map[5] = 2 + 3;
map.~put("6", 2*3);
for(key, value : map) {
echo key + ":" +value + "\n";
}
}
%>
```
> [More examples][tests]
## License
**Febit Wit 3** is released under the Apache-2.0 license. See the bundled [LICENSE file][license] for
details.
## Third-party Licenses
+ **ASM** under the BSD License.[License file][asm_license]
## Bug report
> [github-issue][new_issue_github]
[tests]: https://github.com/febit/wit/tree/main/wit-core/src/test/resources/org/febit/wit/scripts/fixtures
[new_issue_github]: https://github.com/febit/wit/issues/new
[license]: https://github.com/febit/wit/blob/main/LICENSE.txt
[asm_license]: https://asm.ow2.io/license.html