CHANGELOG

develop branch

New

• Added support for inspecting class and object properties
  • added get_class_properties()
  • added get_object_properties()
  • added has_class_properties()
  • added has_object_properties()
  • added FilterClassProperties::from()
  • added FilterObjectProperties::from()
  • added FilterProperties helper class
  • added HasClassProperties::check()
  • added HasObjectProperties::check()
  • added HasFilteredProperties helper class
  • added IsClassProperty helper class
  • added IsObjectProperty helper class
• Added support for a formal approach to writing IsXXX() classes
  • added Check interface
  • added ListCheck interface
  • added ListCheckHelper trait
• Added Check and ListCheck support to existing classes
  • added IsStringy::check()
  • is_stringy() now uses IsStringy::check()
  • IsList now implements Check and ListCheck
  • IsListyObject now implements Check and ListCheck
• Added a whole bunch of type checks, originally from our Defensive library:
  • added IsArray::check()
  • added IsArray::checkList()
  • added IsArray::inspect()
  • added IsArray::inspectList()
  • added check_is_array() convenience function
  • added check_is_array_list() convenience function
  • added IsAssignable::check()
  • added IsAssignable::checkList()
  • added IsAssignable::inspect()
  • added IsAssignable::inspectList()
  • added check_is_assignable() convenience function
  • added check_is_assignable_list() convenience function
  • added IsBoolean::check()
  • added IsBoolean::checkList()
  • added IsBoolean::inspect()
  • added IsBoolean::inspectList()
  • added check_is_boolean() convenience function
  • added check_is_boolean_list() convenience function
  • added IsCallable::check()
  • added IsCallable::checkList()
  • added IsCallable::inspect()
  • added IsCallable::inspectList()
  • added check_is_callable() convenience function
  • added check_is_callable_list() convenience function
  • added IsCompatibleWith::check()
  • added IsCompatibleWith::checkList()
  • added IsCompatibleWith::inspect()
  • added IsCompatibleWith::inspectList()
  • added check_is_compatible_with() convenience function
  • added check_is_compatible_with_list() convenience function
  • added IsDefinedClass::check()
  • added IsDefinedClass::checkList()
  • added IsDefinedClass::inspect()
  • added IsDefinedClass::inspectList()
  • added check_is_defined_class() convenience function
  • added check_is_defined_class_list() convenience function
  • added IsDefinedInterface::check()
  • added IsDefinedInterface::checkList()
  • added IsDefinedInterface::inspect()
  • added IsDefinedInterface::inspectList()
  • added check_is_defined_interface() convenience function
  • added check_is_defined_interface_list() convenience function
  • added IsDefinedObjectType::check()
  • added IsDefinedObjectType::checkList()
  • added IsDefinedObjectType::inspect()
  • added IsDefinedObjectType::inspectList()
  • added check_is_defined_object_type() convenience function
  • added check_is_defined_object_type_list() convenience function
  • added IsDefinedTrait::check()
  • added IsDefinedTrait::checkList()
  • added IsDefinedTrait::inspect()
  • added IsDefinedTrait::inspectList()
  • added check_is_defined_trait() convenience function
  • added check_is_defined_trait_list() convenience function
  • added IsDouble::check()
  • added IsDouble::checkList()
  • added IsDouble::inspect()
  • added IsDouble::inspectList()
  • added check_is_double() convenience function
  • added check_is_double_list() convenience function
  • added IsEmpty::check()
  • added IsEmpty::checkList()
  • added IsEmpty::inspect()
  • added IsEmpty::inspectList()
  • added check_is_empty() convenience function
  • added check_is_empty_list() convenience function
  • added IsIndexable::check()
  • added IsIndexable::checkList()
  • added IsIndexable::inspect()
  • added IsIndexable::inspectList()
  • added check_is_indexable() convenience function
  • added check_is_indexable_list() convenience function
  • added IsInteger::check()
  • added IsInteger::checkList()
  • added IsInteger::inspect()
  • added IsInteger::inspectList()
  • added check_is_integer() convenience function
  • added check_is_integer_list() convenience function
  • added IsLogical::check()
  • added IsLogical::checkList()
  • added IsLogical::inspect()
  • added IsLogical::inspectList()
  • added check_is_logical() convenience function
  • added check_is_logical_list() convenience function
  • added IsNull::check()
  • added IsNull::checkList()
  • added IsNull::inspect()
  • added IsNull::inspectList()
  • added check_is_null() convenience function
  • added check_is_null_list() convenience function
  • added IsNumeric::check()
  • added IsNumeric::checkList()
  • added IsNumeric::inspect()
  • added IsNumeric::inspectList()
  • added check_is_numeric() convenience function
  • added check_is_numeric_list() convenience function
  • added IsObject::check()
  • added IsObject::checkList()
  • added IsObject::inspect()
  • added IsObject::inspectList()
  • added check_is_object() convenience function
  • added check_is_object_list() convenience function
  • added IsObjectOfType::check()
  • added IsObjectOfType::checkList()
  • added IsObjectOfType::inspect()
  • added IsObjectOfType::inspectList()
  • added check_is_object_of_type() convenience function
  • added check_is_object_of_type_list() convenience function
  • added IsPcreRegex::check()
  • added IsPcreRegex::checkList()
  • added IsPcreRegex::inspect()
  • added IsPcreRegex::inspectList()
  • added check_is_pcre_regex() convenience function
  • added check_is_pcre_regex_list() convenience function
  • added IsResource::check()
  • added IsResource::checkList()
  • added IsResource::inspect()
  • added IsResource::inspectList()
  • added check_is_resource() convenience function
  • added check_is_resource_list() convenience function
