HTTPBackend¶
- class mmeval.fileio.HTTPBackend[source]¶
HTTP and HTTPS storage bachend.
- get(filepath: str) → bytes[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: str) → Generator[Union[str, pathlib.Path], None, None][source]¶
Download a file from
filepath
to a local temporary directory, and return the temporary path.get_local_path
is decorated bycontxtlib.contextmanager()
. It can be called withwith
statement, and when exists from thewith
statement, the temporary path will be released.- Parameters
filepath (str) – Download a file from
filepath
.- Yields
Iterable[str] – Only yield one temporary path.
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') → str[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'