TracDev/ApiChanges/0.12

Summary

1. New Dependencies
   1. Babel (optional)
2. Modifications made to the 0.11 API
   1. Modified Interfaces
      1. IWikiMacroProvider ^{(0.12)​ (0.11)​}
      2. IWikiPageManipulator ^{(0.12)​ (0.11)​}
   2. Other Changes to the 0.11 API
3. New in the 0.12 API
   1. New Classes
      1. trac.resource.Resource ^(0.12)​
   2. New Interfaces
      1. trac.resource.IResourceManager ^(0.12)​

New Dependencies

Babel (optional)

The internationalization support (i18) for Trac is depending on ​Babel.

It's perfectly fine to go on using Trac without it, but then of course the interface will remain in English.

Modifications made to the 0.11 API

Modified Interfaces

IWikiMacroProvider ^{(0.12)​ (0.11)​}

Added an optional argument args to IWikiMacroProvider.expand_macro() to contain the shebang-line arguments when using wiki processor syntax. For example, with the following content:

{{{
#!MyMacro test=123 other="This is a text"
This is the content.
}}}

The macro MyMacro will have its expand_macro() called with args={'test': '123', 'other': 'This is a text'}.

See also #8204.

IWikiPageManipulator ^{(0.12)​ (0.11)​}

This interface has not actually been changed, but the implementation has been fixed so that it actually does what it promises, that is, validate a wiki page after it's been populated from user input. Previously, page.text would contain the old text, and the new text would typically be retrieved with req.args.get('text') as a workaround.

The page now has the new text in page.text, and the old text in page.old_text.

See also #7731.

Other Changes to the 0.11 API

New in the 0.12 API

New Classes

trac.resource.Resource ^(0.12)​

FIXME just an example

New Interfaces

trac.resource.IResourceManager ^(0.12)​

FIXME just an example