files

Documentation

Overview

Package files allows to interact with files on a file system.

Index

• func CopyFile(source string, destination string) error
• func CopyFolderContents(source string, destination string) error
• func CopyFolderContentsWithFilter(source string, destination string, filter func(path string) bool) error
• func CopyFolderToTemp(folderPath string, tempFolderPrefix string, filter func(path string) bool) (string, error)
• func CopyTerraformFolderToTemp(folderPath string, tempFolderPrefix string) (string, error)
• func CopyTerragruntFolderToTemp(folderPath string, tempFolderPrefix string) (string, error)
• func FileExists(path string) bool
• func FileExistsE(path string) (bool, error)
• func FindTerraformSourceFilesInDir(dirPath string) ([]string, error)
• func IsExistingDir(path string) bool
• func IsExistingFile(path string) bool
• func PathContainsHiddenFileOrFolder(path string) bool
• func PathContainsTerraformState(path string) bool
• func PathContainsTerraformStateOrVars(path string) bool
• func PathIsTerraformVersionFile(path string) bool
• func WriteFileWithSamePermissions(source string, destination string, contents []byte) error
• type DirNotFoundError
  • func (err DirNotFoundError) Error() string

Functions

func CopyFile

func CopyFile(source string, destination string) error

CopyFile copies a file from source to destination.

func CopyFolderContents

func CopyFolderContents(source string, destination string) error

CopyFolderContents copies all the files and folders within the given source folder to the destination folder.

func CopyFolderContentsWithFilter

func CopyFolderContentsWithFilter(source string, destination string, filter func(path string) bool) error

CopyFolderContentsWithFilter copies the files and folders within the given source folder that pass the given filter (return true) to the destination folder.

func CopyFolderToTemp

func CopyFolderToTemp(folderPath string, tempFolderPrefix string, filter func(path string) bool) (string, error)

CopyFolderToTemp creates a copy of the given folder and all its filtered contents in a temp folder with a unique name and the given prefix.

func CopyTerraformFolderToTemp

func CopyTerraformFolderToTemp(folderPath string, tempFolderPrefix string) (string, error)

CopyTerraformFolderToTemp creates a copy of the given folder and all its contents in a temp folder with a unique name and the given prefix. This is useful when running multiple tests in parallel against the same set of Terraform files to ensure the tests don't overwrite each other's .terraform working directory and terraform.tfstate files. This method returns the path to the temp folder with the copied contents. Hidden files and folders (with the exception of the `.terraform-version` files used by the [tfenv tool](https://github.com/tfutils/tfenv)), Terraform state files, and terraform.tfvars files are not copied to this temp folder, as you typically don't want them interfering with your tests.

func CopyTerragruntFolderToTemp

func CopyTerragruntFolderToTemp(folderPath string, tempFolderPrefix string) (string, error)

CopyTerragruntFolderToTemp creates a copy of the given folder and all its contents in a temp folder with a unique name and the given prefix. Since terragrunt uses tfvars files to specify modules, they are copied to the temporary directory as well. Terraform state files are excluded as well as .terragrunt-cache to avoid overwriting contents.

func FileExists

func FileExists(path string) bool

FileExists returns true if the given file exists.

func FileExistsE

func FileExistsE(path string) (bool, error)

FileExistsE returns true if the given file exists It will return an error if os.Stat error is not an ErrNotExist

func FindTerraformSourceFilesInDir

func FindTerraformSourceFilesInDir(dirPath string) ([]string, error)

FindTerraformSourceFilesInDir given a directory path, finds all the terraform source files contained in it. This will recursively search subdirectories, but will ignore any hidden files (which in turn ignores terraform data dirs like .terraform folder).

func IsExistingDir

func IsExistingDir(path string) bool

IsExistingDir returns true if the path exists and is a directory

func IsExistingFile

func IsExistingFile(path string) bool

IsExistingFile returns true if the path exists and is a file.

func PathContainsHiddenFileOrFolder

func PathContainsHiddenFileOrFolder(path string) bool

PathContainsHiddenFileOrFolder returns true if the given path contains a hidden file or folder.

func PathContainsTerraformState

func PathContainsTerraformState(path string) bool

PathContainsTerraformState returns true if the path corresponds to a Terraform state file.

func PathContainsTerraformStateOrVars

func PathContainsTerraformStateOrVars(path string) bool

PathContainsTerraformStateOrVars returns true if the path corresponds to a Terraform state file or .tfvars/.tfvars.json file.

func PathIsTerraformVersionFile

func PathIsTerraformVersionFile(path string) bool

PathIsTerraformVersionFile returns true if the given path is the special '.terraform-version' file used by the [tfenv](https://github.com/tfutils/tfenv) tool.

func WriteFileWithSamePermissions

func WriteFileWithSamePermissions(source string, destination string, contents []byte) error

WriteFileWithSamePermissions writes a file to the given destination with the given contents using the same permissions as the file at source.

Types

type DirNotFoundError

type DirNotFoundError struct {
	Directory string
}

DirNotFoundError is an error that occurs if a directory doesn't exist

func (DirNotFoundError) Error

func (err DirNotFoundError) Error() string