Add some type annotations, most notably to smbclient.open_file

[mon]

I won't lie, overloads are super verbose. But I worked off the ones for the stdlib open(), so it's "known good" at least.
I tested this by looking through all the test_smbclient_os opens and making sure the correct type was inferred.

I also added some extras so you can get typed connection details from an fd. It still kinda sucks (because something like the buffer sizes are None until connect is called) but at least it has intellisense.

Unfortunate API break: I couldn't work out a way to set the file/dir/pipe arg to specific values without forcing kwargs with * or moving the arg. I chose the latter, interested to hear your thoughts.

[codecov]

Codecov Report

Attention: Patch coverage is 95.83333% with 1 line in your changes missing coverage. Please review.

Project coverage is 99.06%. Comparing base (42804ca) to head (68e761f).
Report is 2 commits behind head on master.

Files with missing lines	Patch %	Lines
src/smbclient/_os.py	95.23%	1 Missing ⚠️

Additional details and impacted files

@@           Coverage Diff           @@
##           master     #295   +/-   ##
=======================================
  Coverage   99.06%   99.06%           
=======================================
  Files          24       24           
  Lines        5117     5146   +29     
=======================================
+ Hits         5069     5098   +29     
  Misses         48       48           

Flag	Coverage Δ
macOS	68.28% <87.50%> (+0.10%)	⬆️
py3.10	99.02% <95.83%> (+<0.01%)	⬆️
py3.11	99.02% <95.83%> (+<0.01%)	⬆️
py3.12	99.02% <95.83%> (+<0.01%)	⬆️
py3.8	99.02% <95.83%> (+<0.01%)	⬆️
py3.9	99.06% <95.83%> (+<0.01%)	⬆️
ubuntu	96.85% <95.83%> (+0.01%)	⬆️
windows	98.98% <95.83%> (+<0.01%)	⬆️
x64	99.06% <95.83%> (+<0.01%)	⬆️
x86	98.98% <95.83%> (+<0.01%)	⬆️

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

[mon]

Hold up on a merge just for a moment, I'm getting a runtime error on py3.10 that the tests haven't caught, making sure I didn't break anything

[mon]

Alright, good to go once the tests finish running. Sorry for the churn!

[jborean93]

Thanks for working on this

[mon]

Thanks for the fast reviews, and having the most pleasant SMB library in the ecosystem :D