coretex.entities.sample.sample.Sample Class Reference

Inheritance diagram for coretex.entities.sample.sample.Sample:

Public Member Functions
None	download (self, bool decrypt=True, bool ignoreCache=False)
None	unzip (self, bool ignoreCache=False)
Path	joinPath (self, Union[Path, str] other)

Detailed Description

    Represents the generic class Sample
    Includes methods that can be used by any instance of Sample
    and abstract methods that must be implemented by any subclass

Definition at line 29 of file sample.py.

Member Function Documentation

download()

None coretex.entities.sample.sample.Sample.download	(		self,
		bool	decrypt = True,
		bool	ignoreCache = False
	)

    Downloads the Sample if it is an instance or a subclass of NetworkSample
    Ignored for instances and subclasses of LocalSample

Reimplemented in coretex.entities.sample.network_sample.NetworkSample, and coretex.entities.sample.local_sample.LocalSample.

Definition at line 50 of file sample.py.

    def download(self, decrypt: bool = True, ignoreCache: bool = False) -> None:
        """
            Downloads the Sample if it is an instance or a subclass of NetworkSample
            Ignored for instances and subclasses of LocalSample
        """
 
        pass
 

joinPath()

Path coretex.entities.sample.sample.Sample.joinPath	(		self,
		Union[Path, str]	other
	)

    Joins sample path and provided path

    Parameters
    ----------
    other : Union[Path, str]
        path for join

    Returns
    -------
    Path -> path created from sample path and provided path

    Example
    -------
    >>> print(sampleObj.joinPath("dummy.zip"))
    Path("path/to/sample/dummy.zip")

Definition at line 98 of file sample.py.

    def joinPath(self, other: Union[Path, str]) -> Path:
        """
            Joins sample path and provided path
 
            Parameters
            ----------
            other : Union[Path, str]
                path for join
 
            Returns
            -------
            Path -> path created from sample path and provided path
 
            Example
            -------
            >>> print(sampleObj.joinPath("dummy.zip"))
            Path("path/to/sample/dummy.zip")
        """
 
        if isinstance(other, str):
            other = Path(other)
 
        return self.path / other
 

unzip()

None coretex.entities.sample.sample.Sample.unzip	(		self,
		bool	ignoreCache = False
	)

    Unzip sample zip file

    Parameters
    ----------
    ignoreCache : bool
        if set to false performs unzip action even if
        sample is previously unzipped

Reimplemented in coretex.entities.sample.sequence_sample.local_sequence_sample.LocalSequenceSample, and coretex.entities.sample.network_sample.NetworkSample.

Definition at line 65 of file sample.py.

    def unzip(self, ignoreCache: bool = False) -> None:
        """
            Unzip sample zip file
 
            Parameters
            ----------
            ignoreCache : bool
                if set to false performs unzip action even if
                sample is previously unzipped
        """
 
        if not self.zipPath.exists():
            raise FileNotFoundError(f"Sample \"{self.name}\" archive does not exist at path \"{self.zipPath}\"")
 
        if self.path.exists() and not ignoreCache:
            return
 
        try:
            self.__unzipSample()
        except BadZipFile:
            # Delete invalid zip file
            self.zipPath.unlink()
 
            # Re-download
            self.download()
 
            # Try to unzip - if it fails again it should crash
            self.__unzipSample()
 

---

The documentation for this class was generated from the following file:

• coretex/entities/sample/sample.py