Skip to content
leesbian edited this page Jan 3, 2013 · 14 revisions

= Mage_Test

A community owned and driven unit and integration test framework for Magento

== Documentation & Support

== Goals

== Getting Started

Mage_Test is designed to be installed and updated via modman.

Before installing, you should consider if you think that you will be contributing fixes and tests back to Mage_Test. If you believe that you will, you should follow the installation instructions for contributors

First, make sure that you have both modman and PHPUnit installed (follow their respective installation procedures if you do not)

If you haven't already done so, change directory to your Magento document root, and initialise modman

$> cd /path/to/your/magento/install $> modman init

Next, install Mage_Test via modman :

$> modman clone git://github.com/mageplus/Mage_Test.git

Next, you need to create a new, empty database for Mage_Test to use where database operations occur. The usual convention is to name this the same as your production database with the suffix of "_tests" (eg, if your production database is named "magento", your tests database should be named "magento_tests")

Finally, edit the local.xml.phpunit file (that now appears in app/etc) that Mage_Test uses for it's configuration and enter the relevant details for the test environment - this is the same format as local.xml, but specifically for the test environment

You can now run Mage_Test :

$> phpunit UnitTests.php

== Updating

Upgrading Mage_Test is simple, quick, and easy :

$> cd /path/to/your/magento/install $> modman update Mage_Test

== Next Steps

The best place to get documentation is at https://github.com/mageplus/Mage_Test/wiki/documentation

If you have any questions, please email the mailing list at http://groups.google.com/group/magetest-users

== Bugs Reports & Contributing

== Feature Requests

Feature requests can be made by submitting an issue - feature requests will be labelled with the label "enhancement" and initially as "unconfirmed". At this point the feature request will be reviewed and assigned to a (release) milestone - this is the release in which you can expect to see your feature. The issue relating to this feature will change status to "confirmed" as soon as work begins on it.

If you are a developer, you can also submit a pull request containing the feature you wish to contribute.

If you are going to submit a pull request, please read the contributing guide: https://github.com/mageplus/Mage_Test/wiki/Contributing

== Copyright

Copyright (c) 2012, 2013 Mage+ Ltd. See LICENSE.txt for details.

Clone this wiki locally