merged branch phmLabs/documentation_return (PR #483)

Commits
-------

389f2c2 Changed mode from 0755 to 0644
c48bd2f Fixed wrong used PHPDoc tags

Discussion
----------

Fixed wrong used PHPDoc tags

@param was used instead of @return

---------------------------------------------------------------------------

by fabpot at 2011/10/25 05:47:59 -0700

Can you revert the mode change (from 0644 to 0755)?

added more unit tests for defined and default

fixed the "defined" test and the "default" filter

added more unit tests (some do not pass... yet)

added missing supported charset for htmlspecialchars

fixed deep nested defined tests

removed unneeded complexity in GetAttr node

added a way to change Twig's options when running integration tests (updated tests accordingly)

Revert "fixed exception"

This reverts commit df47659e9de71a48a24f31ed0cc16a2674a06d43.

fixed example in doc (closes #484)

Changed mode from 0755 to 0644

added some references to the doc

Fixed wrong used PHPDoc tags

reverted mode change from previous commit

merged branch phmLabs/Twig_NodeInterface_Bug (PR #482)

Commits
-------

c91357d Moved interfaces

Discussion
----------

Moved interfaces

The Countable and IteratorAggregate interfaces have to be part of the Twig_NodeInterface as the Twig_NodeInterface is used as a typehint and the function tries to iterate over its elements.

E.g:

Twig_NodeTraverser::traverseForVisitor

foreach ($node as $k => $n)

Revert "added a tip for the block tag"

This reverts commit 1a2175fc4992b74a473845eab0972d464086398f.

Moved interfaces

added a tip for the block tag

merged branch yegeniy/patch-1 (PR #474)

Commits
-------

cf03a65 add another example add another example to constant.rst

Discussion
----------

add another example

An example for using the `constant` function

---------------------------------------------------------------------------

by yegeniy at 2011/10/19 09:48:37 -0700

Should be ready.

---------------------------------------------------------------------------

by nikic at 2011/10/19 10:58:01 -0700

I think you should just add that as a line to the other example, so you got this in the end:

```rst
``constant``
============

``constant`` returns the constant value for a given string:

.. code-block:: jinja

    {{ some_date|date(constant('DATE_W3C')) }}
    {{ constant('Namespace\\Classname::CONSTANT_NAME') }}
```

---------------------------------------------------------------------------

by fabpot at 2011/10/21 07:24:32 -0700

That's indeed a good addition to the doc. Can you squash your commits in to one before I merge this pull request? Thanks.

---------------------------------------------------------------------------

by yegeniy at 2011/10/22 06:28:58 -0700

Thanks!

fixed typos

changed the way extensions are loaded (addFilter/addFunction/addGlobal/addTest/addNodeVisitor/addTokenParser/addExtension can now be called in any order)

add another example
add another example to constant.rst

added Twig_Environment::display()

simplified some code

added more unit tests

added an optimization when the same temporary variable would have been created twice

fixed doc

made the escape filter smarter when the encoding is not supported by PHP

added a convert_encoding filter

added a Twig_Node_Expression_DefaultFilter to replace the current way of dealing with default filters

added public getters on the environment to be able to get various stuff

fixed exception

fixed download page in the docs

merged branch trompette/patch-1 (PR #465)

Commits
-------

0451cfd typo

Discussion
----------

typo

typo

updated CHANGELOG

refactored Twig_Node_Expression_GetAttr for better readability of compiled templates

optimized variable access when possible

refactored 'defined' test and 'default' filter

Node manipulations have been moved outside the compile() method.
That's needed if we want to be able to visit all nodes that will be
compiled.

optimized lexer by pre-computing regexes

made an optimization by removing array_merge usage

bumped version to 1.4.0-DEV

prepared the 1.3.0-RC1 release

updated CHANGELOG

prepared the 1.3.0-RC1 release

fixed a unit test for PHPUnit 3.6

fixed optimizer

fixed wrong node type for the for tag

added an optimization for simple variables output

fixed hardcoded name escaping

removed usage of PHP 5.3 __DIR__

fixed composer version

merged branch igorw/composer (PR #452)

Commits
-------

bd04de2 [composer] add composer.json

Discussion
----------

[composer] add composer.json

merged branch phiamo/master (PR #454)

Commits
-------

5fa0094 Added Capability to format DateInterval via twig date filter

Discussion
----------

Added Capability to format DateInterval via twig date filter

hi,
i was wondering why twig couldn't format my DateInterval and added it.

Either this is ok for you or we should add something similar for DateInterval because it uses a little bit different syntax to format its string (e.g. prepend with "%")

Cheers Phil

fixed unit test broken by previous merge

merged branch Sannis/patch-1 (PR #455)

Commits
-------

68ec644 FloorDiv (//) should return integer value according to documentation

Discussion
----------

FloorDiv (//) should return integer value according to documentation

FloorDiv (//) should return integer value according to documentation

Added Capability to format DateInterval via twig date filter

[composer] add composer.json

added an optimization for the parent() function

added a note about the usage of Twig_Template methods

refactored documentation

simplified intro and added a not about the render() method in docs

fixed makup in doc

made a small optimization when a macro does not take any argument

added cache reloading when auto_reload is true and an extension has been modified

tweaked docs

tweaked previous merge

merged branch runfalk/master (PR #368)

Commits
-------

eb5c9fb Recipe code formatting fix. New recipe for improved APC bytecode support

Discussion
----------

APC recipe

A new recipe to support cache invalidation when using *APC* with *apc.stat* = 0 and compiled code caching turned on. One sometimes want to test things without restarting apache. This recipe overrides *writeCacheFile* in *Twig_Environment* and calls *apc_compile_file to refresh cache.

added the possibility to force the escaping of a string already marked as safe

added traits support for the parent function

allowed empty templates to be used as traits

bumped version to 1.3.0-DEV

prepared 1.2.0 release

prepared 1.2.0-RC1 release

added an exception for unclosed tags

updated CHANGELOG

merged branch maxromanovsky/master (PR #431)

Commits
-------

4b95621 Added: Countable interface support for empty test

Discussion
----------

Countable interface support for empty test

See [issue](https://github.com/fabpot/Twig/issues/430)

Added: Countable interface support for empty test

added more unit tests

removed some loop variable when using an if statement in a for loop

made a markup refactoring

fixed algorithm that determines if a template using inheritance is valid (no output between block definitions)

tweaked an error message

renamed a class in unit test to avoid confusion with PHPStorm

fixed resolveTemplate() method (we only catch loader exceptions)

added better support for encoding problems when escaping a string (available as of PHP 5.4)

From the PHP CHANGELOG:

The flag ENT_SUBSTITUTE makes invalid multibyte sequences be replaced by
U+FFFD (UTF-8) or &#FFFD; by htmlspecialchars and htmlentities. It is an
alternative to the default behavior, which just returns an empty string and to
ENT_IGNORE, which is a security risk. The behavior follows the recommendations
of Unicode Technical Report #36.

simplified previous merge

fixed CS

merged branch Brouznouf/patch-1 (PR #425)

Commits
-------

4dc490f Removing array_shift for optimisation.

Discussion
----------

Removing array_shift for optimisation.

For example we check if a template and use exception to redirect to a default template

Before : We checked ~1000 times => 100sec due to array_shift
After  : ~1sec

Removing array_shift for optimisation.

For example we check if a template and use exception to redirect to a default template

Before : We checked ~1000 times => 100sec due to array_shift
After  : ~1sec

fixed markup in the doc

added support for an array of templates to the "extends" tag

added a way to ignore a missing template when using the "include" tag

added support for an array of templates to the include tag

updated CHANGELOG

merged branch jturmel/master (PR #403)

Commits
-------

c2c01de Add bitwise operators to core

Discussion
----------

Added bitwise operators (and, xor, or) to core

* Added bitwise operators (and, xor, or) to core

---------------------------------------------------------------------------

by nikic at 2011/08/02 21:02:14 -0700

I'm not sure bitwise ops really belong into a templateing language...

---------------------------------------------------------------------------

by jturmel at 2011/08/02 21:06:02 -0700

That's a general statement to make without knowing why it was implemented at all... no one is forced to use them, however when you do need them, them not being available makes you have relegate something that should be in the view in the particular case I needed them, to be done in a controller instead, which would be quite a bit nastier in my case.

---------------------------------------------------------------------------

by nikic at 2011/08/02 23:23:30 -0700

@jturmel: I do not doubt that there are some cases where bitwise operations are useful. I can't think of one of the top of my head, though I imagine that it could be useful when using bitwise right management or something like that. What I was trying to say is, that I don't really believe that there are enough significant use cases for bitwise ops to justify adding them to the core (I know, "You Don't Have To Use It!", but it isn't good to clutter the core with features nearly no one uses). Maybe you could give an example of what you needed them for?

---------------------------------------------------------------------------

by jturmel at 2011/08/02 23:41:36 -0700

It would be one thing if I was implementing some operator that didn't normally exist in PHP itself, but it seems a bit odd to even say that it's cluttering it up, it's 3 lines of code that add 3 missing standard operators from PHP.

Simply put, I have an object that gets passed to the template that has many properties, these properties are bit values, I need to do checks on them to select/deselect various checkboxes in a grid... this is the cleanest way to do it without mudding up controller code with view logic.

---------------------------------------------------------------------------

by jalliot at 2011/08/03 01:42:56 -0700

Why not adding ``<<`` and ``>>`` then @jturmel?
I don't have a particular use case but I think that if Twig includes those 3 operators, it should also support these 2 to be "complete". What do you think?

---------------------------------------------------------------------------

by jturmel at 2011/08/03 06:07:46 -0700

Of course, if you guys think we need the shifting operators as well, we can... but modifying data in the view seems much less practical than the one's I added, although I did miss NOT.

---------------------------------------------------------------------------

by jalliot at 2011/08/03 06:16:38 -0700

I forgot about ``~`` but sure it should be included as well.
As for ``<<`` and ``>>``, they could also be used for verifying grant access for example in some implementations.
``{% if some_var << some_other_var & 1 %}``

replace file_exists() by is_file() as this is semantically more correct (we don't want dirs to match)

replaced usage of array_replace by array_merge (for 5.2 compatibility)

added the "attribute" function to allow getting dynamic attributes on variables