Coverage for /pythoncovmergedfiles/medio/medio/usr/local/lib/python3.11/site-packages/chardet/_utils.py: 72%

1"""Internal shared utilities for chardet.""" 

2 

3from __future__ import annotations 

4 

5import warnings 

6 

7#: Default maximum number of bytes to examine during detection. 

8DEFAULT_MAX_BYTES: int = 200_000 

9 

10#: Default minimum confidence threshold for filtering results. 

11MINIMUM_THRESHOLD: float = 0.20 

12 

13#: Default chunk_size value (deprecated, kept for backward-compat signatures). 

14_DEFAULT_CHUNK_SIZE: int = 65_536 

15 

16 

17def _warn_deprecated_chunk_size(chunk_size: int, stacklevel: int = 3) -> None: 

18 """Emit a deprecation warning if *chunk_size* differs from the default.""" 

19 if chunk_size != _DEFAULT_CHUNK_SIZE: 

20 warnings.warn( 

21 "chunk_size is not used in this version of chardet and will be ignored", 

22 DeprecationWarning, 

23 stacklevel=stacklevel, 

24 ) 

25 

26 

27def _validate_max_bytes(max_bytes: int) -> None: 

28 """Raise ValueError if *max_bytes* is not a positive integer.""" 

29 if isinstance(max_bytes, bool) or not isinstance(max_bytes, int) or max_bytes < 1: 

30 msg = "max_bytes must be a positive integer" 

31 raise ValueError(msg) 

32 

33 

34def _resolve_prefer_superset( 

35 should_rename_legacy: bool, prefer_superset: bool, stacklevel: int = 3 

36) -> bool: 

37 """Resolve the deprecated *should_rename_legacy* into *prefer_superset*.""" 

38 if should_rename_legacy: 

39 warnings.warn( 

40 "should_rename_legacy is deprecated, use prefer_superset instead", 

41 DeprecationWarning, 

42 stacklevel=stacklevel, 

43 ) 

44 return True 

45 return prefer_superset