tasks/ext/coverage/CoverageThresholdTask.php
\CoverageThresholdTask
Stops the build if any of the specified coverage threshold was not reached
Use {@link Project#createTask} to register a new Task.
- Parent(s)
- \Task < \ProjectComponent
- Author
- Benjamin Schultz
- Copyright
- 2001,2002 THYRELL. All rights reserved
- Since
- 2.4.1
- Version
- $Id: ed00d6f1d05bb5dc7c9967c9ec67fa6f958682ec $
Properties

\PhingFile
$_database= 'null'
Holds an optional database file
nullDetails- Type
- \PhingFile

integer
$_minClassCoverageFound= 'null'
Holds the minimum found coverage value for a class
nullDetails- Type
- integer

integer
$_minMethodCoverageFound= 'null'
Holds the minimum found coverage value for a method
nullDetails- Type
- integer

integer
$_perClass= '25'
Holds the coverage threshold for any class
25Details- Type
- integer

integer
$_perMethod= '25'
Holds the coverage threshold for any method
25Details- Type
- integer

integer
$_perProject= '25'
Holds the coverage threshold for the entire project
25Details- Type
- integer

integer
$_projectStatementCount= '0'
Number of statements in the entire project
0Details- Type
- integer

integer
$_projectStatementsCovered= '0'
Number of covered statements in the entire project
0Details- Type
- integer

boolean
$_verbose= 'false'
Whether to enable detailed logging
falseDetails- Type
- boolean

\Project
$project= 'null'
Holds a reference to the project that a project component (a task, a target, etc.) belongs to
A reference to the current project instanceInherited from: \ProjectComponent::$$project\Task::$$projectnullDetails- Type
- \Project
- Inherited_from
- \ProjectComponent::$$project
- Inherited_from
- \Task::$$project
Methods

calculateCoverageThreshold(
string $filename, array $coverageInformation
)
:
voidCalculates the coverage threshold
| Name | Type | Description |
|---|---|---|
| $filename | string | The filename to analyse |
| $coverageInformation | array | Array with coverage information |

filterCovered(
integer $var
)
:
booleanFilter covered statements
| Name | Type | Description |
|---|---|---|
| $var | integer | Coverage CODE/count |
| Type | Description |
|---|---|
| boolean |

getLocation(
)
:
\LocationReturns the location within the buildfile this task occurs. Used by {@link BuildException} to give detailed error messages.
Inherited from: \Task::getLocation()| Type | Description |
|---|---|
| \Location | The location object describing the position of this task within the buildfile. |

getProject(
)
:
\ProjectReturns a reference to current project
Inherited from: \ProjectComponent::getProject()\Task::getProject()| Type | Description |
|---|---|
| \Project | Reference to current porject object |

getRuntimeConfigurableWrapper(
)
:
\RuntimeConfigurableReturns the wrapper object for runtime configuration
Inherited from: \Task::getRuntimeConfigurableWrapper()| Type | Description |
|---|---|
| \RuntimeConfigurable | The wrapper object used by this task |

getTaskType(
)
:
stringReturns the name of the task under which it was invoked, usually the XML tagname
Inherited from: \Task::getTaskType()| Type | Description |
|---|---|
| string | The type of this task (XML Tag) |

init(
)
:
void
Should throw a BuildException if something goes wrong with the build
This is abstract here, but may not be overloaded by subclasses.
| Exception | Description |
|---|---|
| \BuildException |

log(
string $msg, integer $level
=
Project::MSG_INFO
)
:
void
| Name | Type | Description |
|---|---|---|
| $msg | string | The message to log |
| $level | integer | The priority of the message |
- See
- \BuildEvent
- See
- \BuildListener

main(
)
:
voidCalled by the project to let the task do it's work. This method may be called more than once, if the task is invoked more than once. For example, if target1 and target2 both depend on target3, then running phing target1 target2 will run all tasks in target3 twice.
Should throw a BuildException if someting goes wrong with the build
This is abstract here. Must be overloaded by real tasks.

maybeConfigure(
)
:
voidConfigure this task if it hasn't been done already.
Inherited from: \Task::maybeConfigure()
setClasspath(
\Path $classpath
)
:
voidSets an optional classpath
| Name | Type | Description |
|---|---|---|
| $classpath | \Path | The classpath |

setDatabase(
\PhingFile $database
)
:
voidSets the optional coverage database to use
| Name | Type | Description |
|---|---|---|
| $database | \PhingFile | The database file |

setDescription(
string $desc
)
:
void
| Name | Type | Description |
|---|---|---|
| $desc | string | The text describing the task |

setLocation(
\Location $location
)
:
voidSets the location within the buildfile this task occurs. Called by the parser to set location information.
Inherited from: \Task::setLocation()| Name | Type | Description |
|---|---|---|
| $location | \Location | The location object describing the position of this task within the buildfile. |

setOwningTarget(
\Target $target
)
:
void
| Name | Type | Description |
|---|---|---|
| $target | \Target | Reference to owning target |

setPerClass(
integer $threshold
)
:
voidSets the coverage threshold for any class
| Name | Type | Description |
|---|---|---|
| $threshold | integer | Coverage threshold for any class |

setPerMethod(
integer $threshold
)
:
voidSets the coverage threshold for any method
| Name | Type | Description |
|---|---|---|
| $threshold | integer | Coverage threshold for any method |

setPerProject(
integer $threshold
)
:
voidSets the coverage threshold for entire project
| Name | Type | Description |
|---|---|---|
| $threshold | integer | Coverage threshold for entire project |

setProject(
\Project $project
)
:
voidReferences the project to the current component.
Inherited from: \ProjectComponent::setProject()\Task::setProject()| Name | Type | Description |
|---|---|---|
| $project | \Project | The reference to the current project |

setRuntimeConfigurableWrapper(
\RuntimeConfigurable $wrapper
)
:
voidSets the wrapper object this task should use for runtime configurable elements.
Inherited from: \Task::setRuntimeConfigurableWrapper()| Name | Type | Description |
|---|---|---|
| $wrapper | \RuntimeConfigurable | The wrapper object this task should use |

setTaskName(
string $name
)
:
string
| Name | Type | Description |
|---|---|---|
| $name | string |
| Type | Description |
|---|---|
| string | A string representing the name of this task for log |

setTaskType(
string $name
)
:
voidSets the type of the task. Usually this is the name of the XML tag
Inherited from: \Task::setTaskType()| Name | Type | Description |
|---|---|---|
| $name | string | The type of this task (XML Tag) |