# Copyright 2008-2018 pydicom authors. See LICENSE file for details. """Miscellaneous helper functions""" from itertools import groupby from pathlib import Path from typing import Optional, Union _size_factors = { "kb": 1000, "mb": 1000 * 1000, "gb": 1000 * 1000 * 1000, "kib": 1024, "mib": 1024 * 1024, "gib": 1024 * 1024 * 1024, } def size_in_bytes( expr: Optional[Union[int, float, str]] ) -> Union[None, float, int]: """Return the number of bytes for `defer_size` argument in :func:`~pydicom.filereader.dcmread`. """ if expr is None or expr == float('inf'): return None if isinstance(expr, (int, float)): return expr try: return int(expr) except ValueError: pass value, unit = ("".join(g) for k, g in groupby(expr, str.isalpha)) if unit.lower() in _size_factors: return float(value) * _size_factors[unit.lower()] raise ValueError(f"Unable to parse length with unit '{unit}'") def is_dicom(file_path: Union[str, Path]) -> bool: """Return ``True`` if the file at `file_path` is a DICOM file. This function is a pared down version of :func:`~pydicom.filereader.read_preamble` meant for a fast return. The file is read for a conformant preamble ('DICM'), returning ``True`` if so, and ``False`` otherwise. This is a conservative approach. Parameters ---------- file_path : str The path to the file. See Also -------- filereader.read_preamble filereader.read_partial """ with open(file_path, 'rb') as fp: fp.read(128) # preamble return fp.read(4) == b"DICM"