mirror of
https://github.com/kamilwylegala/cakephp2-php8.git
synced 2025-01-19 11:06:15 +00:00
da79dff7d7
- Dispatcher sets a Controller::here variable with the real URL used to access the page, so that tag generators can that use an url (linkTo and formTag for example) use the real url, not guess it from the controller and action names which often fails - Log class works more reliably and a LogError() shortcut function was added - Nstring class added, to store string-related functions (there are just four yet, including a random password generator and an string-to-array splitter - SimpleTest library (with Rephlux) included in /vendors; I've tweaked SimpleScorer::inCli() function, because it didn't work on my setup, it should work everywhere now (it checks for empty REQUEST_METHOD, which should only be empty in CLI) git-svn-id: https://svn.cakephp.org/repo/trunk/cake@248 3807eeeb-6ff5-0310-8944-8be069107fe0
110 lines
4.7 KiB
Text
110 lines
4.7 KiB
Text
SimpleTest
|
|
==========
|
|
You probably got this package from...
|
|
http://sourceforge.net/projects/simpletest/
|
|
|
|
If there is no licence agreement with this package please download
|
|
a version from the location above. You must read and accept that
|
|
licence to use this software. The file is titled simply LICENSE.
|
|
|
|
What is it? It's a framework for unit testing, web site testing and
|
|
mock objects for PHP 4.2.0+.
|
|
|
|
If you have used JUnit you will find this PHP unit testing version very
|
|
similar. Also included is a mock objects and server stubs generator.
|
|
The stubs can have return values set for different arguments, can have
|
|
sequences set also by arguments and can return items by reference.
|
|
The mocks inherit all of this functionality and can also have
|
|
expectations set, again in sequences and for different arguments.
|
|
|
|
A web tester similar in concept to JWebUnit is also included. There is no
|
|
JavaScript or tables support, but forms, authentication, cookies and
|
|
frames are handled.
|
|
|
|
You are not tied to just using SimpleTest, though. The mocks and stubs
|
|
will work with other test frameworks and SimpleTest can use other
|
|
framework's (PHPUnit, PEAR::PhpUnit) test cases as it's own. The
|
|
web browser part of the web tester can also be used independently either
|
|
in other testers or as part of a scripting solution.
|
|
|
|
You can see a release schedule at http://www.lastcraft.com/overview.php
|
|
which is also copied to the documentation folder with this release.
|
|
A full PHPDocumenter API documentation exists at
|
|
http://simpletest.sourceforge.net/.
|
|
|
|
The user interface is minimal
|
|
in the extreme, but a lot of information flows from the test suite.
|
|
After version 1.0 we will release a better web UI, but we are leaving XUL
|
|
and GTk versions to volunteers as everybody has their own opinion
|
|
on a good GUI, and we don't want to discourage development by shipping
|
|
one with the toolkit.
|
|
|
|
You are looking at a first full release. The unit tests for SimpleTest
|
|
itself can be run here...
|
|
|
|
simpletest/test/unit_tests.php
|
|
|
|
And tests involving live network connections as well are here...
|
|
|
|
simpletest/test/all_tests.php
|
|
|
|
The full tests will typically overrun the 8Mb limit usually allowed
|
|
to a PHP process. A workaround is to run the tests on the command
|
|
with a custom php.ini file if you do not have access to your server
|
|
version.
|
|
|
|
You will have to edit the all_tests.php file if you are accesssing
|
|
the internet through a proxy server. See the comments in all_tests.php
|
|
for instructions.
|
|
|
|
The full tests read some test data from the LastCraft site. If the site
|
|
is down or has been modified for a later version then you will get
|
|
spurious errors. A unit_tests.php failure on the other hand would be
|
|
very serious. As far as we know we haven't yet managed to check in any
|
|
test failures so please correct us if you find one.
|
|
|
|
Even if all of the tests run please verify that your existing test suites
|
|
also function as expected. If they don't see the file...
|
|
|
|
HELP_MY_TESTS_DONT_WORK_ANYMORE
|
|
|
|
This contains information on interface changes. It also points out
|
|
deprecated interfaces so you should read this even if all of
|
|
your current tests appear to run.
|
|
|
|
There is a documentation folder which contains the core reference information
|
|
in English and French, although this information is fairly basic.
|
|
You can find a tutorial on http://www.lastcraft.com/first_test_tutorial.php
|
|
to get you started and this material will eventually become included
|
|
with the project documentation. A French translation exists at
|
|
http://www.onpk.net/index.php/2005/01/12/254-tutoriel-simpletest-decouvrir-les-tests-unitaires.
|
|
|
|
If you download and use and possibly even extend this tool, please let us
|
|
know. Any feedback, even bad, is always welcome and we will work to get
|
|
your suggestions into the version one release. Ideally please send your
|
|
comments to...
|
|
|
|
simpletest-support@lists.sourceforge.net
|
|
|
|
...so that others can read them too. We usually try to respond within 48
|
|
hours.
|
|
|
|
There is no change log as yet except at Sourceforge. You can visit the
|
|
release notes to see the completed TODO list after each cycle and also the
|
|
status of any bugs, but if the bug is recent then it will be fixed in CVS only.
|
|
The CVS check-ins always have all the tests passing and so CVS snapshots should
|
|
be pretty usable, although the code may not look so good internally.
|
|
|
|
Oh, yes. It is called "Simple" because it should be simple to
|
|
use. We intend to add a complete set of tools for a test first
|
|
and "test as you code" type of development. "Simple" does not
|
|
mean "Lite" in this context.
|
|
|
|
Thanks to everyone who has sent comments and offered suggestions. They
|
|
really are invaluable, but sadly you are too many to mention in full.
|
|
Thanks to all on the advanced PHP forum on SitePoint, especially Harry
|
|
Feucks. Early adopters are always an inspiration.
|
|
|
|
yours Marcus Baker, Jason Sweat and Perrick Penet.
|
|
--
|
|
marcus@lastcraft.com
|