HTTPBackend¶

class mmengine.fileio.HTTPBackend[source]¶

HTTP and HTTPS storage bachend.

get(filepath)[source]¶

Read bytes from a given filepath.

Parameters: filepath (str) – Path to read data.
Returns: Expected bytes object.
Return type: bytes

Examples

>>> backend = HTTPBackend()
>>> backend.get('http://path/of/file')
b'hello world'

get_local_path(filepath)[source]¶

Download a file from filepath to a local temporary directory, and return the temporary path.

get_local_path is decorated by contxtlib.contextmanager(). It can be called with with statement, and when exists from the with statement, the temporary path will be released.

Parameters: filepath (str) – Download a file from filepath.
Yields: Iterable[str] – Only yield one temporary path.
Return type: Generator[Union[str, pathlib.Path], None, None]

Examples

>>> backend = HTTPBackend()
>>> # After existing from the ``with`` clause,
>>> # the path will be removed
>>> with backend.get_local_path('http://path/of/file') as path:
...     # do something here

get_text(filepath, encoding='utf-8')[source]¶

Read text from a given filepath.

Parameters

filepath (str) – Path to read data.
encoding (str) – The encoding format used to open the filepath. Defaults to ‘utf-8’.

Returns

Expected text reading from filepath.

Return type

str

Examples

>>> backend = HTTPBackend()
>>> backend.get_text('http://path/of/file')
'hello world'