= !TracDev/ApiChanges/0.12 =

[[PageOutline(2-4,Summary,inline)]]

== New Dependencies ==
=== Babel (optional) ===

The internationalization support (i18) for Trac is depending on [http://babel.edgewall.org/ 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` ^[source:trunk/trac/wiki/api.py@8372:85#L72 (0.12)] [source:branches/0.11-stable/trac/wiki/api.py@8372:90#L77 (0.11)]^ ==== #IWikiMacroProvider
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` ^[source:trunk/trac/wiki/api.py@8429:64#L52 (0.12)] [source:branches/0.11-stable/trac/wiki/api.py@8429:69#L57 (0.11)]^ ==== #IWikiPageManipulator
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` ^[source:trunk/trac/resource.py@#L75 (0.12)]^ ==== #Resource

FIXME: just an example

=== New Interfaces ===
==== `trac.resource.IResourceManager` ^[source:trunk/trac/resource.py@#L28 (0.12)]^ ==== #IResourceManager

FIXME: just an example