PlayRythm version history

What’s left for R1.0

• Support java extension in tag invocation

v1.0.0-20120815a

• Buf fixes:
  • The render result of calling tag inside a body of another tag call is disordered

v1.0.0-20120814a

Break change: any “\” in template will be automatically doubled in Java code to prevent “Invalid escape sequence” compilation error

• Enhancement:
  • Add String render() interface to ITag.Body, support fix of https://github.com/greenlaw110/greenscript/issues/58
  • Support line breaks into tags
• Buf fixes:
  • '\/' in template cause 'Invalid escape sequence' compilation error
  • Use @chain() in a `@include` template cause compilation exception
  • Call @chain().raw().assign('foo'){...} not work as expected
  • Unexpected behaviour on error reporting

v1.0.0-20120806b

• Bug fix:
  • An emergency fix to NPE on prod mode of v1.0.0-20120806
  • '@url' is separating the parameters using '&' instead '&'

v1.0.0-20120806

• Enhancement
  • Scan template root to pre-load template classes on start up if running in product mode
  • Executing macro like invoking a tag
  • New loop variables (separator and utils) inside @for loop
• Bug fix
  • Unclear error report when routes file configured bad static URL mapping
  • StringIndexOutOfBoundsException when calling Rythm.toString() in PlayRythm
  • Resolve NPE issue on TagContext.enter() call in some rare cases

v1.0.0-20120718

• Bug fix
  • @msg() tag does not recognize parameter if there is quotation mark on it
  • @msg() tag does not recognize variable as message

v1.0.0-20120717

• Bug fix
  • Pre load routes cause class not found error in some cases
  • Wrong Template Compilation Error Position with @msg() tag

v1.0.0-20120716

• Feature
  • Auto To String Mode
  • support overload for inline tag definition
• Bug fix
  • FastTag body parameter should be null when no body is supported
  • @assign does not work inside tags
  • cannot use @for loop inside include template

v1.0.0-20120704a

• Bug fix
  • external parser like @url() not recognized once NotSIMTemplate captured

v1.0.0-20120704

• Feature
  • Support TSM (toString mode)
• Enhancement
  • ClasspathResource should check resource change on dev mode

v1.0.0-20120703

• Feature
  • Support array in String interpolation mode
  • Add @nosim() keyword
• Bug fix
  • SIM not work with @(foo) style expression
  • @url, @fullUrl and @msg not work in SIM

v1.0.0-20120630

• Feature
  • String interpolation mode
• Enhancement
  • support defining return type of the inline tag

v1.0.0-RC8

• Bug fixes:
  • Space get removed when run in compact output mode
  • StringIndexOutOfBoundsException occured on reloading

v1.0.0-RC7

• New built-in tags:
  • errors
• Enhancements:
  • Improved boot up performance when running in product mode
  • Support multi lines import declaration
  • Support multi line render args declaration
• Bug Fixes:
  • unexpected line breaks
  • line separator not kept for certain case
  • embedded tag call with @doBody() output not synchronized
  • Empty lines in template are removed
  • getRenderArg can't get anything in layout template
  • Make getRenderArg method generic?
  • update layout templates only effects on one content template
  • NPE when call Java based tag with empty parameter
  • @errorList() does not output content
  • NPE when calling @errorList()

v1.0.0-RC6

• New built-in keywords:
  • @expand: alias of @exec, used to expand a predefined @macro
• Enhancements:
  • Support assign to final variable: @assign(“foo”, true) {...} and @myTag(...).assign(“myTagResult”, true)
• Bug fixes:
  • Cannot pass expression in parameters to @extends
  • Cannot use complex expression in @set
  • Need refresh twice when layout template changed
  • expression with the same name as a keyword will not be evaluated
  • In prod mode, javascript in templates can get corrupt over dropped newlines
  • Support java syntax in tag parameters
  • @url expression cause trouble
  • String index out of range: -1
  • 'Action Application.public not found' error when deploying to Heroku
  • In prod mode, javascript in templates can get corrupt over dropped newlines
  • i18n is always escaped

v1.0.0-RC5

• New built-in keywords:
  • @compact: mark a block of template to be output in compact mode without regarding to global engine setting
  • @nocompact: mark a block of template to be output in NON-compact mode without regarding to global engine setting
  • @macro: define an macro
  • @exec: execute an macro
• Support custom defined Java Extensions
• Bug fixes:
  • enhance embedded template class fail
  • The content inside @for loop doesn't update on dev mode

v1.0.0-RC4

• Support groovy style null safe expression
• Support pre-compile – fast load on GAE or other cloud stack
• Support template source properties enhancement
• Bug fixes:
  • Template cache cannot handle nested class with levels 2 or more
  • @invoke tag parse issue
  • Cannot compile template when reference to application class in WAR deployment

v1.0.0-RC3

• Bug fixes:
  • cannot do type cast in @for loop
  • escape with JSON format cause syntax error in javascript
  • @__simple__ template java source does not have setRenderArgs(Object...) method
  • Cannot use primitive type in @for loop
  • @args: Cannot declare array type
  • Logic error is RythmPlugin.isActionCall
  • Fix login form for Secure - thanks to Roman Dolgushin for the contribution
  • NPE when doing reverse url lookup in mail template - thanks to Sojin for the contribution

