Typed data

[gapple]

New classes make constructing a value to pass to Serializer and working with data from Parser easier.
Tuple types (Item and InnerList) are still accessible by array indexes to be backwards compatible with older code ($item->value === $item[0], $item->parameters === $item[1])

• Item
• OuterList
• InnerList
• Dictionary
• Parameters

Serializer::serializeItem(new Item(true));
// ?1
Serializer::serializeItem(new Item('towel', (object) ['panic' => false']));
// "towel";panic=?0

---

Resolves #19

[codecov]

Codecov Report

Base: 100.00% // Head: 100.00% // No change to project coverage 👍

Coverage data is based on head (da7f48a) compared to base (489626c).
Patch coverage: 100.00% of modified lines in pull request are covered.

Additional details and impacted files

@@             Coverage Diff              @@
##             develop       #29    +/-   ##
============================================
  Coverage     100.00%   100.00%            
- Complexity       103       169    +66     
============================================
  Files              5        11     +6     
  Lines            246       391   +145     
============================================
+ Hits             246       391   +145     

Flag	Coverage Δ
phpunit	100.00% <100.00%> (ø)

Flags with carried forward coverage won't be shown. Click here to find out more.

Impacted Files	Coverage Δ
src/Dictionary.php	100.00% <100.00%> (ø)
src/InnerList.php	100.00% <100.00%> (ø)
src/Item.php	100.00% <100.00%> (ø)
src/OuterList.php	100.00% <100.00%> (ø)
src/Parameters.php	100.00% <100.00%> (ø)
src/Parser.php	100.00% <100.00%> (ø)
src/Serializer.php	100.00% <100.00%> (ø)
src/TupleTrait.php	100.00% <100.00%> (ø)

Help us with your feedback. Take ten seconds to tell us how you rate us. Have a feature suggestion? Share it here.

☔ View full report at Codecov.
📢 Do you have feedback about the report comment? Let us know in this issue.

[gapple]

Some static fromArray() methods would be helpful to convert simple arrays to valid structures for serializing.

• OuterList::fromArray() - convert an array of scalar values to an array of Items or InnerLists
• InnerList::fromArray() - convert an array of scalar values to an array of Items
• Dictionary::fromArray() - convert an associative array to an array of Items. Numeric indexes could throw an exception here, but leave validation of string keys to Serializer
• Parameters::FromArray() - basically a wrapper for (object) $array, but an exception for numeric indexes could be helpful.

[gapple]

It's potentially a BC break that Parser:parseItem() and Parser::parseList() methods return objects instead of arrays.

The new classes still allow access in the same way as with the untyped return values (via ArrayAccess, and the OuterList class is iterable), so code making use of them shouldn't need to be changed, unless they pass on the value to somewhere that is typed to expect an array.