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
-