109 | * If the given {@code URL} is {@code null} or the properties can't be read, an empty properties object is returned. 110 | *
111 | * 112 | * @param url the {@code URL} of the properties resource to load or {@code null} 113 | * @return the loaded properties or an empty {@code Properties} instance if properties fail to load 114 | * @since 3.1.0 115 | */ 116 | @Nonnull 117 | public static Properties loadOptionalProperties(final @Nullable URL url) { 118 | 119 | Properties properties = new Properties(); 120 | if (url != null) { 121 | try (InputStream in = url.openStream()) { 122 | properties.load(in); 123 | } catch (IllegalArgumentException | IOException ex) { 124 | // ignore and return empty properties 125 | } 126 | } 127 | return properties; 128 | } 129 | 130 | /** 131 | * Loads {@code Properties} from a {@code File}. 132 | *133 | * If the given {@code File} is {@code null} or the properties file can't be read, an empty properties object is 134 | * returned. 135 | *
136 | * 137 | * @param file the {@code File} of the properties resource to load or {@code null} 138 | * @return the loaded properties or an empty {@code Properties} instance if properties fail to load 139 | * @since 3.1.0 140 | */ 141 | @Nonnull 142 | public static Properties loadOptionalProperties(final @Nullable File file) { 143 | Properties properties = new Properties(); 144 | if (file != null) { 145 | try (InputStream in = new FileInputStream(file)) { 146 | properties.load(in); 147 | } catch (IllegalArgumentException | IOException ex) { 148 | // ignore and return empty properties 149 | } 150 | } 151 | 152 | return properties; 153 | } 154 | 155 | /** 156 | * Loads {@code Properties} from an {@code InputStream} and closes the stream. 157 | * If the given {@code InputStream} is {@code null} or the properties can't be read, an empty properties object is 158 | * returned. In a future release, this will no longer close the stream, so callers 159 | * should close the stream themselves. 160 | * 161 | * @param inputStream the properties resource to load or {@code null} 162 | * @return the loaded properties or an empty {@code Properties} instance if properties fail to load 163 | * @since 3.1.0 164 | */ 165 | @Nonnull 166 | public static Properties loadOptionalProperties(final @Nullable InputStream inputStream) { 167 | 168 | Properties properties = new Properties(); 169 | 170 | if (inputStream != null) { 171 | try (InputStream in = inputStream) // reassign inputStream to autoclose 172 | { 173 | properties.load(in); 174 | } catch (IllegalArgumentException | IOException ex) { 175 | // ignore and return empty properties 176 | } 177 | } 178 | 179 | return properties; 180 | } 181 | } 182 | -------------------------------------------------------------------------------- /src/main/java/org/apache/maven/shared/utils/cli/AbstractStreamHandler.java: -------------------------------------------------------------------------------- 1 | /* 2 | * Licensed to the Apache Software Foundation (ASF) under one 3 | * or more contributor license agreements. See the NOTICE file 4 | * distributed with this work for additional information 5 | * regarding copyright ownership. The ASF licenses this file 6 | * to you under the Apache License, Version 2.0 (the 7 | * "License"); you may not use this file except in compliance 8 | * with the License. You may obtain a copy of the License at 9 | * 10 | * http://www.apache.org/licenses/LICENSE-2.0 11 | * 12 | * Unless required by applicable law or agreed to in writing, 13 | * software distributed under the License is distributed on an 14 | * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY 15 | * KIND, either express or implied. See the License for the 16 | * specific language governing permissions and limitations 17 | * under the License. 18 | */ 19 | package org.apache.maven.shared.utils.cli; 20 | 21 | /** 22 | * @author Kristian Rosenvold 23 | */ 24 | class AbstractStreamHandler extends Thread { 25 | private volatile boolean done; 26 | 27 | private volatile boolean disabled; 28 | 29 | boolean isDone() { 30 | return done; 31 | } 32 | 33 | public synchronized void waitUntilDone() throws InterruptedException { 34 | while (!isDone()) { 35 | wait(); 36 | } 37 | } 38 | 39 | boolean isDisabled() { 40 | return disabled; 41 | } 42 | 43 | public void disable() { 44 | disabled = true; 45 | } 46 | 47 | protected void setDone() { 48 | done = true; 49 | } 50 | } 51 | -------------------------------------------------------------------------------- /src/main/java/org/apache/maven/shared/utils/cli/Arg.java: -------------------------------------------------------------------------------- 1 | /* 2 | * Licensed to the Apache Software Foundation (ASF) under one 3 | * or more contributor license agreements. See the NOTICE file 4 | * distributed with this work for additional information 5 | * regarding copyright ownership. The ASF licenses this file 6 | * to you under the Apache License, Version 2.0 (the 7 | * "License"); you may not use this file except in compliance 8 | * with the License. You may obtain a copy of the License at 9 | * 10 | * http://www.apache.org/licenses/LICENSE-2.0 11 | * 12 | * Unless required by applicable law or agreed to in writing, 13 | * software distributed under the License is distributed on an 14 | * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY 15 | * KIND, either express or implied. See the License for the 16 | * specific language governing permissions and limitations 17 | * under the License. 18 | */ 19 | package org.apache.maven.shared.utils.cli; 20 | 21 | import java.io.File; 22 | 23 | /** 24 | * 25 | */ 26 | public interface Arg { 27 | /** 28 | * @param value the value to be set 29 | */ 30 | void setValue(String value); 31 | 32 | /** 33 | * @param line the line of arguments 34 | * @throws CommandLineException in case of unbalanced quotes. 35 | */ 36 | void setLine(String line) throws CommandLineException; 37 | 38 | /** 39 | * @param file the file to be set 40 | */ 41 | void setFile(File file); 42 | 43 | /** 44 | * Whether to hide the argument value when a command line prints the arguments. 45 | * 46 | * @param mask new state of the {@code mask} property 47 | * @since 0.6 48 | */ 49 | void setMask(boolean mask); 50 | } 51 | -------------------------------------------------------------------------------- /src/main/java/org/apache/maven/shared/utils/cli/CommandLineCallable.java: -------------------------------------------------------------------------------- 1 | /* 2 | * Licensed to the Apache Software Foundation (ASF) under one 3 | * or more contributor license agreements. See the NOTICE file 4 | * distributed with this work for additional information 5 | * regarding copyright ownership. The ASF licenses this file 6 | * to you under the Apache License, Version 2.0 (the 7 | * "License"); you may not use this file except in compliance 8 | * with the License. You may obtain a copy of the License at 9 | * 10 | * http://www.apache.org/licenses/LICENSE-2.0 11 | * 12 | * Unless required by applicable law or agreed to in writing, 13 | * software distributed under the License is distributed on an 14 | * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY 15 | * KIND, either express or implied. See the License for the 16 | * specific language governing permissions and limitations 17 | * under the License. 18 | */ 19 | package org.apache.maven.shared.utils.cli; 20 | 21 | import java.util.concurrent.Callable; 22 | 23 | /** 24 | * Callable wrapper that exposes the proper exception type to the client. 25 | * 26 | * @author Kristian Rosenvold 27 | */ 28 | public interface CommandLineCallable extends CallableWorks in concert with the StreamPumper class to 25 | * allow implementations to gain access to the lines being 26 | * "Pumped".
27 | *Please note that implementations of this interface can be expected to be 28 | * called from arbitrary threads and must therefore be threadsafe.
29 | * 30 | * @author Florin Vancea 31 | * @author Paul Julius 32 | */ 33 | public interface StreamConsumer { 34 | /** 35 | * Called when the StreamPumper pumps a line from the Stream. 36 | * @param line The line to be consumed. 37 | * @throws IOException if consuming {@code line} fails. 38 | */ 39 | void consumeLine(String line) throws IOException; 40 | } 41 | -------------------------------------------------------------------------------- /src/main/java/org/apache/maven/shared/utils/cli/StreamPollFeeder.java: -------------------------------------------------------------------------------- 1 | /* 2 | * Licensed to the Apache Software Foundation (ASF) under one 3 | * or more contributor license agreements. See the NOTICE file 4 | * distributed with this work for additional information 5 | * regarding copyright ownership. The ASF licenses this file 6 | * to you under the Apache License, Version 2.0 (the 7 | * "License"); you may not use this file except in compliance 8 | * with the License. You may obtain a copy of the License at 9 | * 10 | * http://www.apache.org/licenses/LICENSE-2.0 11 | * 12 | * Unless required by applicable law or agreed to in writing, 13 | * software distributed under the License is distributed on an 14 | * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY 15 | * KIND, either express or implied. See the License for the 16 | * specific language governing permissions and limitations 17 | * under the License. 18 | */ 19 | package org.apache.maven.shared.utils.cli; 20 | 21 | import java.io.IOException; 22 | import java.io.InputStream; 23 | import java.io.OutputStream; 24 | import java.util.Objects; 25 | 26 | /** 27 | * Poll InputStream for available data and write the output to an OutputStream. 28 | * 29 | * @author Trygve Laugstøl 30 | */ 31 | class StreamPollFeeder extends Thread { 32 | 33 | public static final int BUF_LEN = 80; 34 | 35 | private final InputStream input; 36 | private final OutputStream output; 37 | 38 | private Throwable exception; 39 | 40 | private boolean done; 41 | private final Object lock = new Object(); 42 | 43 | /** 44 | * Create a new StreamPollFeeder 45 | * 46 | * @param input Stream to read from 47 | * @param output Stream to write to 48 | */ 49 | StreamPollFeeder(InputStream input, OutputStream output) { 50 | this.input = Objects.requireNonNull(input); 51 | this.output = Objects.requireNonNull(output); 52 | this.done = false; 53 | } 54 | 55 | @Override 56 | public void run() { 57 | 58 | byte[] buf = new byte[BUF_LEN]; 59 | 60 | try { 61 | while (!done) { 62 | if (input.available() > 0) { 63 | int i = input.read(buf); 64 | if (i > 0) { 65 | output.write(buf, 0, i); 66 | output.flush(); 67 | } else { 68 | done = true; 69 | } 70 | } else { 71 | synchronized (lock) { 72 | if (!done) { 73 | lock.wait(100); 74 | } 75 | } 76 | } 77 | } 78 | } catch (IOException e) { 79 | exception = e; 80 | } catch (InterruptedException e) { 81 | Thread.currentThread().interrupt(); 82 | } finally { 83 | close(); 84 | } 85 | } 86 | 87 | private void close() { 88 | try { 89 | output.close(); 90 | } catch (IOException e) { 91 | if (exception == null) { 92 | exception = e; 93 | } 94 | } 95 | } 96 | 97 | /** 98 | * @since 3.2.0 99 | */ 100 | public Throwable getException() { 101 | return this.exception; 102 | } 103 | 104 | public void waitUntilDone() { 105 | 106 | synchronized (lock) { 107 | done = true; 108 | lock.notifyAll(); 109 | } 110 | 111 | try { 112 | join(); 113 | } catch (InterruptedException e) { 114 | Thread.currentThread().interrupt(); 115 | } 116 | } 117 | } 118 | -------------------------------------------------------------------------------- /src/main/java/org/apache/maven/shared/utils/cli/StreamPumper.java: -------------------------------------------------------------------------------- 1 | /* 2 | * Licensed to the Apache Software Foundation (ASF) under one 3 | * or more contributor license agreements. See the NOTICE file 4 | * distributed with this work for additional information 5 | * regarding copyright ownership. The ASF licenses this file 6 | * to you under the Apache License, Version 2.0 (the 7 | * "License"); you may not use this file except in compliance 8 | * with the License. You may obtain a copy of the License at 9 | * 10 | * http://www.apache.org/licenses/LICENSE-2.0 11 | * 12 | * Unless required by applicable law or agreed to in writing, 13 | * software distributed under the License is distributed on an 14 | * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY 15 | * KIND, either express or implied. See the License for the 16 | * specific language governing permissions and limitations 17 | * under the License. 18 | */ 19 | package org.apache.maven.shared.utils.cli; 20 | 21 | import javax.annotation.Nullable; 22 | 23 | import java.io.BufferedReader; 24 | import java.io.IOException; 25 | import java.io.InputStream; 26 | import java.io.InputStreamReader; 27 | import java.io.Reader; 28 | import java.nio.charset.Charset; 29 | 30 | /** 31 | * Class to pump the error stream during Process's runtime. Copied from the Ant built-in task. 32 | * 33 | * @author Florin Vancea 34 | * @author Paul Julius 35 | */ 36 | public class StreamPumper extends AbstractStreamHandler { 37 | private final BufferedReader in; 38 | 39 | private final StreamConsumer consumer; 40 | 41 | private volatile Exception exception = null; 42 | 43 | private static final int SIZE = 1024; 44 | 45 | /** 46 | * @param in {@link InputStream} 47 | * @param consumer {@link StreamConsumer} 48 | */ 49 | public StreamPumper(InputStream in, StreamConsumer consumer) { 50 | this(new InputStreamReader(in), consumer); 51 | } 52 | 53 | /** 54 | * @param in {@link InputStream} 55 | * @param consumer {@link StreamConsumer} 56 | * @param charset {@link Charset} 57 | */ 58 | public StreamPumper(InputStream in, StreamConsumer consumer, @Nullable Charset charset) { 59 | this(null == charset ? new InputStreamReader(in) : new InputStreamReader(in, charset), consumer); 60 | } 61 | 62 | /** 63 | * @param in {@link Reader} 64 | * @param consumer {@link StreamConsumer} 65 | */ 66 | private StreamPumper(Reader in, StreamConsumer consumer) { 67 | super(); 68 | this.in = new BufferedReader(in, SIZE); 69 | this.consumer = consumer; 70 | } 71 | 72 | /** run it. */ 73 | public void run() { 74 | try { 75 | for (String line = in.readLine(); line != null; line = in.readLine()) { 76 | try { 77 | if (exception == null) { 78 | consumeLine(line); 79 | } 80 | } catch (Exception t) { 81 | exception = t; 82 | } 83 | } 84 | } catch (IOException e) { 85 | exception = e; 86 | } finally { 87 | try { 88 | in.close(); 89 | } catch (final IOException e2) { 90 | if (this.exception == null) { 91 | this.exception = e2; 92 | } 93 | } 94 | 95 | synchronized (this) { 96 | setDone(); 97 | 98 | this.notifyAll(); 99 | } 100 | } 101 | } 102 | 103 | /** 104 | * flush. 105 | * 106 | * @deprecated As of 3.2.0, removed without replacement. 107 | */ 108 | @Deprecated 109 | public void flush() { 110 | // Nothing to flush. 111 | } 112 | 113 | /** 114 | * Close it. 115 | * 116 | * @deprecated As of 3.2.0, removed without replacement. 117 | */ 118 | @Deprecated 119 | public void close() { 120 | // Nothing to close. 121 | } 122 | 123 | /** 124 | * @return {@link Exception} 125 | */ 126 | public Exception getException() { 127 | return exception; 128 | } 129 | 130 | private void consumeLine(String line) throws IOException { 131 | if (consumer != null && !isDisabled()) { 132 | consumer.consumeLine(line); 133 | } 134 | } 135 | } 136 | -------------------------------------------------------------------------------- /src/main/java/org/apache/maven/shared/utils/cli/WriterStreamConsumer.java: -------------------------------------------------------------------------------- 1 | /* 2 | * Licensed to the Apache Software Foundation (ASF) under one 3 | * or more contributor license agreements. See the NOTICE file 4 | * distributed with this work for additional information 5 | * regarding copyright ownership. The ASF licenses this file 6 | * to you under the Apache License, Version 2.0 (the 7 | * "License"); you may not use this file except in compliance 8 | * with the License. You may obtain a copy of the License at 9 | * 10 | * http://www.apache.org/licenses/LICENSE-2.0 11 | * 12 | * Unless required by applicable law or agreed to in writing, 13 | * software distributed under the License is distributed on an 14 | * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY 15 | * KIND, either express or implied. See the License for the 16 | * specific language governing permissions and limitations 17 | * under the License. 18 | */ 19 | package org.apache.maven.shared.utils.cli; 20 | 21 | import java.io.BufferedWriter; 22 | import java.io.IOException; 23 | import java.io.Writer; 24 | 25 | /** 26 | * @author Jason van Zyl 27 | * 28 | */ 29 | public class WriterStreamConsumer implements StreamConsumer { 30 | 31 | private final BufferedWriter writer; 32 | 33 | /** 34 | * @param writer {@link Writer} 35 | */ 36 | public WriterStreamConsumer(Writer writer) { 37 | super(); 38 | this.writer = new BufferedWriter(writer); 39 | } 40 | 41 | /** 42 | * {@inheritDoc} 43 | */ 44 | @Override 45 | public void consumeLine(String line) throws IOException { 46 | this.writer.append(line); 47 | this.writer.newLine(); 48 | this.writer.flush(); 49 | } 50 | } 51 | -------------------------------------------------------------------------------- /src/main/java/org/apache/maven/shared/utils/cli/javatool/AbstractJavaToolRequest.java: -------------------------------------------------------------------------------- 1 | /* 2 | * Licensed to the Apache Software Foundation (ASF) under one 3 | * or more contributor license agreements. See the NOTICE file 4 | * distributed with this work for additional information 5 | * regarding copyright ownership. The ASF licenses this file 6 | * to you under the Apache License, Version 2.0 (the 7 | * "License"); you may not use this file except in compliance 8 | * with the License. You may obtain a copy of the License at 9 | * 10 | * http://www.apache.org/licenses/LICENSE-2.0 11 | * 12 | * Unless required by applicable law or agreed to in writing, 13 | * software distributed under the License is distributed on an 14 | * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY 15 | * KIND, either express or implied. See the License for the 16 | * specific language governing permissions and limitations 17 | * under the License. 18 | */ 19 | package org.apache.maven.shared.utils.cli.javatool; 20 | 21 | import org.apache.maven.shared.utils.cli.StreamConsumer; 22 | 23 | /** 24 | * Abstract implementation of a {@link JavaToolRequest}. 25 | * 26 | * @author Tony Chemit 27 | * @since 0.5 28 | */ 29 | public class AbstractJavaToolRequest implements JavaToolRequest { 30 | 31 | /** 32 | * Optional system out stream consumer used by the commandline execution. 33 | */ 34 | private StreamConsumer systemOutStreamConsumer; 35 | 36 | /** 37 | * Optional system error stream consumer used by the commandline execution. 38 | */ 39 | private StreamConsumer systemErrorStreamConsumer; 40 | 41 | /** 42 | * {@inheritDoc} 43 | */ 44 | public StreamConsumer getSystemOutStreamConsumer() { 45 | return systemOutStreamConsumer; 46 | } 47 | 48 | /** 49 | * {@inheritDoc} 50 | */ 51 | public StreamConsumer getSystemErrorStreamConsumer() { 52 | return systemErrorStreamConsumer; 53 | } 54 | 55 | /** 56 | * {@inheritDoc} 57 | */ 58 | public void setSystemOutStreamConsumer(StreamConsumer systemOutStreamConsumer) { 59 | this.systemOutStreamConsumer = systemOutStreamConsumer; 60 | } 61 | 62 | /** 63 | * {@inheritDoc} 64 | */ 65 | public void setSystemErrorStreamConsumer(StreamConsumer systemErrorStreamConsumer) { 66 | this.systemErrorStreamConsumer = systemErrorStreamConsumer; 67 | } 68 | } 69 | -------------------------------------------------------------------------------- /src/main/java/org/apache/maven/shared/utils/cli/javatool/JavaTool.java: -------------------------------------------------------------------------------- 1 | /* 2 | * Licensed to the Apache Software Foundation (ASF) under one 3 | * or more contributor license agreements. See the NOTICE file 4 | * distributed with this work for additional information 5 | * regarding copyright ownership. The ASF licenses this file 6 | * to you under the Apache License, Version 2.0 (the 7 | * "License"); you may not use this file except in compliance 8 | * with the License. You may obtain a copy of the License at 9 | * 10 | * http://www.apache.org/licenses/LICENSE-2.0 11 | * 12 | * Unless required by applicable law or agreed to in writing, 13 | * software distributed under the License is distributed on an 14 | * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY 15 | * KIND, either express or implied. See the License for the 16 | * specific language governing permissions and limitations 17 | * under the License. 18 | */ 19 | package org.apache.maven.shared.utils.cli.javatool; 20 | 21 | /** 22 | *Describes a java tool, means a executable available in the jdk.
23 | *The name of the tool ({@link #getJavaToolName()}) reflects the name of the executable that should exists as an 24 | * executable in the jdk, like {@code jarsigner, keytool, javadoc, ...}.
25 | *An abstract implementation of the {@link JavaTool} named {@link AbstractJavaTool} use the command line API to 26 | * execute any user requests of this tool.
27 | * 28 | * @author Tony Chemit 29 | * @since 0.5 30 | * @paramReturn the name of the java tool. This is exactly the name (without his extension) of the executable to 36 | * find in the {@code jdk/bin} directory.
37 | *For example: {@code jarsigner, keytool, javadoc, ...}
38 | * 39 | * @return the name of the java tool. 40 | */ 41 | String getJavaToolName(); 42 | 43 | /** 44 | * Set an optional tool chain to find out the java tool executable location. 45 | * 46 | * @param toolchain optional tool chain to find out the java tool executable location. 47 | * To avoid direct dependency on Maven core, this parameter is an Object that will be 48 | * used as Toolchain through reflection 49 | */ 50 | void setToolchain(Object toolchain); 51 | 52 | /** 53 | *Execute the input request and then returns the result of the execution.
54 | *If could not create the java tool invocation, a {@link JavaToolException} will be thrown.
55 | *If execution fails, then the result will have a none-zero {@link JavaToolResult#getExitCode()} and his 56 | * {@link JavaToolResult#getExecutionException()} will be filled with the error, otherwise the exist code will be 57 | * zero.
58 | * 59 | * @param request the request to perform 60 | * @return the result of the tool execution 61 | * @throws JavaToolException if could not create the java tool invocation 62 | */ 63 | JavaToolResult execute(Request request) throws JavaToolException; 64 | } 65 | -------------------------------------------------------------------------------- /src/main/java/org/apache/maven/shared/utils/cli/javatool/JavaToolException.java: -------------------------------------------------------------------------------- 1 | /* 2 | * Licensed to the Apache Software Foundation (ASF) under one 3 | * or more contributor license agreements. See the NOTICE file 4 | * distributed with this work for additional information 5 | * regarding copyright ownership. The ASF licenses this file 6 | * to you under the Apache License, Version 2.0 (the 7 | * "License"); you may not use this file except in compliance 8 | * with the License. You may obtain a copy of the License at 9 | * 10 | * http://www.apache.org/licenses/LICENSE-2.0 11 | * 12 | * Unless required by applicable law or agreed to in writing, 13 | * software distributed under the License is distributed on an 14 | * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY 15 | * KIND, either express or implied. See the License for the 16 | * specific language governing permissions and limitations 17 | * under the License. 18 | */ 19 | package org.apache.maven.shared.utils.cli.javatool; 20 | 21 | /** 22 | *Signals an error during the construction of the command line used to invoke java tool, e.g. illegal invocation 23 | * arguments.
24 | *This should not be confused with a failure of the invoked java tool build itself which will be reported by means 25 | * of a non-zero exit code.
26 | * 27 | * @author Tony Chemit 28 | * 29 | * @see JavaToolResult#getExitCode() 30 | * @since 0.5 31 | */ 32 | public class JavaToolException extends Exception { 33 | private static final long serialVersionUID = 1L; 34 | 35 | /** 36 | * @param message The message of the exception. 37 | */ 38 | public JavaToolException(String message) { 39 | super(message); 40 | } 41 | 42 | /** 43 | * @param message The message of the exception. 44 | * @param cause The cause of the exception. 45 | */ 46 | public JavaToolException(String message, Throwable cause) { 47 | super(message, cause); 48 | } 49 | } 50 | -------------------------------------------------------------------------------- /src/main/java/org/apache/maven/shared/utils/cli/javatool/JavaToolRequest.java: -------------------------------------------------------------------------------- 1 | /* 2 | * Licensed to the Apache Software Foundation (ASF) under one 3 | * or more contributor license agreements. See the NOTICE file 4 | * distributed with this work for additional information 5 | * regarding copyright ownership. The ASF licenses this file 6 | * to you under the Apache License, Version 2.0 (the 7 | * "License"); you may not use this file except in compliance 8 | * with the License. You may obtain a copy of the License at 9 | * 10 | * http://www.apache.org/licenses/LICENSE-2.0 11 | * 12 | * Unless required by applicable law or agreed to in writing, 13 | * software distributed under the License is distributed on an 14 | * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY 15 | * KIND, either express or implied. See the License for the 16 | * specific language governing permissions and limitations 17 | * under the License. 18 | */ 19 | package org.apache.maven.shared.utils.cli.javatool; 20 | 21 | import org.apache.maven.shared.utils.cli.StreamConsumer; 22 | 23 | /** 24 | * Specifies the minimum parameters used to control a {@link JavaTool} invocation. 25 | * 26 | * @author Tony Chemit 27 | * @since 0.5 28 | */ 29 | public interface JavaToolRequest { 30 | 31 | /** 32 | *Gets the value of the {@code systemOutStreamConsumer} field.
33 | *This option field if filled is used by the commandline tool to consume system ouput stream of the jarsigner 34 | * command.
35 | * 36 | * @return the value of the {@code systemOutStreamConsumer} field. 37 | */ 38 | StreamConsumer getSystemOutStreamConsumer(); 39 | 40 | /** 41 | *Gets the value of the {@code systemErrorStreamConsumer} field.
42 | *This option field if filled is used by the commandline tool to consume system error stream of the jarsigner 43 | * command.
44 | * 45 | * @return the value of the {@code systemErrorStreamConsumer} field. 46 | */ 47 | StreamConsumer getSystemErrorStreamConsumer(); 48 | 49 | /** 50 | * Sets the new given value to the field {@code systemOutStreamConsumer} of the request. 51 | * 52 | * @param systemOutStreamConsumer the new value of the field {@code systemOutStreamConsumer}. 53 | */ 54 | void setSystemOutStreamConsumer(StreamConsumer systemOutStreamConsumer); 55 | 56 | /** 57 | * Sets the new given value to the field {@code systemErrorStreamConsumer} of the request. 58 | * 59 | * @param systemErrorStreamConsumer the new value of the field {@code systemErrorStreamConsumer}. 60 | */ 61 | void setSystemErrorStreamConsumer(StreamConsumer systemErrorStreamConsumer); 62 | } 63 | -------------------------------------------------------------------------------- /src/main/java/org/apache/maven/shared/utils/cli/javatool/JavaToolResult.java: -------------------------------------------------------------------------------- 1 | /* 2 | * Licensed to the Apache Software Foundation (ASF) under one 3 | * or more contributor license agreements. See the NOTICE file 4 | * distributed with this work for additional information 5 | * regarding copyright ownership. The ASF licenses this file 6 | * to you under the Apache License, Version 2.0 (the 7 | * "License"); you may not use this file except in compliance 8 | * with the License. You may obtain a copy of the License at 9 | * 10 | * http://www.apache.org/licenses/LICENSE-2.0 11 | * 12 | * Unless required by applicable law or agreed to in writing, 13 | * software distributed under the License is distributed on an 14 | * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY 15 | * KIND, either express or implied. See the License for the 16 | * specific language governing permissions and limitations 17 | * under the License. 18 | */ 19 | package org.apache.maven.shared.utils.cli.javatool; 20 | 21 | import org.apache.maven.shared.utils.cli.CommandLineException; 22 | import org.apache.maven.shared.utils.cli.Commandline; 23 | 24 | /** 25 | * Describes the result of a {@link JavaTool} invocation. 26 | * 27 | * @author Tony Chemit 28 | * @since 0.5 29 | */ 30 | public class JavaToolResult { 31 | /** 32 | * The exception that prevented to execute the command line, will benull if jarSigner could be
33 | * successfully started.
34 | */
35 | private CommandLineException executionException;
36 |
37 | /**
38 | * The exit code reported by the Maven invocation.
39 | */
40 | private int exitCode = Integer.MIN_VALUE;
41 |
42 | /**
43 | * The command line used to obtain this result.
44 | */
45 | private Commandline commandline;
46 |
47 | /**
48 | * Gets the exit code from the tool invocation. A non-zero value indicates a build failure. Note:
49 | * This value is undefined if {@link #getExecutionException()} reports an exception.
50 | *
51 | * @return The exit code from the tool invocation.
52 | */
53 | public int getExitCode() {
54 | return exitCode;
55 | }
56 |
57 | /**
58 | * Gets the command line used.
59 | *
60 | * @return The command line used
61 | */
62 | public Commandline getCommandline() {
63 | return commandline;
64 | }
65 |
66 | /**
67 | * Gets the exception that possibly occurred during the execution of the command line.
68 | *
69 | * @return The exception that prevented to invoke tool or null if the command line was successfully
70 | * processed by the operating system.
71 | */
72 | public CommandLineException getExecutionException() {
73 | return executionException;
74 | }
75 |
76 | /**
77 | * Sets the exit code reported by the tool invocation.
78 | *
79 | * @param exitCode The exit code reported by the tool invocation.
80 | */
81 | public void setExitCode(int exitCode) {
82 | this.exitCode = exitCode;
83 | }
84 |
85 | /**
86 | * Sets the exception that prevented to execute the command line.
87 | *
88 | * @param executionException The exception that prevented to execute the command line, may be null.
89 | */
90 | public void setExecutionException(CommandLineException executionException) {
91 | this.executionException = executionException;
92 | }
93 |
94 | /**
95 | * Set the commandline used to obtain this result.
96 | *
97 | * @param commandline the commandline used to obtain this result
98 | */
99 | public void setCommandline(Commandline commandline) {
100 | this.commandline = commandline;
101 | }
102 | }
103 |
--------------------------------------------------------------------------------
/src/main/java/org/apache/maven/shared/utils/cli/shell/BourneShell.java:
--------------------------------------------------------------------------------
1 | /*
2 | * Licensed to the Apache Software Foundation (ASF) under one
3 | * or more contributor license agreements. See the NOTICE file
4 | * distributed with this work for additional information
5 | * regarding copyright ownership. The ASF licenses this file
6 | * to you under the Apache License, Version 2.0 (the
7 | * "License"); you may not use this file except in compliance
8 | * with the License. You may obtain a copy of the License at
9 | *
10 | * http://www.apache.org/licenses/LICENSE-2.0
11 | *
12 | * Unless required by applicable law or agreed to in writing,
13 | * software distributed under the License is distributed on an
14 | * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
15 | * KIND, either express or implied. See the License for the
16 | * specific language governing permissions and limitations
17 | * under the License.
18 | */
19 | package org.apache.maven.shared.utils.cli.shell;
20 |
21 | import java.util.ArrayList;
22 | import java.util.List;
23 |
24 | import org.apache.maven.shared.utils.Os;
25 |
26 | /**
27 | * @author Jason van Zyl
28 | */
29 | public class BourneShell extends Shell {
30 |
31 | /**
32 | * Create instance of BourneShell.
33 | */
34 | public BourneShell() {
35 | setUnconditionalQuoting(true);
36 | setShellCommand("/bin/sh");
37 | setArgumentQuoteDelimiter('\'');
38 | setExecutableQuoteDelimiter('\'');
39 | setSingleQuotedArgumentEscaped(true);
40 | setSingleQuotedExecutableEscaped(false);
41 | setQuotedExecutableEnabled(true);
42 | }
43 |
44 | /**
45 | * {@inheritDoc}
46 | */
47 | public String getExecutable() {
48 | if (Os.isFamily(Os.FAMILY_WINDOWS)) {
49 | return super.getExecutable();
50 | }
51 |
52 | return quoteOneItem(super.getExecutable(), true);
53 | }
54 |
55 | /** {@inheritDoc} */
56 | public ListUnify quotes in a path for the Bourne Shell.
101 | *
102 | * BourneShell.quoteOneItem(null) = null
103 | * BourneShell.quoteOneItem("") = ''
104 | * BourneShell.quoteOneItem("/test/quotedpath'abc") = '/test/quotedpath'"'"'abc'
105 | * BourneShell.quoteOneItem("/test/quoted path'abc") = '/test/quoted pat'"'"'habc'
106 | * BourneShell.quoteOneItem("/test/quotedpath\"abc") = '/test/quotedpath"abc'
107 | * BourneShell.quoteOneItem("/test/quoted path\"abc") = '/test/quoted path"abc'
108 | * BourneShell.quoteOneItem("/test/quotedpath\"'abc") = '/test/quotedpath"'"'"'abc'
109 | * BourneShell.quoteOneItem("/test/quoted path\"'abc") = '/test/quoted path"'"'"'abc'
110 | *
111 | *
112 | * @param path not null path.
113 | * @return the path unified correctly for the Bourne shell.
114 | */
115 | protected String quoteOneItem(String path, boolean isExecutable) {
116 | if (path == null) {
117 | return null;
118 | }
119 |
120 | return "'" + path.replace("'", "'\"'\"'") + "'";
121 | }
122 | }
123 |
--------------------------------------------------------------------------------
/src/main/java/org/apache/maven/shared/utils/cli/shell/CmdShell.java:
--------------------------------------------------------------------------------
1 | /*
2 | * Licensed to the Apache Software Foundation (ASF) under one
3 | * or more contributor license agreements. See the NOTICE file
4 | * distributed with this work for additional information
5 | * regarding copyright ownership. The ASF licenses this file
6 | * to you under the Apache License, Version 2.0 (the
7 | * "License"); you may not use this file except in compliance
8 | * with the License. You may obtain a copy of the License at
9 | *
10 | * http://www.apache.org/licenses/LICENSE-2.0
11 | *
12 | * Unless required by applicable law or agreed to in writing,
13 | * software distributed under the License is distributed on an
14 | * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
15 | * KIND, either express or implied. See the License for the
16 | * specific language governing permissions and limitations
17 | * under the License.
18 | */
19 | package org.apache.maven.shared.utils.cli.shell;
20 |
21 | import java.util.Arrays;
22 | import java.util.List;
23 |
24 | /**
25 | * Implementation to call the CMD Shell present on Windows NT, 2000, XP, 7, 8, and 10.
26 | *
27 | * @author Carlos Sanchez
28 | *
29 | */
30 | public class CmdShell extends Shell {
31 | /**
32 | * Create an instance of CmdShell.
33 | */
34 | public CmdShell() {
35 | setShellCommand("cmd.exe");
36 | setQuotedExecutableEnabled(true);
37 | setShellArgs(new String[] {"/X", "/C"});
38 | }
39 |
40 | /**
41 | * 42 | * Specific implementation that quotes all the command line. 43 | *
44 | *45 | * Workaround for http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6468220 46 | *
47 | *48 | * From cmd.exe /? output: 49 | *
50 | *
51 | * If /C or /K is specified, then the remainder of the command line after
52 | * the switch is processed as a command line, where the following logic is
53 | * used to process quote (") characters:
54 | *
55 | * 1. If all of the following conditions are met, then quote characters
56 | * on the command line are preserved:
57 | *
58 | * - no /S switch
59 | * - exactly two quote characters
60 | * - no special characters between the two quote characters,
61 | * where special is one of: &<>()@ˆ|
62 | * - there are one or more whitespace characters between the
63 | * the two quote characters
64 | * - the string between the two quote characters is the name
65 | * of an executable file.
66 | *
67 | * 2. Otherwise, old behavior is to see if the first character is
68 | * a quote character and if so, strip the leading character and
69 | * remove the last quote character on the command line, preserving
70 | * any text after the last quote character.
71 | *
72 | * 73 | * Always quoting the entire command line, regardless of these conditions 74 | * appears to make Windows processes invoke successfully. 75 | *
76 | * 77 | * @param executable The executable. 78 | * @param arguments The arguments for the executable. 79 | * @return The resulting command line. 80 | */ 81 | public ListDescribes a match target for SelectorUtils.
31 | *32 | * Significantly more efficient than using strings, since re-evaluation and re-tokenizing is avoided.
33 | * 34 | * @author Kristian Rosenvold 35 | * @deprecated use {@code java.nio.file.DirectoryStream.FilterChecks these MatchPatterns against a specified string.
41 | *Uses far less string tokenization than any of the alternatives.
42 | * 43 | * @param name The name to look for 44 | * @param isCaseSensitive If the comparison is case sensitive 45 | * @return true if any of the supplied patterns match 46 | */ 47 | public boolean matches(@Nonnull String name, boolean isCaseSensitive) { 48 | String[] tokenized = MatchPattern.tokenizePathToString(name, File.separator); 49 | for (MatchPattern pattern : patterns) { 50 | if (pattern.matchPath(name, tokenized, isCaseSensitive)) { 51 | return true; 52 | } 53 | } 54 | return false; 55 | } 56 | 57 | /** 58 | * @param name The name. 59 | * @param isCaseSensitive being case sensetive. 60 | * @return true if any of the supplied patterns match start. 61 | */ 62 | public boolean matchesPatternStart(@Nonnull String name, boolean isCaseSensitive) { 63 | for (MatchPattern includesPattern : patterns) { 64 | if (includesPattern.matchPatternStart(name, isCaseSensitive)) { 65 | return true; 66 | } 67 | } 68 | return false; 69 | } 70 | 71 | /** 72 | * @param sources The sources 73 | * @return Converted match patterns. 74 | */ 75 | public static MatchPatterns from(@Nonnull String... sources) { 76 | final int length = sources.length; 77 | MatchPattern[] result = new MatchPattern[length]; 78 | for (int i = 0; i < length; i++) { 79 | result[i] = MatchPattern.fromString(sources[i]); 80 | } 81 | return new MatchPatterns(result); 82 | } 83 | } 84 | -------------------------------------------------------------------------------- /src/main/java/org/apache/maven/shared/utils/io/ScanConductor.java: -------------------------------------------------------------------------------- 1 | /* 2 | * Licensed to the Apache Software Foundation (ASF) under one 3 | * or more contributor license agreements. See the NOTICE file 4 | * distributed with this work for additional information 5 | * regarding copyright ownership. The ASF licenses this file 6 | * to you under the Apache License, Version 2.0 (the 7 | * "License"); you may not use this file except in compliance 8 | * with the License. You may obtain a copy of the License at 9 | * 10 | * http://www.apache.org/licenses/LICENSE-2.0 11 | * 12 | * Unless required by applicable law or agreed to in writing, 13 | * software distributed under the License is distributed on an 14 | * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY 15 | * KIND, either express or implied. See the License for the 16 | * specific language governing permissions and limitations 17 | * under the License. 18 | */ 19 | package org.apache.maven.shared.utils.io; 20 | 21 | import java.io.File; 22 | 23 | /** 24 | *Visitor pattern for the DirectoryScanner. A ScanConductor controls the scanning process.
25 | *Create an instance and pass it to 26 | * {@link org.apache.maven.shared.utils.io.DirectoryScanner#setScanConductor(ScanConductor)}. 27 | * You will get notified about every visited directory and file. You can use the {@link ScanAction} 28 | * to control what should happen next.
29 | *A ScanConductor might also store own information but users must make sure that the state gets 30 | * cleaned between two scan() invocations.
31 | * 32 | * @author Mark Struberg 33 | * 34 | * @deprecated use {@code java.nio.file.Files.walkFileTree()} and related classes 35 | */ 36 | @Deprecated 37 | public interface ScanConductor { 38 | /** 39 | * 40 | */ 41 | enum ScanAction { 42 | /** 43 | * Abort the whole scanning process. The current file will not 44 | * be added anymore. 45 | */ 46 | ABORT, 47 | 48 | /** 49 | * Continue the scanning with the next item in the list. 50 | */ 51 | CONTINUE, 52 | 53 | /** 54 | * This response is only valid for {@link ScanConductor#visitDirectory(String, java.io.File)}. 55 | * Do not recurse into the current directory. The current directory will not be added 56 | * and the processing will be continued with the next item in the list. 57 | */ 58 | NO_RECURSE, 59 | 60 | /** 61 | * Abort processing the current directory. 62 | * The current file will not be added. 63 | * The processing will continue it's scan in the parent directory if any. 64 | */ 65 | ABORT_DIRECTORY 66 | } 67 | 68 | /** 69 | * This method will get invoked for every detected directory. 70 | * 71 | * @param name the directory name (contains parent folders up to the pwd) 72 | * @param directory The directory. 73 | * @return the ScanAction to control how to proceed with the scanning 74 | */ 75 | ScanAction visitDirectory(String name, File directory); 76 | 77 | /** 78 | * This method will get invoked for every detected file. 79 | * 80 | * @param name the file name (contains parent folders up to the pwd) 81 | * @param file The file. 82 | * @return the ScanAction to control how to proceed with the scanning 83 | */ 84 | ScanAction visitFile(String name, File file); 85 | } 86 | -------------------------------------------------------------------------------- /src/main/java/org/apache/maven/shared/utils/io/WalkCollector.java: -------------------------------------------------------------------------------- 1 | /* 2 | * Licensed to the Apache Software Foundation (ASF) under one 3 | * or more contributor license agreements. See the NOTICE file 4 | * distributed with this work for additional information 5 | * regarding copyright ownership. The ASF licenses this file 6 | * to you under the Apache License, Version 2.0 (the 7 | * "License"); you may not use this file except in compliance 8 | * with the License. You may obtain a copy of the License at 9 | * 10 | * http://www.apache.org/licenses/LICENSE-2.0 11 | * 12 | * Unless required by applicable law or agreed to in writing, 13 | * software distributed under the License is distributed on an 14 | * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY 15 | * KIND, either express or implied. See the License for the 16 | * specific language governing permissions and limitations 17 | * under the License. 18 | */ 19 | package org.apache.maven.shared.utils.io; 20 | 21 | import java.io.File; 22 | import java.util.ArrayList; 23 | import java.util.List; 24 | 25 | /** 26 | * @deprecated use {@code java.nio.file.FileVisitor} and related classes 27 | */ 28 | @Deprecated 29 | public class WalkCollector implements DirectoryWalkListener { 30 | final List24 | * Messages are built with instances of {@code MessageBuilder} 25 | * which provides a fluent API, while error level are colored by slf4j provider with 26 | * {@code LoggerLevelRenderer}. 27 | *
28 | * {@code MessageUtils} gives access to these builders. 29 | *
30 | * Plugins can use this API with any Maven version: color 31 | * just won't be activated when run with Maven versions older than 3.5.0. 32 | *
33 | * Styles are:
debug, info, warning and error for
35 | * logger level rendering,success, warning, failure, strong, mojo
37 | * and project for message contentMAVEN_OPTS
40 | * environment variable (eventually in .mavenrc script):style.<style name>,bold, <color> and
43 | * bg<color> (for background), where <color> is
44 | * an ANSI color: black,
45 | * red, green, yellow, blue, magenta,
46 | * cyan or white, eventually with bright prefixstr == null || String.isBlank(str) (Java 11+)
128 | * or org.apache.commons.lang3.StringUtils.isBlank(str)
129 | * @param str the string to be checked
130 | * @return true if the string is null, empty, or whitespace only; false otherwise
131 | */
132 | @Deprecated
133 | public static boolean isEmpty(String str) {
134 | return str == null || str.trim().length() == 0;
135 | }
136 | }
137 |
--------------------------------------------------------------------------------
/src/main/java/org/apache/maven/shared/utils/xml/Xpp3DomWriter.java:
--------------------------------------------------------------------------------
1 | /*
2 | * Licensed to the Apache Software Foundation (ASF) under one
3 | * or more contributor license agreements. See the NOTICE file
4 | * distributed with this work for additional information
5 | * regarding copyright ownership. The ASF licenses this file
6 | * to you under the Apache License, Version 2.0 (the
7 | * "License"); you may not use this file except in compliance
8 | * with the License. You may obtain a copy of the License at
9 | *
10 | * http://www.apache.org/licenses/LICENSE-2.0
11 | *
12 | * Unless required by applicable law or agreed to in writing,
13 | * software distributed under the License is distributed on an
14 | * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
15 | * KIND, either express or implied. See the License for the
16 | * specific language governing permissions and limitations
17 | * under the License.
18 | */
19 | package org.apache.maven.shared.utils.xml;
20 |
21 | import java.io.IOException;
22 | import java.io.PrintWriter;
23 | import java.io.Writer;
24 |
25 | /**
26 | * @author Brett Porter
27 | * @deprecated use org.w3c.dom, JDOM, XOM, or SAX
28 | */
29 | @Deprecated
30 | public class Xpp3DomWriter {
31 | /**
32 | * @param writer {@link Writer}
33 | * @param dom {@link Xpp3Dom}
34 | * @throws IOException if writing fails.
35 | */
36 | public static void write(Writer writer, Xpp3Dom dom) throws IOException {
37 | write(new PrettyPrintXMLWriter(writer), dom);
38 | }
39 |
40 | /**
41 | * @param writer {@link PrintWriter}
42 | * @param dom {@link Xpp3Dom}
43 | * @throws IOException if writing fails.
44 | */
45 | public static void write(PrintWriter writer, Xpp3Dom dom) throws IOException {
46 | write(new PrettyPrintXMLWriter(writer), dom);
47 | }
48 |
49 | /**
50 | * @param xmlWriter {@link XMLWriter}
51 | * @param dom {@link Xpp3Dom}
52 | * @throws IOException if writing fails.
53 | */
54 | public static void write(XMLWriter xmlWriter, Xpp3Dom dom) throws IOException {
55 | write(xmlWriter, dom, true);
56 | }
57 |
58 | /**
59 | * @param xmlWriter {@link XMLWriter}
60 | * @param dom {@link Xpp3Dom}
61 | * @param escape true/false.
62 | * @throws IOException if writing fails.
63 | */
64 | public static void write(XMLWriter xmlWriter, Xpp3Dom dom, boolean escape) throws IOException {
65 | xmlWriter.startElement(dom.getName());
66 | String[] attributeNames = dom.getAttributeNames();
67 | for (String attributeName : attributeNames) {
68 | xmlWriter.addAttribute(attributeName, dom.getAttribute(attributeName));
69 | }
70 | Xpp3Dom[] children = dom.getChildren();
71 | for (Xpp3Dom aChildren : children) {
72 | write(xmlWriter, aChildren, escape);
73 | }
74 |
75 | String value = dom.getValue();
76 | if (value != null) {
77 | if (escape) {
78 | xmlWriter.writeText(value);
79 | } else {
80 | xmlWriter.writeMarkup(value);
81 | }
82 | }
83 | xmlWriter.endElement();
84 | }
85 | }
86 |
--------------------------------------------------------------------------------
/src/main/java/org/apache/maven/shared/utils/xml/pull/XmlPullParserException.java:
--------------------------------------------------------------------------------
1 | /*
2 | * Licensed to the Apache Software Foundation (ASF) under one
3 | * or more contributor license agreements. See the NOTICE file
4 | * distributed with this work for additional information
5 | * regarding copyright ownership. The ASF licenses this file
6 | * to you under the Apache License, Version 2.0 (the
7 | * "License"); you may not use this file except in compliance
8 | * with the License. You may obtain a copy of the License at
9 | *
10 | * http://www.apache.org/licenses/LICENSE-2.0
11 | *
12 | * Unless required by applicable law or agreed to in writing,
13 | * software distributed under the License is distributed on an
14 | * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
15 | * KIND, either express or implied. See the License for the
16 | * specific language governing permissions and limitations
17 | * under the License.
18 | */
19 | package org.apache.maven.shared.utils.xml.pull;
20 |
21 | import java.io.IOException;
22 |
23 | import org.xml.sax.SAXException;
24 |
25 | /**
26 | * @deprecated use org.w3c.dom, JDOM, XOM, or SAX
27 | */
28 | @Deprecated
29 | public class XmlPullParserException extends RuntimeException {
30 |
31 | private static final long serialVersionUID = 117075811816936575L;
32 |
33 | /**
34 | * @param e the root cause
35 | */
36 | public XmlPullParserException(IOException e) {
37 | super(e);
38 | }
39 |
40 | /**
41 | * @param e the root cause
42 | */
43 | public XmlPullParserException(SAXException e) {
44 | super(e);
45 | }
46 |
47 | /**
48 | * @param message the message
49 | */
50 | public XmlPullParserException(String message) {
51 | super(message);
52 | }
53 | }
54 |
--------------------------------------------------------------------------------
/src/main/resources/META-INF/NOTICE:
--------------------------------------------------------------------------------
1 | This product includes software developed by
2 | The Apache Software Foundation (http://www.apache.org/).
3 |
--------------------------------------------------------------------------------
/src/site/apt/index.apt.vm:
--------------------------------------------------------------------------------
1 | ------
2 | Introduction
3 | ------
4 | Kristian Rosenvold
5 | ------
6 | 2013-07-24
7 | ------
8 |
9 | ~~ Licensed to the Apache Software Foundation (ASF) under one
10 | ~~ or more contributor license agreements. See the NOTICE file
11 | ~~ distributed with this work for additional information
12 | ~~ regarding copyright ownership. The ASF licenses this file
13 | ~~ to you under the Apache License, Version 2.0 (the
14 | ~~ "License"); you may not use this file except in compliance
15 | ~~ with the License. You may obtain a copy of the License at
16 | ~~
17 | ~~ http://www.apache.org/licenses/LICENSE-2.0
18 | ~~
19 | ~~ Unless required by applicable law or agreed to in writing,
20 | ~~ software distributed under the License is distributed on an
21 | ~~ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
22 | ~~ KIND, either express or implied. See the License for the
23 | ~~ specific language governing permissions and limitations
24 | ~~ under the License.
25 |
26 | ~~ NOTE: For help with the syntax of this file, see:
27 | ~~ http://maven.apache.org/doxia/references/apt-format.html
28 |
29 |
30 | ${project.name}
31 |
32 | This project aims to be a functional replacement for
33 | {{{http://codehaus-plexus.github.io/plexus-utils/}plexus-utils}} in Maven.
34 |
35 | It is not a 100% API compatible replacement though but a replacement ${project.name} ${project.version} is distributed in source format.
31 | 32 |Use a source archive if you intend to build ${project.name} yourself.
33 | 34 |Otherwise, simply use the ready-made binary artifacts from central repository.
35 | 36 |${project.name} is distributed under the Apache License, version 2.0.
37 | 38 |This is the current stable version of ${project.name}.
41 | 42 || 46 | | Link | 47 |Checksum | 48 |Signature | 49 |
|---|---|---|---|
| ${project.name} ${project.version} (Source zip) | 54 |${project.artifactId}-${project.version}-source-release.zip | 55 |${project.artifactId}-${project.version}-source-release.zip.sha512 | 56 |${project.artifactId}-${project.version}-source-release.zip.asc | 57 |
It is essential that you verify the integrity of the downloaded file 62 | using the checksum (.sha512 file) 63 | or using the signature (.asc file) against the public KEYS used by the Apache Maven developers. 64 |
65 | 66 |It is strongly recommended to use the latest release version of ${project.name} to take advantage of the newest features and bug fixes.
70 |Older non-recommended releases can be found on our archive site.
71 |