Documentation
¶
Index ¶
- Constants
- func Archive(sourcePath, targetArchivePath string, ignore []string) (e error)
- func CloseFile(file io.Closer, err error) error
- func CopyByPatterns(source, target string, patterns []string) error
- func CopyDir(src string, dst string, withParents bool, ...) error
- func CopyEntries(entries []os.FileInfo, src, dst string) error
- func CopyEntriesInParallel(entries []os.FileInfo, src, dst string) (rerr error)
- func CopyFile(src, dst string) (rerr error)
- func CopyFileWithMode(src, dst string, mode os.FileMode) (rerr error)
- func CreateDirIfNotExist(dir string) error
- func CreateFile(path string) (file *os.File, err error)
- func Read(ep IMtaYaml) ([]byte, error)
- func ReadExt(ep IMtaExtYaml, extFileName string) ([]byte, error)
- func ValidateDeploymentDescriptor(descriptor string) error
- type IDescriptor
- type IModule
- type IMtaExtYaml
- type IMtaParser
- type IMtaYaml
- type ISourceModule
- type ITargetArtifacts
- type ITargetModule
- type ITargetPath
- type Loc
- func (ep *Loc) GetDescriptor() string
- func (ep *Loc) GetExtensionFilePaths() []string
- func (ep *Loc) GetManifestPath() string
- func (ep *Loc) GetMetaPath() string
- func (ep *Loc) GetMtaExtYamlPath(extFileName string) string
- func (ep *Loc) GetMtaYamlFilename() string
- func (ep *Loc) GetMtaYamlPath() string
- func (ep *Loc) GetMtadPath() string
- func (ep *Loc) GetMtarDir(targetProvided bool) string
- func (ep *Loc) GetSource() string
- func (ep *Loc) GetSourceModuleDir(modulePath string) string
- func (ep *Loc) GetTarget() string
- func (ep *Loc) GetTargetModuleDir(moduleName string) string
- func (ep *Loc) GetTargetModuleZipPath(moduleName string) string
- func (ep *Loc) GetTargetTmpDir() string
- func (ep *Loc) IsDeploymentDescriptor() bool
- func (ep *Loc) ParseExtFile(extFileName string) (*mta.EXT, error)
- func (ep *Loc) ParseFile() (*mta.MTA, error)
- func (ep *Loc) ParseMtaFile() (*mta.MTA, error)
Constants ¶
const ( // FolderCreationFailedMsg - message raised when folder creation fails because of the existence file with identical name FolderCreationFailedMsg = `could not create the "%s" folder because a file exists with the same name` // InitLocFailedOnWorkDirMsg - message raised on getting working directory when initializing location InitLocFailedOnWorkDirMsg = `could not get working directory` // InvalidDescMsg - invalid descriptor InvalidDescMsg = `the "%s" descriptor is invalid; expected one of the following values: Dev, Dep` // ReadFailedMsg - read failed message ReadFailedMsg = `could not read the "%s" file` // ParseMtaYamlFileFailedMsg - parse of mta yaml file failed ParseMtaYamlFileFailedMsg = `the "%s" file is not a valid MTA descriptor` )
const ( //Dep - deployment descriptor Dep = "dep" //Dev - development descriptor Dev = "dev" // TempFolderSuffix - temporary folder suffix TempFolderSuffix = "_mta_build_tmp" // Mtad - deployment descriptor file name Mtad = "mtad.yaml" // MtarFolder - default archives folder MtarFolder = "mta_archives" )
Variables ¶
This section is empty.
Functions ¶
func Archive ¶
Archive module and mtar artifacts, compatible with the JAR specification to support the spec requirements Source Path to be zipped Target artifact
func CloseFile ¶
CloseFile - closes file error handling takes into account error of the calling function
func CopyByPatterns ¶
CopyByPatterns - copy files/directories according to patterns from source folder to target folder patterns are relative to source folder
func CopyDir ¶
func CopyDir(src string, dst string, withParents bool, copyDirEntries func(entries []os.FileInfo, src, dst string) error) error
CopyDir - copy directory content
func CopyEntries ¶
CopyEntries - copies entries (files and directories) from source to destination folder
func CopyEntriesInParallel ¶
CopyEntriesInParallel - copies entries (files and directories) from source to destination folder in parallel
func CopyFileWithMode ¶
CopyFileWithMode - copy file content using file mode parameter
func CreateDirIfNotExist ¶
CreateDirIfNotExist - Create new dir
func CreateFile ¶
CreateFile - create new file
func ReadExt ¶
func ReadExt(ep IMtaExtYaml, extFileName string) ([]byte, error)
ReadExt returns mta extension byte slice.
func ValidateDeploymentDescriptor ¶
ValidateDeploymentDescriptor validates the deployment descriptor.
Types ¶
type IDescriptor ¶
IDescriptor - descriptor interface
type IMtaExtYaml ¶
IMtaExtYaml - MTA Extension Yaml interface
type IMtaParser ¶
type IMtaParser interface {
ParseFile() (*mta.MTA, error)
ParseExtFile(platform string) (*mta.EXT, error)
}
IMtaParser - MTA Parser interface
type ISourceModule ¶
ISourceModule - source module interface
type ITargetArtifacts ¶
type ITargetArtifacts interface {
GetMetaPath() string
GetMtadPath() string
GetManifestPath() string
GetMtarDir(targetProvided bool) string
}
ITargetArtifacts - target artifacts interface
type ITargetModule ¶
type ITargetModule interface {
GetTargetModuleDir(moduleName string) string
GetTargetModuleZipPath(moduleName string) string
}
ITargetModule - Target Module interface
type ITargetPath ¶
ITargetPath - target path interface
type Loc ¶
type Loc struct {
// SourcePath - Path to MTA project
SourcePath string
// TargetPath - Path to results
TargetPath string
// MtaFilename - MTA yaml filename "mta.yaml" by default
MtaFilename string
// Descriptor - indicator of deployment descriptor usage (mtad.yaml)
Descriptor string
// ExtensionFileNames - list of MTA extension descriptors (could be empty)
ExtensionFileNames []string
}
Loc - MTA tool file properties
func Location ¶
func Location(source, target, descriptor string, extensions []string, wdGetter func() (string, error)) (*Loc, error)
Location - provides Location parameters of MTA
func (*Loc) GetDescriptor ¶
GetDescriptor - gets descriptor type of Location
func (*Loc) GetExtensionFilePaths ¶ added in v0.3.0
GetExtensionFilePaths returns the MTA extension descriptor full paths
func (*Loc) GetManifestPath ¶
GetManifestPath gets the path to the generated manifest file.
func (*Loc) GetMetaPath ¶
GetMetaPath gets the path to the generated META-INF directory.
func (*Loc) GetMtaExtYamlPath ¶
GetMtaExtYamlPath gets the full MTA extension file path by file name or path. If the file name is an absolute path it's returned as is. Otherwise the returned path is relative to the source folder.
func (*Loc) GetMtaYamlFilename ¶
GetMtaYamlFilename - Gets the MTA .yaml file name.
func (*Loc) GetMtaYamlPath ¶
GetMtaYamlPath gets the MTA .yaml file path.
func (*Loc) GetMtadPath ¶
GetMtadPath gets the path to the generated MTAD file.
func (*Loc) GetMtarDir ¶
GetMtarDir - gets archive folder if the target folder provided archive will be saved in the target folder otherwise archives folder - "mta_archives" subfolder in the project folder
func (*Loc) GetSource ¶
GetSource gets the processed project path; if it is not provided, use the current directory.
func (*Loc) GetSourceModuleDir ¶
GetSourceModuleDir gets the path to the module to be packed. The subdirectory is in the source.
func (*Loc) GetTarget ¶
GetTarget gets the target path; if it is not provided, use the path of the processed project.
func (*Loc) GetTargetModuleDir ¶
GetTargetModuleDir gets the path to the packed module directory. The subdirectory in the temporary target directory is named by the module name.
func (*Loc) GetTargetModuleZipPath ¶
GetTargetModuleZipPath gets the path to the packed module data.zip file. The subdirectory in temporary target directory is named by the module name.
func (*Loc) GetTargetTmpDir ¶
GetTargetTmpDir gets the temporary target directory path. The subdirectory in the target folder is named as the source project folder suffixed with "_mta_build_tmp". Subdirectory name is prefixed with "." as a hidden folder
func (*Loc) IsDeploymentDescriptor ¶
IsDeploymentDescriptor checks whether the flag is related to the deployment descriptor.
func (*Loc) ParseExtFile ¶
ParseExtFile returns a reference to the MTA extension descriptor object of the extension file.