From c230f7f9790ea28320addf1283314257f242afa2 Mon Sep 17 00:00:00 2001 From: "Erik C. Thauvin" Date: Sun, 27 Aug 2023 09:37:13 -0700 Subject: [PATCH] Initial commit --- .github/workflows/bld.yml | 32 ++++ .gitignore | 55 ++++++ .idea/.gitignore | 3 + .idea/app.iml | 29 +++ .idea/bld.iml | 14 ++ .idea/copyright/Apache_License.xml | 6 + .idea/copyright/profiles_settings.xml | 3 + .idea/inspectionProfiles/Project_Default.xml | 8 + .idea/libraries/bld.xml | 17 ++ .idea/libraries/compile.xml | 13 ++ .idea/libraries/runtime.xml | 14 ++ .idea/libraries/test.xml | 14 ++ .idea/misc.xml | 18 ++ .idea/modules.xml | 9 + .idea/runConfigurations/Run Tests.xml | 9 + .vscode/launch.json | 11 ++ .vscode/settings.json | 15 ++ LICENSE.txt | 177 ++++++++++++++++++ README.md | 72 +++++++ bld | 2 + bld.bat | 4 + config/pmd.xml | 110 +++++++++++ lib/bld/bld-wrapper.jar | Bin 0 -> 27246 bytes lib/bld/bld-wrapper.properties | 8 + .../bld/extension/ExecOperationBuild.java | 96 ++++++++++ .../java/rife/bld/extension/ExecFail.java | 27 +++ .../rife/bld/extension/ExecOperation.java | 146 +++++++++++++++ .../rife/bld/extension/ExecOperationTest.java | 128 +++++++++++++ 28 files changed, 1040 insertions(+) create mode 100644 .github/workflows/bld.yml create mode 100644 .gitignore create mode 100644 .idea/.gitignore create mode 100644 .idea/app.iml create mode 100644 .idea/bld.iml create mode 100644 .idea/copyright/Apache_License.xml create mode 100644 .idea/copyright/profiles_settings.xml create mode 100644 .idea/inspectionProfiles/Project_Default.xml create mode 100644 .idea/libraries/bld.xml create mode 100644 .idea/libraries/compile.xml create mode 100644 .idea/libraries/runtime.xml create mode 100644 .idea/libraries/test.xml create mode 100644 .idea/misc.xml create mode 100644 .idea/modules.xml create mode 100644 .idea/runConfigurations/Run Tests.xml create mode 100644 .vscode/launch.json create mode 100644 .vscode/settings.json create mode 100644 LICENSE.txt create mode 100755 README.md create mode 100755 bld create mode 100644 bld.bat create mode 100644 config/pmd.xml create mode 100644 lib/bld/bld-wrapper.jar create mode 100644 lib/bld/bld-wrapper.properties create mode 100644 src/bld/java/rife/bld/extension/ExecOperationBuild.java create mode 100644 src/main/java/rife/bld/extension/ExecFail.java create mode 100644 src/main/java/rife/bld/extension/ExecOperation.java create mode 100644 src/test/java/rife/bld/extension/ExecOperationTest.java diff --git a/.github/workflows/bld.yml b/.github/workflows/bld.yml new file mode 100644 index 0000000..ddcc35c --- /dev/null +++ b/.github/workflows/bld.yml @@ -0,0 +1,32 @@ +name: bld-ci + +on: [ push, pull_request, workflow_dispatch ] + +jobs: + build-bld-project: + runs-on: ubuntu-latest + + strategy: + matrix: + java-version: [ 17, 19, 20 ] + + steps: + - name: Checkout source repository + uses: actions/checkout@v3 + with: + fetch-depth: 0 + + - name: Set up JDK ${{ matrix.java-version }} + uses: actions/setup-java@v3 + with: + distribution: 'zulu' + java-version: ${{ matrix.java-version }} + + - name: Grant execute permission for bld + run: chmod +x bld + + - name: Download the dependencies + run: ./bld download + + - name: Run tests with bld + run: ./bld compile test \ No newline at end of file diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..a2805aa --- /dev/null +++ b/.gitignore @@ -0,0 +1,55 @@ +.gradle +.DS_Store +build +lib/bld/** +!lib/bld/bld-wrapper.jar +!lib/bld/bld-wrapper.properties +lib/compile/ +lib/runtime/ +lib/standalone/ +lib/test/ + +# IDEA ignores + +# User-specific +.idea/**/workspace.xml +.idea/**/tasks.xml +.idea/**/usage.statistics.xml +.idea/**/dictionaries +.idea/**/shelf + +# AWS User-specific +.idea/**/aws.xml + +# Generated files +.idea/**/contentModel.xml + +# Sensitive or high-churn files +.idea/**/dataSources/ +.idea/**/dataSources.ids +.idea/**/dataSources.local.xml +.idea/**/sqlDataSources.xml +.idea/**/dynamic.xml +.idea/**/uiDesigner.xml +.idea/**/dbnavigator.xml + +# Gradle +.idea/**/gradle.xml + +# Mongo Explorer plugin +.idea/**/mongoSettings.xml + +# mpeltonen/sbt-idea plugin +.idea_modules/ + +# JIRA plugin +atlassian-ide-plugin.xml + +# Cursive Clojure plugin +.idea/replstate.xml + +# SonarLint plugin +.idea/sonarlint/ + +# Editor-based Rest Client +.idea/httpRequests \ No newline at end of file diff --git a/.idea/.gitignore b/.idea/.gitignore new file mode 100644 index 0000000..26d3352 --- /dev/null +++ b/.idea/.gitignore @@ -0,0 +1,3 @@ +# Default ignored files +/shelf/ +/workspace.xml diff --git a/.idea/app.iml b/.idea/app.iml new file mode 100644 index 0000000..787b59b --- /dev/null +++ b/.idea/app.iml @@ -0,0 +1,29 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/.idea/bld.iml b/.idea/bld.iml new file mode 100644 index 0000000..e63e11e --- /dev/null +++ b/.idea/bld.iml @@ -0,0 +1,14 @@ + + + + + + + + + + + + + + \ No newline at end of file diff --git a/.idea/copyright/Apache_License.xml b/.idea/copyright/Apache_License.xml new file mode 100644 index 0000000..15687f4 --- /dev/null +++ b/.idea/copyright/Apache_License.xml @@ -0,0 +1,6 @@ + + + + \ No newline at end of file diff --git a/.idea/copyright/profiles_settings.xml b/.idea/copyright/profiles_settings.xml new file mode 100644 index 0000000..f2907f1 --- /dev/null +++ b/.idea/copyright/profiles_settings.xml @@ -0,0 +1,3 @@ + + + \ No newline at end of file diff --git a/.idea/inspectionProfiles/Project_Default.xml b/.idea/inspectionProfiles/Project_Default.xml new file mode 100644 index 0000000..1e01b48 --- /dev/null +++ b/.idea/inspectionProfiles/Project_Default.xml @@ -0,0 +1,8 @@ + + + + \ No newline at end of file diff --git a/.idea/libraries/bld.xml b/.idea/libraries/bld.xml new file mode 100644 index 0000000..722b42e --- /dev/null +++ b/.idea/libraries/bld.xml @@ -0,0 +1,17 @@ + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/.idea/libraries/compile.xml b/.idea/libraries/compile.xml new file mode 100644 index 0000000..9bd86aa --- /dev/null +++ b/.idea/libraries/compile.xml @@ -0,0 +1,13 @@ + + + + + + + + + + + + + \ No newline at end of file diff --git a/.idea/libraries/runtime.xml b/.idea/libraries/runtime.xml new file mode 100644 index 0000000..2ae5c4b --- /dev/null +++ b/.idea/libraries/runtime.xml @@ -0,0 +1,14 @@ + + + + + + + + + + + + + + \ No newline at end of file diff --git a/.idea/libraries/test.xml b/.idea/libraries/test.xml new file mode 100644 index 0000000..b80486a --- /dev/null +++ b/.idea/libraries/test.xml @@ -0,0 +1,14 @@ + + + + + + + + + + + + + + \ No newline at end of file diff --git a/.idea/misc.xml b/.idea/misc.xml new file mode 100644 index 0000000..8e43730 --- /dev/null +++ b/.idea/misc.xml @@ -0,0 +1,18 @@ + + + + + + + + + + + + + \ No newline at end of file diff --git a/.idea/modules.xml b/.idea/modules.xml new file mode 100644 index 0000000..55adcb9 --- /dev/null +++ b/.idea/modules.xml @@ -0,0 +1,9 @@ + + + + + + + + + \ No newline at end of file diff --git a/.idea/runConfigurations/Run Tests.xml b/.idea/runConfigurations/Run Tests.xml new file mode 100644 index 0000000..c7304ae --- /dev/null +++ b/.idea/runConfigurations/Run Tests.xml @@ -0,0 +1,9 @@ + + + + \ No newline at end of file diff --git a/.vscode/launch.json b/.vscode/launch.json new file mode 100644 index 0000000..48cb4bf --- /dev/null +++ b/.vscode/launch.json @@ -0,0 +1,11 @@ +{ + "version": "0.2.0", + "configurations": [ + { + "type": "java", + "name": "Run Tests", + "request": "launch", + "mainClass": "rife.bld.extension.ExecOperationTest" + } + ] +} diff --git a/.vscode/settings.json b/.vscode/settings.json new file mode 100644 index 0000000..c4bc81e --- /dev/null +++ b/.vscode/settings.json @@ -0,0 +1,15 @@ +{ + "java.project.sourcePaths": [ + "src/main/java", + "src/main/resources", + "src/test/java", + "src/bld/java" + ], + "java.configuration.updateBuildConfiguration": "automatic", + "java.project.referencedLibraries": [ + "${HOME}/.bld/dist/bld-1.7.2.jar", + "lib/compile/*.jar", + "lib/runtime/*.jar", + "lib/test/*.jar" + ] +} diff --git a/LICENSE.txt b/LICENSE.txt new file mode 100644 index 0000000..49cc83d --- /dev/null +++ b/LICENSE.txt @@ -0,0 +1,177 @@ + + Apache License + Version 2.0, January 2004 + https://www.apache.org/licenses/ + + TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION + + 1. Definitions. + + "License" shall mean the terms and conditions for use, reproduction, + and distribution as defined by Sections 1 through 9 of this document. + + "Licensor" shall mean the copyright owner or entity authorized by + the copyright owner that is granting the License. + + "Legal Entity" shall mean the union of the acting entity and all + other entities that control, are controlled by, or are under common + control with that entity. For the purposes of this definition, + "control" means (i) the power, direct or indirect, to cause the + direction or management of such entity, whether by contract or + otherwise, or (ii) ownership of fifty percent (50%) or more of the + outstanding shares, or (iii) beneficial ownership of such entity. + + "You" (or "Your") shall mean an individual or Legal Entity + exercising permissions granted by this License. + + "Source" form shall mean the preferred form for making modifications, + including but not limited to software source code, documentation + source, and configuration files. + + "Object" form shall mean any form resulting from mechanical + transformation or translation of a Source form, including but + not limited to compiled object code, generated documentation, + and conversions to other media types. + + "Work" shall mean the work of authorship, whether in Source or + Object form, made available under the License, as indicated by a + copyright notice that is included in or attached to the work + (an example is provided in the Appendix below). + + "Derivative Works" shall mean any work, whether in Source or Object + form, that is based on (or derived from) the Work and for which the + editorial revisions, annotations, elaborations, or other modifications + represent, as a whole, an original work of authorship. For the purposes + of this License, Derivative Works shall not include works that remain + separable from, or merely link (or bind by name) to the interfaces of, + the Work and Derivative Works thereof. + + "Contribution" shall mean any work of authorship, including + the original version of the Work and any modifications or additions + to that Work or Derivative Works thereof, that is intentionally + submitted to Licensor for inclusion in the Work by the copyright owner + or by an individual or Legal Entity authorized to submit on behalf of + the copyright owner. For the purposes of this definition, "submitted" + means any form of electronic, verbal, or written communication sent + to the Licensor or its representatives, including but not limited to + communication on electronic mailing lists, source code control systems, + and issue tracking systems that are managed by, or on behalf of, the + Licensor for the purpose of discussing and improving the Work, but + excluding communication that is conspicuously marked or otherwise + designated in writing by the copyright owner as "Not a Contribution." + + "Contributor" shall mean Licensor and any individual or Legal Entity + on behalf of whom a Contribution has been received by Licensor and + subsequently incorporated within the Work. + + 2. Grant of Copyright License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + copyright license to reproduce, prepare Derivative Works of, + publicly display, publicly perform, sublicense, and distribute the + Work and such Derivative Works in Source or Object form. + + 3. Grant of Patent License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + (except as stated in this section) patent license to make, have made, + use, offer to sell, sell, import, and otherwise transfer the Work, + where such license applies only to those patent claims licensable + by such Contributor that are necessarily infringed by their + Contribution(s) alone or by combination of their Contribution(s) + with the Work to which such Contribution(s) was submitted. If You + institute patent litigation against any entity (including a + cross-claim or counterclaim in a lawsuit) alleging that the Work + or a Contribution incorporated within the Work constitutes direct + or contributory patent infringement, then any patent licenses + granted to You under this License for that Work shall terminate + as of the date such litigation is filed. + + 4. Redistribution. You may reproduce and distribute copies of the + Work or Derivative Works thereof in any medium, with or without + modifications, and in Source or Object form, provided that You + meet the following conditions: + + (a) You must give any other recipients of the Work or + Derivative Works a copy of this License; and + + (b) You must cause any modified files to carry prominent notices + stating that You changed the files; and + + (c) You must retain, in the Source form of any Derivative Works + that You distribute, all copyright, patent, trademark, and + attribution notices from the Source form of the Work, + excluding those notices that do not pertain to any part of + the Derivative Works; and + + (d) If the Work includes a "NOTICE" text file as part of its + distribution, then any Derivative Works that You distribute must + include a readable copy of the attribution notices contained + within such NOTICE file, excluding those notices that do not + pertain to any part of the Derivative Works, in at least one + of the following places: within a NOTICE text file distributed + as part of the Derivative Works; within the Source form or + documentation, if provided along with the Derivative Works; or, + within a display generated by the Derivative Works, if and + wherever such third-party notices normally appear. The contents + of the NOTICE file are for informational purposes only and + do not modify the License. You may add Your own attribution + notices within Derivative Works that You distribute, alongside + or as an addendum to the NOTICE text from the Work, provided + that such additional attribution notices cannot be construed + as modifying the License. + + You may add Your own copyright statement to Your modifications and + may provide additional or different license terms and conditions + for use, reproduction, or distribution of Your modifications, or + for any such Derivative Works as a whole, provided Your use, + reproduction, and distribution of the Work otherwise complies with + the conditions stated in this License. + + 5. Submission of Contributions. Unless You explicitly state otherwise, + any Contribution intentionally submitted for inclusion in the Work + by You to the Licensor shall be under the terms and conditions of + this License, without any additional terms or conditions. + Notwithstanding the above, nothing herein shall supersede or modify + the terms of any separate license agreement you may have executed + with Licensor regarding such Contributions. + + 6. Trademarks. This License does not grant permission to use the trade + names, trademarks, service marks, or product names of the Licensor, + except as required for reasonable and customary use in describing the + origin of the Work and reproducing the content of the NOTICE file. + + 7. Disclaimer of Warranty. Unless required by applicable law or + agreed to in writing, Licensor provides the Work (and each + Contributor provides its Contributions) on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or + implied, including, without limitation, any warranties or conditions + of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A + PARTICULAR PURPOSE. You are solely responsible for determining the + appropriateness of using or redistributing the Work and assume any + risks associated with Your exercise of permissions under this License. + + 8. Limitation of Liability. In no event and under no legal theory, + whether in tort (including negligence), contract, or otherwise, + unless required by applicable law (such as deliberate and grossly + negligent acts) or agreed to in writing, shall any Contributor be + liable to You for damages, including any direct, indirect, special, + incidental, or consequential damages of any character arising as a + result of this License or out of the use or inability to use the + Work (including but not limited to damages for loss of goodwill, + work stoppage, computer failure or malfunction, or any and all + other commercial damages or losses), even if such Contributor + has been advised of the possibility of such damages. + + 9. Accepting Warranty or Additional Liability. While redistributing + the Work or Derivative Works thereof, You may choose to offer, + and charge a fee for, acceptance of support, warranty, indemnity, + or other liability obligations and/or rights consistent with this + License. However, in accepting such obligations, You may act only + on Your own behalf and on Your sole responsibility, not on behalf + of any other Contributor, and only if You agree to indemnify, + defend, and hold each Contributor harmless for any liability + incurred by, or claims asserted against, such Contributor by reason + of your accepting any such warranty or additional liability. + + END OF TERMS AND CONDITIONS diff --git a/README.md b/README.md new file mode 100755 index 0000000..ea52dab --- /dev/null +++ b/README.md @@ -0,0 +1,72 @@ +# [bld](https://rife2.com/bldb) Command Line Execution Extension + +[![License](https://img.shields.io/badge/license-Apache%20License%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0) +[![Java](https://img.shields.io/badge/java-17%2B-blue)](https://www.oracle.com/java/technologies/javase/jdk17-archive-downloads.html) +[![bld](https://img.shields.io/badge/1.7.2-FA9052?label=bld&labelColor=2392FF)](https://rife2.com/bld) +[![Release](https://flat.badgen.net/maven/v/metadata-url/repo.rife2.com/releases/com/uwyn/rife2/bld-exec/maven-metadata.xml?color=blue)](https://repo.rife2.com/#/releases/com/uwyn/rife2/bld-exec) +[![Snapshot](https://flat.badgen.net/maven/v/metadata-url/repo.rife2.com/snapshots/com/uwyn/rife2/bld-exec/maven-metadata.xml?label=snapshot)](https://repo.rife2.com/#/snapshots/com/uwyn/rife2/bld-exec) +[![GitHub CI](https://github.com/rife2/bld-exec/actions/workflows/bld.yml/badge.svg)](https://github.com/rife2/bld-exec/actions/workflows/bld.yml) + +To install, please refer to the [extensions documentation](https://github.com/rife2/bld/wiki/Extensions). + +To execute a command at the command line, add the following to your build file: + +```java +@BuildCommand +public void startServer() throws Exception { + new ExecOperation() + .fromProject(this) + .command("./start.sh") + .execute(); +} +``` + +### Failure Modes + +Use the `fail` function to specify whether data returned to the standard streams and/or an abnormal exit value +constitute a failure. + +```java +@BuildCommand +public void startServer() throws Exception { + new ExecOperation() + .fromProject(this) + .command("cmd", "/c", "stop.bat") + .fail(ExecFail.STDERR) + .execute(); +} +``` + +The following predefined values are available: + +| Name | Failure When | +|:------------------|:-----------------------------------------------------------------| +| `ExecFail.EXIT` | Exit value > 0 | +| `ExecFail.NORMAL` | Exit value > 0 or any data to the standard error stream (stderr) | +| `ExecFail.OUTPUT` | Any data to the standard output stream (stdout) or stderr. | +| `ExecFail.STDERR` | Any data to stderr. | +| `ExecFail.STDOUT` | Any data to stdout. | +| `ExecFail.ALL` | Any of the conditions above. | +| `ExecFail.NONE` | Never fails. | + +`ExecFail.NORMAL` is the default value. + +## Working Directory + +You can also specify the working directory: + +```java +@BuildCommand +public void startServer() throws Exception { + new ExecOperation() + .fromProject(this) + .command("touch", "foo.txt") + .workDir("/tmp") + .execute(); +} +``` + + + + + diff --git a/bld b/bld new file mode 100755 index 0000000..2e6b6f6 --- /dev/null +++ b/bld @@ -0,0 +1,2 @@ +#!/usr/bin/env sh +java -jar "$(dirname "$0")/lib/bld/bld-wrapper.jar" "$0" --build rife.bld.extension.ExecOperationBuild "$@" \ No newline at end of file diff --git a/bld.bat b/bld.bat new file mode 100644 index 0000000..8db6d45 --- /dev/null +++ b/bld.bat @@ -0,0 +1,4 @@ +@echo off +set DIRNAME=%~dp0 +if "%DIRNAME%" == "" set DIRNAME=. +java -jar "%DIRNAME%/lib/bld/bld-wrapper.jar" "%0" --build rife.bld.extension.ExecOperationBuild %* \ No newline at end of file diff --git a/config/pmd.xml b/config/pmd.xml new file mode 100644 index 0000000..1039e40 --- /dev/null +++ b/config/pmd.xml @@ -0,0 +1,110 @@ + + + Erik's Ruleset + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/lib/bld/bld-wrapper.jar b/lib/bld/bld-wrapper.jar new file mode 100644 index 0000000000000000000000000000000000000000..300e7671ba25653cb5e7ad12c9bdc8321d0afd65 GIT binary patch literal 27246 zcmaI7Q*19zw18XNcDrlawr$&Pf3r<2g1w#XZf`S6NsKC(x`u_|xATS^~F;yWtDS2@QIU#u|aWNHDdO7jmDIlO{xtVEM z89Mq!co{nCxtaN9WyTejgVQIunVDtRIVoEDHf2f>>IIo8sYMzFXtO0^`gdbQ^p>i}fkFJqozC$`SK)43@gu<~$R9&DYD_Y$8nto;Lh`&0>4(AZ^FpofA(XmeVgBCTLDRrFzw z?IJ5RTFUtW^(y!QIjbp-&gikZCTsF}KBFz({EpRNpi*<8!m>gDq16&ol^m0Bg#u~-ZnC4aa8m>iFS1EL35HN)?9?Dg zMrVOhF=`#nTRTnC+lv)Q77Xv9L_@1BRn2Ijz=?tQ_NE@*jT;1dSXZlQwW!ztxXv`w z&~agBgJKru@ope4uGoWEHC1A%1zzncDm3I>;ZLaxGRG)w)*#ch_OUQ zc48q?uYn$G^u*qzt)LEmvBgq?SSC_^B+aJ1DzcaK;Wc&-Wkio9YRt~mwfV5A7UOgI zV~OxRcEnUGvj$m_{v`{egI4Glut-f!5cx93O0X6ret`|t*Oja?ixpLMh|1D0P8WrI z!C6*T*amQQl{wG4YHRCCBX^7o|6N>2Tae$=;zffu8QiuCm*Sz@5+jsJUT*Od^fX}H zYh?o)qI)=U{#-L`VRKm&q})N5KGyg4DCVo6MwI?UiKaKZFcLG_T6dCuxeYm1w6b)~C) zot2}arpcZ{)O=C9^KFtFPyG6OVH1@1c4uAzui3=4feQ=H?B)bFmE_?vaF@s|CgZYc zGnU4xUSDl==)ByLdUpqR(5&oh zZtHuzA?PTlSn=WF$Xl+>ROPNem5A+^mLD*>hI@%TD*l{tOK2&~aPIHClJkMyl(Z~| z4pO?PU@;HB{j-`n8b_q{O7n||1rm!L%xmaI0^+ZnsHXJvs6vPPXW}(ilCSx~+e>75 zC5dmr2L3lAEp}DzpnR>3)E_pBo!F7DY)XP*2xXQ=fK8BLabC`Av&dk9p-@sBCv5Kr zG@*heDvXDgq>FKndT+U&?hD?5azRrMQOmNz-p-8T+a2R4?-w%+-9vj1H)eE0=P_s@ zm1w2<1u|K``6AvnY#h!id~48SFIUPRCyccNcNWyi7MPn1E#&qG;M^PsRlYNr#RU*7+;z7IAllWE2fQWZASbJ!v3-+n>(qF{Mu=-#gHqa*rP1U3pM zuJfkKNYW_#i2*A=F$izB8rYf)jqTFcQZ)Xt5-~g%p-$;>5wgLi#spveXw}bjQORT0 z)TlLv+M==i2Q&JWGo&8Y3VIY-W9@7&a6`RrvPrb9?(!;jM7ZpM%vHEc2o_2Oj5cwY zJYH#?dtsjte$=?oUXzdsW=$f-ytLKF6M`lQQofrszUcymF=?V%v=7T-+?4K*&U9H$ zjqI->rG8^uDX?J^_K-aeCQ`C!AQiceaTF&NHV*f0fwZCg@Po}zTQI$)vl4fSs*ajq z4sBUx(E`fyXiSMd_8Pp(Ktg?NXd2`p=;(%q0b+>p4Xw-!M!BK9Z5jU!O2Ddy^t3ll zm8=r0tZ$%~>!F8>hTzQLo?r@!OiC2#YB+jjm z(8Z#%fdk8$u?(#dJB%f}vzrQi6Nqu<1hZJ{dZP5~1?qI;Bn-oHaFc7A<{&3LBYtwU z0lB(Xk$#Q1zdmNpe3qV5HX49q#CF2(-aW$Vnu>!o&r{#Q+d@ZA(ymfr|JnKj(z$uxqh&>F z0?b4uKr@*=as=;~VNurJU5P~Nbq37*EKcM+X|Z*A71_ucDUsXqc7}@28j3qq2sVUw zeWfTU_cp#=HU+;$WVZ)02F77sz_|Y&%6r7W!yPqJJjhjJi*PsiNmsJnsMnrxCjLk8 zjACVsn7?$7WQ~|D5wGvgU&iufKc-Mmo;Mn_k3gvFf@*{syq1ymjT?f})(f6GaUWqG z6KIG!#)S0_s@fPZrorGxuL9PQKg7WAWFs&V9I~jly#O!+wYtk zT_(LM@q6)+<8qH7WN{BcPhswZ)a?)^HEEsq?X-_}kNCD^F;Rt9(2$;GANJaPRZJTK zGSw4!k0l;kDD#W~wv5~h^ZMADPmmif+J?iLUxj3Tq<(N*!D!;gObGiD6S8#{69SDR z&v2Q!-L8Xsz)+(Khra|gMNg6Wjer6YhJ*KWj97FAL?^ywkelOD#ZiXQdf7)CneQ-6 ze)iQu2tP&2iL};ywF;G&$o<$BVG7z8=#J{&rnRyww%Y2fZ7jNa?IT1ueBFiG#3NLH zw3ZW2=56%LYOIY$8r{NSyW4?M;tm*$Yyqt!_}IHVO&iV)!fl+$za!Z}YZQOR<#RO% zB1e&^!h#?5e*VDci9z3J9;y+eGg0$UC)=~<95h0qEr)0SktTuK$SdAwl zziBLg87;?zX(Kk4|(C^j@`oOiYdkLAnU23>MJu(x3&a{(Ce%>;%xz^d%zOq?s z8|1URt*Lc*T(-PyHx)b+L=7oIns}_+(+Peh+s))1fldcIvE&*{=}g0$7N-{wk$`d$ zNcX}XXWmab*8DH&hZ}_f3i3#*J;YFaJ9=30XyPIR;+EbO3r^p#xv^+rkYDV7oF6Bp z24c+HoB9-aH}GR1x$LHzW!p~B$erbr=GVo&5C1m&r8t?y5Ibo}$rjMPNuqZ;ONq^~ zpTy1y$=uOgSKrmriIq?`R9+lCbxtF*Xij2be-G*IG>#*SKGC%dpj(^}{KwcovU(t# zrrDIjm3WJfOOEi{(YKR?t~(ERc#&cXAo#pM$q)HkiDQEaabo3MNQJ5O{56NiKTA;ejwvK8+aIves+XX2_+21;U zOb_85Pond&WTc-|yp-Sa{>qW4YdzuKMCiOe+Gy5*EYA%x=g1L6n*Oc0X*luf1jdS# zSZiDHPSRqRSknMM@qF@8anpVR!Injwy~;I$9}Z&!dh>3AUDJ0fk0aM5HyB6h-%QeJ z8IgcE@;qrL`ztJCZ_+ro1QLS-+=`Tjtn#MwM2s!hH4!%-=YcTz?tBiK#fP_bm;y$J z|A*2V3n8$VCN3&7Hs^6;5SQ7061a2stwFD2Ihr}p&`$<|?R3s`qyW4056WJW>!;FR z13`Ua2DVePv>sjkMA^C+Fc_$KiQq%5pnmj4C{`V-MQD2e*Q?HI-zQW>h}}d+(NFjh zd%*{_8V=vG9&)Z`5^A}`kEjX34xZG$gonJJL&+XTmi2QbLH&6OgdcuSlK&{5@gg{# zxb}TA7XoDNPi@XoEb}7tcb?_3fc9>GR($YzR+G6;&p#ZZVJ%K_&hp2VHUU`6diZX4 z*j#PTG5b^8HJ{`=A$9DpHB}({rc>UN+_j$UKRtPd*2Bpb1L<$U=_PrDT%3jTvMeoG z=G6|dRZo+VzI1hJJ9J_nS>LsuV4tGhl-rrm_HhD z*4hy?go*K4&i!PlPlC*J8AcR}(R_!uiFQD~=3y5nBjhZnLPBK2o+n(02;(@;@ z`l-QB4P=DL@jTc|2ZFRGQnzqi&q9_A@tRNBcw00s?~@Lo^JZq;nr76zR+IP6IlR>9 z6b$#bhiT<>pK$FlQmrc+#nfDddQ=2Q`t#aP;ZG8V7kQ2v_k!-0uWx;9gOsu~#HjO? zj?`lW7=Zfc$@7MeCi;leXTxviT)o;9f!34gCyN^>H-PmiR`~9<+~+f^aBZZx;faY9 zqDmjBzfmHUf9B(kH-7uSt)%|Me(>t|koGXc$*XKWsZTh@YLA6`y3hV6bOa8rH=}jZ zVW5}qV4v9(|CW>MCk3m=uw_uNP2`)vyQr(<126IGe7aBa^SUu{yWC@R*+2h`C)>Fi z8P$^)afh2V9yMfsV-+^WH`KS6&(i(dPXt=T?zh)=QCA1{nos&q`fpi-)AoK1eXg$z zRsRwX+Y>t0NuvIO%J@y#WS~X68G%pMSkc;1NzjQ&3+5pk+g?G3ZxQeHM4rXN4?{73 z4~f((r!lKyTmXzpC~jhM*>cjbd2!9C^DDp8U@Gv!rQEo&@7Z~Uf^YeDZ*XG6JvQ6{ zoHaTGm)GHPk!2f1TvOZHsm0=zi)A<_mAY(hP#-Rgs8~J8k0v&&Sa8GGq9Qev@IH15 zjxwAm(eEygX~IUbN4w-LLD?Ns8Lu*+X*mh$N0}+RW~mO9PO|TdbviW)Th1$BY>TSN zv}y(9!GaV(2zAWt=`}5EIx%*=02hrLwRmo`MyrWb@b)ED3h1mfY{Iw+i6UUO&?X<4 z#R%GK2$8Bw4A&~`h#-Xv&Z~aTrl$u!D86as=2fb~NV{SEs1;ombe$^ER2XXR#X!ZmgTB4OsJYg;qx7mBW%L?@ z8acPpxyJx~>%7u48+*_@WuEv(Zfw?7;qz}JPJ0km?Ogjx7S3<{Rao>ToGZku91Vh4 zk!eG%H#h@j8QNCWTyVO@+$k#z#MpB2wM%}r*wpk@jMVfTHg_o{&qv)6G3(A! zYp&BHUH8ExLKPa?#y}rG$}+XIs`Cc+bcfKI3Wo|AJ^0PKxi-~c>yZU|+~RRrbJL!v z&2`iNk%HQIwzsw2)uQ1pTd?bW3=z!uj-Tom?cSl z$~m;QH7bjt8?Uj!G-}nh@*m$Y!)!)#-*vCg6^sYZF&<3dtQxNal}gxf-EH151!#Ax zgw4`OB+~l8TwoW?Ff5CmDE3Q72C({(>G$ zASb`8JIgXw_p)Vm(QWJUQn$+ZKm(1{+-)tL{-(a#*5<;_-n!6wW_rX3_f@hq4+Fg^ zH-_QPN{-pIQO=$rWkL<8#iv`B-KvGTtvotDCyHH0*N>?rq^rY^N}4~_Ut>3Gk_Hpy zbzxzLP;hxsUueASt-0wwxutdIHQA#U&Ne#N+MI`HDjd$bP|{y3atTkPlP+b+SUTGJ zK5NGK3bb@vj=x9G(r5H_4bik2?G1)|)D^s-XIBzw68XX-8rqGGJMt+{H*Rw+w!@z+ z)Mfb^$}Ve1mvMxw?!|MI)L`CX<5-EZ0^Gg#K#|kYuJN&xEZI-S`CBF;hqe)6gIqI- z=RL4{EMJiAB`Rs5PD_c9NvxRlpaJH|NkYIGb{*xAfptjE5%EHbr zjGo?}E;)msOx~Kg+~q?$jPbH7@sQo)9!yA;)#A=Bb34Ag>M9+L&z0e}zoy|Tr#iun zwH1~QmHN#Px?N?Z_F_Ms{I3O%>fuvlJ7a*BruxVG4B zp3YknaQI{0v2?CBSvuF-SvoHuFgssefbFZSn`|d9*o3=7yMkrZw>v(L-2(=Md~Wc$ z!3!s^M(Y|o2njhS?@dsxyX!QH^=pUQO^`gSh@e>Wviy2Ff;lglL7%ZFN%shbgyC4r zrOyX;x7-Z1&02lTm^a7GO4cJCZ(|<}0cC=uKW~?SQ)sbFdxYmzGq8J5Uqdy1wYddI zm2$mcH@q{a-GzHTqgxNpI14!mQ6u6VA0V%I!i#+rc(?GYZV{o3MhIUWuk<(WmJBGA z4SBI)f7itp>GA_?#NvZjcRL%nHy#fu`F8rT%2V}o=1QV`7W{evSKk%@>WQv}u+b>P zNwlyCLos|W1(>Ao+z%y~D#>n6&~)SMT$h=v7{m+twb4)pj*1>8>2PW?bsyqUrzne6 zi4JEDQA>RXoSw*&HC!=eP5sVi(Oqug;-#nYJ(uDabrZW&-~NdKsz(>AH?$#_!2U%G zw2`a#()nG*iwz7`D$h#ealUoQBgaaG$h4NoR~!*1AWVD<`|m6`aEza?3hRNj`N91C z6{KO+{;T$ww_#WLdt8|eKoa8_~>wM^&y)KvIIY@?0_veq}Oq7uRJ~cvo}8n zPq^UMk__C>j?N?Y4*DA87whi)xOuLRecC08?~_~ibSO#AFC$y7Na9@IU1-mm=_2}5 zPM)U4QpI42XXU-4sE~H9$!2a_&g>rAcgu0f-^PGhkvhJv^#o?!NKt<_B=DW@i-#V* zk5e$z@4GJXsRND7G0uCsBNL(J@@2Q6zUFClc%N|6RD?XY98pfy++6Vc8vsgAvV^<| zkMMkRX*V|lEHT;?qsK@K{Z~A0mY9L=OcTfPMs*uc=7P)@L>d!5K>!60P%K_7!ppb_ zRSt}{$Bm652`tANo(!h$yM?^wNQNIz&fSjbv@G{;*vQsbz_yhCnZ-mFOjfp47BZS@ z!L}S0>Feu*sxZ0%v4R;ZH{=lCmZsTM*#ngawag#OFDS;{95e^Yq?U=!J*y*bfU?ig zCH4hG+UQ)Lshiy!^y$lo8v+R?MtgU2H-+{7TBF$D+LYgXd;RpRtULi%?iAc(7tdW@~Z`B99TRjDCf*4&MHG)DXmHN2T_? z{!2$sk{=&zp;p)xGUw|JDsw3XY2pKe+(IWy2UXc6+G>`-*!o8pxqH|xF0XZVw7f!< z?NkD_+rIJ}w}S`GzEB%YZl(pHhVz>3^Qzxcw)p5cDk-9gQZ?n{klkUZb- zJP~WIv9S<-r+10C%#=lHPJ-RbeN>+wxEAlZY*m8UkBW7 zJmBOaK$GC+*6ubkyvk<`{NN($g*9-&6ByK#%gRz_OO6WkZ1EnuVY3r2Z0%7;qHoGhWVk$%8qE4Db=>yyZ^D$3yqp%@IyFf)(qW zzX+$Gn>rN!glkaod%D72P|~7=nVz18^@Z5ymL8Pl)()L%#u;-HA|q+TbVCg3=;|x# zY@oovg)$nDcWhWV?3@3vRP7mMWg_P4gzTnjTEO4laSQt|^ASm`!6RDoVj=v^8zfxaBM6nhW9TmL3gh zVC7!n1>Ngs8UMJfCAuv(2Yk-i&y&$SVwW{`S4!j2iP?t_!DPQR~tNi=Vl)-yS{1WLGky_cmf*)Lh z55&Trc@;mf)Bmci`6670RQ-`pz=+?tN(3)0`>{_#3ZDcih@M~mFsH+LPwz^8Gc5m( zDG482`U9Rg_)hnWzUdVH%~BdDfPdtTtW&;vLyW%eB)f3M|Jwi#9M5@IoAa*s!*sOAyC+uMAtf~T zLMi1D^bK@Zc?4D-4WHakOlOfSMo|3q%L;fpi34?6^2^eueOq=(u_*MJ^2${Iaa1fwmUsv295Q&p<{isq&D zCcUzJh28UW<$d*cj#`7enwC=*q&d$sgPJD_(&`boN=k8;XtkUi4#)@yq=dse0HcDi z!r~F*D!c`P58D!!>N}iZl&lomnwDN_fs2Z>*mWCXsw_4|dY#}!^?HaqE%+n@zys}s1)U^d+DJ&Q)+9yC*&J23XnLZ`*4ITTFtH$TNyLRoDTw~KN`bt(&aJu*d+)lduonhypvQ?JwvrWL`7RFR7--k+ z#E90JTwG7QJz)tq4^b8Qby>;R#whD|vQ zU7EAlnR5*{AH4I12y0 zq~x&0blsS&0Sc2B5Zq#SLH+G;l4dt7=6AU9oxJ11OVgRHtD;IQJaMGnNWp|87>zJ zFTwj|y@T;?D`elitHSZ@Oa7QILhEAhOP?=d*Tr>98sA|0!f+tyZ-u|Wx5x>{N`jmP zkqaQeIils&`8LEYouVC+pHmykOFg2Yao5v{T@gf;`U6Udip{97?4{#w|(x>0< zD$1)KS84B5xt6t>adIu{v`LX}!$w{>(s$mmg17JQi}6o>Sq1s6+o1;N6c_E#UZFM! z%h&kfm$3-hV-7)MkQWT4kQcdSM@_tm1@4bt^M0>e^*T4}{kQA>C@)4@!cgB1H>Fat zqQ4E)%`h=RH6ag}SXr{GXoa_$U-AVX&OLU_YQiEY_+wdw#g8wXco8HQpK{t_`yi2h za@Q9;E(Cm1yDxfM;tIfH%Zj8D7hYcC$t74=6=kbem{;lA)q4lTKM;_Y{9VdF(myyG zPD;Iep;zT{UikS#yi-%FI?>#_2Y=nOgwwuxOeJ3PVWXZ)P+PA2$=Z3_iT~7y7{dYn zhKs~bHg6mt@kh~Hr|?<)zt`8=_&G`iuNKBW?%bY@7z*in0DjWtOY znDZ_IGaW`OsQ&jXGp!8Cm@>_Pjzk4;OCv^frf!mfZ$c~iXr?rSMXAutf;4|9X=fn8 za$|g+@UgaqL|gYT{E^@HenBLIR#G!0A6e>ERlEfB)kymX)(^~sz2Q?a<`ronxjC)r zb5}CkFv!)wIqp)H(^oT>69KVLlmQG;=^?BcN);B=JoXVbzj@!dP?P?G-`oOE9Pp>~ z3%*}B&5~md{UiE<&N%gye1;u3m}fjXZ@^+0hWr38`AUBP^An@F;K(?1M=RM6R?{EU ztsh$ZhG;MtmaR9bYiHcfCwg}P{<6uqb)9*~F#kq9`L?6{ac2!>7Y3RKW%H}{gY4rB zPpjOo{ukQMlHOLOu~J>|mzi7QN2s?<%xeUqXLTt@w?E%;sbX66RMQlW^O&hq^f|h(3Ip+$POylTBMxA);PQzMtvkx7VfyFZ z@(Y^vn}6|4kTNbHRM_9moQ4SVi@irbTmb~WzmTG3tRkag#E(t5h$o)rg{s3Hg`iAg zlNr2*r|iZRIa0&AsS7P;R=u0iybCLh5XBDcZkTAfLam06hL3_%i$CWmoU`7MF3yIJ zf$5ThkCYu}snN;$rwdP^lk<--bR&Ab-9^SODIqOAxcCqv`%{84L6DYnLw9CIKSo*& z@cn3m+qEbf44~Ez7e_<}+6xLfiI6u%gb-OGf#s5N76fG~q-2yh+B!7;N(_MwN`Ng2 zhz%ANNnEKL>sGr*>!Hv<(E&K0tHIvihy&!A`nB!XdgS+Z&73*6%Z={{zxK7~ZW3|D z;Lz`9*0sFzOmBse3`6lviFSVMO?w>Z?yX;;IQ#K8VDd-+CTsgdYdXH-KPd1AXSNwv z+micnh9(DK3x~)_MR{esCqIoPY{C;6+^j6LbZHIGlCQY3|3>@7=NnwmYCoM)K;Gd% z-ccd!*h1c!A?(D}_&AM5EKqnAYU&nJ#r7<~3=9$kqn{}azZE@GD z|7b!nk9ua9S@(UY_I1$zvA1lO;Yho<@0lkXk-JeG1kcmeoob}bLX6&}&1xqbx%IYc zyK5Q0WMxvJum}q2_$y!K4*Px<{TJmZTFy*?mU*S9=27c7_HRXpt!@#p?&lX*n@}ovTEX$TJ zXd5HcBbEyj=L#^K$cq|F(J(9qLFkJ4in8ud*<0pYhl*Rp|Ow_|{UfD*1*m@KoW5T!Bu3y9pFXc^EH#Z|lt$aXks7VtymQJ$2hA z`~&XiGWbTl*bq?YakNoE5n`Vy4*)v&{u!70o#Dy9n8Ju=NV8+K3s zu4>Ww?W)SaksWn=s!WeQgwU~Y|gtw-CnGWvqzV&?S`{X7~j1?CmmwkyKg z&(ka*#rhlT0HG+s68N>zDD>#CyIYf$3-p|RBBPXbKx)ffG0iI!51H}@-{&K@K=Ub| z#;N5I@lP6mOzkd3Gs=r4Gj_m0kx~AOQ)vWY5>yz9v+88xQOJzVhKvc$Vj9DEaovk# zK>ed1 z4glkqE1x(O$5@$0);2V4KC-BD?s$+*JQl1(@f%*z)uc-~EcQHDtGwWQJqQHbxs3^WDkWhL;j#Cs&ZMddGQEW8`N_^N&n!5?8Rd60}ZylB(JDven_jG$Swj$I`9V65VF zj%g;4!z@1r4f-QIb7!4_u@c2p*S=l5;M-LHI7iJbvQXF(5mMYWsbF)DjEMJ1Idmv> za`n*B5op-+EK;lJ!y6d7Q{aGF@jjdX*TlptTgFa151aPsQ)30OVd*TQ(Wznt{zsxTvF5m8UV)jf!*sl(`>XCqQQv>yBuS}W1&V|yg zohdJsaK4c3?nlus1u;NT+5kk-O$<0WR~Trt+DFkZ6Zjaw?@xXb%vgma8z4L3tLT)B z%b6BR%{Ovbqj$g{j}iy|BI2yrpD!P8I$CdJ?ho7g0+UOsUrPQ6sm-8Y%rkOL^lS4{ z@PUetd`j@EGrM9U%SdiK_Ue+yG)W26 zNmzns(!>PLDIklHaY*{&Jr-%2`7qD(yRwhhT~UawqGw6LBg+)lhD!!-8fx7I>s8V5bfGQ$9L$~h|qp3hO@xGnKkMY(6CKeqH|-pl>zMbx2}6Heqkyy z?bS!!P0+6%`gai>`t#>)sY&QFxXI_!gua0TbDi+>iQ*D{V+i&({8YxV{$v_2ob;rA zBQ>eN8GW-FvCB({5I^!?g2I49Ff6M+UTNinfP7-oRB6$&83vuucfayih0<509E5H= z0ga1O!`|qi7cS(6Ni@@PMrdzMiH}K}Q*w59Z{CVQoH>m5 z!;?Ic@YSYa)w1S`eqtE6)UB=@f8T)%k_`BlAm#pn=Fk3VnLjgzG{V&TA}ToneBS-P zjs3A>W4mx_Ms3JbiC}4UbNDLTwGZKl;3;NF3tLp``vM$>$|ZMAxl7K1GWD-a>CY=u zzU+u#Zg4Cuj{s|GP%Jo#5d$Qoh&{BO>8YHcoM3ANVnMaG@HNa2)GO6+D%{&3ZK8@L z>V_N-XLf%l!AkjR)4z(0Fpb9r+Afm0m2~TS#SGZdH6YJaoXTfHqnO>bke!-0Xz$8@ z%H#8kpzX!9F*XmG_H>h`VPqSyquBF}K(*es&8k6?KVcRtuTFcdR$WTQ{essbzR zlT<2I@+fgGg_`8&QSnZ}kQ1vS1$s26PDx#Q11o*0$EO<=E-u2|18A5p}g7ZsC0r!0iZJLloe?j+?v zZXN2esO#8JA1LsCdShDQT%la!NGI+a9SqlKmYDx0@;<9_vr;6NtP_{q>e6v=y@gD? zfea#zhIg*o9XDq8weC?JfIi>r>Qig#rDjYSjQ_gnZE5toRbg5nU;{b*@XMn+J2h=$u!4M0_v+I1W9X zFO1E-78%pg#+Jraprvjl3EwJaSZfKd?ns%)OxYgN^Hp38{FN|}H4`y+Y#^B@R-rG} z)sjm#gP%>Bu2fxH^63o1m`b&WB&m@c1Tnj-c&;>8q&01;g0HGxP7hL zzSe8k$Tfij!K2C+G;VZp>jaU$GkDscqpu&YfwKU{{Q=`!QEXDEo$&@J))J`7#nQHJ zC`T70iCE(=3bpDVIRO(Eu9qB{+4Y`mo+QJw>a%;-tb>G0_^KM$tnhN@$+N4MYB6+& z)u#6jcy)*zC&8lKJU734ZY&bPlPSjO`DDPE6|#_9H_NxTlEYflxM-MImF4J&mE~-A zptuFYG;u{b1g}Q6pXWg1%AiRjNi-?pn^U;S+ zyo6*BGg4Ennc?p)c|(vNsA*A%{c!xGdb(U54XO#hIpRETSUfrizdU1@I07xHeE6wu z$imV5w|WPhMCaU_LiU$v$ta7GD{oG>>xhuaM2){trS!1|8@*1>r`GLKX``psaY zD*C+&Pua=pFmxbrmd5koX&R+mh;y_mx- z`ofz}%(A{*vk4lCjo+NPQTJj`$#pOpfu}W0bBj)Lsr-#5u1aN?Hu(s0#Hqe1d^Y^$ zsP{*cId2SEX}AYENplcs+>+223E+dymXg%cVZ0MimQ)A+z^}xpC=FY`u$r@04eDjX z#QBYDz4-3|=6FSn!&4ghcqK}oS5=@_SrRL)+^r>bvl<+RQ4*%=eP1qjF+#4-Bu$J4 zw_#DfA$5})?U(V_PpcNM;~Gz^xnIXcKCfIqkCQ&G?Y|uY2D{0M@BBq>j4V*|X2r`? zgc-R~7Q%SkN?ieIN(ooUaqWtj!khLT>`uyK+;kh1NE`q#UAbU0wS+G+VchXl_&d=W*FOrj~V40hDJb>sB~S z>_^9sDmL;L$Uo(AhJG|un*+@i2Qc^h{dxl(P~nv~2^{>G5O7+?4E%hHttE*Z zWmSe)TELQibdZZj40p@t5oRuV)7ytfz^aMDkK(;^pB)zL@>}O z&{dp=wqrEmCaw%4z`2h}t>&$7MkPBrz&!;wS_hToD}ZDWgl%w|8SI2xHB((RCKnbv zCD4P@VSd2fR=K_7RFMoO`=9KI#z33Vqm@pq+-+7Wp(L+x7&_;oUl6u7x zX4-teU_R>R`)KX5gz-fAmDBzg|E{&eWz`Qw7J|=x!g2aHKD$Bk?l~FB^-#DX2w20e zl)_bNuy7b7R+T!I54<*?@Nu~ z>B1G67%HoU_3Max!x&a%eT&|J9gb^OAl?ewe&MPcsTlYwQmPQVD@dgpsJjT;?itum z%nEhU>XXbX6Z7*9h*k6-ce*9HPHjn(KXwkn-ojaoDz|W*DmAfOzk(Gb~ zsWp-rV5(Ghwd#Cho4f|8-OVU1X*p=Bs{>zSOAp4@7F6@XxICkC%|cDM(yiRmiDAak z;{E@jQEU=1lLG_@$QJDXq7mo+rP0N~!4|+EZe?qx=3-?F_+R{beV`3hS9{<8`QORj znL0NkNlr9iza>aP5fPI|1tthG0>jw=jsC$lB+86rL1nL`sdKGw4Q*4ejexC6KA+1a1MaW?vF!!Scb&6QJ2-cB!xS>KH;QD zKrA;{TADPF6GXa8-H2^xSvsmX zO3W?^@)E>^L4G!wM;#}V>XfShFFycpohu>3FIH|86tc!t616fU6U5KNii7fGQd8Fm z;oH<@CzZ;VE0-aI&MTHPmlaOdNA=;&$_z_AFG=E*E?WkVEnv%rp&}iiN6jLNF-enl zsT}r*w-MSbaN^9LTqy(SDjf>e6d-tQWLdqbJb7UVx`kba`m2wyWzWOZMDim0BTJ zl=q_TAWxDH$IJR!h^k0F7$7`I;=>5QBb8o*ka1qUumAyzRnwvax-!g{VL zw~9L0S_gaO`;H{A}l!`>@5uSrd8T%G`zO3jFPxYq$wcH)uS?R z3r<^n`VS<2qCJ$bqo*m*4*F^;L~YS(0nWuuN&<(4Qf_L~A6m(Vry1zLzO(tRm)<5 zT#{c{sHGfIdsyTpnlVl~UU_FVO$XHi8%I}VI}cVI$K3_g+lWYFLwK99P@|+n3yJ0) zGL%AGx&u^NxOaC~nU@ud+`A&y{&65B(fkL0k{4W;DjjDB=v9nTA?GT>Gq!BZaYIS$ zq9v)dLP17`S1Gf-Nmfd%#O4Z>^m3``9jhg#9t6{6#LK`)PNI2|icDGNzZjwPWpvrS zIYSLb0#>@!gs7LYQAeU)=RgfymsoAX_q91i)-+g@bsQIbJ;Y|tKSxK zbwnrO>lZF0Dq7BK0My!*ptd1ljm-d?Vz^86a#yf3%AcvlKu&3^kj02 z8-!_d2^*5{J59hvt_mwq9GVn{<36uvZ02%+s;B~6wHvM*K+1+B{EVEHQ< zJm(LjWw201Pm6j}fTs@&DN0Q0ePZk>lNd9*n)5$oD_KIbD!d(WhJCzP+jO7GWDKu0WtCE$jzEbiG!)=u29TFh!F^OB2<{RZq!6)uNt*Uo zAw4S+67byO<9~n}c&5F)y^4gOU>@kIu?(R{Pm1(&^Q12NTM@=rdR|!h$O#oNOz3(? zQ$*%vcE1poZ_R$CA=4SHWtdTW*uOLl*aKq48>;5ATE z{0v!c#C8YnNT*kny@qXmGOS##AR{NI6lu{6ib$tr>KFPiUsQsBbAL%p5Sp0I4z>s` zg8t|#C)y>n(gh{>m;PO=})L&#!{t=WiSm=UlWC4mFkugOBQA#N`Ei!-of?LLfaJ`F%09g#L z#|UW4^SYGtnlAX4M6eB;*Dh=cnjO^i^$zh9_zTq>dKD(<0B0@0OSaSy8DMu$x)H`U zzm1JpHNdP!vR@`36Z;L@0jkiitiD4*s32|fS`z*{=8|W{*yaFXeY(U=b}Q~4-;&?~ zJ$`s^yc7gBbUG!fU1nOP`udOUg6|7*jo6zaAUjp>zPtsF+a#oba3P%A*K}e01$tRi z$C~@##AJ{Y3l+*8q9_;M9NYO^zp=;a$9Cf`EoMx;n7i{Nc|tk^*pAm2Ms|ta>^ey< zS}T|^JsPfzrgH8s1dYpU<{I9$ur^)KQRC)NH#d>cH}n}L5^~H=UZGaEy877}Tw$?u z$*^Cwg}5{sKGD+Aj1fmgwd77K)c9%2HRV|~*v13r2{>kf++<4A#|n)mVhkBij-T&u zzcNae(L*LL>hw4f6>>oByj2#k+>sVU{%mt{R!ND=R6$k>&WdM;dQydqS4fTDJK9}U z#uL`(oT|9JKpkKJM2NI^OFQr|2roc_e@MD{WA zcAw;DMw44!iGScA-A+`A_z?}Rpob6WK)0Jd6ZXor5vfdR+E@vXy?rpJyRf+MVL-|Z z+`4ZMsNWs^G%&*h6J987vfs3a+*olpB-NR<4Vd_Uj z@bZLV)!*j0aRBw6VRiPT*q*6IKb6VjI-eTi--BmCYnDB@?I{rym8D+21(=8&a*^m# ztN$ET9q2BJ(IbBz6^m|SR6U;`*dsr0qFGUCCSNIT65f-GM^`CS-P-j@9n^Sc%fQq` zgU^(8{rWf7;IbGc;_B%`XHfq93b9X=u9wt`-UM3mTg!+Mt0$CsJ!;yX4fk8K12U1U z1GEO2>map3b&iM2l$h&m-7dxA$fFX=;^oL*g*$-rFxyg)5mmu~Dcd!DFwe4-?BlH> z-bMA%3_*ow!0N$pKm1fYm{%t#p$M|IkRT@_=%UI5pQvQlI5qoG4Y8lS!Ico0^`f?1 zD$=RRPr&HW4@cl^1g|4IDdNN5n-Mm(2YK0Nj6)uoIw4VM90r#ip1t**F&J(tP0jIh z25v0W$#Q6P0ybPqJEa`PyY`$6;h+3>0s0RroP~wscv7tS%Mz`?JFZVk{3Q0PeS{W7 zQwwpnyQ=vmRd9Zq3L|6a7{20RMpXZQMH8v>&KP*4ZW})T?SpeNW=1l)#M_9&1`r1S zbc2OYvEcskeFfyaFiDN{%UmMg&cVC94|#w{V+XNGFmt@Y8R5mZNU%RC$=A`0W2TfS zJBAAOzmWrtkN>B!uMDbd+q%RF?h@P~xE$OexCJ@5ySuxEAOQ{pC%C&F;1D!{;O-s{ z7Tn#w+^@Uq-uJrSS3P&_s=aGgjrC*BJ$~#p#~K@^EZAtCy~)5bo24c5X@)}?S;*5V z(kt>Sy3hjoZv|^kcu!(h)Z6n3jNnugcpg*!EpDoDp@(VPdY)O>rh=%~kCK=7>B@VS z3+@HO<~!oW+I-``))crH#K@ot>s^`MCPnuu?=m51pcZj2OYK z+};sCqx1@1`Q>w`MwKJE0Cl26oj)+3DX33w*DC`frm9M@?QtNz^1l-F360v9+7U!t z4>ii{ZN5qtGdTU&z<4o%m}PIk_bRZX;yz(TZ0uq6a0uFzKEN^_mFr~ZktQdnwjhpB zzJ1~fNp3H4bcP`igp$x_LngbwL{Ww12MiWMSoUgN?49ilyFE`XcH*7l%!-g#XCrq} z$MQus&Fx1>K3MJp&Is+IUeuEYxgwnvQ{cX3$eyY7kZkh4&(%66v+Z0iyp0Z&#(&ed zh3IxyM|{!i%(A(5rY6uuY)HQ2olQ)W#AL1iqDIUPk9MYoE*;CHnDH}D$XgSSB!NjK zgpGT+KOo`W^BcJc0EeyDe0u(#~3c{`clL@~Is#?P;) zT6_kZ$112xZ=I4tJH4)E)^`L}sws2U}krlH zKatzt(0OYfgZbb4duIuoLkgum4`^(o@zF5HmnBsTL4dRb$>MV=B3#p~u?#=R^vcss`Yd zZhS#PFa)PAIy&hED?~tzrP?FpG+pOq{4A=>5J({@yF`MQ4`gZ(q2Y>-95Fb zD?rln6GyZ?5^-#+#76O2(gMSL_5c*p*day+%6<#st~2RY*Mq6Er@h4kd0~vXr@-Cw z8?+ZD$%{x1wu3e^5`$LYMH#-XilW`GlFYQiY!QQGg2G=H18Rau8_UQ;wh zbPyGAUS%)>G?v_PjR6B9%W&l_4N+^HLjFbSFpjXfHhhhW{*$Z5l6x4Pr2L8#tn=g2 zWwzMX)E&Xu&1t`ECy|7&nVMCNbKFkah4clz^&~ix-RJe~`IQ7yC;MB!Z0<`iW@-aa z94g-T(shVgt5YORvw!q=w-DT#6+QOEH>)hHNwfZPQ{t&=WYQ(_>}5zj%#+#JC5LFT z!xoXJrC{Kgrw?5dD?-?8zRodIqj~JbEEb2zUry2*e5bl!rD{cuXjrdp>ug~yqo_=J z+e}b`H{W0NE8R$V5hd!1K(Y!K3W}|6{o(feLmKX#pemaqR$4U5POaKZ!xP z(#dSpa8vk6yE-TRomxBi5&cB)CQDtTG5-NR((E1i*t5l`3$sqZY$Zb$)|BWXlRSTz$gu@!ROzjcP zq9cV(OjR?$f26mUgu?>XVf5#axdL|^RLBo0k}l48rwt# zD;TfPoG~@7fdbK+Qr+rzB>T?5clHfIjzvhigej%-b2VKME3AEGa*S#=Q9xF@p2OHK zz-PC3cWjLKWoE`TlX`J!sX%O}hOP7x>6@(=$@3?xItqIyJ%#!&!e$RGeKja*v$d>; zsGcsr(Us+!I`PIwn<4Py%$e7T;0h}r9z3M>`%a`7i6g*+ni?c^J42fpLGM|qLPmuC zYc40-P_q zHQ5zv=ig#{vpPkFKf1{8mOWksrg;_z@(18^2F2(YR2r2#I7PK68|1nht$lBjL18Dx zTg))^Gj46ViU{e1`T8Q~G1&Wv$pDa99)^8sGo_!@Kc-Kdceb^$=ZR|u4}Ig=AKss0 zHy7d|rPPo?9F?ztfnVT>SD?$RR2jr)5Qdi_WvXAFU!4^wB5Pdh1#qv#cdpwKJrwa? zg=n=Pr4i>N(wsGn6Ef4YVx?pg(QUH=n?PD+_UMpQJM&?v1b1#5eRRh#^-uZm33tAD z$7tkP*f#rYn%6fJ!@x>guXw7@&e2!iUc)RD_R*dy@O2~7=em%mN8I<+zdhbPjQXsW zCD)9K$8nNo>mnt4P9m3v?1ok;OmXna3_$&l4==3M-ZLgSdwnwW_NlcBXczF5F)!oo z8kC_4;jg(lLnAy&N-^wflFX|RlXTStg`kouK-%K2AHNjal zHAn>fgR!I-HHua2(_+HE6?CT~NQc;pO_dj%`*BrA8hVqjD(ALrj2c;5W<~o@*RT@U32PP7&|NE zJHj8jX4GHEhJ6Hw^EjBlglvc3W@gl7yPxeir;Kaah`c`;rtM3tDm4MM?#&i5fZ`Zp zI4XB4WXK?Xu?SYrsyc!;96f%Uq+Q)*e&kjy2YoO8;*<86)oqZZ}nQY1isxAF_C-*++HB zb$}1N=x!;fh@x`zz;P*al8-A9H-VVt z_xJ{vc8$AR6<0b|28SdAZ4?29iETth8RhGY15LK#2>F{HkZjBvkhcU0PlA-0q`c(5y(6L^e=YLs!F9T;&F$i27Jg&>3_ezps8!;xf(WpVTs=W{doczoWCy{lIoy>Lc;Yk$>*f9;-SzcT^~P zRNw%~sNI_Kq*W_6z@NA^-F5+)h@i``BlP>9zgb7+T(>@Fx|&Gt9bfYdMNQOj$ z;>RcF3rCx=k=xhm0$nlE0)-?qjEJ{URA{2SObB5t$WXpaPz5KCmp)Z*cvk9M%Lt7z zJY+Bw6rSM?TjicnL&Wo`8M%&nEZ4SG?~(joGZ?~uekwLtc10K*Et8#DJXZu==D%21 zU^pM=^L=`L9NG%8rt~xPz?^gpsTtYxw@x$2PSs4-gm&dINd9uSo;?tIMkLvtp_V&* zEVrmz67f;P>^lNR&q073lSh>^C)I*Nl+87x<|MIuIlA+E@@3z8yF1I5QmA!P61V;S}McqUeGFk+q?bhBC<1yjW8zS8d7pg7wrhW*Cn<_d@y% z>!D!+sD4z}Y4vpc1{xrxg=h;6RQ!;U-tfeCiAIcrEJ?fP^~{Xri@|b_E7VJ+ypM2} za^>G(djwtuoSZq<-6Pv`twIVH+2UYm8xy0*%gP(y4dioiGOpy+T;0wj31|8;ji4s3p&(Py;byR4+ft0P5`Tl37kZg18&sK=HjLo*I{S_W}1L;Re6~^)7B8B zRr=aTJ1ei409mJmnT*}VpIYg2FQ4rb)pVkSHp(7Fp0AeRw|O_5*S4atMZd=C;9>M$ z?)4l3e_acmJs_U>M~oNoQ;WMudI!rLUj@WYQexvi;Ur&U9+!zvS=1{8m50Q>AQitl zk4$)-ZBD?bkh29r^*a0}eZqV(FTT(gG^xL)#R$nRB0ipBNU)ygy@&LOpIR_~+|8v* zoZi5jO`d#7I@QE1X8I`UBblXw6b~Cg_sXGU@c~Khq#ogoq3wCM#MsMxrOmEwlOcWW z)UBowFvdZ)W+kS5C5q@pwKscjWWP)p3nce)vc3h^yrJ^Zn^3uSHbsh%Gn_69NBBdm-rZpi)ckp*qWw@pCb4H%8ZzAz&-|7ADhOssN9ev zFZl6?+V=n!TAS=nHQOkZRpf0&IVU3Wmgcj%a*xg1?{xNgY6ORWHtw;BM0e~6JeaE< zY){F!9;yKNIDzY zpM4Y{cf6%6aB0@25fF$h5qAq!B+Tyi1J~NWwY<_14+vExAPlB=RSUCVpuB{90^wA)eHzwm&Nwu62_Wx!ZQctW~c63~wHz=SE^JPD0$o zrf0b)Ai9=Nyty>b+#R#zL1;Z;)jz5=?GmIostwl!>``8~HAEYohi&5RaTMkJ_9nv! zeUx3H_hp2h?)fbzIbNbyPPt(7D?z7_!Zawop*fmDIKw=2p*4_NSt-X%oJj_59Sp!b}%<;)&!6u}0a<5MFJ!TS7uc)T$ zHDa@cPd{Jp=rM__u)`Nq7~HYU?h|PeMC5)@~8= zp1bMys4a1(OnUAJ5xa%NyOW3ioPK}KbDn2<4mT1rSl%+$oQWEhw9PC+-4vZph30}K z9J8}!l^1yA6HfDbF$cFJ1=4&Jw9BXBzI!zD?@m;u<42usLFxW1^E}yb%=MiMc9L0{ zT>fd50eWn=5g??dfUgtfB7qk zvoxB<^I{5Hwr^M%TJLA$R&8qiESbO94$+9fCcwWKD1VL&4E(+>cCJp%@ZeBFPtZbJ zgY6=bt;{y1fX_Y)0XX@`r`@-$G+w0J^c5aObpGDrsf@bl3(gHhcf-1NLrop7cNB!Q?`UL~E{l^KZP zN4ml3q*|h1GS>I(IdX$-+Cj~Rp|C{1%E3mVjvS*LdXXp|d>`#dvJ^5$E4G8h#GQ0h z?#NNIEZWNewG-gB;1&WbaGBeh_il18BG9zneR}RwC7naft#WtH=O|y}Y$bz=1dNp*0OOO00Lr7z7PC%;~zN1L0YF@sa0!iD$#u zcht-MnbtbJIQ_kbFsDDwh$6RN`^rr-OP!DuMx!j^?yUE-d)ysI+`R|uuFGKI1zT{% z#fw(zr_8K%R5RV?Hq=U^60(9owpxwYW9-PZV*TvWWyJohf;KUokKdCY!5_At%N;bk z69y&UH{=_apYxTUd%Ff8&-ya9b;jAB2e1!2LAmuAyjRHTq5@LvS@K&vQkJ>dnr5}7 z8hgJRNKGRoWV=M^?33_FX+Xbw1{CuD?@*iT_nbF7XQKWA-@Ev z#2F9g?uY05zSDk6R>AD;6rPcL4u!~4?fdU3T3}R~Hgrtuo&A!k)f4&7Qi<{L-Ya{c z|Bhq2W&lF2|c<l z(!AX=Bd}w#5~-1{jlObEC_QXG5^V}kQ_EFrDJYw^?_BH|F)|xyBfynN6Q&$xEY%S` z?=uVzLOE^q+EuEO4NMWaCGf<*4+l%pLkT{~u<=e1;1Yu0kUj8RNPc;eI^=Zdb6XGR zY&nDj9aH>FzwvN9bQgw<(2R z#j|mq^T|2%GW}+{&@y#l519S6Xy+98*rtecTd5baw0fLUg7et6c)r83OO(leClVAm zfzwsTxA5up`uw>(pCLMkv6MFC;m*NcAdqF4n`RCjK$B|u7AFk_Zx7kwGM|qS|A9*k z)YF?z3$}N8WQ8A6O5&Kjn~%Y= z?YzUbKBGmYxmsftE2x1Y6dr!@toYe%Fk_pTCcWUm-mdO3qXWRYc7R-U?3Sd1MIJJ( zC+nI6A9A!MP93CwCB{K?S$5o=1QzVAIzC*UYd9g)&C6a8I-$#fd3+Q3!dzw;E_0UO zcPVA}J%Sa3r7kZ$^fAQifR{etiYFc?r0&|B{_g4VZT{xWr&@2m?y|WH=S?R=>n?F%|v z`@VT~X$zj1QEKL*Mq2BYWzNg(SKnFll&Gg#FGLLQopRhq&)*r8>4OFp@dsP9Y%kj%Xf3s?Yx+MBsW-Ib1}@VB^wA~} zYG&Mg%y75Y>ol&+K*7a?@`IQCjP84~D#&>350Oy^7Zb4__xm$O7w1>>x26Gsa~i4$lgxEoCmOkAC}a>KTf!JDAK)FQzwOjFY$$xaVYidvHGNhUWEecO zJRtM^+M=-NNmFv*PJCzO5H8V#>-y5=;r>?ce&Pb@Ll8F^SLP#Us$HV#MPhgZa)sif z(40M%aB;QjW$6+1(Lm${;E)2-$Wo-xPx3Y8F#0^kGdcTRRkY z_saV=I6hk%+8vxYY|k0{dpiaDtI=<{ z8%&T;LQj<~H%Xa4m=k+0KYQ0HmCsVg6V3HFc=(0!*!(E$iyUR^wM5Bpc8++T9rgH; ze7)L0dsl)FRaKz0Z&8!XIt^0!7{~Uuh1}wTXG0dvNzB%^`P9oy9e&uGDsptYt)Erk zD&}sS(&u7?)$X#!2j&QwHvqhs7W)@AA@5Zvr6AKuBp6`Qq8zi5!XMkabO$ct>Ro^M}uM+sdnr6`7G-{p%{OUv~s@p)c@Ior>J~}Xawc9ftWXbBZm(JAG zzQuIvFk<=CL}MBd!KY2SH!0g>-C+g$%Y4VVAVXI-H00v)lC7A5sy3%wrP1)zk5B`0 zK#V~s@SnEx17g)bi6}H6?CBGhJ=`V7Q&H8~H*IYn~*- zrIVc;jdq9IoU~5g$JU=KHl?w|xU64=ol8NLseebPGt$|8AePHMm!CIbe-1GQ@pozI zbIUq!j3}9~JMfDS?4`X`>YjK$f^}!R>83hGkC|iRR-gM63+B$4q-xNl8VZv5Dbmaf zO66$1#oryu{#r{wXUH<-T2oq3%lm6XpX68{*$EO|+QuH$QeA{*1Zz7?|H}#){7q=z ze1YM>)u~jawkAQkuY!3wjnrnZyhg%~QffYjQ!=|*kszPgGijH|MGtluF~tGNRwz*b zMa8QM)G8KaP#@|(Ew*UzM~(=h=JXShG4{(@fo_nE@c5=4pZ)MGc2j*Ui10ApaoiS< z7TX3$I#g;~Ol8THW{x9|urJHCqlG#Q8F({5f@_)cMxLA7ij9O>`B)u%$O*I4uj6W}FefeT+%_DMQ#nU4K4h35s;s>MMcrw5 zIoaTDSBiPDq_~vAb$wL4)9!m}o$-4T?926;6tVoC^W^u4v?vnkZLQ54vm4#ofWIFU zen6Zxn=NFk?J{rkMDZ5Aots>{5SA~txjcY71*Kqu)6&aoZXxaMCe&&TXtF|-+mPT zYjWGM^X%E34F-nD?thxx=K0sjZ7W|3D_2iD7w3Nram%>7ySU5zpTz$f=}t`=QiYSm zj(SbDTE#|i6aU@M6nzO(PLz%yeUEq7vCQc6_p&VCaVaH?yP80!aeb5e#kQG)F8)>KC*km-jp%$4gGxa$+y`XZgdPhl`@3>sug| z8ZE)1s73QVx8k^B(fdizPxoN`75Yh7>ZTvH@{#J&2u7LyMitfTqT;DapZnW&jQxox>tuv=H5ej2N~hrm%9+DO8WLRal#N$)bGC= zPO{QG1HVHlo%p^IjkpeAVDEAzpm#G0kV>Udx~C65(&@Aa`m}pitirDiWQm*x`J|-^ z;tOP*RB?W!!IqoJFpIK?N7v=0^My68=va@qCD)EV#%!5Q5BlB#J1WzZ5hwRGaSiSC zuZq&e4Q9K+!oWoQnaBUnE-G~YT2TdOXDj#rR)qXp2|p%}InPL754>jo^tPX7paaC; zF@;?uwY^a?gii&*zGH$)D4nd-s}Kn~Y$p7zEwhN2}2P|-Pyz)kdq;hA@|T&OE1 z(Fa&R-m8B~?@>RE^@NQkw8-aqnQHnz8m zB~{t`ZHISA?TV6lh3wkL!54M1&Ryh!-`+^?x>LUEyv;h+d~Y+%WD#Egz*XpB)aP_; z5oTl%DCeBr3$bQv7l_M>@Q)Q5s3#ba-egqAx9=`XiH-m{baGC*hb<+tO9SI{FI=h2 zRl;mKkDX;$rpF zX7bI76g(UQ@N|AZp*8C?%PmSobY*W7OukQYj4MPZVw(PeDjK?VyqXmr1SpKV@>Y2e za@2B-sn%xrLC6mO(_S6Ny1HtS!7H{i&BA9$?b6A`26ayWEIZs@z{frJ*`Abe&9$9R z@G#*#ESdk~Bf%l1HDINWG)ik6@V3HVeC?OW#>6GtDPHBk7agMHnhuPpLs_patiO83 zjnrQf`ln~U!v9Y_gZ8Iqq?F&AXv=75DyXUQ%! zrI-45*nd*#Us9L9LzwS>!~Q>oFaM77&ky)7;{7|WE&c`P|CfgUeSv>g`!62&I|i)& qWr6?53jdDy&-(w>C4a}G&A;@_2PH(Lzmmv*F7iJFC2afG+kXLH(m8Erik C. Thauvin + * @since 1.0 + */ +public enum ExecFail { + ALL, EXIT, NONE, NORMAL, OUTPUT, STDERR, STDOUT +} diff --git a/src/main/java/rife/bld/extension/ExecOperation.java b/src/main/java/rife/bld/extension/ExecOperation.java new file mode 100644 index 0000000..fb83ceb --- /dev/null +++ b/src/main/java/rife/bld/extension/ExecOperation.java @@ -0,0 +1,146 @@ +/* + * Copyright 2023 the original author or authors. + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * https://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package rife.bld.extension; + +import rife.bld.BaseProject; +import rife.bld.operations.AbstractOperation; + +import java.io.File; +import java.io.IOException; +import java.io.InputStream; +import java.util.*; +import java.util.concurrent.TimeUnit; +import java.util.logging.Logger; + +/** + * Executes a command on the command line. + * + * @author Erik C. Thauvin + * @since 1.0 + */ +public class ExecOperation extends AbstractOperation { + private static final Logger LOGGER = Logger.getLogger(ExecOperation.class.getName()); + private final List args_ = new ArrayList<>(); + private final Set fail_ = new HashSet<>(); + private BaseProject project_; + private String workDir_; + + /** + * Configures the command and arguments to be executed. + *

