Add binaryornot stubs

[Tatsh]

https://github.com/binaryornot/binaryornot

Upstream has been inactive for 2 months and has a PR open to add a minimal type stubs (in the code would be better), but it is incomplete.

helpers.is_binary_string does not accept str (as the name may suggest) because it calls on chardet.detect() which only accepts bytes | bytearray.

[github-actions]

According to mypy_primer, this change has no effect on the checked open source code. 🤖🎉

[srittau]

Thanks! Remarks below.

[srittau]

When we're including __email__ we should also include __author__ and __version__. Also, these should be final:

Suggested change

	__email__: str = ...
	from typing import Final
	__author__: Final[str]
	__email__: Final[str]
	__version__: Final[str]

[srittau]

We actually have a helper for the argument type:

Suggested change

	import os
	from typing import Any
	def is_binary(filename: os.PathLike[Any] | bytes | str) -> bool: ...
	import os
	from _typeshed import StrOrBytesPath
	def is_binary(filename: StrOrBytesPath) -> bool: ...

[srittau]

Here as well:

Suggested change

	import os
	from typing import Any
	def print_as_hex(s: str) -> None: ...
	def get_starting_chunk(filename: os.PathLike[Any] | bytes | str, length: int = 1024) -> bytes: ...
	def is_binary_string(bytes_to_check: bytes | bytearray) -> bool: ...
	import os
	from _typeshed import StrOrBytesPath
	def print_as_hex(s: str) -> None: ...
	def get_starting_chunk(filename: StrOrBytesPath, length: int = 1024) -> bytes: ...
	def is_binary_string(bytes_to_check: bytes | bytearray) -> bool: ...