Skip to content

Commit 827b178

Browse files
author
Frederic Dewinne
committed
add documentation
1 parent 1562cd0 commit 827b178

File tree

2 files changed

+53
-2
lines changed

2 files changed

+53
-2
lines changed

README.md

Lines changed: 52 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,4 +2,55 @@
22

33
[![Build Status](https://status.continuousphp.com/git-hub/continuousphp/phing-tasks?token=bb175a86-acb5-4f62-92b5-86d5900b6971)](https://continuousphp.com/git-hub/continuousphp/phing-tasks)
44

5-
continuousphp Phing tasks
5+
[Phing](https://www.phing.info/) tasks to consume [continuousphp](https://continuousphp.com/) API in a Phing build
6+
7+
## Installation
8+
9+
Install this package through [Composer](https://getcomposer.org/) by adding this package in the require section
10+
11+
```json
12+
"require": {
13+
"continuousphp/phing-tasks": "~0.1"
14+
}
15+
```
16+
17+
## Import tasks in your build
18+
```xml
19+
<import file="./vendor/continuousphp/phing-tasks/tasks.xml"/>
20+
```
21+
22+
## Tasks
23+
24+
### 1. continuousphp-config
25+
The goal of this task is to setup your credential in order to start consuming
26+
[continuousphp](https://continuousphp.com/) API
27+
28+
#### 1.1. Attributes
29+
| Name | Type | Description | Default | Required |
30+
| ----- | ------ | -------------------------------- | ------- | -------- |
31+
| token | String | A valid token to consume the API | n/a | Yes |
32+
33+
#### 1.2. Example
34+
```xml
35+
<continuousphp-config token="my-valid-token" />
36+
```
37+
38+
### 2. continuousphp-package
39+
This task helps you to get a package url for a repository.
40+
41+
#### 2.1. Attributes
42+
| Name | Type | Description | Default | Required |
43+
| ---------- | ------ | -------------------------------------------------------- | ------- | -------- |
44+
| provider | String | the repository provider platform (git-hub, bitbucket...) | n/a | Yes |
45+
| repository | String | the repository name | n/a | Yes |
46+
| reference | String | the GIT reference of the package | n/a | No |
47+
| property | String | the property in which the download URL will be provided | n/a | No |
48+
49+
#### 2.2 Example
50+
```xml
51+
<continuousphp-package
52+
provider="git-hub"
53+
repository="continuousphp/phing-tasks"
54+
reference="/refs/heads/master"
55+
property="package.url" />
56+
```

build.xml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@
44

55

66
<target name="help" description="List available targets">
7-
<exec executable="{phing.bin}"
7+
<exec executable="${phing.bin}"
88
passthru="true">
99
<arg value="-l"/>
1010
</exec>

0 commit comments

Comments
 (0)