1 /*
2  * Copyright (c) 2009, 2015, Oracle and/or its affiliates. All rights reserved.
3  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
4  *
5  * This code is free software; you can redistribute it and/or modify it
6  * under the terms of the GNU General Public License version 2 only, as
7  * published by the Free Software Foundation.  Oracle designates this
8  * particular file as subject to the "Classpath" exception as provided
9  * by Oracle in the LICENSE file that accompanied this code.
10  *
11  * This code is distributed in the hope that it will be useful, but WITHOUT
12  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
13  * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
14  * version 2 for more details (a copy is included in the LICENSE file that
15  * accompanied this code).
16  *
17  * You should have received a copy of the GNU General Public License version
18  * 2 along with this work; if not, write to the Free Software Foundation,
19  * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
20  *
21  * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
22  * or visit www.oracle.com if you need additional information or have any
23  * questions.
24  */
25 
26 /*
27  * This file is available under and governed by the GNU General Public
28  * License version 2 only, as published by the Free Software Foundation.
29  * However, the following notice accompanied the original version of this
30  * file:
31  *
32  * The MIT License
33  *
34  * Copyright (c) 2004-2015 Paul R. Holser, Jr.
35  *
36  * Permission is hereby granted, free of charge, to any person obtaining
37  * a copy of this software and associated documentation files (the
38  * "Software"), to deal in the Software without restriction, including
39  * without limitation the rights to use, copy, modify, merge, publish,
40  * distribute, sublicense, and/or sell copies of the Software, and to
41  * permit persons to whom the Software is furnished to do so, subject to
42  * the following conditions:
43  *
44  * The above copyright notice and this permission notice shall be
45  * included in all copies or substantial portions of the Software.
46  *
47  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
48  * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
49  * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
50  * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
51  * LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
52  * OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
53  * WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
54  */
55 
56 package jdk.internal.joptsimple;
57 
58 import java.util.List;
59 
60 import static java.lang.Character.*;
61 
62 /**
63  * Can tell whether or not options are well-formed.
64  *
65  * @author <a href="mailto:pholser@alumni.rice.edu">Paul Holser</a>
66  */
67 final class ParserRules {
68     static final char HYPHEN_CHAR = '-';
69     static final String HYPHEN = String.valueOf( HYPHEN_CHAR );
70     static final String DOUBLE_HYPHEN = "--";
71     static final String OPTION_TERMINATOR = DOUBLE_HYPHEN;
72     static final String RESERVED_FOR_EXTENSIONS = "W";
73 
ParserRules()74     private ParserRules() {
75         throw new UnsupportedOperationException();
76     }
77 
isShortOptionToken( String argument )78     static boolean isShortOptionToken( String argument ) {
79         return argument.startsWith( HYPHEN )
80             && !HYPHEN.equals( argument )
81             && !isLongOptionToken( argument );
82     }
83 
isLongOptionToken( String argument )84     static boolean isLongOptionToken( String argument ) {
85         return argument.startsWith( DOUBLE_HYPHEN ) && !isOptionTerminator( argument );
86     }
87 
isOptionTerminator( String argument )88     static boolean isOptionTerminator( String argument ) {
89         return OPTION_TERMINATOR.equals( argument );
90     }
91 
ensureLegalOption( String option )92     static void ensureLegalOption( String option ) {
93         if ( option.startsWith( HYPHEN ) )
94             throw new IllegalOptionSpecificationException( String.valueOf( option ) );
95 
96         for ( int i = 0; i < option.length(); ++i )
97             ensureLegalOptionCharacter( option.charAt( i ) );
98     }
99 
ensureLegalOptions( List<String> options )100     static void ensureLegalOptions( List<String> options ) {
101         for ( String each : options )
102             ensureLegalOption( each );
103     }
104 
ensureLegalOptionCharacter( char option )105     private static void ensureLegalOptionCharacter( char option ) {
106         if ( !( isLetterOrDigit( option ) || isAllowedPunctuation( option ) ) )
107             throw new IllegalOptionSpecificationException( String.valueOf( option ) );
108     }
109 
isAllowedPunctuation( char option )110     private static boolean isAllowedPunctuation( char option ) {
111         String allowedPunctuation = "?._" + HYPHEN_CHAR;
112         return allowedPunctuation.indexOf( option ) != -1;
113     }
114 }
115