summaryrefslogtreecommitdiffstats
path: root/auth/auth-cmd/src/main/java/org/onap/aaf/auth/cmd/Help.java
blob: 12cf0635fc47549e899fbdd5d3419239db85d7b7 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
/**
 * ============LICENSE_START====================================================
 * org.onap.aaf
 * ===========================================================================
 * Copyright (c) 2018 AT&T Intellectual Property. All rights reserved.
 * ===========================================================================
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 * 
 *      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.
 * ============LICENSE_END====================================================
 *
 */

package org.onap.aaf.auth.cmd;

import java.util.List;

import org.onap.aaf.cadi.CadiException;
import org.onap.aaf.cadi.LocatorException;
import org.onap.aaf.misc.env.APIException;

public class Help extends Cmd {
    private List<Cmd> cmds;

    public Help(AAFcli aafcli, List<Cmd> cmds) {
        super(aafcli, "--help", 
            new Param("-d (more details)", false),
            new Param("command",false));
        this.cmds = cmds;
    }

    @Override
    public int _exec( int idxValue, final String ... args) throws CadiException, APIException, LocatorException {
            int idx = idxValue;
        boolean first = true;
        StringBuilder sb = new StringBuilder("AAF Command Line Tool");
        StringBuilder details;
        multiChar(sb, 21, '-',0);
        sb.append("\n  SingleLine Commands");
        multiChar(sb, 21, '-',2);
        sb.append("\n    force   - add to regular commands to override depency checks");
        sb.append("\n    details - add to role list or perm list commands for rich format");
        multiChar(sb, 48, '-',2);
        // if details !=null, then extra details are written to it.
        details = aafcli.isDetailed()?new StringBuilder():null;

        String comp = args.length>idx?args[idx++]:null;
        if ("help".equalsIgnoreCase(comp)) {
            build(sb,null);
            detailedHelp(4, sb);
            sb.append('\n');
        } else {
            for (Cmd c : cmds) {
                if (!(c instanceof DeprecatedCMD)) {
                    if (comp!=null) {
                        if (comp.equals(c.getName())) {
                            multiChar(sb,2,' ',0);
                            c.build(sb,details);
                        }
                    } else {
                        if (first) {
                            first=false;
                        } else {
                            multiChar(sb,80,'-',2);
                        }
                        multiChar(sb,2,' ',0);
                        c.build(sb,details);
                        if (details!=null) {
                            c.detailedHelp(4, sb);
                        }
                    }
                }
            }
        }
        pw().println(sb.toString());
        return 200 /*HttpStatus.OK_200*/;
    }
    
    @Override
    public void detailedHelp(int indentValue, StringBuilder sb) {
            int indent = indentValue;
        detailLine(sb,indent,"To print main help, enter \"aafcli\" or \"aafcli --help \"");
        detailLine(sb,indent,"To print narrow the help content, enter sub-entries after aafcli,");
        detailLine(sb,indent+2,"i.e. \"aafcli perm\"");
        detailLine(sb,indent,"To see version of AAF CLI, enter \"aafcli --version \"");
        sb.append('\n');
        detailLine(sb,indent,"State Commands: change variables or credentials between calls.");
        indent+=4;
        detailLine(sb,indent,"set <tag>=<value>   - Set any System Property to a new value");
        detailLine(sb,indent,"as <id:password>    - Change Credentials.  Password may be encrypted");
        detailLine(sb,indent,"expect <int> [int]* - In test mode, check for proper HTTP Status Codes");
        detailLine(sb,indent,"sleep <int>         - Wait for <int> seconds");
        detailLine(sb,indent,"force               - force deletions that have relationships");
        detailLine(sb,indent,"details               - cause list commands (role, perm) to print rich format");
        detailLine(sb,indent,"                       - In GUI CmdLine, use HourGlass option (top right)");
        sb.append('\n');
        detailLine(sb,indent-4,"CmdLine Arguments: change behavior of the aafcli program");
        detailLine(sb,indent,"-i - Read commands from Shell Standard Input");
        detailLine(sb,indent,"-f - Read commands from a file");
        detailLine(sb,indent,"-r - Clear Command Line SSO credential");
        detailLine(sb,indent,"-a - In test mode, do not stop execution on unexpected error");
        detailLine(sb,indent,"-t - Test Mode will not print variable fields that could break tc runs");
        detailLine(sb,indent+6,"such as expiration dates of a credential");
        detailLine(sb,indent,"-s - Request specific Start Date (not immediately)");
        detailLine(sb,indent+6,"Format YYYY-MM-DD.  Can also be set with \"set " + Cmd.STARTDATE + "=<value>\"");
        detailLine(sb,indent,"-e - Set Expiration/End Date, where commands support");
        detailLine(sb,indent+6,"Format YYYY-MM-DD.  Can also be set with \"set " + Cmd.ENDDATE + "=<value>\"");
    }
}