Coverage for /pythoncovmergedfiles/medio/medio/usr/local/lib/python3.11/site-packages/ijson/compat.py: 69%

1''' 

2Python2/Python3 compatibility utilities. 

3''' 

4 

5import sys 

6import warnings 

7 

8 

9class utf8reader: 

10 """Takes a utf8-encoded string reader and reads bytes out of it""" 

11 

12 def __init__(self, str_reader): 

13 self.str_reader = str_reader 

14 

15 def read(self, n): 

16 return self.str_reader.read(n).encode('utf-8') 

17 

18_str_vs_bytes_warning = ''' 

19ijson works by reading bytes, but a string reader has been given instead. This 

20probably, but not necessarily, means a file-like object has been opened in text 

21mode ('t') rather than binary mode ('b'). 

22 

23An automatic conversion is being performed on the fly to continue, but on the 

24other hand this creates unnecessary encoding/decoding operations that decrease 

25the efficiency of the system. In the future this automatic conversion will be 

26removed, and users will receive errors instead of this warning. To avoid this 

27problem make sure file-like objects are opened in binary mode instead of text 

28mode. 

29''' 

30 

31def _warn_and_return(o): 

32 warnings.warn(_str_vs_bytes_warning, DeprecationWarning) 

33 return o 

34 

35def bytes_reader(f): 

36 """Returns a file-like object that reads bytes""" 

37 if type(f.read(0)) == bytes: 

38 return f 

39 return _warn_and_return(utf8reader(f))