Skip to content
This repository was archived by the owner on Mar 17, 2020. It is now read-only.
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
51 changes: 47 additions & 4 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,10 +1,14 @@
[Browser Automated Tests for Joomla! CMS(covering Users and Content features - GSoC1 16)](https://summerofcode.withgoogle.com/projects/#5724182314745856)
[Browser Automated Tests for Joomla! CMS(covering Users and Content features - GSoC 16)](https://summerofcode.withgoogle.com/projects/#5724182314745856)
===

Abstract
---
System development nowadays more than ever starts to look for automated test methods. There are several main drivers for this trend -need for faster design‐develop‐test‐analysis cycle, push for higher quality, increasing complexity of systems and their integration and last but not least ever‐rising costs of manual testing. Software testing itself is very wide field with topics ranging from compliance frameworks.

System development nowadays more than ever starts to look for automated test methods. There are several main drivers for this trend,
+ Need for faster design‐develop‐test‐analysis cycle
+ Push for higher quality
+ Increasing complexity of systems and their integration and last but not least
+ Ever‐rising costs of manual testing

Automation Testing means using an automation tool to execute test case suite. The automation software can also enter test data into the System Under Test, compare expected and actual results and generate detailed test reports.

Test Automation demands considerable investments of money and resources. Successive development cycles will require execution of same test suite repeatedly. Using a test automation tool it's possible to record this test suite and re-play it as required. Once the test suite is automated, no human intervention is required.
Expand Down Expand Up @@ -39,6 +43,8 @@ BDD Testing with Gherkin and Codeception
* Examples

### Example
Create a .feature using command `tests/vendor/bin/codecept generate:feature acceptance content`

File `content.feature` contains,

```gherkin
Expand All @@ -58,6 +64,41 @@ Feature: content
And I save an article
Then I should see the "Article successfully saved." message
```
Generate snippets of .featuer file using command `tests/vendor/bin/codecept gherkin:snippets acceptance`

```snippets
/**
* @Given There is a add content link
*/
public function thereIsAAddContentLink()
{
throw new \Codeception\Exception\Incomplete("Step `There is a add content link` is not defined");
}

/**
* @When I create new content with field title as :arg1 and content as a :arg2
*/
public function iCreateNewContentWithFieldTitleAsAndContentAsA($arg1, $arg2)
{
throw new \Codeception\Exception\Incomplete("Step `I create new content with field title as :arg1 and content as a :arg2` is not defined");
}

/**
* @When I save an article
*/
public function iSaveAnArticle()
{
throw new \Codeception\Exception\Incomplete("Step `I save an article` is not defined");
}

```
Copy the all snippets and put in stepobject file

Create a stepobject file using command `tests/vendor/bin/codecept generate:stepobject acceptance Administrator/content`

Define your step file path in `acceptance.suit.yml file`

For Example `- Step\Acceptance\Administrator\Content`

### Installation

Expand Down Expand Up @@ -86,7 +127,7 @@ _We are using `composer.json` file for `tests` folder, so that you will have to

### Run tests

To run the tests please execute the following commands. We are usin [Robo.li](http://robo.li/) to execute the tests.
To run the tests please execute the following commands. We are using [Robo.li](http://robo.li/) to execute [PhpUnit](https://phpunit.de/) based [Codeception](http://codeception.com/for/joomla) test suits.

#### To execute all the test features you should use.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

System-tests, you forgot about the unit tests (and upcoming javascript tests)

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Humm but I thought this README.md is only focused for this project.


Expand All @@ -110,6 +151,8 @@ $ tests/vendor/bin/codecept run tests/acceptance/users.feature

_If you want to see steps then you can use `--steps` option of codeceptio. Check [full codecept command list here](http://codeception.com/docs/reference/Commands#Run)_

**Note**:You can modify the timeout time by setting the value of **TIMEOUT** constant lower for fast machines and higher for slow computers. The constant located in the file `tests/acceptance/_bootstrap.php`

Do you have suggestions?
---
Please create an issue here https://github.com/joomla-projects/gsoc16_browser-automated-tests/issues we will be happy to discuss and improve project.
Expand Down