v1.0.0-RC2

• Support GAE mode
• A live demo application running on GAE for study
• Issues resolved:
  • Support TagContext in FastTags
  • Support FastTags default arg

v1.0.0-RC1

break changes

• @renderBody() does not render layout content now. It’s used to render tag body specifically. To render the layout content, use @doLayout() or @render() without section name parameter
• Automatic escape expression with html format if the template file name suffix is .html. If your code breaks, try to use @raw() tag to surround relevant template part or export your variable with .raw() extension.
  • Note auto-escape can cause template execution performance up to 3 times slower (still much faster than groovy) depending on how many expressions there are in your template, but we consider it a good trade-off to offer a secure default behavior. For those people who “need for speed”, simply wrap your entire template content in raw block: @raw(){your content comes here}.
• app/view as template root are no longer supported. All rythm template files must be put into app/rythm folder
• app/view/tags/rythm as tag root are no longer supported. Just put tag files as normal template file into app/rythm folder
• @section tag usage:
  • previously @section sectionName {...}
  • now @section(“sectionName”) {...}

New features

• Tag invocation decorations and chain them together
  • Cache tag invocation result
  • Cache controller action invocation result
  • Invoke tag/action call using relative path and import path
  • Specify body callback parameter spec
• Template content decorations and chain them together
  • Mark a template block to output raw expression
  • Mark a template block to escape expression using specific type
  • assign a block of template content into a variable
  • cache a template block
• Dynamic tag invocation with @invoke keyword
• Call tag body with parameter
• Include other template inline. And now you can reuse inline tag definitions across multiple views
• Call the current template (self) as a tag using @this directive
• @extends() directive now has new syntax to specify layout(parent) template
• Abort current template executing process and return to caller using @return
• Break the current loop using @break
• Continue the current loop using @continue
• New Cache4 annotation to mark on controller action method
• @ts() output timestamp in place
• @__simple__ mark the current template as simple template with no implicit variables/imports and does not extend other template
• An new demo application with 25 sample cases, with each one has template source and generated java source presented for quick study the Rythm engine

Small enhancements

• @verbatim(){} now escape html code
• @render[Section]() now accept default content/section block
• Support @for(int i = 0; i < 100; ++i) loop style
• New alias for Play specific keywords:
  • @url: previously @_u, url reverse lookup
  • @fullUrl: previously @_au, url reverse lookup with absolute path
  • @msg: previously @_m, i18n message lookup

Issues closed

• https://github.com/greenlaw110/Rythm/issues/6
• https://github.com/greenlaw110/Rythm/issues/21
• https://github.com/greenlaw110/Rythm/issues/14
• https://github.com/greenlaw110/play-rythm/issues/5
• https://github.com/greenlaw110/play-rythm/issues/1
• https://github.com/greenlaw110/play-rythm/pull/11

v0.9.7a

• Add two implicit variables: _rythmPlugin: the RythmPlugin instance; _rythm the RythmEngine instance
• Add RythmPlugin.isActionCall() api to allow template author to know whether it is inside a action invocation context

v0.9.7

• Support invoke controller action method in template

v0.9.6c

• Fix bug: Secure layout not found when loading the module directly in project folder instead of installing to play/modules

v0.9.6b

• Fix bug: Java FastTags stop working on v0.96.

v0.9.6a

• Emergency fix to ArgsParser: line breaks stay there which makes the generated html not valid as you have line breaks before <!DOCTYPE html>

v0.9.6

• Error report update to play-2.0 style
• Solve several issues in built-in tag/templates
• Precompile now build all rythm templates (So move templates to app/rythm folder)
• @UseRythmTemplateEngine and @UseSystemTemplateEngine annotation are deprecated now
• add @__exitIfNoClass__ directive to allow exit parsing process if no certain class exists
• bug fix: https://github.com/greenlaw110/Rythm/issues/15
• print out java source if compilation error on prod mode
• bug fix: NPE while scan tags in rare cases
• simplified class reloading logic in TemplateClassLoader.detectChange(...)
• improved template line number report in error reporting
• buf fix: https://github.com/greenlaw110/Rythm/issues/1
• support {} to enclose tag body
• support @{} to enclose script content.
• improved space/line break compact handling, now “//” line will not get merged with the following line
• improved debugging when error happened in the embedded class

v0.9.5b

• Bug fixes
  • https://github.com/greenlaw110/Rythm/issues/15
  • https://github.com/greenlaw110/Rythm/issues/13
  • https://github.com/greenlaw110/play-rythm/issues/4
• Add @__exitIfNoClass__ instruction to enable exit from parsing process if no class found

v0.9.5a

• Support app/rythm as view root
• Fix NPE when running in prod mode in rare cases
• template class cache hash calculation take plugin version into consideration
• Now you can call self tag inside that tag

v0.9

• The first public beta release