Callmap Laravel Package

• implemented #120 Allow methods returning void or never to be mocked to throw an Exception

• Removed support for argument verification with xp-framework/unittest, library was discontinued in 2023
• Postponed removal of support for methods and functions without a return type declaration to 10.0.0, is still supported with 9.0.0
• Ensured compatibility with phpunit/phpunit 12.4 while keeping compatibility with the predecessor version 11.5

• Raised minimum required PHP version to 8.3.0
• Deprecated support for argument verification with xp-framework/unittest, will be removed with 9.0.0, library was discontinued in 2023

• Fixed optional nullable parameters with another case

• Restrict deprecated support for methods and functions without a return type to user-defined methods and functions
• Added #[\ReturnTypeWillChange] to generated proxy methods if a PHP-internal class is mocked to prevent deprecation notices, as their return types available via reflection are not always up to date, e.g. for \XSLTProcessor where reflection delivers no return type information for the single methods of this class

• Fixed bug with non-optional nullable parameters

• Prevent deprecation notice when calling get_parent_class() in generated proxy
• Replace deprecated call of is_callable(['parent', $someMethod])

• Added proper return type hints to bovigo\callmap\FunctionProxy::returns() and bovigo\callmap\FunctionProxy::throws() so the instance is further recognized as a callable.

• Provide more details about mocked method/function in deprecation notice when method or function doesn't have a return type declaration.
• Improve support for mocking \IteratorAggregate by providing specific return type information, as reflection doesn't provide a return type for \IteratorAggregate::getIterator().

HEADS UP

• Raised minimum required PHP version to 8.2
• Deprecated support for methods and functions without a return type declaration, will be removed with 10.0.0. In case no sensible return type can be specified a "mixed" return type continues to be supported. Starting with 10.0.0, providing a callmap to returns() containing methods that don't have a return type declaration will result in an InvalidArgumentException.

Other changes

• Added support for return type never

HEADS UP

• Raised minimum required PHP version to 8.0

Other changes

• Added support for intersection types
• Added support for combined union and intersection types

• Replace ReflectionParameter::getClass() by ::getType() (#22) PHP 8 deprecates the usage of ::getClass. So switch to an implementation using getType equal to the existing resolveUnionTypes function.

• Ensured compatibility with PHP 8 (#14)
  • Added support for union types
  • Added support for mixed type hint
  • Added support for static return type hint
• Ensured compatibility with PHPUnit 9.2 and later

• Verifications (verify()->wasCalled*(), verify()->receivedNothing()) now increase assertion counter of PHPUnit

HEADS UP

• raised minimum required PHP version to 7.3.0

Other changes

• fixed handling of return values from PHPUnit constraints in argument verification

• changed return type hint of NewCallable::of() and NewCallable::stub() to callable&\bovigo\callmap\FunctionProxy

• added phpstan annotations so instances created with bovigo\callmap\NewInstance::of() and bovigo\callmap\NewInstance::stub() have the proper intersection type

• added bovigo\callmap\ClassProxy::stub(string ...$methods) to allow stubbing of methods on a proxy instance that otherwise forwards method calls to the original class
• fixed bug that optional return type hints with builtin types aren't optional any more in mock instances

• fixed bug that optional return type hints aren't optional any more in mock instances

• prevent deprecation notice in PHP 7.4 by using proper methods

HEADS UP

• raised minimum required PHP version to 7.2.0
• removed bovigo\callmap\ClassProxy::mapCalls() and bovigo\callmap\FunctionProxy::mapCall(), deprecated since 3.2.0

Other changes

• lots of code cleanups

• fixed invalid handling of methods and functions with return type declared as void

BC breaks

• raised minimum required PHP version to 7.1.0
• ensured compatibility with PHPUnit 6.x

HEADS UP

• added bovigo\callmap\ClassProxy::returns(), bovigo\callmap\ClassProxy::mapCalls() is now an alias for this and should be considered deprecated
• added bovigo\callmap\FunctionProxy::returns(), bovigo\callmap\FunctionProxy::mapCall() is now an alias for this and should be considered deprecated

Other changes

• added bovigo\callmap\FunctionProxy::throws()

• removed usage of call_user_func_array(), instead call functions and methods directly
• added shortcut to prevent iterating over implemented interfaces and parent classes when no return type for a method can be detected
• minor doc comment fixes

• introduced possibility to mock functions as callable
• bovigo\callmap\throws() now accepts all instances of \Throwable, not just \Exception

• fixed bug that optional string arguments with default values where generated wrong in callmap proxy

• fixed bug that return type hint self was not used correctly and lead to a fatal error when creating callmap instances of interfaces or classes using such a return type hint

• switch recommendation from xp-framework/core to xp-framework/unittest

BC breaks

• raised minimum required PHP version to 7.0.0
• introduced scalar type hints and strict type checking
• bovigo\callmap\NewInstance::of() and bovigo\callmap\NewInstance::stub() now throw a bovigo\callmap\ProxyCreationFailure instead of \ReflectionException when creation of proxy fails

Other changes

• added support scalar type hints

• added support for variadic arguments, fixes #9

• fixed bug that mapping a return value to null called original method instead of returning null

• raised minimum required PHP version to 5.6.0
• added support for argument verification with bovigo/assert
• added support for PHP 7 return type hints
• bovigo\callmap\Verification is now automatically blacklisted in PHPUnit and will not appear in PHPUnit error stacks any more

• added support for argument verification with xp-framework/core

• fixed conversion spec in parameter error message

• fixed bug with optional default value null in user defined classes

• failing argument verification now also lists the name of the argument, not just its position, fixes #2
• fixed bug with optional array parameters
• onConsecutiveCalls() now falls back to the default return value in case a method gets invoked more often than results are defined
• fixed #4: onConsecutiveCalls() should allow callables which are executed
• fixed #5: returning a callable requires another callable by providing bovigo\callmap\wrap()

• added bovigo\callmap\verify() as possibility to verify an expected call amount as well as expected arguments
• retrieving call for a method which doesn't exist or is not applicable for mapping now throws an \InvalidArgumentException
• retrieving received arguments for a method which doesn't exist or is not applicable for mapping now throws an \InvalidArgumentException
• changed API status for bovigo\callmap\Proxy::callsReceivedFor() to internal, use verify()->was*() instead
• changed API status for bovigo\callmap\Proxy::argumentsReceivedFor() to internal, use verify()->received*() instead

• calling bovigo\callmap\NewInstance::*() with a final class now throws an \InvalidArgumentException
• passing a method within the callmap to bovigo\callmap\Proxy::mapCalls() which doesn't exist or is not applicable for mapping now throws an \InvalidArgumentException

• added automatic return of instance when return type hint denotes a type within the type hierarchy of the proxied class
• renamed bovigo\callmap\Proxy::argumentsReceived() to bovigo\callmap\Proxy::argumentsReceivedFor()
• fixed missing & for parameters that must be passed by reference

• added possibility to force a method to throw an exception using bovigo\callmap\throws()
• added bovigo\callmap\NewInstance::classname() to retrieve the name of the generated proxy
• added bovigo\callmap\onConsecutiveCalls() for passing a list of invocation results, removing api status from bovigo\callmap\InvocationResults

• Initial release.