Filesystem

Filesystem represents abstract API definition. It is now implemented by conu.DockerContainerViaExportFS

class conu.apidefs.filesystem.Filesystem(object_instance, mount_point=None)

Utility methods used to access filesystem of containers and images.

Implementations should probably be done using context managers.

__init__(object_instance, mount_point=None)

Parameters:

• object_instance – instance of the container or image
• mount_point – str, directory where the filesystem will be mounted

copy_from(src, dest)

copy a file or a directory from container or image to host system. If you are copying directories, the target directory must not exist (this function is using shutil.copytree to copy directories and that’s a requirement of the function). In case the directory exists, OSError on python 2 or FileExistsError on python 3 are raised.

Parameters:

• src – str, path to a file or a directory within container or image
• dest – str, path to a file or a directory on host system

Returns:

None

copy_to(src, dest)

copy a file or a directory from host system to a container – don’t implement for images, those are immutable

Parameters:

• src – str, path to a file or a directory on host system
• dest – str, path to a file or a directory within container

Returns:

None

directory_is_present(directory_path)

check if directory ‘directory_path’ is present, raise IOError if it’s not a directory

Parameters:directory_path – str, directory to check Returns:True if directory exists, False if directory does not exist

file_is_present(file_path)

check if file ‘file_path’ is present, raises IOError if file_path is not a file

Parameters:file_path – str, path to the file Returns:True if file exists, False if file does not exist

get_file(file_path, mode='r')

provide File object specified via ‘file_path’

Parameters:

• file_path – str, path to the file
• mode – str, mode used when opening the file

Returns:

File instance

get_selinux_context(file_path)

Get SELinux file context of the selected file.

Parameters:file_path – str, path to the file Returns:str, name of the SELinux file context

p(path)

provide absolute path within the container

Parameters:path – path with container Returns:str

read_file(file_path)

read file specified via ‘file_path’ and return its content - raises an ConuException if there is an issue accessing the file

Parameters:file_path – str, path to the file to read Returns:str (not bytes), content of the file