Documentation ¶
Index ¶
- func CheckAddonDescriptorForRepositories(addonDescriptor AddonDescriptor) error
- func ConvertTime(logTimeStamp string) time.Time
- func GetHTTPResponse(requestType string, connectionDetails ConnectionDetailsHTTP, body []byte, ...) (*http.Response, error)
- func HandleHTTPError(resp *http.Response, err error, message string, ...) error
- func PollEntity(repositoryName string, connectionDetails ConnectionDetailsHTTP, ...) (string, error)
- func PrintLegacyLogs(repositoryName string, connectionDetails ConnectionDetailsHTTP, ...)
- func PrintLogs(repositoryName string, connectionDetails ConnectionDetailsHTTP, ...)
- func ReadConfigFile(path string) (file []byte, err error)
- type AUtilsMock
- type AbapBinding
- type AbapConnection
- type AbapEnvironmentCheckoutBranchOptions
- type AbapEnvironmentOptions
- type AbapEnvironmentPullGitRepoOptions
- type AbapEnvironmentRunATCCheckOptions
- type AbapError
- type AbapErrorMessage
- type AbapLogs
- type AbapLogsV2
- type AbapMetadata
- type AbapServiceKey
- type AbapUtils
- type AddonDescriptor
- func (me *AddonDescriptor) AsJSON() []byte
- func (me *AddonDescriptor) AsJSONstring() string
- func (me *AddonDescriptor) GetRepositoriesInBuildScope() []Repository
- func (me *AddonDescriptor) InitFromJSONstring(JSONstring string) error
- func (me *AddonDescriptor) SetRepositories(Repositories []Repository)
- type BranchEntity
- type ClientMock
- func (c *ClientMock) DownloadFile(url, filename string, header http.Header, cookies []*http.Cookie) error
- func (c *ClientMock) SendRequest(method, url string, bdy io.Reader, hdr http.Header, cookies []*http.Cookie) (*http.Response, error)
- func (c *ClientMock) SetOptions(opts piperhttp.ClientOptions)
- type CloneEntity
- type Communication
- type ConnectionDetailsHTTP
- type EntitySetsForManageGitRepository
- type LogProtocol
- type LogProtocolResults
- type LogResults
- type LogResultsV2
- type PullEntity
- type ReadAddonDescriptorType
- type RepositoriesConfig
- type Repository
- func (me *Repository) GetAakAasLanguageVector() string
- func (repo *Repository) GetCloneLogString() (logString string)
- func (repo *Repository) GetCloneRequestBody() (body string)
- func (repo *Repository) GetLogStringForCommitOrTag() (logString string)
- func (repo *Repository) GetPullLogString() (logString string)
- func (repo *Repository) GetPullRequestBody() (body string)
- func (repo *Repository) GetRequestBodyForCommitOrTag() (requestBodyString string)
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func CheckAddonDescriptorForRepositories ¶
func CheckAddonDescriptorForRepositories(addonDescriptor AddonDescriptor) error
CheckAddonDescriptorForRepositories checks AddonDescriptor struct if it contains any repositories. If not it will return an error
func ConvertTime ¶
ConvertTime formats an ABAP timestamp string from format /Date(1585576807000+0000)/ into a UNIX timestamp and returns it
func GetHTTPResponse ¶
func GetHTTPResponse(requestType string, connectionDetails ConnectionDetailsHTTP, body []byte, client piperhttp.Sender) (*http.Response, error)
GetHTTPResponse wraps the SendRequest function of piperhttp
func HandleHTTPError ¶
func HandleHTTPError(resp *http.Response, err error, message string, connectionDetails ConnectionDetailsHTTP) error
HandleHTTPError handles ABAP error messages which can occur when using OData services
The point of this function is to enrich the error received from a HTTP Request (which is passed as a parameter to this function). Further error details may be present in the response body of the HTTP response. If the response body is parseable, the included details are wrapped around the original error from the HTTP repsponse. If this is not possible, the original error is returned.
func PollEntity ¶
func PollEntity(repositoryName string, connectionDetails ConnectionDetailsHTTP, client piperhttp.Sender, pollIntervall time.Duration) (string, error)
PollEntity periodically polls the pull/import entity to get the status. Check if the import is still running
func PrintLegacyLogs ¶
func PrintLegacyLogs(repositoryName string, connectionDetails ConnectionDetailsHTTP, client piperhttp.Sender, errorOnSystem bool)
PrintLegacyLogs sorts and formats the received transport and execution log of an import; Deprecated with SAP BTP, ABAP Environment release 2205
func PrintLogs ¶
func PrintLogs(repositoryName string, connectionDetails ConnectionDetailsHTTP, client piperhttp.Sender)
func ReadConfigFile ¶
ReadCOnfigFile reads a file from a specific path and returns the json string as []byte
Types ¶
type AUtilsMock ¶
type AUtilsMock struct { ReturnedConnectionDetailsHTTP ConnectionDetailsHTTP ReturnedError error }
AUtilsMock mock
func (*AUtilsMock) GetAbapCommunicationArrangementInfo ¶
func (autils *AUtilsMock) GetAbapCommunicationArrangementInfo(options AbapEnvironmentOptions, oDataURL string) (ConnectionDetailsHTTP, error)
GetAbapCommunicationArrangementInfo mock
func (*AUtilsMock) GetPollIntervall ¶
func (autils *AUtilsMock) GetPollIntervall() time.Duration
GetPollIntervall mock
type AbapBinding ¶
type AbapBinding struct { ID string `json:"id"` Type string `json:"type"` Version string `json:"version"` Env string `json:"env"` }
AbapBinding contains information about service binding in Cloud Foundry
type AbapConnection ¶
type AbapConnection struct { Username string `json:"username"` Password string `json:"password"` CommunicationScenarioID string `json:"communication_scenario_id"` CommunicationArrangementID string `json:"communication_arrangement_id"` CommunicationSystemID string `json:"communication_system_id"` CommunicationInboundUserID string `json:"communication_inbound_user_id"` CommunicationInboundUserAuthMode string `json:"communication_inbound_user_auth_mode"` }
AbapConnection contains information about the ABAP connection for the ABAP endpoint
type AbapEnvironmentCheckoutBranchOptions ¶
type AbapEnvironmentCheckoutBranchOptions struct { AbapEnvOptions AbapEnvironmentOptions RepositoryName string `json:"repositoryName,omitempty"` }
AbapEnvironmentCheckoutBranchOptions struct for the CheckoutBranch piper step
type AbapEnvironmentOptions ¶
type AbapEnvironmentOptions struct { Username string `json:"username,omitempty"` Password string `json:"password,omitempty"` Host string `json:"host,omitempty"` CfAPIEndpoint string `json:"cfApiEndpoint,omitempty"` CfOrg string `json:"cfOrg,omitempty"` CfSpace string `json:"cfSpace,omitempty"` CfServiceInstance string `json:"cfServiceInstance,omitempty"` CfServiceKeyName string `json:"cfServiceKeyName,omitempty"` }
AbapEnvironmentOptions contains cloud foundry fields and the host parameter for connections to ABAP Environment instances
type AbapEnvironmentPullGitRepoOptions ¶
type AbapEnvironmentPullGitRepoOptions struct { AbapEnvOptions AbapEnvironmentOptions RepositoryNames []string `json:"repositoryNames,omitempty"` }
AbapEnvironmentPullGitRepoOptions struct for the PullGitRepo piper step
type AbapEnvironmentRunATCCheckOptions ¶
type AbapEnvironmentRunATCCheckOptions struct { AbapEnvOptions AbapEnvironmentOptions AtcConfig string `json:"atcConfig,omitempty"` }
AbapEnvironmentRunATCCheckOptions struct for the RunATCCheck piper step
type AbapError ¶
type AbapError struct { Code string `json:"code"` Message AbapErrorMessage `json:"message"` }
AbapError contains the error code and the error message for ABAP errors
type AbapErrorMessage ¶
AbapErrorMessage contains the lanuage and value fields for ABAP errors
type AbapLogs ¶
type AbapLogs struct {
Results []LogResults `json:"results"`
}
AbapLogs struct for ABAP logs
type AbapLogsV2 ¶
type AbapLogsV2 struct {
Results []LogResultsV2 `json:"results"`
}
type AbapMetadata ¶
type AbapMetadata struct {
URI string `json:"uri"`
}
AbapMetadata contains the URI of metadata files
type AbapServiceKey ¶
type AbapServiceKey struct { SapCloudService string `json:"sap.cloud.service"` URL string `json:"url"` SystemID string `json:"systemid"` Abap AbapConnection `json:"abap"` Binding AbapBinding `json:"binding"` PreserveHostHeader bool `json:"preserve_host_header"` }
AbapServiceKey contains information about an ABAP service key
func ReadServiceKeyAbapEnvironment ¶
func ReadServiceKeyAbapEnvironment(options AbapEnvironmentOptions, c command.ExecRunner) (AbapServiceKey, error)
ReadServiceKeyAbapEnvironment from Cloud Foundry and returns it. Depending on user/developer requirements if he wants to perform further Cloud Foundry actions
type AbapUtils ¶
type AbapUtils struct { Exec command.ExecRunner Intervall time.Duration }
AbapUtils Struct
func (*AbapUtils) GetAbapCommunicationArrangementInfo ¶
func (abaputils *AbapUtils) GetAbapCommunicationArrangementInfo(options AbapEnvironmentOptions, oDataURL string) (ConnectionDetailsHTTP, error)
GetAbapCommunicationArrangementInfo function fetches the communcation arrangement information in SAP CP ABAP Environment
func (*AbapUtils) GetPollIntervall ¶
GetPollIntervall returns the specified intervall from AbapUtils or a default value of 10 seconds
type AddonDescriptor ¶
type AddonDescriptor struct { AddonProduct string `json:"addonProduct"` AddonVersionYAML string `json:"addonVersion"` AddonVersion string `json:"addonVersionAAK"` AddonSpsLevel string AddonPatchLevel string TargetVectorID string Repositories []Repository `json:"repositories"` }
AddonDescriptor contains fields about the addonProduct
func ConstructAddonDescriptorFromJSON ¶
func ConstructAddonDescriptorFromJSON(JSON []byte) (AddonDescriptor, error)
ConstructAddonDescriptorFromJSON : Create new AddonDescriptor filled with data from JSON
func ReadAddonDescriptor ¶
func ReadAddonDescriptor(FileName string) (AddonDescriptor, error)
ReadAddonDescriptor parses AddonDescriptor YAML file
func (*AddonDescriptor) AsJSONstring ¶
func (me *AddonDescriptor) AsJSONstring() string
AsJSONstring : dito
func (*AddonDescriptor) GetRepositoriesInBuildScope ¶
func (me *AddonDescriptor) GetRepositoriesInBuildScope() []Repository
func (*AddonDescriptor) InitFromJSONstring ¶
func (me *AddonDescriptor) InitFromJSONstring(JSONstring string) error
initFromJSON : Init from json string
func (*AddonDescriptor) SetRepositories ¶
func (me *AddonDescriptor) SetRepositories(Repositories []Repository)
SetRepositories : dito
type BranchEntity ¶
type BranchEntity struct { Metadata AbapMetadata `json:"__metadata"` ScName string `json:"sc_name"` Namespace string `json:"namepsace"` BranchName string `json:"branch_name"` ParentBranch string `json:"derived_from"` CreatedBy string `json:"created_by"` CreatedOn string `json:"created_on"` IsActive bool `json:"is_active"` CommitID string `json:"commit_id"` CommitMessage string `json:"commit_message"` LastCommitBy string `json:"last_commit_by"` LastCommitOn string `json:"last_commit_on"` }
BranchEntity struct for the Branch entity A4C_A2G_GHA_SC_BRANCH
type ClientMock ¶
ClientMock contains information about the client mock
func (*ClientMock) DownloadFile ¶
func (c *ClientMock) DownloadFile(url, filename string, header http.Header, cookies []*http.Cookie) error
DownloadFile : Empty file download
func (*ClientMock) SendRequest ¶
func (c *ClientMock) SendRequest(method, url string, bdy io.Reader, hdr http.Header, cookies []*http.Cookie) (*http.Response, error)
SendRequest sets a HTTP response for a client mock
func (*ClientMock) SetOptions ¶
func (c *ClientMock) SetOptions(opts piperhttp.ClientOptions)
SetOptions sets clientOptions for a client mock
type CloneEntity ¶
type CloneEntity struct { Metadata AbapMetadata `json:"__metadata"` UUID string `json:"uuid"` ScName string `json:"sc_name"` BranchName string `json:"branch_name"` ImportType string `json:"import_type"` Namespace string `json:"namepsace"` Status string `json:"status"` StatusDescription string `json:"status_descr"` StartedByUser string `json:"user_name"` StartTime string `json:"start_time"` ChangeTime string `json:"change_time"` }
CloneEntity struct for the Clone entity A4C_A2G_GHA_SC_CLONE
type Communication ¶
type Communication interface { GetAbapCommunicationArrangementInfo(options AbapEnvironmentOptions, oDataURL string) (ConnectionDetailsHTTP, error) GetPollIntervall() time.Duration }
Communication for defining function used for communication
type ConnectionDetailsHTTP ¶
type ConnectionDetailsHTTP struct { Host string User string `json:"user"` Password string `json:"password"` URL string `json:"url"` XCsrfToken string `json:"xcsrftoken"` }
ConnectionDetailsHTTP contains fields for HTTP connections including the XCSRF token
type EntitySetsForManageGitRepository ¶
type EntitySetsForManageGitRepository struct {
EntitySets []string `json:"EntitySets"`
}
type LogProtocol ¶
type LogProtocol struct { Metadata AbapMetadata `json:"__metadata"` OverviewIndex int `json:"log_index"` ProtocolLine int `json:"index_no"` Type string `json:"type"` Description string `json:"descr"` }
type LogProtocolResults ¶
type LogProtocolResults struct {
Results []LogProtocol `json:"results"`
}
type LogResults ¶
type LogResults struct { Index string `json:"index_no"` Type string `json:"type"` Description string `json:"descr"` Timestamp string `json:"timestamp"` }
LogResults struct for Execution and Transport Log entities A4C_A2G_GHA_SC_LOG_EXE and A4C_A2G_GHA_SC_LOG_TP
type LogResultsV2 ¶
type LogResultsV2 struct { Metadata AbapMetadata `json:"__metadata"` Index int `json:"log_index"` Name string `json:"log_name"` Status string `json:"type_of_found_issues"` Timestamp string `json:"timestamp"` ToLogProtocol LogProtocolResults `json:"to_Log_Protocol"` }
type PullEntity ¶
type PullEntity struct { Metadata AbapMetadata `json:"__metadata"` UUID string `json:"uuid"` Namespace string `json:"namepsace"` ScName string `json:"sc_name"` ImportType string `json:"import_type"` BranchName string `json:"branch_name"` StartedByUser string `json:"user_name"` Status string `json:"status"` StatusDescription string `json:"status_descr"` CommitID string `json:"commit_id"` StartTime string `json:"start_time"` ChangeTime string `json:"change_time"` ToExecutionLog AbapLogs `json:"to_Execution_log"` ToTransportLog AbapLogs `json:"to_Transport_log"` ToLogOverview AbapLogsV2 `json:"to_Log_Overview"` }
PullEntity struct for the Pull/Import entity A4C_A2G_GHA_SC_IMP
func GetPullStatus ¶
func GetPullStatus(repositoryName string, connectionDetails ConnectionDetailsHTTP, client piperhttp.Sender) (body PullEntity, status string, err error)
type ReadAddonDescriptorType ¶
type ReadAddonDescriptorType func(FileName string) (AddonDescriptor, error)
ReadAddonDescriptorType is the type for ReadAddonDescriptor for mocking
type RepositoriesConfig ¶
type RepositoriesConfig struct { BranchName string RepositoryName string RepositoryNames []string Repositories string }
RepositoriesConfig struct for parsing one or multiple branches and repositories configurations
type Repository ¶
type Repository struct { Name string `json:"name"` Tag string `json:"tag"` Branch string `json:"branch"` CommitID string `json:"commitID"` VersionYAML string `json:"version"` Version string `json:"versionAAK"` PackageName string PackageType string SpLevel string PatchLevel string PredecessorCommitID string Status string Namespace string SarXMLFilePath string Languages []string `json:"languages"` InBuildScope bool }
Repository contains fields for the repository/component version
func GetRepositories ¶
func GetRepositories(config *RepositoriesConfig) ([]Repository, error)
GetRepositories for parsing one or multiple branches and repositories from repositories file or branchName and repositoryName configuration
func (*Repository) GetAakAasLanguageVector ¶
func (me *Repository) GetAakAasLanguageVector() string
GetAakAasLanguageVector : dito
func (*Repository) GetCloneLogString ¶
func (repo *Repository) GetCloneLogString() (logString string)
func (*Repository) GetCloneRequestBody ¶
func (repo *Repository) GetCloneRequestBody() (body string)
func (*Repository) GetLogStringForCommitOrTag ¶
func (repo *Repository) GetLogStringForCommitOrTag() (logString string)
func (*Repository) GetPullLogString ¶
func (repo *Repository) GetPullLogString() (logString string)
func (*Repository) GetPullRequestBody ¶
func (repo *Repository) GetPullRequestBody() (body string)
func (*Repository) GetRequestBodyForCommitOrTag ¶
func (repo *Repository) GetRequestBodyForCommitOrTag() (requestBodyString string)