github.com/jfrog/frogbot@v1.1.1-0.20231221090046-821a26f50338/action/node_modules/@actions/core/lib/core.d.ts (about) 1 /** 2 * Interface for getInput options 3 */ 4 export interface InputOptions { 5 /** Optional. Whether the input is required. If required and not present, will throw. Defaults to false */ 6 required?: boolean; 7 /** Optional. Whether leading/trailing whitespace will be trimmed for the input. Defaults to true */ 8 trimWhitespace?: boolean; 9 } 10 /** 11 * The code to exit an action 12 */ 13 export declare enum ExitCode { 14 /** 15 * A code indicating that the action was successful 16 */ 17 Success = 0, 18 /** 19 * A code indicating that the action was a failure 20 */ 21 Failure = 1 22 } 23 /** 24 * Optional properties that can be sent with annotatation commands (notice, error, and warning) 25 * See: https://docs.github.com/en/rest/reference/checks#create-a-check-run for more information about annotations. 26 */ 27 export interface AnnotationProperties { 28 /** 29 * A title for the annotation. 30 */ 31 title?: string; 32 /** 33 * The path of the file for which the annotation should be created. 34 */ 35 file?: string; 36 /** 37 * The start line for the annotation. 38 */ 39 startLine?: number; 40 /** 41 * The end line for the annotation. Defaults to `startLine` when `startLine` is provided. 42 */ 43 endLine?: number; 44 /** 45 * The start column for the annotation. Cannot be sent when `startLine` and `endLine` are different values. 46 */ 47 startColumn?: number; 48 /** 49 * The start column for the annotation. Cannot be sent when `startLine` and `endLine` are different values. 50 * Defaults to `startColumn` when `startColumn` is provided. 51 */ 52 endColumn?: number; 53 } 54 /** 55 * Sets env variable for this action and future actions in the job 56 * @param name the name of the variable to set 57 * @param val the value of the variable. Non-string values will be converted to a string via JSON.stringify 58 */ 59 export declare function exportVariable(name: string, val: any): void; 60 /** 61 * Registers a secret which will get masked from logs 62 * @param secret value of the secret 63 */ 64 export declare function setSecret(secret: string): void; 65 /** 66 * Prepends inputPath to the PATH (for this action and future actions) 67 * @param inputPath 68 */ 69 export declare function addPath(inputPath: string): void; 70 /** 71 * Gets the value of an input. 72 * Unless trimWhitespace is set to false in InputOptions, the value is also trimmed. 73 * Returns an empty string if the value is not defined. 74 * 75 * @param name name of the input to get 76 * @param options optional. See InputOptions. 77 * @returns string 78 */ 79 export declare function getInput(name: string, options?: InputOptions): string; 80 /** 81 * Gets the values of an multiline input. Each value is also trimmed. 82 * 83 * @param name name of the input to get 84 * @param options optional. See InputOptions. 85 * @returns string[] 86 * 87 */ 88 export declare function getMultilineInput(name: string, options?: InputOptions): string[]; 89 /** 90 * Gets the input value of the boolean type in the YAML 1.2 "core schema" specification. 91 * Support boolean input list: `true | True | TRUE | false | False | FALSE` . 92 * The return value is also in boolean type. 93 * ref: https://yaml.org/spec/1.2/spec.html#id2804923 94 * 95 * @param name name of the input to get 96 * @param options optional. See InputOptions. 97 * @returns boolean 98 */ 99 export declare function getBooleanInput(name: string, options?: InputOptions): boolean; 100 /** 101 * Sets the value of an output. 102 * 103 * @param name name of the output to set 104 * @param value value to store. Non-string values will be converted to a string via JSON.stringify 105 */ 106 export declare function setOutput(name: string, value: any): void; 107 /** 108 * Enables or disables the echoing of commands into stdout for the rest of the step. 109 * Echoing is disabled by default if ACTIONS_STEP_DEBUG is not set. 110 * 111 */ 112 export declare function setCommandEcho(enabled: boolean): void; 113 /** 114 * Sets the action status to failed. 115 * When the action exits it will be with an exit code of 1 116 * @param message add error issue message 117 */ 118 export declare function setFailed(message: string | Error): void; 119 /** 120 * Gets whether Actions Step Debug is on or not 121 */ 122 export declare function isDebug(): boolean; 123 /** 124 * Writes debug message to user log 125 * @param message debug message 126 */ 127 export declare function debug(message: string): void; 128 /** 129 * Adds an error issue 130 * @param message error issue message. Errors will be converted to string via toString() 131 * @param properties optional properties to add to the annotation. 132 */ 133 export declare function error(message: string | Error, properties?: AnnotationProperties): void; 134 /** 135 * Adds a warning issue 136 * @param message warning issue message. Errors will be converted to string via toString() 137 * @param properties optional properties to add to the annotation. 138 */ 139 export declare function warning(message: string | Error, properties?: AnnotationProperties): void; 140 /** 141 * Adds a notice issue 142 * @param message notice issue message. Errors will be converted to string via toString() 143 * @param properties optional properties to add to the annotation. 144 */ 145 export declare function notice(message: string | Error, properties?: AnnotationProperties): void; 146 /** 147 * Writes info to log with console.log. 148 * @param message info message 149 */ 150 export declare function info(message: string): void; 151 /** 152 * Begin an output group. 153 * 154 * Output until the next `groupEnd` will be foldable in this group 155 * 156 * @param name The name of the output group 157 */ 158 export declare function startGroup(name: string): void; 159 /** 160 * End an output group. 161 */ 162 export declare function endGroup(): void; 163 /** 164 * Wrap an asynchronous function call in a group. 165 * 166 * Returns the same type as the function itself. 167 * 168 * @param name The name of the group 169 * @param fn The function to wrap in the group 170 */ 171 export declare function group<T>(name: string, fn: () => Promise<T>): Promise<T>; 172 /** 173 * Saves state for current action, the state can only be retrieved by this action's post job execution. 174 * 175 * @param name name of the state to store 176 * @param value value to store. Non-string values will be converted to a string via JSON.stringify 177 */ 178 export declare function saveState(name: string, value: any): void; 179 /** 180 * Gets the value of an state set by this action's main execution. 181 * 182 * @param name name of the state to get 183 * @returns string 184 */ 185 export declare function getState(name: string): string; 186 export declare function getIDToken(aud?: string): Promise<string>; 187 /** 188 * Summary exports 189 */ 190 export { summary } from './summary'; 191 /** 192 * @deprecated use core.summary 193 */ 194 export { markdownSummary } from './summary'; 195 /** 196 * Path exports 197 */ 198 export { toPosixPath, toWin32Path, toPlatformPath } from './path-utils';