helper#

pathlib_mate.helper.ensure_str(value)[source]#

Ensure value is string.

pathlib_mate.helper.ensure_list(path_or_path_list)[source]#

Pre-process input argument, whether if it is:

  1. abspath

  2. Path instance

  3. string

  4. list or set of any of them

It returns list of path.

Return path_or_path_list:

always return list of path in string

中文文档

预处理输入参数。

pathlib_mate.helper.repr_data_size(size_in_bytes, precision=2)[source]#

Return human readable string represent of a file size. Doesn’t support size greater than 1YB.

For example: - 100 bytes => 100 B - 100,000 bytes => 97.66 KB - 100,000,000 bytes => 95.37 MB - 100,000,000,000 bytes => 93.13 GB - 100,000,000,000,000 bytes => 90.95 TB - 100,000,000,000,000,000 bytes => 88.82 PB - and more …

Magnitude of data:

1000         kB    kilobyte
1000 ** 2    MB    megabyte
1000 ** 3    GB    gigabyte
1000 ** 4    TB    terabyte
1000 ** 5    PB    petabyte
1000 ** 6    EB    exabyte
1000 ** 7    ZB    zettabyte
1000 ** 8    YB    yottabyte
Return type:

str

pathlib_mate.helper.parse_data_size(s)[source]#

Parse human readable string representing a file size. Doesn’t support size greater than 1YB.

Examples:

>>> parse_data_size("3.43 MB")
3596615
>>> parse_data_size("2_512.4 MB")
2634442342
>>> parse_data_size("2,512.4 MB")
2634442342
Return type:

int