velocity

Laconic API for Apache Velocity

License	${project.licence}
GroupId	com.github.dgroup
ArtifactId	velocity
Last Version	0.4.0
Release Date	Oct 30, 2018
Type	jar
Description	velocity Laconic API for Apache Velocity
Project URL	http://github.com/dgroup/velocity
Source Code Management	http://github.com/dgroup/velocity/tree/master

Download velocity

Filename	Size
velocity-0.4.0.pom
velocity-0.4.0.jar	14 KB
velocity-0.4.0-sources.jar	13 KB
velocity-0.4.0-javadoc.jar	77 KB

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/com.github.dgroup/velocity/ -->
<dependency>
    <groupId>com.github.dgroup</groupId>
    <artifactId>velocity</artifactId>
    <version>0.4.0</version>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/com.github.dgroup/velocity/
implementation 'com.github.dgroup:velocity:0.4.0'

Gradle Kotlin

// https://jarcasting.com/artifacts/com.github.dgroup/velocity/
implementation ("com.github.dgroup:velocity:0.4.0")

Apache Buildr

'com.github.dgroup:velocity:jar:0.4.0'

Apache Ivy

<dependency org="com.github.dgroup" name="velocity" rev="0.4.0">
  <artifact name="velocity" type="jar" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='com.github.dgroup', module='velocity', version='0.4.0')
)

Scala SBT

libraryDependencies += "com.github.dgroup" % "velocity" % "0.4.0"

Leiningen

[com.github.dgroup/velocity "0.4.0"]

Dependencies

provided (2)

Group / Artifact	Type	Version
org.cactoos : cactoos	jar	0.37
org.apache.velocity : velocity	jar	1.7

test (4)

Group / Artifact	Type	Version
junit : junit	jar	4.12
com.tngtech.junit.dataprovider : junit4-dataprovider	jar	2.0
org.hamcrest : hamcrest-all	jar	1.3
org.assertj : assertj-core	jar	3.8.0

Project Modules

There are no modules declared in this project.

ATTENTION: We're still in a very early alpha version, the API may and will change frequently. Please, use it at your own risk, until we release version 1.0.

Maven:

<dependency>
    <groupId>com.github.dgroup</groupId>
    <artifactId>laconic-velocity</artifactId>
</dependency>

Gradle:

dependencies {
    compile 'com.github.dgroup:laconic-velocity:<version>'
}

Get started

Generate the text/sql/xml/markdown/json/etc based on Apache Velocity template.

1. Define velocity template query.sql

   select 1 from dual
   #if ($flag)
   union
   select 2 from dual
   #end

   in

   velocity $ tree
   ...
   |-- src
   |   |-- main
   |   |   |-- ...
   |   |
   |   `-- test
   |       |-- java
   |       |   `-- ...
   |       `-- resources
   |           `-- velocity
   |               |-- ...
   |               |-- query.sql
   |               |-- ...
   ...
   
   

2. Define instance of velocity template using
   • full path to template

     @Test
     public void transformSql() throws TemplateException {
         MatcherAssert.assertThat(
             new Text("query.sql", "src/test/resources/velocity").compose(
                 new ArgOf("flag", true)
             ),
             Matchers.equalTo(
                 "select 1 from dual\nunion\nselect 2 from dual\n"
             )
         );
     }

     See more.
   • hierarchical search

     @Test
     public void hierarchical() throws TemplateException {
         MatcherAssert.assertThat(
             new Text("query.sql", "src/test/resources").compose(
                 new ArgOf("flag", true)
             ),
             Matchers.equalTo(
                 "select 1 from dual\nunion\nselect 2 from dual\n"
             )
         );
     }

     You can also specify the multiple roots (more).
   • classpath template

     @Test
     public void classpath() throws TemplateException {
         MatcherAssert.assertThat(
             new Text(new RelativePath("velocity/query.sql")).compose(
                 new ArgOf("flag", true)
             ),
             Matchers.equalTo(
                 "select 1 from dual\nunion\nselect 2 from dual\n"
             )
         );
     }

     See more.

Versions

Version
0.4.0 Oct 30, 2018
0.3.0 Oct 29, 2018
0.2.0 Oct 26, 2018
0.1.0 Oct 5, 2018