• Added type-hinting / strict type declaration support for entities:
  • added empty Entity interface
• Added immutable support to entities
  • added ReadOnlyForeverException exception
  • added setReadOnlyForever() to WriteProtectableEntity interface
  • WriteProtectableEntity::setReadWrite() must now throw ReadOnlyForeverException if setReadOnlyForever() has been called
  • added setReadOnlyForever() to WriteProtectTab trait
  • WriteProtectTab::setReadWrite() now throws ReadOnlyForeverException if WriteProtectTab::setReadOnlyForever() has been called
• Added support for iterating into the contents of lists
  • added RecursiveTraverse::using()

Refactor

Before refactoring, we checked Packagist to make sure that these changes would not break anything that depends upon The Missing Bits.

• Moved several classes from TypeInspectors to TypeChecks
  • moved IsList
  • moved IsListyObject
• Move away from __invoke() methods for objects
  • in practice, using objects via their __invoke() methods results in code that's hard to read and understand
  • we're switching to having the object's main method be the same as the class name
  • FilterBacktrace::__invoke() is now FilterBacktrace::filterBacktrace()
  • GetArrayTypes::__invoke() is now GetArrayTypes::getArrayTypes()
  • GetCaller::__invoke() is now GetCaller::getCaller()
  • GetClassTraits::__invoke() is now GetClassTraits::getClassTraits()
  • GetClassTypes::__invoke() is now GetClassTypes::getClassTypes()
  • GetDuckTypes::__invoke() is now GetDuckTypes::getDuckTypes()
  • GetNamespace::__invoke() is now GetNamespace::getNamespace()
  • GetNumericType::__invoke() is now GetNumericType::getNumericType()
  • GetObjectTypes::__invoke() is now GetObjectTypes::getObjectTypes()
  • GetPrintableType::__invoke() is now GetPrintableType::getPrintableType()
  • GetStrictTypes::__invoke() is now GetStrictTypes::getStrictTypes()
  • GetStringDuckTypes::__invoke() is now GetStringDuckTypes::getStringDuckTypes()
  • GetStringTypes::__invoke() is now GetStringTypes::getStringTypes()
  • StripNamespace::__invoke() is now StripNamespace::stripNamespace()
• Move away from 'is_XXX()' for check functions
  • we want to avoid current and future clashes with PHP core
  • moved is_list() to check_is_list()
  • moved is_listy_object() to check_is_listy_object()
  • moved is_stringy() to check_is_stringy()

v1.9.0

Released Sun 31st July 2016.

New

• Added support for detecting lists
  • added is_list()
  • added IsList::check()
  • added is_listy_object()
  • added IsListyObject::check()

v1.8.0

Released Sun 31st July 2016.

New

• Added support for iterating over lists
  • added traverse_array()
  • added TraverseArray::using()
  • added traverse_list()
  • added TraverseList::using()
  • added traverse_object()
  • added TraverseObject::using()
• Added additional type inspections
  • added is_stringy()
• Additional string functions to help build PHP code snippets
  • added quote_index()
  • added quote_property()

v1.7.0

Released Sun 19th June 2016.

New

• Added some helpers to overcome array_merge() performance issues.
  • added array_append_values()
  • added array_merge_keys()

v1.6.1

Released Sun 12th June 2016.

Fixes

• Make sure $flags for GetPrintableType are always valid
  • if we get invalid flags, we use the default flags

v1.6.0

Released Sun 12th June 2016.

New

• Added some interfaces to map objects to PHP types / inspect objects as you'd inspect a PHP type
  • added CanBeEmpty
  • added Listable
  • added Logical

v1.5.1

Released Wed 1st June 2016.

Fixes

• GetDuckTypes now also returns numeric for PHP double and integer types

v1.5.0

Released Tue 31st May 2016.

New

• Extra duck type features
  • added GetStringDuckTypes
  • added numeric duck type; can be returned by
  • GetDuckTypes
  • GetStringDuckTypes

Fixes

• Performance improvements to:
  • GetDuckTypes
• Scrutinizer-CI suggested fixes to:
  • GetClassTraits
  • GetClassTypes
  • GetNamespace
  • GetPrintableType
  • GetStrictTypes
  • GetStringTypes
  • StripNamespace
  • get_caller

v1.4.0

Released Tue 24th May 2016.

New

• Added support for inspecting class, interface, trait and object names
  • added GetNamespace
  • added StripNamespace
• Added support for working with PHP stack traces
  • added FilterBacktrace
  • added GetCaller
  • added get_caller()
  • added get_caller_from_trace()
  • added StackFrame

v1.3.0

Released Sunday 22nd May 2016.

New

• Added a richer set of type inspectors, based on code originally from ganbarodigital/php-defensive
  • added GetArrayTypes
  • added GetClassTraits
  • added GetClassTypes
  • added GetDuckTypes
  • added GetObjectTypes
  • added GetNumericType
  • added GetStrictTypes
  • added GetStringTypes

v1.2.0

Released Monday 9th May 2016.

New

• Added support for entities that can switch between a read-only mode and read-write
  • Added ReadOnlyException
  • Added WriteProtectableEntity interface
  • Added WriteProtectedEntity interface
  • Added WriteProtectTab trait

v1.1.1

Released Tuesday 19th April 2016.

Docs

• Switched to downloading template from Github
• Switched to Stuart's fork of Couscous

v1.1.0

Released Sunday 17th April 2016.

New

• Added GetPrintableType

v1.0.0

Released Sunday 17th April 2016.

New

• Added vnsprint()