(self, cid: base.cid_t, offset: int = 0,
	        length: ty.Optional[int] = None, **kwargs: base.CommonArgs)
return self._client.request('/cat', args, **kwargs)
r"""Retrieves the contents of a file identified by hash
		
		.. code-block:: python
		
			>>> client.cat('QmTkzDwWqPbnAh5YiV5VwcTLnGdwSNsNTn2aDxdXBFca7D')
			Traceback (most recent call last):
			  ...
			ipfsapi.exceptions.Error: this dag node is a directory
			>>> client.cat('QmeKozNssnkJ4NcyRidYgDY2jfRZqVEoRGfipkgath71bX')
			b'<!DOCTYPE html>\n<html>\n\n<head>\n<title>ipfs example viewer</…'
		
		Parameters
		----------
		cid
			The name or path of the IPFS object(s) to be retrieved
		offset
			Byte offset to begin reading from
		length
			Maximum number of bytes to read (defaults to reading the entire file)
		
		Returns
		-------
			bytes
				The file's contents
r"""Retrieves the contents of a file identified by hash
		
		.. code-block:: python
		
			>>> client.cat('QmTkzDwWqPbnAh5YiV5VwcTLnGdwSNsNTn2aDxdXBFca7D')
			Traceback (most recent call last):
			  ...
			ipfsapi.exceptions.Error: this dag node is a directory
			>>> client.cat('QmeKozNssnkJ4NcyRidYgDY2jfRZqVEoRGfipkgath71bX')
			b'<!DOCTYPE html>\n<html>\n\n<head>\n<title>ipfs example viewer</…'
		
		Parameters
		----------
		cid
			The name or path of the IPFS object(s) to be retrieved
		offset
			Byte offset to begin reading from
		length
			Maximum number of bytes to read (defaults to reading the entire file)
		
		Returns
		-------
			bytes
				The file's contents
r Retrieves the contents of a file identified by hash .. code - block :: python >>> client . cat ( QmTkzDwWqPbnAh5YiV5VwcTLnGdwSNsNTn2aDxdXBFca7D ) Traceback ( most recent call last ) : ... ipfsapi . exceptions . Error : this dag node is a directory >>> client . cat ( QmeKozNssnkJ4NcyRidYgDY2jfRZqVEoRGfipkgath71bX ) b <!DOCTYPE html > \ n<html > \ n \ n<head > \ n<title > ipfs example viewer< / … Parameters ---------- cid The name or path of the IPFS object ( s ) to be retrieved offset Byte offset to begin reading from length Maximum number of bytes to read ( defaults to reading the entire file ) Returns ------- bytes The file s contents
def cat(self, cid: base.cid_t, offset: int = 0,
	        length: ty.Optional[int] = None, **kwargs: base.CommonArgs):
		r"""Retrieves the contents of a file identified by hash
		
		.. code-block:: python
		
			>>> client.cat('QmTkzDwWqPbnAh5YiV5VwcTLnGdwSNsNTn2aDxdXBFca7D')
			Traceback (most recent call last):
			  ...
			ipfsapi.exceptions.Error: this dag node is a directory
			>>> client.cat('QmeKozNssnkJ4NcyRidYgDY2jfRZqVEoRGfipkgath71bX')
			b'<!DOCTYPE html>\n<html>\n\n<head>\n<title>ipfs example viewer</…'
		
		Parameters
		----------
		cid
			The name or path of the IPFS object(s) to be retrieved
		offset
			Byte offset to begin reading from
		length
			Maximum number of bytes to read (defaults to reading the entire file)
		
		Returns
		-------
			bytes
				The file's contents
		"""
		args = (str(cid),)
		opts = {}
		if offset != 0:
			opts['offset'] = offset
		if length is not None:
			opts['length'] = length
		kwargs.setdefault('opts', opts)
		return self._client.request('/cat', args, **kwargs)
def cat ( self , cid : base . cid_t , offset : int = 0 , length : ty . Optional [ int ] = None , * * kwargs : base . CommonArgs ) : args = ( str ( cid ) , ) opts = { } if offset != 0 : opts [ 'offset' ] = offset if length is not None : opts [ 'length' ] = length kwargs . setdefault ( 'opts' , opts ) return self . _client . request ( '/cat' , args , * * kwargs )