Make pandas.ExcelFile(...) in stubs consistent with the run time version.

[cainmagi]

• Closes The signature of pandas.ExcelFile(...) in stubs is not consistent with the run-time signature. #1116
• Tests added: Please use assert_type() to assert the type of any return value
• I have run the pytest in my local environment.

Introduction

The changes make the signature of

pandas-stubs/pandas-stubs/io/excel/_base.pyi

Lines 246 to 251 in 4976e11

	def __init__(
	self,
	io: FilePath | ReadBuffer[bytes] | bytes,
	engine: ExcelReadEngine | None = ...,
	storage_options: StorageOptions = ...,
	) -> None: ...

consistent with the run time version:

https://github.com/pandas-dev/pandas/blob/0691c5cf90477d3503834d983f69350f250a6ff7/pandas/io/excel/_base.py#L1507-L1513

Fixes

• The first argument name should be path_or_buffer, not io. (The property ExcelFile(...).io is correct. No need to change this.)
• The keyword engine_kwargs is added.
• The keyword storage_options should allow a None value. Sorry, I found that None case has been included here. No need to make changes for this.

[Dr-Irv]

thanks @cainmagi