HTTPBackend

class mmengine.fileio.HTTPBackend

HTTP and HTTPS storage bachend.

get(filepath)

Read bytes from a given filepath.

参数:

filepath (str) – Path to read data.

返回:

Expected bytes object.

返回类型:

bytes

示例

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

get_local_path(filepath)

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.

参数:

filepath (str) – Download a file from filepath.

生成器:

Iterable[str] – Only yield one temporary path.

返回类型:

Generator[str | Path, None, None]

示例

>>> 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')

Read text from a given filepath.

参数:

• filepath (str) – Path to read data.

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

返回:

Expected text reading from filepath.

返回类型:

str

示例

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