README.md

JagTag

JagTag is a simple - yet powerful and customizable - interpretted text parsing language! Some methods are included in the built-in libraries, and additional methods can be defined that utilize the parser environment veriables, as well as the method's input.

Simple Example

import com.jagrosh.jagtag.*;
public class Example
{
  public static void main(String[] args)
  {
    Parser parser = JagTag.newDefaultBuilder()
                .addMethod( new Method("exclaim", (env,in) -> in[0]+"!!!") )
                .build();
    String result = parser.parse("{exclaim:{if:this|=|that|then:Foo Bar|else:Hello World}}");
    System.out.println(result);
  }
}

Result: Hello World!!!

Maven

To use Maven with JagTag, simply add the following sections to your pom.xml

  <repository>
    <id>central</id>
    <name>bintray</name>
    <url>http://jcenter.bintray.com</url>
  </repository>

  <dependency>
    <groupId>com.jagrosh</groupId>
    <artifactId>JagTag</artifactId>
    <version>0.5</version>
  </dependency>

Current Projects

Here are some other projects that utilize JagTag:

• Spectra (Discord Bot) - Spectra uses JagTag in its customizable "tags" (user-created commands), and in welcome and leave messages for servers. (https://github.com/jagrosh/Spectra/blob/master/src/spectra/jagtag/libraries/Discord.java)

Other Libraries

Below are JagTag-related libraries available for other languages or purposes:

• TheSharks/JagTag-JS - A JavaScript port of the JagTag text parsing language
• TheMonitorLizard/JagTagXML - a JagTag to XML transpiler written in Java