Added auto-casting feature

[damianopetrungaro]

Specifying a 'mapTo' key in an entry of the array returned by getCols method in TableInterface, the value will be casted using the settype php function.

This is incredibly useful when using type hinting in an entity (an example here)

Example here from EmployeeTable.php in tests

[pmjones]

It's very difficult to see the substantial changes when they are mixed in with the style changes. For example, Atlas attempts to follow PSR-2, so that means the brace placement should be left alone. If you could, for Atlas PRs, please attempt to follow the existing style.

Once the style changes back, the diff will be much smaller, and I will be able to examine the auto-casting portion of the PR.

[damianopetrungaro]

All the commits follow PSR2 standard.
Anyway i understand that may be difficult to see the substantial changes.

The substantial changes are in those commits:
1 2 3

If you prefer i will go back and push only the 'useful' commits.
😄

[damianopetrungaro]

Cleaned up!

[pmjones]

All right, this is a lot easier to review, thanks!

I can see now that there is a significant problem. The "Table" classes are auto-generated by the CLI tooling; if you change a table at the database and use the CLI tooling to regenerate the class (which is normal and expected) then all the mapTo keys will be lost.

If you want casting of values coming out of the database, and casting of them when they go back into the database, you will probably want to add some logic to a custom TableEvents class. In particular, you'll want to work with modifySelectedRow() (to cast the values coming out of the database), beforeInsert() or modifyInsert(), and beforeUpdate() or modifyUpdate() (to cast the values going back to the database).

It occurs to me that there's an opportunity here to build the auto-caster as a plugin or class of its own, that can be either injected into or used statically within the TableEvents class.

Does that begin to help?

[damianopetrungaro]

The Table Event is perfect for solve this kinda problem imo, i missed it.

Thanks for clarifying!

[pmjones]

i missed it.

Easy to miss since I have failed to document it (along with so much else). Thanks for the PR, and for your patience!