+ * For example: + *

    + *
  • {@code command("cmd", "/c", "stop.bat")}
    • + *
  • {@code command("./stop.sh"}
    • + *

+ */ + public ExecOperation command(String... arg) { + args_.addAll(List.of(arg)); + return this; + } + + /** + * Executes the command. + */ + @Override + public void execute() throws Exception { + if (project_ == null) { + LOGGER.severe("A project must be specified."); + } + var errorMessage = new StringBuilder(27); + + final File workDir; + if (workDir_ == null || workDir_.isBlank()) { + workDir = new File(project_.workDirectory().getAbsolutePath()); + } else { + workDir = new File(workDir_); + } + + if (workDir.isDirectory()) { + var pb = new ProcessBuilder(); + pb.command(args_); + pb.directory(workDir); + + var proc = pb.start(); + var err = proc.waitFor(30, TimeUnit.SECONDS); + var stdout = readStream(proc.getInputStream()); + var stderr = readStream(proc.getErrorStream()); + + if (!err) { + errorMessage.append("TIMEOUT"); + } else if (!fail_.contains(ExecFail.NONE)) { + var all = fail_.contains(ExecFail.ALL); + var output = fail_.contains(ExecFail.OUTPUT); + if ((all || fail_.contains(ExecFail.EXIT) || fail_.contains(ExecFail.NORMAL)) && proc.exitValue() > 0) { + errorMessage.append("EXIT ").append(proc.exitValue()); + if (!stderr.isEmpty()) { + errorMessage.append(", STDERR -> ").append(stderr.get(0)); + } else if (!stdout.isEmpty()) { + errorMessage.append(", STDOUT -> ").append(stdout.get(0)); + } + } else if ((all || output || fail_.contains(ExecFail.STDERR) || fail_.contains(ExecFail.NORMAL)) + && !stderr.isEmpty()) { + errorMessage.append("STDERR -> ").append(stderr.get(0)); + } else if ((all || output || fail_.contains(ExecFail.STDOUT)) && !stdout.isEmpty()) { + errorMessage.append("STDOUT -> ").append(stdout.get(0)); + } + } + } else { + errorMessage.append("Invalid working directory: ").append(workDir.getCanonicalPath()); + } + + if (!errorMessage.isEmpty()) { + throw new IOException(errorMessage.toString()); + } + } + + /** + * Configure the failure mode. + * + * @see ExecFail + */ + public ExecOperation fail(ExecFail... fail) { + fail_.addAll(Set.of(fail)); + return this; + } + + /** + * Configures an Exec operation from a {@link BaseProject}. + */ + public ExecOperation fromProject(BaseProject project) { + project_ = project; + return this; + } + + private List readStream(InputStream stream) { + var lines = new ArrayList(); + try (var scanner = new Scanner(stream)) { + while (scanner.hasNextLine()) { + lines.add(scanner.nextLine()); + } + } + return lines; + } + + /** + * Configures the working directory. + */ + public ExecOperation workDir(String dir) { + workDir_ = dir; + return this; + } +} \ No newline at end of file diff --git a/src/test/java/rife/bld/extension/ExecOperationTest.java b/src/test/java/rife/bld/extension/ExecOperationTest.java new file mode 100644 index 0000000..9a01a69 --- /dev/null +++ b/src/test/java/rife/bld/extension/ExecOperationTest.java @@ -0,0 +1,128 @@ +/* + * Copyright 2023 the original author or authors. + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * https://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package rife.bld.extension; + +import org.junit.jupiter.api.Test; +import rife.bld.BaseProject; +import rife.bld.Project; +import rife.bld.WebProject; + +import java.io.File; +import java.io.IOException; + +import static org.assertj.core.api.Assertions.assertThat; +import static org.assertj.core.api.Assertions.assertThatCode; + + +class ExecOperationTest { + private static final String FOO = "foo"; + + @Test + void testAll() { + assertThatCode(() -> + new ExecOperation() + .fromProject(new Project()) + .command("date") + .fail(ExecFail.ALL) + .execute() + ).isInstanceOf(IOException.class); + } + + @Test + void testCat() throws Exception { + var tmpFile = new File("hello.tmp"); + tmpFile.deleteOnExit(); + new ExecOperation() + .fromProject(new Project()) + .command("touch", tmpFile.getName()) + .fail(ExecFail.NORMAL) + .execute(); + + assertThat(tmpFile).exists(); + } + + @Test + void testException() { + assertThatCode(() -> + new ExecOperation() + .fromProject(new BaseProject()) + .command(FOO) + .execute()).message().startsWith("Cannot run program \"" + FOO + '"'); + } + + @Test + void testExit() { + assertThatCode(() -> + new ExecOperation() + .fromProject(new BaseProject()) + .command("tail", FOO) + .fail(ExecFail.EXIT) + .execute()).message().startsWith("EXIT "); + } + + @Test + void testNone() { + assertThatCode(() -> + new ExecOperation() + .fromProject(new WebProject()) + .command("cat", FOO) + .fail(ExecFail.NONE) + .execute()).doesNotThrowAnyException(); + } + + @Test + void testOutput() { + assertThatCode(() -> + new ExecOperation() + .fromProject(new WebProject()) + .command("echo") + .fail(ExecFail.OUTPUT) + .execute() + ).message().isEqualTo("STDOUT -> "); + } + + @Test + void testStdErr() { + assertThatCode(() -> + new ExecOperation() + .fromProject(new BaseProject()) + .command("logger", "-s", "Hello") + .fail(ExecFail.STDERR) + .execute()).message().startsWith("STDERR -> ").endsWith("Hello"); + } + + @Test + void testStdOut() { + assertThatCode(() -> + new ExecOperation() + .fromProject(new BaseProject()) + .command("echo", "Hello") + .fail(ExecFail.STDOUT) + .execute()).message().isEqualTo("STDOUT -> Hello"); + } + + @Test + void testWorkDir() { + assertThatCode(() -> + new ExecOperation() + .fromProject(new BaseProject()) + .command("echo") + .workDir(FOO) + .fail(ExecFail.NORMAL) + .execute()).message().startsWith("Invalid working directory: ").endsWith(FOO); + } +} \ No newline at end of file