erik/kobalt-exec
erik/kobalt-exec
1
0
Fork 0
Code Issues Pull requests Releases Activity

More documentation.

Browse source
This commit is contained in:
Erik C. Thauvin 2016-07-13 01:13:49 -07:00
parent 0dfaf8fe46
commit 6ab9efe714
2 changed files with 49 additions and 35 deletions
Download patch file Download diff file Expand all files Collapse all files

59
README.md
View file

@ -2,6 +2,8 @@
[![License (3-Clause BSD)](https://img.shields.io/badge/license-BSD%203--Clause-blue.svg?style=flat-square)](http://opensource.org/licenses/BSD-3-Clause) [![Build Status](https://travis-ci.org/ethauvin/kobalt-exec.svg?branch=master)](https://travis-ci.org/ethauvin/kobalt-exec) [![License (3-Clause BSD)](https://img.shields.io/badge/license-BSD%203--Clause-blue.svg?style=flat-square)](http://opensource.org/licenses/BSD-3-Clause) [![Build Status](https://travis-ci.org/ethauvin/kobalt-exec.svg?branch=master)](https://travis-ci.org/ethauvin/kobalt-exec)
To use the plug-in included the following in your `Build.kt` file:
```kotlin ```kotlin
var pl = plugins("net.thauvin.erik:kobalt-exc:") var pl = plugins("net.thauvin.erik:kobalt-exc:")
@ -13,12 +15,15 @@ var p = project {
} }
} }
``` ```
To invoke the `exex` task:
```sh ```sh
./kobaltw assemble exec ./kobaltw exec
``` ```
## CommandLine Directive ## commandLine Directive
The `commandLine` directive will execute command line(s) during the build process:
```kotlin ```kotlin
exec { exec {
@ -30,9 +35,9 @@ exec {
### Parameters ### Parameters
#### args #### `args`
The full command line including the executable and its parameters. The full command line including the executable and all parameters.
```kotlin ```kotlin
exec { exec {
@ -41,9 +46,9 @@ exec {
} }
``` ```
#### dir #### `dir`
The working directory for the process. Defaults to the project directory. The working directory in which the command should be executed. Defaults to the project directory.
```kotlin ```kotlin
exec { exec {
@ -51,23 +56,23 @@ exec {
} }
``` ```
#### os #### `os`
The operating system(s) to execute the command on. If the current operating system does not match, the command will not be executed. List of operating systems on which the command may be executed. If the current OS is contained within the list, the command will be executed.
The following predefined values are available: The following predefined values are available:
Name | Operating System Name | Operating System
------------|-------------------------------------------------------------------- --------------|--------------------------------------------------------------------
Os.FREEBSD | FreeBSD `Os.FREEBSD` | FreeBSD
Os.LINUX | Linux `Os.LINUX` | Linux
Os.MAC | Apple Macintosh / OS X `Os.MAC` | Apple Macintosh / OS X
Os.OPENVMS | OpenVMS `Os.OPENVMS` | OpenVMS
Os.OS400 | OS/400 `Os.OS400` | OS/400
Os.SOLARIS | Solaris / SunOS `Os.SOLARIS` | Solaris / SunOS
Os.TANDEM | Tandem's Non-Stop `Os.TANDEM` | Tandem's Non-Stop
Os.WINDOWS | Microsoft Windows `Os.WINDOWS` | Microsoft Windows
Os.ZOS | z/OS / OS/390 `Os.ZOS` | z/OS / OS/390
```kotlin ```kotlin
exec { exec {
@ -76,20 +81,20 @@ exec {
} }
``` ```
#### fail #### `fail`
Specifies whether output to the stderr, stdout and/or an abnormal exit value constitutes a failure. List of error options to specify whether data returned to the standard streams and/or an abnormal exit value constitute build failure signaling.
The following predefined values are available: The following predefined values are available:
Name | Failure When Name | Failure When
------------|-------------------------------------------------------------------- --------------|--------------------------------------------------------------------
Fail.EXIT | Exit value > 0 `Fail.EXIT` | Exit value > 0
Fail.NORMAL | Exit value > 0 or any output to the standard error stream (stderr). `Fail.NORMAL` | Exit value > 0 or any data to the standard error stream (stderr).
Fail.OUTPUT | Any output to the standard output stream (stdout) or stderr. `Fail.OUTPUT` | Any data to the standard output stream (stdout) or stderr.
Fail.STDERR | Any output to stderr. `Fail.STDERR` | Any data to stderr.
Fail.STDOUT | Any output to stdout. `Fail.STDOUT` | Any data to stdout.
Fail.ALL | Any of the conditions above. `Fail.ALL` | Any of the conditions above.
`Fail.NORMAL` is the default value. `Fail.NORMAL` is the default value.

21
kobalt-exec.iml
View file

@ -25,18 +25,18 @@
</library> </library>
</orderEntry> </orderEntry>
<orderEntry type="module-library" scope="TEST"> <orderEntry type="module-library" scope="TEST">
<library name="Kobalt: org.apache.ant:ant:jar:1.7.0"> <library name="Kobalt: org.testng:testng:jar:(0,]">
<CLASSES> <CLASSES>
<root url="jar://$USER_HOME$/.kobalt/repository/org/apache/ant/ant/1.7.0/ant-1.7.0.jar!/" /> <root url="jar://$USER_HOME$/.kobalt/repository/org/testng/testng/6.9.12/testng-6.9.12.jar!/" />
</CLASSES> </CLASSES>
<JAVADOC /> <JAVADOC />
<SOURCES /> <SOURCES />
</library> </library>
</orderEntry> </orderEntry>
<orderEntry type="module-library" scope="TEST"> <orderEntry type="module-library" scope="TEST">
<library name="Kobalt: com.beust:jcommander:jar:1.48"> <library name="Kobalt: org.apache.ant:ant-launcher:jar:1.7.0">
<CLASSES> <CLASSES>
<root url="jar://$USER_HOME$/.kobalt/repository/com/beust/jcommander/1.48/jcommander-1.48.jar!/" /> <root url="jar://$USER_HOME$/.kobalt/repository/org/apache/ant/ant-launcher/1.7.0/ant-launcher-1.7.0.jar!/" />
</CLASSES> </CLASSES>
<JAVADOC /> <JAVADOC />
<SOURCES /> <SOURCES />
@ -52,9 +52,18 @@
</library> </library>
</orderEntry> </orderEntry>
<orderEntry type="module-library" scope="TEST"> <orderEntry type="module-library" scope="TEST">
<library name="Kobalt: org.apache.ant:ant-launcher:jar:1.7.0"> <library name="Kobalt: com.beust:jcommander:jar:1.48">
<CLASSES> <CLASSES>
<root url="jar://$USER_HOME$/.kobalt/repository/org/apache/ant/ant-launcher/1.7.0/ant-launcher-1.7.0.jar!/" /> <root url="jar://$USER_HOME$/.kobalt/repository/com/beust/jcommander/1.48/jcommander-1.48.jar!/" />
</CLASSES>
<JAVADOC />
<SOURCES />
</library>
</orderEntry>
<orderEntry type="module-library" scope="TEST">
<library name="Kobalt: org.apache.ant:ant:jar:1.7.0">
<CLASSES>
<root url="jar://$USER_HOME$/.kobalt/repository/org/apache/ant/ant/1.7.0/ant-1.7.0.jar!/" />
</CLASSES> </CLASSES>
<JAVADOC /> <JAVADOC />
<SOURCES /> <SOURCES />