Fit Shelf for PHPFIT
INTRODUCTION
Fit Shelf is a reimplementation in PHP of the functionality of Fit Library as described in
the book "Fit for developing Software" of Rick Mugridge and Ward Cunningham,
mostly chapters 10 and 28. For usage documentation i refer to these chapters of this
excellent book and http://fit.c2.com., (*1)
Fit shelf is not a port of Fit Library. The reason to reimplement was that the porting
of the 1175 KB java source files of Fit Library (not including Fit and examples)
would have taken too much work. With only 53.2 KB in PHP source files[1] Fit Shelf is
much simpeler. As its name suggest is does not pretend to be a complete library,
but rather a small shelf. But easyer to understand, use and port. And written in PHP!, (*2)
SECURITY
Do not install in a production environment., (*3)
WARNING: Fit Shelf allows tests to access arbitrary properties and methods on the object under test.
It has no notion of authorization. Allowing end users to run self-modified tests may expose sensitive
data, cause fatal errors and leave the system in an undefined state., (*4)
INSTALLATION AND CONFIGURATION
SPECIAL FEATURES
-
Mixed data typing, (*9)
In order to support the mixed data typing of PHP, a special adapter
is included: PHPFIT_TypeAdapter_PhpTolerant.php. Because adapter is
meant to work with any type, it is used as a fallback whenever
type information is missing. In practice this means that
you can in most case simply run any tests and forget about data typing., (*10)
However, if you DO supply type information, this adapter will delegate
to the corresponding PhpFit data type adapter., (*11)
-
Support for not-yet-defined properties and __get, __set and __call magic methods, (*12)
Fit Library supports the direct usage of properties and methods
of the system under test from tests. With DoFixture if a method or
property does not exist, a fixture is loaded. But in PHP5,
if the right magic methods are implemented you may
get or set a property or call a method that does not exist.
And you may also set a property that is not defined at all., (*13)
In order to allow you to get, set and call unconditionally,
Shelf's DoFixture supports the fixture methods 'get', 'set' and 'call'
that do not default to fixure loading., (*14)
-
Adaptation to application meta models, (*15)
In Java an single meta model is prescibed by the Java Beans standard:
properties have getters, setters and maybe a field, meta data can be
obtained through Bean Descriptors and reflection., (*16)
In PHP there is not such a strict standard. The documentation and the
__get and __set magic methods suggest the meaning of properties,
but specific applications and frameworks may well follow a different
meta model. This will for example be the case with a one to one port
of the examples of of the book: they follow the Java Beans standard,
which is different from the way suggested by the documentation of PHP., (*17)
In order to support that, Shelf uses two layers of adapters, one
for the meta model, and a second for the actual typing. Currently
two MetaModel adapters are available:, (*18)
- PHPFIT_TypeAdapter_PhpTolerant for ordinary PHP objects using member variables
for properties. This is the default adapter used by Shelf fixtures
- PHPFIT_TypeAdapter_BeanTolerant for Beans-like objects using getter and setter
methods for accessing properties.
You may activate an adapter from your fixture class by adding the following method:, (*19)
protected function interpretTablesInit() {
parent::interpretTablesInit();
fitshelf\ClassHelper::adapterType('BeanTolerant');
}
Usually your tests will start with activating some subclass of fitshelf\DoFixture and
that fixture will run this method. From then on the other shelf fixtures that
your tests use will also use this adapter. Fixtures directly extending those
from PHPFIT need to add another method:, (*20)
static function getType($classOrObject, $name, $property) {
return fitshelf\ClassHelper::adapterType();
}
Fit Shelf provides subclasses for serveral PHPFIT fixtures that already have this method., (*21)
If the meta model of your own application (or framework) is different
you may implement your own type adapter using the adapters that come
with shelf as examples. If you use Composer you may autoload them using
the ClassLoader of Composer or the one from Fit Shelf.
Warning: The adapers will be refactored in order
to support strict typing for the php metamodel., (*22)
RELEASE NOTES
This beta has been adapted to PSR-0 name spacing and class loading.
If you have Fixtures running on a previous version of Fit Shelf you
will have to adapt them., (*23)
This beta does not include CalculateFixture and SetupFixture., (*24)
This beta does not include all examples ported from the tests described
in the book "Fit for developing Software". Please help by porting more
tests that are meant to run on Fit Library., (*25)
The Adapters should be refactored in order to support strict typing,
see PHPFIT_TypeAdapter_PhpTolerant.php., (*26)
Some smaller refactorings may be made with respect to reoccurring code., (*27)
Also see the ChangeLog in the doc folder., (*28)
SUPPORT (Dutch)
MetaClass biedt hulp en ondersteuning binnen Nederland bij onderhoud
en ontwikkeling van software, tests en fixtures.
Voor meer informatie kijk op http://www.metaclass.nl/, (*29)
COPYRIGHT AND LICENCE
Courtesy to Rick Mugridge for the functional specification of Fit Library
(http://sourceforge.net/projects/fitlibrary/) and the ideas behind it
to which MetaClass claims no rights., (*30)
This implementation (Fit Shelf) is Copyright (c) 2010-2012 H. Verhoeven Beheer BV,
holding of MetaClass Groningen Nederland., (*31)
Licensed under the GNU General Public License version 3 or later., (*32)
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version., (*33)
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details., (*34)
IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS
THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY
GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE
USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF
DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD
PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS),
EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF
SUCH DAMAGES., (*35)
[1]: not including CalculateFixture and SetupFixture.
Fit Shelf is not tested with Fitnesse. Is not inteded to work the
same as Fit Library, only to work like descibed in the book, but with the
special features as described here., (*36)
Wallogit.com
