Deprecate several utility functions

[kurtmckee]

This PR introduces the following changes:

• Deprecate two utility functions and their aliases
• Add type annotations to utility functions
• Update utility function doc strings
• Use newer Python constructs to simplify remaining code

[coveralls]

coverage: 43.87% (-16.2%) from 60.085%
when pulling d71d968 on kurtmckee:utility-functions
into de690e7 on LudovicRousseau:master.

[LudovicRousseau]

You should also update the documentation to replace calls to deprecated functions

https://github.com/LudovicRousseau/pyscard/blob/master/src/smartcard/doc/user-guide.rst#binary-strings-and-list-of-bytes

[kurtmckee]

Shoot, I had been filtering my search to .py files. Yep, I'll get that updated. Thanks!

[kurtmckee]

Hmm, that section is part of a discussion about cryptography, but specifically pycrypto, which hasn't had a release in 11 years.

I'll make a quick update to that section, but this has informed me that there's some additional work to do with that section on cryptography. 👍

[LudovicRousseau]

You can update the documentation in a different commit.
It will be easier to review.

[kurtmckee]

I included an update for SHA-1 and MD5 hashing that makes the docs for that section usable.

[LudovicRousseau]

Thanks