com.thoughtworks.go.plugin.api.task.Console Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of go-plugin-api Show documentation
Show all versions of go-plugin-api Show documentation
The APIs described here are needed for developing plugins for GoCD - A continuous delivery server
/*
* Copyright 2020 ThoughtWorks, Inc.
*
* 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.
*/
package com.thoughtworks.go.plugin.api.task;
import java.io.InputStream;
import java.util.Map;
/**
* Used to write information of a task run, out to the build log.
*/
@Deprecated
//Will be moved to internal scope
public interface Console {
/**
* Print a line out to the build log.
*
* @param line Line to write.
*/
void printLine(String line);
/**
* Setup the console to read the input stream as standard error.
*
* This is used to connect the output of a process, to the build log. This is usually used as:
* console.readErrorOf(process.getErrorStream());
*
* where the "process" object is of type {@link java.lang.Process}.
*
* @param in The input stream to read as standard error.
*/
void readErrorOf(InputStream in);
/**
* Setup the console to read the input stream as standard output.
*
* This is used to connect the output of a process, to the build log. This is usually used as:
* console.readOutputOf(process.getInputStream());
*
* where the "process" object is of type {@link java.lang.Process}.
*
* @param in The input stream to read as standard output.
*/
void readOutputOf(InputStream in);
/**
* Print details about the environment specified in the argument into the build log.
*
* @param environment Environment to print details of.
* @param secureEnvVarSpecifier {@link com.thoughtworks.go.plugin.api.task.Console.SecureEnvVarSpecifier}
*/
void printEnvironment(Map environment, SecureEnvVarSpecifier secureEnvVarSpecifier);
/**
* Used to specify which environment variables are secure and shouldn't be printed literally.
*/
interface SecureEnvVarSpecifier {
public boolean isSecure(String variableName);
}
}
© 2015 - 2024 Weber Informatics LLC | Privacy Policy