Make sure type checks pass with mypy as well

[plamut]

googleapis/python-pubsub#500 added type annotation to the codebase, but we only checked that static type analysis passes under pytype. A lot of people, on the other hand, use mypy, but mypy currently reports 97 errors.

If we want users to leverage our type annotations, we should make sure that the checks pass with mypy as well, and then we can also add py.typed file to declare the library type-checked.

An additional requirement of this issue is that a new nox session named mypy needs to be added and enabled by default.

Acceptance criteria:

• A new nox session named mypy is added, and it runs on every PR.
  process: make sure type annoations pass with mypy python-pubsub#542
• The hand-written layer passes type checks.
  process: make sure type annoations pass with mypy python-pubsub#542
• The autogenerated part of the library is included in mypy checks and produces no errors.
  BLOCKED by Generated code for Pub/Sub does not pass type checks with mypy gapic-generator-python#1092
• Code samples are checked with mypy and the check runs on every PR (process: add mypy session for samples python-pubsub#551).
  • Refactor the manual client to inherit from the generated class instead of dynamically injecting the latter's methods. Mypy otherwise cannot know about the dynamically added methods.
• The library declares itself as type-checked by adding a marker py.typed file (requires all above items to be completed first)

[parthea]

I reviewed the mypy failures for the generated code and found that the warnings are specific to the customized portion of the generated code.

For example, for google/pubsub_v1/types/__init__.py:82 error: Name "google" is not defined, the specific replacement in owlbot.py is here:
https://github.com/googleapis/python-pubsub/blob/8513f539a5dfad8ea22126706f3a4e9580df25dc/owlbot.py#L273-L288

For another error google/pubsub_v1/services/subscriber/client.py:492: error: Incompatible types in assignment (expression has type "partial[SubscriberTransport]", variable has type "Type[SubscriberTransport]"), the specific replacement in owlbot.py is here: https://github.com/googleapis/python-pubsub/blob/8513f539a5dfad8ea22126706f3a4e9580df25dc/owlbot.py#L108-L122

[kasium]

I'm not sure, but isn't the py.typed file missing in google/cloud/pubsub and google/cloud/pubsub_v1?

[ckcr4lyf]

FYI: If someone stumbles across this after struggling with mypy, you can just ignore it:

from google.cloud import pubsub_v1  # type: ignore[attr-defined]