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
-