You are viewing a plain text version of this content. The canonical link for it is here.
Posted to notifications@commons.apache.org by br...@apache.org on 2015/05/09 20:19:17 UTC
svn commit: r950741 [29/40] - in
/websites/production/commons/content/proper/commons-cli: ./ apidocs/
apidocs/org/apache/commons/cli/ apidocs/org/apache/commons/cli/class-use/
apidocs/resources/ apidocs/src-html/org/apache/commons/cli/ cobertura/
jacoc...
Added: websites/production/commons/content/proper/commons-cli/jacoco/org.apache.commons.cli/OptionBuilder.html
==============================================================================
--- websites/production/commons/content/proper/commons-cli/jacoco/org.apache.commons.cli/OptionBuilder.html (added)
+++ websites/production/commons/content/proper/commons-cli/jacoco/org.apache.commons.cli/OptionBuilder.html Sat May 9 18:19:15 2015
@@ -0,0 +1 @@
+<?xml version="1.0" encoding="iso-8859-1"?><!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"><html xmlns="http://www.w3.org/1999/xhtml" lang="en"><head><meta http-equiv="Content-Type" content="text/html;charset=UTF-8"/><link rel="stylesheet" href="../.resources/report.css" type="text/css"/><link rel="shortcut icon" href="../.resources/report.gif" type="image/gif"/><title>OptionBuilder</title><script type="text/javascript" src="../.resources/sort.js"></script></head><body onload="initialSort(['breadcrumb'])"><div class="breadcrumb" id="breadcrumb"><span class="info"><a href="../.sessions.html" class="el_session">Sessions</a></span><a href="../index.html" class="el_report">Apache Commons CLI</a> > <a href="index.html" class="el_package">org.apache.commons.cli</a> > <span class="el_class">OptionBuilder</span></div><h1>OptionBuilder</h1><table class="coverage" cellspacing="0" id="coveragetable"><thead><tr><td class="sortab
le" id="a" onclick="toggleSort(this)">Element</td><td class="down sortable bar" id="b" onclick="toggleSort(this)">Missed Instructions</td><td class="sortable ctr2" id="c" onclick="toggleSort(this)">Cov.</td><td class="sortable bar" id="d" onclick="toggleSort(this)">Missed Branches</td><td class="sortable ctr2" id="e" onclick="toggleSort(this)">Cov.</td><td class="sortable ctr1" id="f" onclick="toggleSort(this)">Missed</td><td class="sortable ctr2" id="g" onclick="toggleSort(this)">Cxty</td><td class="sortable ctr1" id="h" onclick="toggleSort(this)">Missed</td><td class="sortable ctr2" id="i" onclick="toggleSort(this)">Lines</td><td class="sortable ctr1" id="j" onclick="toggleSort(this)">Missed</td><td class="sortable ctr2" id="k" onclick="toggleSort(this)">Methods</td></tr></thead><tfoot><tr><td>Total</td><td class="bar">8 of 154</td><td class="ctr2">95%</td><td class="bar">0 of 4</td><td class="ctr2">100%</td><td class="ctr1">2</td><td class="ctr2">24</td><td class="ctr1">3</td><td
class="ctr2">66</td><td class="ctr1">2</td><td class="ctr2">22</td></tr></tfoot><tbody><tr><td id="a11"><a href="OptionBuilder.java.html#L213" class="el_method">isRequired(boolean)</a></td><td class="bar" id="b0"><img src="../.resources/redbar.gif" width="12" height="10" title="4" alt="4"/></td><td class="ctr2" id="c20">0%</td><td class="bar" id="d2"/><td class="ctr2" id="e2">n/a</td><td class="ctr1" id="f0">1</td><td class="ctr2" id="g2">1</td><td class="ctr1" id="h0">2</td><td class="ctr2" id="i7">2</td><td class="ctr1" id="j0">1</td><td class="ctr2" id="k0">1</td></tr><tr><td id="a19"><a href="OptionBuilder.java.html#L298" class="el_method">withType(Object)</a></td><td class="bar" id="b1"><img src="../.resources/redbar.gif" width="12" height="10" title="4" alt="4"/></td><td class="ctr2" id="c21">0%</td><td class="bar" id="d3"/><td class="ctr2" id="e3">n/a</td><td class="ctr1" id="f1">1</td><td class="ctr2" id="g3">1</td><td class="ctr1" id="h1">1</td><td class="ctr2" id="i20">1<
/td><td class="ctr1" id="j1">1</td><td class="ctr2" id="k1">1</td></tr><tr><td id="a2"><a href="OptionBuilder.java.html#L372" class="el_method">create(String)</a></td><td class="bar" id="b2"><img src="../.resources/greenbar.gif" width="120" height="10" title="37" alt="37"/></td><td class="ctr2" id="c0">100%</td><td class="bar" id="d4"/><td class="ctr2" id="e4">n/a</td><td class="ctr1" id="f2">0</td><td class="ctr2" id="g4">1</td><td class="ctr1" id="h2">0</td><td class="ctr2" id="i0">12</td><td class="ctr1" id="j2">0</td><td class="ctr2" id="k2">1</td></tr><tr><td id="a13"><a href="OptionBuilder.java.html#L81" class="el_method">reset()</a></td><td class="bar" id="b3"><img src="../.resources/greenbar.gif" width="55" height="10" title="17" alt="17"/></td><td class="ctr2" id="c1">100%</td><td class="bar" id="d5"/><td class="ctr2" id="e5">n/a</td><td class="ctr1" id="f3">0</td><td class="ctr2" id="g5">1</td><td class="ctr1" id="h3">0</td><td class="ctr2" id="i1">9</td><td class="ctr1" i
d="j3">0</td><td class="ctr2" id="k3">1</td></tr><tr><td id="a0"><a href="OptionBuilder.java.html#L351" class="el_method">create()</a></td><td class="bar" id="b4"><img src="../.resources/greenbar.gif" width="35" height="10" title="11" alt="11"/></td><td class="ctr2" id="c2">100%</td><td class="bar" id="d0"><img src="../.resources/greenbar.gif" width="120" height="10" title="2" alt="2"/></td><td class="ctr2" id="e0">100%</td><td class="ctr1" id="f4">0</td><td class="ctr2" id="g0">2</td><td class="ctr1" id="h4">0</td><td class="ctr2" id="i2">4</td><td class="ctr1" id="j4">0</td><td class="ctr2" id="k4">1</td></tr><tr><td id="a4"><a href="OptionBuilder.java.html#L125" class="el_method">hasArg(boolean)</a></td><td class="bar" id="b5"><img src="../.resources/greenbar.gif" width="25" height="10" title="8" alt="8"/></td><td class="ctr2" id="c3">100%</td><td class="bar" id="d1"><img src="../.resources/greenbar.gif" width="120" height="10" title="2" alt="2"/></td><td class="ctr2" id="e1">100
%</td><td class="ctr1" id="f5">0</td><td class="ctr2" id="g1">2</td><td class="ctr1" id="h5">0</td><td class="ctr2" id="i8">2</td><td class="ctr1" id="j5">0</td><td class="ctr2" id="k5">1</td></tr><tr><td id="a14"><a href="OptionBuilder.java.html#L48" class="el_method">static {...}</a></td><td class="bar" id="b6"><img src="../.resources/greenbar.gif" width="25" height="10" title="8" alt="8"/></td><td class="ctr2" id="c4">100%</td><td class="bar" id="d6"/><td class="ctr2" id="e6">n/a</td><td class="ctr1" id="f6">0</td><td class="ctr2" id="g6">1</td><td class="ctr1" id="h6">0</td><td class="ctr2" id="i3">4</td><td class="ctr1" id="j6">0</td><td class="ctr2" id="k6">1</td></tr><tr><td id="a7"><a href="OptionBuilder.java.html#L250" class="el_method">hasOptionalArg()</a></td><td class="bar" id="b7"><img src="../.resources/greenbar.gif" width="19" height="10" title="6" alt="6"/></td><td class="ctr2" id="c5">100%</td><td class="bar" id="d7"/><td class="ctr2" id="e7">n/a</td><td class="ctr1
" id="f7">0</td><td class="ctr2" id="g7">1</td><td class="ctr1" id="h7">0</td><td class="ctr2" id="i4">3</td><td class="ctr1" id="j7">0</td><td class="ctr2" id="k7">1</td></tr><tr><td id="a8"><a href="OptionBuilder.java.html#L263" class="el_method">hasOptionalArgs()</a></td><td class="bar" id="b8"><img src="../.resources/greenbar.gif" width="19" height="10" title="6" alt="6"/></td><td class="ctr2" id="c6">100%</td><td class="bar" id="d8"/><td class="ctr2" id="e8">n/a</td><td class="ctr1" id="f8">0</td><td class="ctr2" id="g8">1</td><td class="ctr1" id="h8">0</td><td class="ctr2" id="i5">3</td><td class="ctr1" id="j8">0</td><td class="ctr2" id="k8">1</td></tr><tr><td id="a9"><a href="OptionBuilder.java.html#L278" class="el_method">hasOptionalArgs(int)</a></td><td class="bar" id="b9"><img src="../.resources/greenbar.gif" width="19" height="10" title="6" alt="6"/></td><td class="ctr2" id="c7">100%</td><td class="bar" id="d9"/><td class="ctr2" id="e9">n/a</td><td class="ctr1" id="f9">0<
/td><td class="ctr2" id="g9">1</td><td class="ctr1" id="h9">0</td><td class="ctr2" id="i6">3</td><td class="ctr1" id="j9">0</td><td class="ctr2" id="k9">1</td></tr><tr><td id="a17"><a href="OptionBuilder.java.html#L99" class="el_method">withLongOpt(String)</a></td><td class="bar" id="b10"><img src="../.resources/greenbar.gif" width="12" height="10" title="4" alt="4"/></td><td class="ctr2" id="c8">100%</td><td class="bar" id="d10"/><td class="ctr2" id="e10">n/a</td><td class="ctr1" id="f10">0</td><td class="ctr2" id="g10">1</td><td class="ctr1" id="h10">0</td><td class="ctr2" id="i9">2</td><td class="ctr1" id="j10">0</td><td class="ctr2" id="k10">1</td></tr><tr><td id="a3"><a href="OptionBuilder.java.html#L111" class="el_method">hasArg()</a></td><td class="bar" id="b11"><img src="../.resources/greenbar.gif" width="12" height="10" title="4" alt="4"/></td><td class="ctr2" id="c9">100%</td><td class="bar" id="d11"/><td class="ctr2" id="e11">n/a</td><td class="ctr1" id="f11">0</td><td cl
ass="ctr2" id="g11">1</td><td class="ctr1" id="h11">0</td><td class="ctr2" id="i10">2</td><td class="ctr1" id="j11">0</td><td class="ctr2" id="k11">1</td></tr><tr><td id="a15"><a href="OptionBuilder.java.html#L138" class="el_method">withArgName(String)</a></td><td class="bar" id="b12"><img src="../.resources/greenbar.gif" width="12" height="10" title="4" alt="4"/></td><td class="ctr2" id="c10">100%</td><td class="bar" id="d12"/><td class="ctr2" id="e12">n/a</td><td class="ctr1" id="f12">0</td><td class="ctr2" id="g12">1</td><td class="ctr1" id="h12">0</td><td class="ctr2" id="i11">2</td><td class="ctr1" id="j12">0</td><td class="ctr2" id="k12">1</td></tr><tr><td id="a10"><a href="OptionBuilder.java.html#L150" class="el_method">isRequired()</a></td><td class="bar" id="b13"><img src="../.resources/greenbar.gif" width="12" height="10" title="4" alt="4"/></td><td class="ctr2" id="c11">100%</td><td class="bar" id="d13"/><td class="ctr2" id="e13">n/a</td><td class="ctr1" id="f13">0</td><t
d class="ctr2" id="g13">1</td><td class="ctr1" id="h13">0</td><td class="ctr2" id="i12">2</td><td class="ctr1" id="j13">0</td><td class="ctr2" id="k13">1</td></tr><tr><td id="a21"><a href="OptionBuilder.java.html#L176" class="el_method">withValueSeparator(char)</a></td><td class="bar" id="b14"><img src="../.resources/greenbar.gif" width="12" height="10" title="4" alt="4"/></td><td class="ctr2" id="c12">100%</td><td class="bar" id="d14"/><td class="ctr2" id="e14">n/a</td><td class="ctr1" id="f14">0</td><td class="ctr2" id="g14">1</td><td class="ctr1" id="h14">0</td><td class="ctr2" id="i13">2</td><td class="ctr1" id="j14">0</td><td class="ctr2" id="k14">1</td></tr><tr><td id="a20"><a href="OptionBuilder.java.html#L199" class="el_method">withValueSeparator()</a></td><td class="bar" id="b15"><img src="../.resources/greenbar.gif" width="12" height="10" title="4" alt="4"/></td><td class="ctr2" id="c13">100%</td><td class="bar" id="d15"/><td class="ctr2" id="e15">n/a</td><td class="ctr1"
id="f15">0</td><td class="ctr2" id="g15">1</td><td class="ctr1" id="h15">0</td><td class="ctr2" id="i14">2</td><td class="ctr1" id="j15">0</td><td class="ctr2" id="k15">1</td></tr><tr><td id="a5"><a href="OptionBuilder.java.html#L225" class="el_method">hasArgs()</a></td><td class="bar" id="b16"><img src="../.resources/greenbar.gif" width="12" height="10" title="4" alt="4"/></td><td class="ctr2" id="c14">100%</td><td class="bar" id="d16"/><td class="ctr2" id="e16">n/a</td><td class="ctr1" id="f16">0</td><td class="ctr2" id="g16">1</td><td class="ctr1" id="h16">0</td><td class="ctr2" id="i15">2</td><td class="ctr1" id="j16">0</td><td class="ctr2" id="k16">1</td></tr><tr><td id="a6"><a href="OptionBuilder.java.html#L238" class="el_method">hasArgs(int)</a></td><td class="bar" id="b17"><img src="../.resources/greenbar.gif" width="12" height="10" title="4" alt="4"/></td><td class="ctr2" id="c15">100%</td><td class="bar" id="d17"/><td class="ctr2" id="e17">n/a</td><td class="ctr1" id="f17"
>0</td><td class="ctr2" id="g17">1</td><td class="ctr1" id="h17">0</td><td class="ctr2" id="i16">2</td><td class="ctr1" id="j17">0</td><td class="ctr2" id="k17">1</td></tr><tr><td id="a18"><a href="OptionBuilder.java.html#L311" class="el_method">withType(Class)</a></td><td class="bar" id="b18"><img src="../.resources/greenbar.gif" width="12" height="10" title="4" alt="4"/></td><td class="ctr2" id="c16">100%</td><td class="bar" id="d18"/><td class="ctr2" id="e18">n/a</td><td class="ctr1" id="f18">0</td><td class="ctr2" id="g18">1</td><td class="ctr1" id="h18">0</td><td class="ctr2" id="i17">2</td><td class="ctr1" id="j18">0</td><td class="ctr2" id="k18">1</td></tr><tr><td id="a16"><a href="OptionBuilder.java.html#L324" class="el_method">withDescription(String)</a></td><td class="bar" id="b19"><img src="../.resources/greenbar.gif" width="12" height="10" title="4" alt="4"/></td><td class="ctr2" id="c17">100%</td><td class="bar" id="d19"/><td class="ctr2" id="e19">n/a</td><td class="ctr
1" id="f19">0</td><td class="ctr2" id="g19">1</td><td class="ctr1" id="h19">0</td><td class="ctr2" id="i18">2</td><td class="ctr1" id="j19">0</td><td class="ctr2" id="k19">1</td></tr><tr><td id="a1"><a href="OptionBuilder.java.html#L340" class="el_method">create(char)</a></td><td class="bar" id="b20"><img src="../.resources/greenbar.gif" width="12" height="10" title="4" alt="4"/></td><td class="ctr2" id="c18">100%</td><td class="bar" id="d20"/><td class="ctr2" id="e20">n/a</td><td class="ctr1" id="f20">0</td><td class="ctr2" id="g20">1</td><td class="ctr1" id="h20">0</td><td class="ctr2" id="i21">1</td><td class="ctr1" id="j20">0</td><td class="ctr2" id="k20">1</td></tr><tr><td id="a12"><a href="OptionBuilder.java.html#L72" class="el_method">OptionBuilder()</a></td><td class="bar" id="b21"><img src="../.resources/greenbar.gif" width="9" height="10" title="3" alt="3"/></td><td class="ctr2" id="c19">100%</td><td class="bar" id="d21"/><td class="ctr2" id="e21">n/a</td><td class="ctr1"
id="f21">0</td><td class="ctr2" id="g21">1</td><td class="ctr1" id="h21">0</td><td class="ctr2" id="i19">2</td><td class="ctr1" id="j21">0</td><td class="ctr2" id="k21">1</td></tr></tbody></table><div class="footer"><span class="right">Created with <a href="http://www.eclemma.org/jacoco">JaCoCo</a> 0.7.2.201409121644</span></div></body></html>
\ No newline at end of file
Propchange: websites/production/commons/content/proper/commons-cli/jacoco/org.apache.commons.cli/OptionBuilder.html
------------------------------------------------------------------------------
svn:eol-style = native
Added: websites/production/commons/content/proper/commons-cli/jacoco/org.apache.commons.cli/OptionBuilder.java.html
==============================================================================
--- websites/production/commons/content/proper/commons-cli/jacoco/org.apache.commons.cli/OptionBuilder.java.html (added)
+++ websites/production/commons/content/proper/commons-cli/jacoco/org.apache.commons.cli/OptionBuilder.java.html Sat May 9 18:19:15 2015
@@ -0,0 +1,397 @@
+<?xml version="1.0" encoding="iso-8859-1"?><!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"><html xmlns="http://www.w3.org/1999/xhtml" lang="en"><head><meta http-equiv="Content-Type" content="text/html;charset=UTF-8"/><link rel="stylesheet" href="../.resources/report.css" type="text/css"/><link rel="shortcut icon" href="../.resources/report.gif" type="image/gif"/><title>OptionBuilder.java</title><link rel="stylesheet" href="../.resources/prettify.css" type="text/css"/><script type="text/javascript" src="../.resources/prettify.js"></script></head><body onload="window['PR_TAB_WIDTH']=4;prettyPrint()"><div class="breadcrumb" id="breadcrumb"><span class="info"><a href="../.sessions.html" class="el_session">Sessions</a></span><a href="../index.html" class="el_report">Apache Commons CLI</a> > <a href="index.source.html" class="el_package">org.apache.commons.cli</a> > <span class="el_source">OptionBuilder.java</span></div><h
1>OptionBuilder.java</h1><pre class="source lang-java linenums">/**
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You 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
+ *
+ * http://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 org.apache.commons.cli;
+
+/**
+ * OptionBuilder allows the user to create Options using descriptive methods.
+ * <p>
+ * Details on the Builder pattern can be found at
+ * <a href="http://c2.com/cgi-bin/wiki?BuilderPattern">http://c2.com/cgi-bin/wiki?BuilderPattern</a>.
+ * <p>
+ * This class is NOT thread safe. See <a href="https://issues.apache.org/jira/browse/CLI-209">CLI-209</a>
+ *
+ * @version $Id: OptionBuilder.java 1677400 2015-05-03 13:46:08Z britter $
+ * @since 1.0
+ * @deprecated since 1.3, use {@link Option#builder(String)} instead
+ */
+@Deprecated
+public final class OptionBuilder
+{
+ /** long option */
+ private static String longopt;
+
+ /** option description */
+ private static String description;
+
+ /** argument name */
+ private static String argName;
+
+ /** is required? */
+ private static boolean required;
+
+ /** the number of arguments */
+<span class="fc" id="L48"> private static int numberOfArgs = Option.UNINITIALIZED;</span>
+
+ /** option type */
+ private static Class<?> type;
+
+ /** option can have an optional argument value */
+ private static boolean optionalArg;
+
+ /** value separator for argument value */
+ private static char valuesep;
+
+ /** option builder instance */
+<span class="fc" id="L60"> private static final OptionBuilder INSTANCE = new OptionBuilder();</span>
+
+ static
+ {
+ // ensure the consistency of the initial values
+<span class="fc" id="L65"> reset();</span>
+<span class="fc" id="L66"> }</span>
+
+ /**
+ * private constructor to prevent instances being created
+ */
+ private OptionBuilder()
+<span class="fc" id="L72"> {</span>
+ // hide the constructor
+<span class="fc" id="L74"> }</span>
+
+ /**
+ * Resets the member variables to their default values.
+ */
+ private static void reset()
+ {
+<span class="fc" id="L81"> description = null;</span>
+<span class="fc" id="L82"> argName = null;</span>
+<span class="fc" id="L83"> longopt = null;</span>
+<span class="fc" id="L84"> type = String.class;</span>
+<span class="fc" id="L85"> required = false;</span>
+<span class="fc" id="L86"> numberOfArgs = Option.UNINITIALIZED;</span>
+<span class="fc" id="L87"> optionalArg = false;</span>
+<span class="fc" id="L88"> valuesep = (char) 0;</span>
+<span class="fc" id="L89"> }</span>
+
+ /**
+ * The next Option created will have the following long option value.
+ *
+ * @param newLongopt the long option value
+ * @return the OptionBuilder instance
+ */
+ public static OptionBuilder withLongOpt(String newLongopt)
+ {
+<span class="fc" id="L99"> OptionBuilder.longopt = newLongopt;</span>
+
+<span class="fc" id="L101"> return INSTANCE;</span>
+ }
+
+ /**
+ * The next Option created will require an argument value.
+ *
+ * @return the OptionBuilder instance
+ */
+ public static OptionBuilder hasArg()
+ {
+<span class="fc" id="L111"> OptionBuilder.numberOfArgs = 1;</span>
+
+<span class="fc" id="L113"> return INSTANCE;</span>
+ }
+
+ /**
+ * The next Option created will require an argument value if
+ * <code>hasArg</code> is true.
+ *
+ * @param hasArg if true then the Option has an argument value
+ * @return the OptionBuilder instance
+ */
+ public static OptionBuilder hasArg(boolean hasArg)
+ {
+<span class="fc bfc" id="L125" title="All 2 branches covered."> OptionBuilder.numberOfArgs = hasArg ? 1 : Option.UNINITIALIZED;</span>
+
+<span class="fc" id="L127"> return INSTANCE;</span>
+ }
+
+ /**
+ * The next Option created will have the specified argument value name.
+ *
+ * @param name the name for the argument value
+ * @return the OptionBuilder instance
+ */
+ public static OptionBuilder withArgName(String name)
+ {
+<span class="fc" id="L138"> OptionBuilder.argName = name;</span>
+
+<span class="fc" id="L140"> return INSTANCE;</span>
+ }
+
+ /**
+ * The next Option created will be required.
+ *
+ * @return the OptionBuilder instance
+ */
+ public static OptionBuilder isRequired()
+ {
+<span class="fc" id="L150"> OptionBuilder.required = true;</span>
+
+<span class="fc" id="L152"> return INSTANCE;</span>
+ }
+
+ /**
+ * The next Option created uses <code>sep</code> as a means to
+ * separate argument values.
+ * <p>
+ * <b>Example:</b>
+ * <pre>
+ * Option opt = OptionBuilder.withValueSeparator('=')
+ * .create('D');
+ *
+ * String args = "-Dkey=value";
+ * CommandLine line = parser.parse(args);
+ * String propertyName = opt.getValue(0); // will be "key"
+ * String propertyValue = opt.getValue(1); // will be "value"
+ * </pre>
+ *
+ * @param sep The value separator to be used for the argument values.
+ *
+ * @return the OptionBuilder instance
+ */
+ public static OptionBuilder withValueSeparator(char sep)
+ {
+<span class="fc" id="L176"> OptionBuilder.valuesep = sep;</span>
+
+<span class="fc" id="L178"> return INSTANCE;</span>
+ }
+
+ /**
+ * The next Option created uses '<code>=</code>' as a means to
+ * separate argument values.
+ *
+ * <b>Example:</b>
+ * <pre>
+ * Option opt = OptionBuilder.withValueSeparator()
+ * .create('D');
+ *
+ * CommandLine line = parser.parse(args);
+ * String propertyName = opt.getValue(0);
+ * String propertyValue = opt.getValue(1);
+ * </pre>
+ *
+ * @return the OptionBuilder instance
+ */
+ public static OptionBuilder withValueSeparator()
+ {
+<span class="fc" id="L199"> OptionBuilder.valuesep = '=';</span>
+
+<span class="fc" id="L201"> return INSTANCE;</span>
+ }
+
+ /**
+ * The next Option created will be required if <code>required</code>
+ * is true.
+ *
+ * @param newRequired if true then the Option is required
+ * @return the OptionBuilder instance
+ */
+ public static OptionBuilder isRequired(boolean newRequired)
+ {
+<span class="nc" id="L213"> OptionBuilder.required = newRequired;</span>
+
+<span class="nc" id="L215"> return INSTANCE;</span>
+ }
+
+ /**
+ * The next Option created can have unlimited argument values.
+ *
+ * @return the OptionBuilder instance
+ */
+ public static OptionBuilder hasArgs()
+ {
+<span class="fc" id="L225"> OptionBuilder.numberOfArgs = Option.UNLIMITED_VALUES;</span>
+
+<span class="fc" id="L227"> return INSTANCE;</span>
+ }
+
+ /**
+ * The next Option created can have <code>num</code> argument values.
+ *
+ * @param num the number of args that the option can have
+ * @return the OptionBuilder instance
+ */
+ public static OptionBuilder hasArgs(int num)
+ {
+<span class="fc" id="L238"> OptionBuilder.numberOfArgs = num;</span>
+
+<span class="fc" id="L240"> return INSTANCE;</span>
+ }
+
+ /**
+ * The next Option can have an optional argument.
+ *
+ * @return the OptionBuilder instance
+ */
+ public static OptionBuilder hasOptionalArg()
+ {
+<span class="fc" id="L250"> OptionBuilder.numberOfArgs = 1;</span>
+<span class="fc" id="L251"> OptionBuilder.optionalArg = true;</span>
+
+<span class="fc" id="L253"> return INSTANCE;</span>
+ }
+
+ /**
+ * The next Option can have an unlimited number of optional arguments.
+ *
+ * @return the OptionBuilder instance
+ */
+ public static OptionBuilder hasOptionalArgs()
+ {
+<span class="fc" id="L263"> OptionBuilder.numberOfArgs = Option.UNLIMITED_VALUES;</span>
+<span class="fc" id="L264"> OptionBuilder.optionalArg = true;</span>
+
+<span class="fc" id="L266"> return INSTANCE;</span>
+ }
+
+ /**
+ * The next Option can have the specified number of optional arguments.
+ *
+ * @param numArgs - the maximum number of optional arguments
+ * the next Option created can have.
+ * @return the OptionBuilder instance
+ */
+ public static OptionBuilder hasOptionalArgs(int numArgs)
+ {
+<span class="fc" id="L278"> OptionBuilder.numberOfArgs = numArgs;</span>
+<span class="fc" id="L279"> OptionBuilder.optionalArg = true;</span>
+
+<span class="fc" id="L281"> return INSTANCE;</span>
+ }
+
+ /**
+ * The next Option created will have a value that will be an instance
+ * of <code>type</code>.
+ * <p>
+ * <b>Note:</b> this method is kept for binary compatibility and the
+ * input type is supposed to be a {@link Class} object.
+ *
+ * @param newType the type of the Options argument value
+ * @return the OptionBuilder instance
+ * @deprecated since 1.3, use {@link #withType(Class)} instead
+ */
+ @Deprecated
+ public static OptionBuilder withType(Object newType)
+ {
+<span class="nc" id="L298"> return withType((Class<?>) newType);</span>
+ }
+
+ /**
+ * The next Option created will have a value that will be an instance
+ * of <code>type</code>.
+ *
+ * @param newType the type of the Options argument value
+ * @return the OptionBuilder instance
+ * @since 1.3
+ */
+ public static OptionBuilder withType(Class<?> newType)
+ {
+<span class="fc" id="L311"> OptionBuilder.type = newType;</span>
+
+<span class="fc" id="L313"> return INSTANCE;</span>
+ }
+
+ /**
+ * The next Option created will have the specified description
+ *
+ * @param newDescription a description of the Option's purpose
+ * @return the OptionBuilder instance
+ */
+ public static OptionBuilder withDescription(String newDescription)
+ {
+<span class="fc" id="L324"> OptionBuilder.description = newDescription;</span>
+
+<span class="fc" id="L326"> return INSTANCE;</span>
+ }
+
+ /**
+ * Create an Option using the current settings and with
+ * the specified Option <code>char</code>.
+ *
+ * @param opt the character representation of the Option
+ * @return the Option instance
+ * @throws IllegalArgumentException if <code>opt</code> is not
+ * a valid character. See Option.
+ */
+ public static Option create(char opt) throws IllegalArgumentException
+ {
+<span class="fc" id="L340"> return create(String.valueOf(opt));</span>
+ }
+
+ /**
+ * Create an Option using the current settings
+ *
+ * @return the Option instance
+ * @throws IllegalArgumentException if <code>longOpt</code> has not been set.
+ */
+ public static Option create() throws IllegalArgumentException
+ {
+<span class="fc bfc" id="L351" title="All 2 branches covered."> if (longopt == null)</span>
+ {
+<span class="fc" id="L353"> OptionBuilder.reset();</span>
+<span class="fc" id="L354"> throw new IllegalArgumentException("must specify longopt");</span>
+ }
+
+<span class="fc" id="L357"> return create(null);</span>
+ }
+
+ /**
+ * Create an Option using the current settings and with
+ * the specified Option <code>char</code>.
+ *
+ * @param opt the <code>java.lang.String</code> representation
+ * of the Option
+ * @return the Option instance
+ * @throws IllegalArgumentException if <code>opt</code> is not
+ * a valid character. See Option.
+ */
+ public static Option create(String opt) throws IllegalArgumentException
+ {
+<span class="fc" id="L372"> Option option = null;</span>
+ try
+ {
+ // create the option
+<span class="fc" id="L376"> option = new Option(opt, description);</span>
+
+ // set the option properties
+<span class="fc" id="L379"> option.setLongOpt(longopt);</span>
+<span class="fc" id="L380"> option.setRequired(required);</span>
+<span class="fc" id="L381"> option.setOptionalArg(optionalArg);</span>
+<span class="fc" id="L382"> option.setArgs(numberOfArgs);</span>
+<span class="fc" id="L383"> option.setType(type);</span>
+<span class="fc" id="L384"> option.setValueSeparator(valuesep);</span>
+<span class="fc" id="L385"> option.setArgName(argName);</span>
+ }
+ finally
+ {
+ // reset the OptionBuilder properties
+<span class="fc" id="L390"> OptionBuilder.reset();</span>
+<span class="fc" id="L391"> }</span>
+
+ // return the Option instance
+<span class="fc" id="L394"> return option;</span>
+ }
+}
+</pre><div class="footer"><span class="right">Created with <a href="http://www.eclemma.org/jacoco">JaCoCo</a> 0.7.2.201409121644</span></div></body></html>
\ No newline at end of file
Propchange: websites/production/commons/content/proper/commons-cli/jacoco/org.apache.commons.cli/OptionBuilder.java.html
------------------------------------------------------------------------------
svn:eol-style = native
Added: websites/production/commons/content/proper/commons-cli/jacoco/org.apache.commons.cli/OptionGroup.html
==============================================================================
--- websites/production/commons/content/proper/commons-cli/jacoco/org.apache.commons.cli/OptionGroup.html (added)
+++ websites/production/commons/content/proper/commons-cli/jacoco/org.apache.commons.cli/OptionGroup.html Sat May 9 18:19:15 2015
@@ -0,0 +1 @@
+<?xml version="1.0" encoding="iso-8859-1"?><!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"><html xmlns="http://www.w3.org/1999/xhtml" lang="en"><head><meta http-equiv="Content-Type" content="text/html;charset=UTF-8"/><link rel="stylesheet" href="../.resources/report.css" type="text/css"/><link rel="shortcut icon" href="../.resources/report.gif" type="image/gif"/><title>OptionGroup</title><script type="text/javascript" src="../.resources/sort.js"></script></head><body onload="initialSort(['breadcrumb'])"><div class="breadcrumb" id="breadcrumb"><span class="info"><a href="../.sessions.html" class="el_session">Sessions</a></span><a href="../index.html" class="el_report">Apache Commons CLI</a> > <a href="index.html" class="el_package">org.apache.commons.cli</a> > <span class="el_class">OptionGroup</span></div><h1>OptionGroup</h1><table class="coverage" cellspacing="0" id="coveragetable"><thead><tr><td class="sortable" id
="a" onclick="toggleSort(this)">Element</td><td class="down sortable bar" id="b" onclick="toggleSort(this)">Missed Instructions</td><td class="sortable ctr2" id="c" onclick="toggleSort(this)">Cov.</td><td class="sortable bar" id="d" onclick="toggleSort(this)">Missed Branches</td><td class="sortable ctr2" id="e" onclick="toggleSort(this)">Cov.</td><td class="sortable ctr1" id="f" onclick="toggleSort(this)">Missed</td><td class="sortable ctr2" id="g" onclick="toggleSort(this)">Cxty</td><td class="sortable ctr1" id="h" onclick="toggleSort(this)">Missed</td><td class="sortable ctr2" id="i" onclick="toggleSort(this)">Lines</td><td class="sortable ctr1" id="j" onclick="toggleSort(this)">Missed</td><td class="sortable ctr2" id="k" onclick="toggleSort(this)">Methods</td></tr></thead><tfoot><tr><td>Total</td><td class="bar">0 of 130</td><td class="ctr2">100%</td><td class="bar">1 of 14</td><td class="ctr2">93%</td><td class="ctr1">1</td><td class="ctr2">16</td><td class="ctr1">0</td><td clas
s="ctr2">35</td><td class="ctr1">0</td><td class="ctr2">9</td></tr></tfoot><tbody><tr><td id="a8"><a href="OptionGroup.java.html#L142" class="el_method">toString()</a></td><td class="bar" id="b0"><img src="../.resources/greenbar.gif" width="120" height="10" title="68" alt="68"/></td><td class="ctr2" id="c0">100%</td><td class="bar" id="d1"><img src="../.resources/greenbar.gif" width="120" height="10" title="8" alt="8"/></td><td class="ctr2" id="e0">100%</td><td class="ctr1" id="f1">0</td><td class="ctr2" id="g0">5</td><td class="ctr1" id="h0">0</td><td class="ctr2" id="i0">18</td><td class="ctr1" id="j0">0</td><td class="ctr2" id="k0">1</td></tr><tr><td id="a7"><a href="OptionGroup.java.html#L88" class="el_method">setSelected(Option)</a></td><td class="bar" id="b1"><img src="../.resources/greenbar.gif" width="47" height="10" title="27" alt="27"/></td><td class="ctr2" id="c1">100%</td><td class="bar" id="d0"><img src="../.resources/redbar.gif" width="15" height="10" title="1" alt="1"
/><img src="../.resources/greenbar.gif" width="75" height="10" title="5" alt="5"/></td><td class="ctr2" id="e1">83%</td><td class="ctr1" id="f0">1</td><td class="ctr2" id="g1">4</td><td class="ctr1" id="h1">0</td><td class="ctr2" id="i1">7</td><td class="ctr1" id="j1">0</td><td class="ctr2" id="k1">1</td></tr><tr><td id="a0"><a href="OptionGroup.java.html#L55" class="el_method">addOption(Option)</a></td><td class="bar" id="b2"><img src="../.resources/greenbar.gif" width="15" height="10" title="9" alt="9"/></td><td class="ctr2" id="c2">100%</td><td class="bar" id="d2"/><td class="ctr2" id="e2">n/a</td><td class="ctr1" id="f2">0</td><td class="ctr2" id="g2">1</td><td class="ctr1" id="h2">0</td><td class="ctr2" id="i2">2</td><td class="ctr1" id="j2">0</td><td class="ctr2" id="k2">1</td></tr><tr><td id="a5"><a href="OptionGroup.java.html#L31" class="el_method">OptionGroup()</a></td><td class="bar" id="b3"><img src="../.resources/greenbar.gif" width="14" height="10" title="8" alt="8"/></
td><td class="ctr2" id="c3">100%</td><td class="bar" id="d3"/><td class="ctr2" id="e3">n/a</td><td class="ctr1" id="f3">0</td><td class="ctr2" id="g3">1</td><td class="ctr1" id="h3">0</td><td class="ctr2" id="i3">2</td><td class="ctr1" id="j3">0</td><td class="ctr2" id="k3">1</td></tr><tr><td id="a1"><a href="OptionGroup.java.html#L67" class="el_method">getNames()</a></td><td class="bar" id="b4"><img src="../.resources/greenbar.gif" width="7" height="10" title="4" alt="4"/></td><td class="ctr2" id="c4">100%</td><td class="bar" id="d4"/><td class="ctr2" id="e4">n/a</td><td class="ctr1" id="f4">0</td><td class="ctr2" id="g4">1</td><td class="ctr1" id="h4">0</td><td class="ctr2" id="i5">1</td><td class="ctr1" id="j4">0</td><td class="ctr2" id="k4">1</td></tr><tr><td id="a2"><a href="OptionGroup.java.html#L76" class="el_method">getOptions()</a></td><td class="bar" id="b5"><img src="../.resources/greenbar.gif" width="7" height="10" title="4" alt="4"/></td><td class="ctr2" id="c5">100%</t
d><td class="bar" id="d5"/><td class="ctr2" id="e5">n/a</td><td class="ctr1" id="f5">0</td><td class="ctr2" id="g5">1</td><td class="ctr1" id="h5">0</td><td class="ctr2" id="i6">1</td><td class="ctr1" id="j5">0</td><td class="ctr2" id="k5">1</td></tr><tr><td id="a6"><a href="OptionGroup.java.html#L121" class="el_method">setRequired(boolean)</a></td><td class="bar" id="b6"><img src="../.resources/greenbar.gif" width="7" height="10" title="4" alt="4"/></td><td class="ctr2" id="c6">100%</td><td class="bar" id="d6"/><td class="ctr2" id="e6">n/a</td><td class="ctr1" id="f6">0</td><td class="ctr2" id="g6">1</td><td class="ctr1" id="h6">0</td><td class="ctr2" id="i4">2</td><td class="ctr1" id="j6">0</td><td class="ctr2" id="k6">1</td></tr><tr><td id="a3"><a href="OptionGroup.java.html#L113" class="el_method">getSelected()</a></td><td class="bar" id="b7"><img src="../.resources/greenbar.gif" width="5" height="10" title="3" alt="3"/></td><td class="ctr2" id="c7">100%</td><td class="bar" id="
d7"/><td class="ctr2" id="e7">n/a</td><td class="ctr1" id="f7">0</td><td class="ctr2" id="g7">1</td><td class="ctr1" id="h7">0</td><td class="ctr2" id="i7">1</td><td class="ctr1" id="j7">0</td><td class="ctr2" id="k7">1</td></tr><tr><td id="a4"><a href="OptionGroup.java.html#L131" class="el_method">isRequired()</a></td><td class="bar" id="b8"><img src="../.resources/greenbar.gif" width="5" height="10" title="3" alt="3"/></td><td class="ctr2" id="c8">100%</td><td class="bar" id="d8"/><td class="ctr2" id="e8">n/a</td><td class="ctr1" id="f8">0</td><td class="ctr2" id="g8">1</td><td class="ctr1" id="h8">0</td><td class="ctr2" id="i8">1</td><td class="ctr1" id="j8">0</td><td class="ctr2" id="k8">1</td></tr></tbody></table><div class="footer"><span class="right">Created with <a href="http://www.eclemma.org/jacoco">JaCoCo</a> 0.7.2.201409121644</span></div></body></html>
\ No newline at end of file
Propchange: websites/production/commons/content/proper/commons-cli/jacoco/org.apache.commons.cli/OptionGroup.html
------------------------------------------------------------------------------
svn:eol-style = native
Added: websites/production/commons/content/proper/commons-cli/jacoco/org.apache.commons.cli/OptionGroup.java.html
==============================================================================
--- websites/production/commons/content/proper/commons-cli/jacoco/org.apache.commons.cli/OptionGroup.java.html (added)
+++ websites/production/commons/content/proper/commons-cli/jacoco/org.apache.commons.cli/OptionGroup.java.html Sat May 9 18:19:15 2015
@@ -0,0 +1,180 @@
+<?xml version="1.0" encoding="iso-8859-1"?><!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"><html xmlns="http://www.w3.org/1999/xhtml" lang="en"><head><meta http-equiv="Content-Type" content="text/html;charset=UTF-8"/><link rel="stylesheet" href="../.resources/report.css" type="text/css"/><link rel="shortcut icon" href="../.resources/report.gif" type="image/gif"/><title>OptionGroup.java</title><link rel="stylesheet" href="../.resources/prettify.css" type="text/css"/><script type="text/javascript" src="../.resources/prettify.js"></script></head><body onload="window['PR_TAB_WIDTH']=4;prettyPrint()"><div class="breadcrumb" id="breadcrumb"><span class="info"><a href="../.sessions.html" class="el_session">Sessions</a></span><a href="../index.html" class="el_report">Apache Commons CLI</a> > <a href="index.source.html" class="el_package">org.apache.commons.cli</a> > <span class="el_source">OptionGroup.java</span></div><h1>Op
tionGroup.java</h1><pre class="source lang-java linenums">/**
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You 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
+ *
+ * http://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 org.apache.commons.cli;
+
+import java.io.Serializable;
+import java.util.Collection;
+import java.util.HashMap;
+import java.util.Iterator;
+import java.util.Map;
+
+/**
+ * A group of mutually exclusive options.
+ *
+ * @version $Id: OptionGroup.java 1669814 2015-03-28 18:09:26Z britter $
+ */
+<span class="fc" id="L31">public class OptionGroup implements Serializable</span>
+{
+ /** The serial version UID. */
+ private static final long serialVersionUID = 1L;
+
+ /** hold the options */
+<span class="fc" id="L37"> private final Map<String, Option> optionMap = new HashMap<String, Option>();</span>
+
+ /** the name of the selected option */
+ private String selected;
+
+ /** specified whether this group is required */
+ private boolean required;
+
+ /**
+ * Add the specified <code>Option</code> to this group.
+ *
+ * @param option the option to add to this group
+ * @return this option group with the option added
+ */
+ public OptionGroup addOption(Option option)
+ {
+ // key - option name
+ // value - the option
+<span class="fc" id="L55"> optionMap.put(option.getKey(), option);</span>
+
+<span class="fc" id="L57"> return this;</span>
+ }
+
+ /**
+ * @return the names of the options in this group as a
+ * <code>Collection</code>
+ */
+ public Collection<String> getNames()
+ {
+ // the key set is the collection of names
+<span class="fc" id="L67"> return optionMap.keySet();</span>
+ }
+
+ /**
+ * @return the options in this group as a <code>Collection</code>
+ */
+ public Collection<Option> getOptions()
+ {
+ // the values are the collection of options
+<span class="fc" id="L76"> return optionMap.values();</span>
+ }
+
+ /**
+ * Set the selected option of this group to <code>name</code>.
+ *
+ * @param option the option that is selected
+ * @throws AlreadySelectedException if an option from this group has
+ * already been selected.
+ */
+ public void setSelected(Option option) throws AlreadySelectedException
+ {
+<span class="fc bfc" id="L88" title="All 2 branches covered."> if (option == null)</span>
+ {
+ // reset the option previously selected
+<span class="fc" id="L91"> selected = null;</span>
+<span class="fc" id="L92"> return;</span>
+ }
+
+ // if no option has already been selected or the
+ // same option is being reselected then set the
+ // selected member variable
+<span class="pc bpc" id="L98" title="1 of 4 branches missed."> if (selected == null || selected.equals(option.getKey()))</span>
+ {
+<span class="fc" id="L100"> selected = option.getKey();</span>
+ }
+ else
+ {
+<span class="fc" id="L104"> throw new AlreadySelectedException(this, option);</span>
+ }
+<span class="fc" id="L106"> }</span>
+
+ /**
+ * @return the selected option name
+ */
+ public String getSelected()
+ {
+<span class="fc" id="L113"> return selected;</span>
+ }
+
+ /**
+ * @param required specifies if this group is required
+ */
+ public void setRequired(boolean required)
+ {
+<span class="fc" id="L121"> this.required = required;</span>
+<span class="fc" id="L122"> }</span>
+
+ /**
+ * Returns whether this option group is required.
+ *
+ * @return whether this option group is required
+ */
+ public boolean isRequired()
+ {
+<span class="fc" id="L131"> return required;</span>
+ }
+
+ /**
+ * Returns the stringified version of this OptionGroup.
+ *
+ * @return the stringified representation of this group
+ */
+ @Override
+ public String toString()
+ {
+<span class="fc" id="L142"> StringBuilder buff = new StringBuilder();</span>
+
+<span class="fc" id="L144"> Iterator<Option> iter = getOptions().iterator();</span>
+
+<span class="fc" id="L146"> buff.append("[");</span>
+
+<span class="fc bfc" id="L148" title="All 2 branches covered."> while (iter.hasNext())</span>
+ {
+<span class="fc" id="L150"> Option option = iter.next();</span>
+
+<span class="fc bfc" id="L152" title="All 2 branches covered."> if (option.getOpt() != null)</span>
+ {
+<span class="fc" id="L154"> buff.append("-");</span>
+<span class="fc" id="L155"> buff.append(option.getOpt());</span>
+ }
+ else
+ {
+<span class="fc" id="L159"> buff.append("--");</span>
+<span class="fc" id="L160"> buff.append(option.getLongOpt());</span>
+ }
+
+<span class="fc bfc" id="L163" title="All 2 branches covered."> if (option.getDescription() != null)</span>
+ {
+<span class="fc" id="L165"> buff.append(" ");</span>
+<span class="fc" id="L166"> buff.append(option.getDescription());</span>
+ }
+
+<span class="fc bfc" id="L169" title="All 2 branches covered."> if (iter.hasNext())</span>
+ {
+<span class="fc" id="L171"> buff.append(", ");</span>
+ }
+<span class="fc" id="L173"> }</span>
+
+<span class="fc" id="L175"> buff.append("]");</span>
+
+<span class="fc" id="L177"> return buff.toString();</span>
+ }
+}
+</pre><div class="footer"><span class="right">Created with <a href="http://www.eclemma.org/jacoco">JaCoCo</a> 0.7.2.201409121644</span></div></body></html>
\ No newline at end of file
Propchange: websites/production/commons/content/proper/commons-cli/jacoco/org.apache.commons.cli/OptionGroup.java.html
------------------------------------------------------------------------------
svn:eol-style = native
Added: websites/production/commons/content/proper/commons-cli/jacoco/org.apache.commons.cli/OptionValidator.html
==============================================================================
--- websites/production/commons/content/proper/commons-cli/jacoco/org.apache.commons.cli/OptionValidator.html (added)
+++ websites/production/commons/content/proper/commons-cli/jacoco/org.apache.commons.cli/OptionValidator.html Sat May 9 18:19:15 2015
@@ -0,0 +1 @@
+<?xml version="1.0" encoding="iso-8859-1"?><!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"><html xmlns="http://www.w3.org/1999/xhtml" lang="en"><head><meta http-equiv="Content-Type" content="text/html;charset=UTF-8"/><link rel="stylesheet" href="../.resources/report.css" type="text/css"/><link rel="shortcut icon" href="../.resources/report.gif" type="image/gif"/><title>OptionValidator</title><script type="text/javascript" src="../.resources/sort.js"></script></head><body onload="initialSort(['breadcrumb'])"><div class="breadcrumb" id="breadcrumb"><span class="info"><a href="../.sessions.html" class="el_session">Sessions</a></span><a href="../index.html" class="el_report">Apache Commons CLI</a> > <a href="index.html" class="el_package">org.apache.commons.cli</a> > <span class="el_class">OptionValidator</span></div><h1>OptionValidator</h1><table class="coverage" cellspacing="0" id="coveragetable"><thead><tr><td class="
sortable" id="a" onclick="toggleSort(this)">Element</td><td class="down sortable bar" id="b" onclick="toggleSort(this)">Missed Instructions</td><td class="sortable ctr2" id="c" onclick="toggleSort(this)">Cov.</td><td class="sortable bar" id="d" onclick="toggleSort(this)">Missed Branches</td><td class="sortable ctr2" id="e" onclick="toggleSort(this)">Cov.</td><td class="sortable ctr1" id="f" onclick="toggleSort(this)">Missed</td><td class="sortable ctr2" id="g" onclick="toggleSort(this)">Cxty</td><td class="sortable ctr1" id="h" onclick="toggleSort(this)">Missed</td><td class="sortable ctr2" id="i" onclick="toggleSort(this)">Lines</td><td class="sortable ctr1" id="j" onclick="toggleSort(this)">Missed</td><td class="sortable ctr2" id="k" onclick="toggleSort(this)">Methods</td></tr></thead><tfoot><tr><td>Total</td><td class="bar">3 of 89</td><td class="ctr2">97%</td><td class="bar">0 of 16</td><td class="ctr2">100%</td><td class="ctr1">1</td><td class="ctr2">12</td><td class="ctr1">1</
td><td class="ctr2">14</td><td class="ctr1">1</td><td class="ctr2">4</td></tr></tfoot><tbody><tr><td id="a2"><a href="OptionValidator.java.html#L26" class="el_method">OptionValidator()</a></td><td class="bar" id="b0"><img src="../.resources/redbar.gif" width="5" height="10" title="3" alt="3"/></td><td class="ctr2" id="c3">0%</td><td class="bar" id="d2"/><td class="ctr2" id="e2">n/a</td><td class="ctr1" id="f0">1</td><td class="ctr2" id="g2">1</td><td class="ctr1" id="h0">1</td><td class="ctr2" id="i1">1</td><td class="ctr1" id="j0">1</td><td class="ctr2" id="k0">1</td></tr><tr><td id="a3"><a href="OptionValidator.java.html#L48" class="el_method">validateOption(String)</a></td><td class="bar" id="b1"><img src="../.resources/greenbar.gif" width="120" height="10" title="70" alt="70"/></td><td class="ctr2" id="c0">100%</td><td class="bar" id="d0"><img src="../.resources/greenbar.gif" width="120" height="10" title="10" alt="10"/></td><td class="ctr2" id="e0">100%</td><td class="ctr1" id=
"f1">0</td><td class="ctr2" id="g0">6</td><td class="ctr1" id="h1">0</td><td class="ctr2" id="i0">11</td><td class="ctr1" id="j1">0</td><td class="ctr2" id="k1">1</td></tr><tr><td id="a1"><a href="OptionValidator.java.html#L86" class="el_method">isValidOpt(char)</a></td><td class="bar" id="b2"><img src="../.resources/greenbar.gif" width="22" height="10" title="13" alt="13"/></td><td class="ctr2" id="c1">100%</td><td class="bar" id="d1"><img src="../.resources/greenbar.gif" width="72" height="10" title="6" alt="6"/></td><td class="ctr2" id="e1">100%</td><td class="ctr1" id="f2">0</td><td class="ctr2" id="g1">4</td><td class="ctr1" id="h2">0</td><td class="ctr2" id="i2">1</td><td class="ctr1" id="j2">0</td><td class="ctr2" id="k2">1</td></tr><tr><td id="a0"><a href="OptionValidator.java.html#L97" class="el_method">isValidChar(char)</a></td><td class="bar" id="b3"><img src="../.resources/greenbar.gif" width="5" height="10" title="3" alt="3"/></td><td class="ctr2" id="c2">100%</td><td c
lass="bar" id="d3"/><td class="ctr2" id="e3">n/a</td><td class="ctr1" id="f3">0</td><td class="ctr2" id="g3">1</td><td class="ctr1" id="h3">0</td><td class="ctr2" id="i3">1</td><td class="ctr1" id="j3">0</td><td class="ctr2" id="k3">1</td></tr></tbody></table><div class="footer"><span class="right">Created with <a href="http://www.eclemma.org/jacoco">JaCoCo</a> 0.7.2.201409121644</span></div></body></html>
\ No newline at end of file
Propchange: websites/production/commons/content/proper/commons-cli/jacoco/org.apache.commons.cli/OptionValidator.html
------------------------------------------------------------------------------
svn:eol-style = native
Added: websites/production/commons/content/proper/commons-cli/jacoco/org.apache.commons.cli/OptionValidator.java.html
==============================================================================
--- websites/production/commons/content/proper/commons-cli/jacoco/org.apache.commons.cli/OptionValidator.java.html (added)
+++ websites/production/commons/content/proper/commons-cli/jacoco/org.apache.commons.cli/OptionValidator.java.html Sat May 9 18:19:15 2015
@@ -0,0 +1,100 @@
+<?xml version="1.0" encoding="iso-8859-1"?><!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"><html xmlns="http://www.w3.org/1999/xhtml" lang="en"><head><meta http-equiv="Content-Type" content="text/html;charset=UTF-8"/><link rel="stylesheet" href="../.resources/report.css" type="text/css"/><link rel="shortcut icon" href="../.resources/report.gif" type="image/gif"/><title>OptionValidator.java</title><link rel="stylesheet" href="../.resources/prettify.css" type="text/css"/><script type="text/javascript" src="../.resources/prettify.js"></script></head><body onload="window['PR_TAB_WIDTH']=4;prettyPrint()"><div class="breadcrumb" id="breadcrumb"><span class="info"><a href="../.sessions.html" class="el_session">Sessions</a></span><a href="../index.html" class="el_report">Apache Commons CLI</a> > <a href="index.source.html" class="el_package">org.apache.commons.cli</a> > <span class="el_source">OptionValidator.java</span></di
v><h1>OptionValidator.java</h1><pre class="source lang-java linenums">/**
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You 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
+ *
+ * http://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 org.apache.commons.cli;
+
+/**
+ * Validates an Option string.
+ *
+ * @version $Id: OptionValidator.java 1544819 2013-11-23 15:34:31Z tn $
+ * @since 1.1
+ */
+<span class="nc" id="L26">final class OptionValidator</span>
+{
+ /**
+ * Validates whether <code>opt</code> is a permissible Option
+ * shortOpt. The rules that specify if the <code>opt</code>
+ * is valid are:
+ *
+ * <ul>
+ * <li>a single character <code>opt</code> that is either
+ * ' '(special case), '?', '@' or a letter</li>
+ * <li>a multi character <code>opt</code> that only contains
+ * letters.</li>
+ * </ul>
+ * <p>
+ * In case {@code opt} is {@code null} no further validation is performed.
+ *
+ * @param opt The option string to validate, may be null
+ * @throws IllegalArgumentException if the Option is not valid.
+ */
+ static void validateOption(String opt) throws IllegalArgumentException
+ {
+ // if opt is NULL do not check further
+<span class="fc bfc" id="L48" title="All 2 branches covered."> if (opt == null)</span>
+ {
+<span class="fc" id="L50"> return;</span>
+ }
+
+ // handle the single character opt
+<span class="fc bfc" id="L54" title="All 2 branches covered."> if (opt.length() == 1)</span>
+ {
+<span class="fc" id="L56"> char ch = opt.charAt(0);</span>
+
+<span class="fc bfc" id="L58" title="All 2 branches covered."> if (!isValidOpt(ch))</span>
+ {
+<span class="fc" id="L60"> throw new IllegalArgumentException("Illegal option name '" + ch + "'");</span>
+ }
+<span class="fc" id="L62"> }</span>
+
+ // handle the multi character opt
+ else
+ {
+<span class="fc bfc" id="L67" title="All 2 branches covered."> for (char ch : opt.toCharArray())</span>
+ {
+<span class="fc bfc" id="L69" title="All 2 branches covered."> if (!isValidChar(ch))</span>
+ {
+<span class="fc" id="L71"> throw new IllegalArgumentException("The option '" + opt + "' contains an illegal "</span>
+ + "character : '" + ch + "'");
+ }
+ }
+ }
+<span class="fc" id="L76"> }</span>
+
+ /**
+ * Returns whether the specified character is a valid Option.
+ *
+ * @param c the option to validate
+ * @return true if <code>c</code> is a letter, '?' or '@', otherwise false.
+ */
+ private static boolean isValidOpt(char c)
+ {
+<span class="fc bfc" id="L86" title="All 6 branches covered."> return isValidChar(c) || c == '?' || c == '@';</span>
+ }
+
+ /**
+ * Returns whether the specified character is a valid character.
+ *
+ * @param c the character to validate
+ * @return true if <code>c</code> is a letter.
+ */
+ private static boolean isValidChar(char c)
+ {
+<span class="fc" id="L97"> return Character.isJavaIdentifierPart(c);</span>
+ }
+}
+</pre><div class="footer"><span class="right">Created with <a href="http://www.eclemma.org/jacoco">JaCoCo</a> 0.7.2.201409121644</span></div></body></html>
\ No newline at end of file
Propchange: websites/production/commons/content/proper/commons-cli/jacoco/org.apache.commons.cli/OptionValidator.java.html
------------------------------------------------------------------------------
svn:eol-style = native
Added: websites/production/commons/content/proper/commons-cli/jacoco/org.apache.commons.cli/Options.html
==============================================================================
--- websites/production/commons/content/proper/commons-cli/jacoco/org.apache.commons.cli/Options.html (added)
+++ websites/production/commons/content/proper/commons-cli/jacoco/org.apache.commons.cli/Options.html Sat May 9 18:19:15 2015
@@ -0,0 +1 @@
+<?xml version="1.0" encoding="iso-8859-1"?><!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"><html xmlns="http://www.w3.org/1999/xhtml" lang="en"><head><meta http-equiv="Content-Type" content="text/html;charset=UTF-8"/><link rel="stylesheet" href="../.resources/report.css" type="text/css"/><link rel="shortcut icon" href="../.resources/report.gif" type="image/gif"/><title>Options</title><script type="text/javascript" src="../.resources/sort.js"></script></head><body onload="initialSort(['breadcrumb'])"><div class="breadcrumb" id="breadcrumb"><span class="info"><a href="../.sessions.html" class="el_session">Sessions</a></span><a href="../index.html" class="el_report">Apache Commons CLI</a> > <a href="index.html" class="el_package">org.apache.commons.cli</a> > <span class="el_class">Options</span></div><h1>Options</h1><table class="coverage" cellspacing="0" id="coveragetable"><thead><tr><td class="sortable" id="a" onclick
="toggleSort(this)">Element</td><td class="down sortable bar" id="b" onclick="toggleSort(this)">Missed Instructions</td><td class="sortable ctr2" id="c" onclick="toggleSort(this)">Cov.</td><td class="sortable bar" id="d" onclick="toggleSort(this)">Missed Branches</td><td class="sortable ctr2" id="e" onclick="toggleSort(this)">Cov.</td><td class="sortable ctr1" id="f" onclick="toggleSort(this)">Missed</td><td class="sortable ctr2" id="g" onclick="toggleSort(this)">Cxty</td><td class="sortable ctr1" id="h" onclick="toggleSort(this)">Missed</td><td class="sortable ctr2" id="i" onclick="toggleSort(this)">Lines</td><td class="sortable ctr1" id="j" onclick="toggleSort(this)">Missed</td><td class="sortable ctr2" id="k" onclick="toggleSort(this)">Methods</td></tr></thead><tfoot><tr><td>Total</td><td class="bar">9 of 273</td><td class="ctr2">97%</td><td class="bar">0 of 20</td><td class="ctr2">100%</td><td class="ctr1">1</td><td class="ctr2">27</td><td class="ctr1">2</td><td class="ctr2">57<
/td><td class="ctr1">1</td><td class="ctr2">17</td></tr></tfoot><tbody><tr><td id="a2"><a href="Options.java.html#L111" class="el_method">addOption(String, String)</a></td><td class="bar" id="b0"><img src="../.resources/redbar.gif" width="25" height="10" title="9" alt="9"/></td><td class="ctr2" id="c16">0%</td><td class="bar" id="d5"/><td class="ctr2" id="e5">n/a</td><td class="ctr1" id="f0">1</td><td class="ctr2" id="g5">1</td><td class="ctr1" id="h0">2</td><td class="ctr2" id="i6">2</td><td class="ctr1" id="j0">1</td><td class="ctr2" id="k0">1</td></tr><tr><td id="a0"><a href="Options.java.html#L154" class="el_method">addOption(Option)</a></td><td class="bar" id="b1"><img src="../.resources/greenbar.gif" width="120" height="10" title="42" alt="42"/></td><td class="ctr2" id="c0">100%</td><td class="bar" id="d0"><img src="../.resources/greenbar.gif" width="120" height="10" title="6" alt="6"/></td><td class="ctr2" id="e0">100%</td><td class="ctr1" id="f1">0</td><td class="ctr2" id="g
0">4</td><td class="ctr1" id="h1">0</td><td class="ctr2" id="i0">9</td><td class="ctr1" id="j1">0</td><td class="ctr2" id="k1">1</td></tr><tr><td id="a4"><a href="Options.java.html#L71" class="el_method">addOptionGroup(OptionGroup)</a></td><td class="bar" id="b2"><img src="../.resources/greenbar.gif" width="102" height="10" title="36" alt="36"/></td><td class="ctr2" id="c1">100%</td><td class="bar" id="d1"><img src="../.resources/greenbar.gif" width="80" height="10" title="4" alt="4"/></td><td class="ctr2" id="e1">100%</td><td class="ctr1" id="f2">0</td><td class="ctr2" id="g1">3</td><td class="ctr1" id="h2">0</td><td class="ctr2" id="i1">8</td><td class="ctr1" id="j2">0</td><td class="ctr2" id="k2">1</td></tr><tr><td id="a5"><a href="Options.java.html#L235" class="el_method">getMatchingOptions(String)</a></td><td class="bar" id="b3"><img src="../.resources/greenbar.gif" width="85" height="10" title="30" alt="30"/></td><td class="ctr2" id="c2">100%</td><td class="bar" id="d2"><img s
rc="../.resources/greenbar.gif" width="80" height="10" title="4" alt="4"/></td><td class="ctr2" id="e2">100%</td><td class="ctr1" id="f3">0</td><td class="ctr2" id="g2">3</td><td class="ctr1" id="h3">0</td><td class="ctr2" id="i2">7</td><td class="ctr1" id="j3">0</td><td class="ctr2" id="k3">1</td></tr><tr><td id="a16"><a href="Options.java.html#L311" class="el_method">toString()</a></td><td class="bar" id="b4"><img src="../.resources/greenbar.gif" width="85" height="10" title="30" alt="30"/></td><td class="ctr2" id="c3">100%</td><td class="bar" id="d6"/><td class="ctr2" id="e6">n/a</td><td class="ctr1" id="f4">0</td><td class="ctr2" id="g6">1</td><td class="ctr1" id="h4">0</td><td class="ctr2" id="i3">7</td><td class="ctr1" id="j4">0</td><td class="ctr2" id="k4">1</td></tr><tr><td id="a15"><a href="Options.java.html#L44" class="el_method">Options()</a></td><td class="bar" id="b5"><img src="../.resources/greenbar.gif" width="65" height="10" title="23" alt="23"/></td><td class="ctr2"
id="c4">100%</td><td class="bar" id="d7"/><td class="ctr2" id="e7">n/a</td><td class="ctr1" id="f5">0</td><td class="ctr2" id="g7">1</td><td class="ctr1" id="h5">0</td><td class="ctr2" id="i4">5</td><td class="ctr1" id="j5">0</td><td class="ctr2" id="k5">1</td></tr><tr><td id="a6"><a href="Options.java.html#L216" class="el_method">getOption(String)</a></td><td class="bar" id="b6"><img src="../.resources/greenbar.gif" width="57" height="10" title="20" alt="20"/></td><td class="ctr2" id="c5">100%</td><td class="bar" id="d4"><img src="../.resources/greenbar.gif" width="40" height="10" title="2" alt="2"/></td><td class="ctr2" id="e3">100%</td><td class="ctr1" id="f6">0</td><td class="ctr2" id="g4">2</td><td class="ctr1" id="h6">0</td><td class="ctr2" id="i5">4</td><td class="ctr1" id="j6">0</td><td class="ctr2" id="k6">1</td></tr><tr><td id="a12"><a href="Options.java.html#L258" class="el_method">hasOption(String)</a></td><td class="bar" id="b7"><img src="../.resources/greenbar.gif" wi
dth="48" height="10" title="17" alt="17"/></td><td class="ctr2" id="c6">100%</td><td class="bar" id="d3"><img src="../.resources/greenbar.gif" width="80" height="10" title="4" alt="4"/></td><td class="ctr2" id="e4">100%</td><td class="ctr1" id="f7">0</td><td class="ctr2" id="g3">3</td><td class="ctr1" id="h7">0</td><td class="ctr2" id="i7">2</td><td class="ctr1" id="j7">0</td><td class="ctr2" id="k7">1</td></tr><tr><td id="a3"><a href="Options.java.html#L142" class="el_method">addOption(String, String, boolean, String)</a></td><td class="bar" id="b8"><img src="../.resources/greenbar.gif" width="34" height="10" title="12" alt="12"/></td><td class="ctr2" id="c7">100%</td><td class="bar" id="d8"/><td class="ctr2" id="e8">n/a</td><td class="ctr1" id="f8">0</td><td class="ctr2" id="g8">1</td><td class="ctr1" id="h8">0</td><td class="ctr2" id="i8">2</td><td class="ctr1" id="j8">0</td><td class="ctr2" id="k8">1</td></tr><tr><td id="a1"><a href="Options.java.html#L126" class="el_method">add
Option(String, boolean, String)</a></td><td class="bar" id="b9"><img src="../.resources/greenbar.gif" width="25" height="10" title="9" alt="9"/></td><td class="ctr2" id="c8">100%</td><td class="bar" id="d9"/><td class="ctr2" id="e9">n/a</td><td class="ctr1" id="f9">0</td><td class="ctr2" id="g9">1</td><td class="ctr1" id="h9">0</td><td class="ctr2" id="i9">2</td><td class="ctr1" id="j9">0</td><td class="ctr2" id="k9">1</td></tr><tr><td id="a11"><a href="Options.java.html#L272" class="el_method">hasLongOption(String)</a></td><td class="bar" id="b10"><img src="../.resources/greenbar.gif" width="22" height="10" title="8" alt="8"/></td><td class="ctr2" id="c9">100%</td><td class="bar" id="d10"/><td class="ctr2" id="e10">n/a</td><td class="ctr1" id="f10">0</td><td class="ctr2" id="g10">1</td><td class="ctr1" id="h10">0</td><td class="ctr2" id="i10">2</td><td class="ctr1" id="j10">0</td><td class="ctr2" id="k10">1</td></tr><tr><td id="a13"><a href="Options.java.html#L286" class="el_method
">hasShortOption(String)</a></td><td class="bar" id="b11"><img src="../.resources/greenbar.gif" width="22" height="10" title="8" alt="8"/></td><td class="ctr2" id="c10">100%</td><td class="bar" id="d11"/><td class="ctr2" id="e11">n/a</td><td class="ctr1" id="f11">0</td><td class="ctr2" id="g11">1</td><td class="ctr1" id="h11">0</td><td class="ctr2" id="i11">2</td><td class="ctr1" id="j11">0</td><td class="ctr2" id="k11">1</td></tr><tr><td id="a8"><a href="Options.java.html#L97" class="el_method">getOptionGroups()</a></td><td class="bar" id="b12"><img src="../.resources/greenbar.gif" width="20" height="10" title="7" alt="7"/></td><td class="ctr2" id="c11">100%</td><td class="bar" id="d12"/><td class="ctr2" id="e12">n/a</td><td class="ctr1" id="f12">0</td><td class="ctr2" id="g12">1</td><td class="ctr1" id="h12">0</td><td class="ctr2" id="i12">1</td><td class="ctr1" id="j12">0</td><td class="ctr2" id="k12">1</td></tr><tr><td id="a14"><a href="Options.java.html#L194" class="el_method">
helpOptions()</a></td><td class="bar" id="b13"><img src="../.resources/greenbar.gif" width="20" height="10" title="7" alt="7"/></td><td class="ctr2" id="c12">100%</td><td class="bar" id="d13"/><td class="ctr2" id="e13">n/a</td><td class="ctr1" id="f13">0</td><td class="ctr2" id="g13">1</td><td class="ctr1" id="h13">0</td><td class="ctr2" id="i13">1</td><td class="ctr1" id="j13">0</td><td class="ctr2" id="k13">1</td></tr><tr><td id="a7"><a href="Options.java.html#L300" class="el_method">getOptionGroup(Option)</a></td><td class="bar" id="b14"><img src="../.resources/greenbar.gif" width="20" height="10" title="7" alt="7"/></td><td class="ctr2" id="c13">100%</td><td class="bar" id="d14"/><td class="ctr2" id="e14">n/a</td><td class="ctr1" id="f14">0</td><td class="ctr2" id="g14">1</td><td class="ctr1" id="h14">0</td><td class="ctr2" id="i14">1</td><td class="ctr1" id="j14">0</td><td class="ctr2" id="k14">1</td></tr><tr><td id="a9"><a href="Options.java.html#L184" class="el_method">getOpt
ions()</a></td><td class="bar" id="b15"><img src="../.resources/greenbar.gif" width="11" height="10" title="4" alt="4"/></td><td class="ctr2" id="c14">100%</td><td class="bar" id="d15"/><td class="ctr2" id="e15">n/a</td><td class="ctr1" id="f15">0</td><td class="ctr2" id="g15">1</td><td class="ctr1" id="h15">0</td><td class="ctr2" id="i15">1</td><td class="ctr1" id="j15">0</td><td class="ctr2" id="k15">1</td></tr><tr><td id="a10"><a href="Options.java.html#L204" class="el_method">getRequiredOptions()</a></td><td class="bar" id="b16"><img src="../.resources/greenbar.gif" width="11" height="10" title="4" alt="4"/></td><td class="ctr2" id="c15">100%</td><td class="bar" id="d16"/><td class="ctr2" id="e16">n/a</td><td class="ctr1" id="f16">0</td><td class="ctr2" id="g16">1</td><td class="ctr1" id="h16">0</td><td class="ctr2" id="i16">1</td><td class="ctr1" id="j16">0</td><td class="ctr2" id="k16">1</td></tr></tbody></table><div class="footer"><span class="right">Created with <a href="htt
p://www.eclemma.org/jacoco">JaCoCo</a> 0.7.2.201409121644</span></div></body></html>
\ No newline at end of file
Propchange: websites/production/commons/content/proper/commons-cli/jacoco/org.apache.commons.cli/Options.html
------------------------------------------------------------------------------
svn:eol-style = native
Added: websites/production/commons/content/proper/commons-cli/jacoco/org.apache.commons.cli/Options.java.html
==============================================================================
--- websites/production/commons/content/proper/commons-cli/jacoco/org.apache.commons.cli/Options.java.html (added)
+++ websites/production/commons/content/proper/commons-cli/jacoco/org.apache.commons.cli/Options.java.html Sat May 9 18:19:15 2015
@@ -0,0 +1,322 @@
+<?xml version="1.0" encoding="iso-8859-1"?><!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"><html xmlns="http://www.w3.org/1999/xhtml" lang="en"><head><meta http-equiv="Content-Type" content="text/html;charset=UTF-8"/><link rel="stylesheet" href="../.resources/report.css" type="text/css"/><link rel="shortcut icon" href="../.resources/report.gif" type="image/gif"/><title>Options.java</title><link rel="stylesheet" href="../.resources/prettify.css" type="text/css"/><script type="text/javascript" src="../.resources/prettify.js"></script></head><body onload="window['PR_TAB_WIDTH']=4;prettyPrint()"><div class="breadcrumb" id="breadcrumb"><span class="info"><a href="../.sessions.html" class="el_session">Sessions</a></span><a href="../index.html" class="el_report">Apache Commons CLI</a> > <a href="index.source.html" class="el_package">org.apache.commons.cli</a> > <span class="el_source">Options.java</span></div><h1>Options.ja
va</h1><pre class="source lang-java linenums">/**
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You 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
+ *
+ * http://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 org.apache.commons.cli;
+
+import java.io.Serializable;
+import java.util.ArrayList;
+import java.util.Collection;
+import java.util.Collections;
+import java.util.HashMap;
+import java.util.HashSet;
+import java.util.LinkedHashMap;
+import java.util.List;
+import java.util.Map;
+
+/**
+ * Main entry-point into the library.
+ * <p>
+ * Options represents a collection of {@link Option} objects, which
+ * describe the possible options for a command-line.
+ * <p>
+ * It may flexibly parse long and short options, with or without
+ * values. Additionally, it may parse only a portion of a commandline,
+ * allowing for flexible multi-stage parsing.
+ *
+ * @see org.apache.commons.cli.CommandLine
+ *
+ * @version $Id: Options.java 1669814 2015-03-28 18:09:26Z britter $
+ */
+<span class="fc" id="L44">public class Options implements Serializable</span>
+{
+ /** The serial version UID. */
+ private static final long serialVersionUID = 1L;
+
+ /** a map of the options with the character key */
+<span class="fc" id="L50"> private final Map<String, Option> shortOpts = new LinkedHashMap<String, Option>();</span>
+
+ /** a map of the options with the long key */
+<span class="fc" id="L53"> private final Map<String, Option> longOpts = new LinkedHashMap<String, Option>();</span>
+
+ /** a map of the required options */
+ // N.B. This can contain either a String (addOption) or an OptionGroup (addOptionGroup)
+ // TODO this seems wrong
+<span class="fc" id="L58"> private final List<Object> requiredOpts = new ArrayList<Object>();</span>
+
+ /** a map of the option groups */
+<span class="fc" id="L61"> private final Map<String, OptionGroup> optionGroups = new HashMap<String, OptionGroup>();</span>
+
+ /**
+ * Add the specified option group.
+ *
+ * @param group the OptionGroup that is to be added
+ * @return the resulting Options instance
+ */
+ public Options addOptionGroup(OptionGroup group)
+ {
+<span class="fc bfc" id="L71" title="All 2 branches covered."> if (group.isRequired())</span>
+ {
+<span class="fc" id="L73"> requiredOpts.add(group);</span>
+ }
+
+<span class="fc bfc" id="L76" title="All 2 branches covered."> for (Option option : group.getOptions())</span>
+ {
+ // an Option cannot be required if it is in an
+ // OptionGroup, either the group is required or
+ // nothing is required
+<span class="fc" id="L81"> option.setRequired(false);</span>
+<span class="fc" id="L82"> addOption(option);</span>
+
+<span class="fc" id="L84"> optionGroups.put(option.getKey(), group);</span>
+<span class="fc" id="L85"> }</span>
+
+<span class="fc" id="L87"> return this;</span>
+ }
+
+ /**
+ * Lists the OptionGroups that are members of this Options instance.
+ *
+ * @return a Collection of OptionGroup instances.
+ */
+ Collection<OptionGroup> getOptionGroups()
+ {
+<span class="fc" id="L97"> return new HashSet<OptionGroup>(optionGroups.values());</span>
+ }
+
+ /**
+ * Add an option that only contains a short name.
+ * The option does not take an argument.
+ *
+ * @param opt Short single-character name of the option.
+ * @param description Self-documenting description
+ * @return the resulting Options instance
+ * @since 1.3
+ */
+ public Options addOption(String opt, String description)
+ {
+<span class="nc" id="L111"> addOption(opt, null, false, description);</span>
+<span class="nc" id="L112"> return this;</span>
+ }
+
+ /**
+ * Add an option that only contains a short-name.
+ * It may be specified as requiring an argument.
+ *
+ * @param opt Short single-character name of the option.
+ * @param hasArg flag signally if an argument is required after this option
+ * @param description Self-documenting description
+ * @return the resulting Options instance
+ */
+ public Options addOption(String opt, boolean hasArg, String description)
+ {
+<span class="fc" id="L126"> addOption(opt, null, hasArg, description);</span>
+<span class="fc" id="L127"> return this;</span>
+ }
+
+ /**
+ * Add an option that contains a short-name and a long-name.
+ * It may be specified as requiring an argument.
+ *
+ * @param opt Short single-character name of the option.
+ * @param longOpt Long multi-character name of the option.
+ * @param hasArg flag signally if an argument is required after this option
+ * @param description Self-documenting description
+ * @return the resulting Options instance
+ */
+ public Options addOption(String opt, String longOpt, boolean hasArg, String description)
+ {
+<span class="fc" id="L142"> addOption(new Option(opt, longOpt, hasArg, description));</span>
+<span class="fc" id="L143"> return this;</span>
+ }
+
+ /**
+ * Adds an option instance
+ *
+ * @param opt the option that is to be added
+ * @return the resulting Options instance
+ */
+ public Options addOption(Option opt)
+ {
+<span class="fc" id="L154"> String key = opt.getKey();</span>
+
+ // add it to the long option list
+<span class="fc bfc" id="L157" title="All 2 branches covered."> if (opt.hasLongOpt())</span>
+ {
+<span class="fc" id="L159"> longOpts.put(opt.getLongOpt(), opt);</span>
+ }
+
+ // if the option is required add it to the required list
+<span class="fc bfc" id="L163" title="All 2 branches covered."> if (opt.isRequired())</span>
+ {
+<span class="fc bfc" id="L165" title="All 2 branches covered."> if (requiredOpts.contains(key))</span>
+ {
+<span class="fc" id="L167"> requiredOpts.remove(requiredOpts.indexOf(key));</span>
+ }
+<span class="fc" id="L169"> requiredOpts.add(key);</span>
+ }
+
+<span class="fc" id="L172"> shortOpts.put(key, opt);</span>
+
+<span class="fc" id="L174"> return this;</span>
+ }
+
+ /**
+ * Retrieve a read-only list of options in this set
+ *
+ * @return read-only Collection of {@link Option} objects in this descriptor
+ */
+ public Collection<Option> getOptions()
+ {
+<span class="fc" id="L184"> return Collections.unmodifiableCollection(helpOptions());</span>
+ }
+
+ /**
+ * Returns the Options for use by the HelpFormatter.
+ *
+ * @return the List of Options
+ */
+ List<Option> helpOptions()
+ {
+<span class="fc" id="L194"> return new ArrayList<Option>(shortOpts.values());</span>
+ }
+
+ /**
+ * Returns the required options.
+ *
+ * @return read-only List of required options
+ */
+ public List getRequiredOptions()
+ {
+<span class="fc" id="L204"> return Collections.unmodifiableList(requiredOpts);</span>
+ }
+
+ /**
+ * Retrieve the {@link Option} matching the long or short name specified.
+ * The leading hyphens in the name are ignored (up to 2).
+ *
+ * @param opt short or long name of the {@link Option}
+ * @return the option represented by opt
+ */
+ public Option getOption(String opt)
+ {
+<span class="fc" id="L216"> opt = Util.stripLeadingHyphens(opt);</span>
+
+<span class="fc bfc" id="L218" title="All 2 branches covered."> if (shortOpts.containsKey(opt))</span>
+ {
+<span class="fc" id="L220"> return shortOpts.get(opt);</span>
+ }
+
+<span class="fc" id="L223"> return longOpts.get(opt);</span>
+ }
+
+ /**
+ * Returns the options with a long name starting with the name specified.
+ *
+ * @param opt the partial name of the option
+ * @return the options matching the partial name specified, or an empty list if none matches
+ * @since 1.3
+ */
+ public List<String> getMatchingOptions(String opt)
+ {
+<span class="fc" id="L235"> opt = Util.stripLeadingHyphens(opt);</span>
+
+<span class="fc" id="L237"> List<String> matchingOpts = new ArrayList<String>();</span>
+
+<span class="fc bfc" id="L239" title="All 2 branches covered."> for (String longOpt : longOpts.keySet())</span>
+ {
+<span class="fc bfc" id="L241" title="All 2 branches covered."> if (longOpt.startsWith(opt))</span>
+ {
+<span class="fc" id="L243"> matchingOpts.add(longOpt);</span>
+ }
+<span class="fc" id="L245"> }</span>
+
+<span class="fc" id="L247"> return matchingOpts;</span>
+ }
+
+ /**
+ * Returns whether the named {@link Option} is a member of this {@link Options}.
+ *
+ * @param opt short or long name of the {@link Option}
+ * @return true if the named {@link Option} is a member of this {@link Options}
+ */
+ public boolean hasOption(String opt)
+ {
+<span class="fc" id="L258"> opt = Util.stripLeadingHyphens(opt);</span>
+
+<span class="fc bfc" id="L260" title="All 4 branches covered."> return shortOpts.containsKey(opt) || longOpts.containsKey(opt);</span>
+ }
+
+ /**
+ * Returns whether the named {@link Option} is a member of this {@link Options}.
+ *
+ * @param opt long name of the {@link Option}
+ * @return true if the named {@link Option} is a member of this {@link Options}
+ * @since 1.3
+ */
+ public boolean hasLongOption(String opt)
+ {
+<span class="fc" id="L272"> opt = Util.stripLeadingHyphens(opt);</span>
+
+<span class="fc" id="L274"> return longOpts.containsKey(opt);</span>
+ }
+
+ /**
+ * Returns whether the named {@link Option} is a member of this {@link Options}.
+ *
+ * @param opt short name of the {@link Option}
+ * @return true if the named {@link Option} is a member of this {@link Options}
+ * @since 1.3
+ */
+ public boolean hasShortOption(String opt)
+ {
+<span class="fc" id="L286"> opt = Util.stripLeadingHyphens(opt);</span>
+
+<span class="fc" id="L288"> return shortOpts.containsKey(opt);</span>
+ }
+
+ /**
+ * Returns the OptionGroup the <code>opt</code> belongs to.
+ * @param opt the option whose OptionGroup is being queried.
+ *
+ * @return the OptionGroup if <code>opt</code> is part
+ * of an OptionGroup, otherwise return null
+ */
+ public OptionGroup getOptionGroup(Option opt)
+ {
+<span class="fc" id="L300"> return optionGroups.get(opt.getKey());</span>
+ }
+
+ /**
+ * Dump state, suitable for debugging.
+ *
+ * @return Stringified form of this object
+ */
+ @Override
+ public String toString()
+ {
+<span class="fc" id="L311"> StringBuilder buf = new StringBuilder();</span>
+
+<span class="fc" id="L313"> buf.append("[ Options: [ short ");</span>
+<span class="fc" id="L314"> buf.append(shortOpts.toString());</span>
+<span class="fc" id="L315"> buf.append(" ] [ long ");</span>
+<span class="fc" id="L316"> buf.append(longOpts);</span>
+<span class="fc" id="L317"> buf.append(" ]");</span>
+
+<span class="fc" id="L319"> return buf.toString();</span>
+ }
+}
+</pre><div class="footer"><span class="right">Created with <a href="http://www.eclemma.org/jacoco">JaCoCo</a> 0.7.2.201409121644</span></div></body></html>
\ No newline at end of file
Propchange: websites/production/commons/content/proper/commons-cli/jacoco/org.apache.commons.cli/Options.java.html
------------------------------------------------------------------------------
svn:eol-style = native
Added: websites/production/commons/content/proper/commons-cli/jacoco/org.apache.commons.cli/ParseException.html
==============================================================================
--- websites/production/commons/content/proper/commons-cli/jacoco/org.apache.commons.cli/ParseException.html (added)
+++ websites/production/commons/content/proper/commons-cli/jacoco/org.apache.commons.cli/ParseException.html Sat May 9 18:19:15 2015
@@ -0,0 +1 @@
+<?xml version="1.0" encoding="iso-8859-1"?><!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"><html xmlns="http://www.w3.org/1999/xhtml" lang="en"><head><meta http-equiv="Content-Type" content="text/html;charset=UTF-8"/><link rel="stylesheet" href="../.resources/report.css" type="text/css"/><link rel="shortcut icon" href="../.resources/report.gif" type="image/gif"/><title>ParseException</title><script type="text/javascript" src="../.resources/sort.js"></script></head><body onload="initialSort(['breadcrumb'])"><div class="breadcrumb" id="breadcrumb"><span class="info"><a href="../.sessions.html" class="el_session">Sessions</a></span><a href="../index.html" class="el_report">Apache Commons CLI</a> > <a href="index.html" class="el_package">org.apache.commons.cli</a> > <span class="el_class">ParseException</span></div><h1>ParseException</h1><table class="coverage" cellspacing="0" id="coveragetable"><thead><tr><td class="sor
table" id="a" onclick="toggleSort(this)">Element</td><td class="down sortable bar" id="b" onclick="toggleSort(this)">Missed Instructions</td><td class="sortable ctr2" id="c" onclick="toggleSort(this)">Cov.</td><td class="sortable bar" id="d" onclick="toggleSort(this)">Missed Branches</td><td class="sortable ctr2" id="e" onclick="toggleSort(this)">Cov.</td><td class="sortable ctr1" id="f" onclick="toggleSort(this)">Missed</td><td class="sortable ctr2" id="g" onclick="toggleSort(this)">Cxty</td><td class="sortable ctr1" id="h" onclick="toggleSort(this)">Missed</td><td class="sortable ctr2" id="i" onclick="toggleSort(this)">Lines</td><td class="sortable ctr1" id="j" onclick="toggleSort(this)">Missed</td><td class="sortable ctr2" id="k" onclick="toggleSort(this)">Methods</td></tr></thead><tfoot><tr><td>Total</td><td class="bar">0 of 4</td><td class="ctr2">100%</td><td class="bar">0 of 0</td><td class="ctr2">n/a</td><td class="ctr1">0</td><td class="ctr2">1</td><td class="ctr1">0</td><td
class="ctr2">2</td><td class="ctr1">0</td><td class="ctr2">1</td></tr></tfoot><tbody><tr><td id="a0"><a href="ParseException.java.html#L40" class="el_method">ParseException(String)</a></td><td class="bar" id="b0"><img src="../.resources/greenbar.gif" width="120" height="10" title="4" alt="4"/></td><td class="ctr2" id="c0">100%</td><td class="bar" id="d0"/><td class="ctr2" id="e0">n/a</td><td class="ctr1" id="f0">0</td><td class="ctr2" id="g0">1</td><td class="ctr1" id="h0">0</td><td class="ctr2" id="i0">2</td><td class="ctr1" id="j0">0</td><td class="ctr2" id="k0">1</td></tr></tbody></table><div class="footer"><span class="right">Created with <a href="http://www.eclemma.org/jacoco">JaCoCo</a> 0.7.2.201409121644</span></div></body></html>
\ No newline at end of file
Propchange: websites/production/commons/content/proper/commons-cli/jacoco/org.apache.commons.cli/ParseException.html
------------------------------------------------------------------------------
svn:eol-style = native
Added: websites/production/commons/content/proper/commons-cli/jacoco/org.apache.commons.cli/ParseException.java.html
==============================================================================
--- websites/production/commons/content/proper/commons-cli/jacoco/org.apache.commons.cli/ParseException.java.html (added)
+++ websites/production/commons/content/proper/commons-cli/jacoco/org.apache.commons.cli/ParseException.java.html Sat May 9 18:19:15 2015
@@ -0,0 +1,43 @@
+<?xml version="1.0" encoding="iso-8859-1"?><!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"><html xmlns="http://www.w3.org/1999/xhtml" lang="en"><head><meta http-equiv="Content-Type" content="text/html;charset=UTF-8"/><link rel="stylesheet" href="../.resources/report.css" type="text/css"/><link rel="shortcut icon" href="../.resources/report.gif" type="image/gif"/><title>ParseException.java</title><link rel="stylesheet" href="../.resources/prettify.css" type="text/css"/><script type="text/javascript" src="../.resources/prettify.js"></script></head><body onload="window['PR_TAB_WIDTH']=4;prettyPrint()"><div class="breadcrumb" id="breadcrumb"><span class="info"><a href="../.sessions.html" class="el_session">Sessions</a></span><a href="../index.html" class="el_report">Apache Commons CLI</a> > <a href="index.source.html" class="el_package">org.apache.commons.cli</a> > <span class="el_source">ParseException.java</span></div>
<h1>ParseException.java</h1><pre class="source lang-java linenums">/**
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You 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
+ *
+ * http://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 org.apache.commons.cli;
+
+/**
+ * Base for Exceptions thrown during parsing of a command-line.
+ *
+ * @version $Id: ParseException.java 1443102 2013-02-06 18:12:16Z tn $
+ */
+public class ParseException extends Exception
+{
+ /**
+ * This exception {@code serialVersionUID}.
+ */
+ private static final long serialVersionUID = 9112808380089253192L;
+
+ /**
+ * Construct a new <code>ParseException</code>
+ * with the specified detail message.
+ *
+ * @param message the detail message
+ */
+ public ParseException(String message)
+ {
+<span class="fc" id="L40"> super(message);</span>
+<span class="fc" id="L41"> }</span>
+}
+</pre><div class="footer"><span class="right">Created with <a href="http://www.eclemma.org/jacoco">JaCoCo</a> 0.7.2.201409121644</span></div></body></html>
\ No newline at end of file