Fix errors reported by mypy

noxfile.py

@@ -3,11 +3,18 @@
 nox.options.stop_on_first_error = True
 nox.options.reuse_existing_virtualenvs = False
 
-nox.options.sessions = ['lint', 'test', 'coverage', 'docs']
+nox.options.sessions = ['lint', 'analyze', 'test', 'coverage', 'docs']
 
 source_files = ("planet", "examples", "tests", "setup.py", "noxfile.py")
 
 
+@nox.session
+def analyze(session):
+    session.install(".[lint]")
+
+    session.run("mypy", "planet")
+
+
 @nox.session
 def coverage(session):
     session.install("-e", ".[test]")

planet/__init__.py

@@ -17,4 +17,11 @@
 from .auth import Auth
 from .clients import DataClient, OrdersClient
 
-__all__ = [Session, OrdersClient, order_request, reporting, Auth, DataClient]
+__all__ = [
+    'Auth',
+    'DataClient'
+    'OrdersClient',
+    'order_request',
+    'reporting',
+    'Session',
+]

planet/auth.py

@@ -30,12 +30,14 @@
 BASE_URL = f'{PLANET_BASE_URL}/v0/auth'
 ENV_API_KEY = 'PL_API_KEY'
 
+AuthType = httpx.Auth
+
 
 class Auth(metaclass=abc.ABCMeta):
     '''Handle authentication information for use with Planet APIs.'''
 
     @staticmethod
-    def from_key(key: str) -> Auth:
+    def from_key(key: str) -> AuthType:
         '''Obtain authentication from api key.
 
         Parameters:
@@ -46,7 +48,7 @@ def from_key(key: str) -> Auth:
         return auth
 
     @staticmethod
-    def from_file(filename: str = None) -> Auth:
+    def from_file(filename: str = None) -> AuthType:
         '''Create authentication from secret file.
 
         The secret file is named `.planet.json` and is stored in the user
@@ -71,7 +73,7 @@ def from_file(filename: str = None) -> Auth:
         return auth
 
     @staticmethod
-    def from_env(variable_name: str = None) -> Auth:
+    def from_env(variable_name: str = None) -> AuthType:
         '''Create authentication from environment variable.
 
         Reads the `PL_API_KEY` environment variable
@@ -80,7 +82,7 @@ def from_env(variable_name: str = None) -> Auth:
             variable_name: Alternate environment variable.
         '''
         variable_name = variable_name or ENV_API_KEY
-        api_key = os.getenv(variable_name)
+        api_key = os.getenv(variable_name, '')
         try:
             auth = APIKeyAuth(api_key)
             LOGGER.debug(f'Auth set from environment variable {variable_name}')
@@ -91,7 +93,7 @@ def from_env(variable_name: str = None) -> Auth:
         return auth
 
     @staticmethod
-    def from_login(email: str, password: str, base_url: str = None) -> Auth:
+    def from_login(email: str, password: str, base_url: str = None) -> AuthType:
         '''Create authentication from login email and password.
 
         Note: To keep your password secure, the use of `getpass` is
@@ -113,14 +115,18 @@ def from_login(email: str, password: str, base_url: str = None) -> Auth:
 
     @classmethod
     @abc.abstractmethod
-    def from_dict(cls, data: dict) -> Auth:
+    def from_dict(cls, data: dict) -> AuthType:
         pass
 
     @property
     @abc.abstractmethod
     def value(self):
         pass
 
+    @abc.abstractmethod
+    def to_dict(self) -> dict:
+        pass
+
     def write(self, filename: str = None):
         '''Write authentication information.
 

planet/clients/__init__.py

@@ -15,6 +15,6 @@
 from .orders import OrdersClient
 
 __all__ = [
-    DataClient,
-    OrdersClient,
+    'DataClient',
+    'OrdersClient',
 ]

planet/clients/data.py

@@ -175,11 +175,12 @@ async def create_search(self,
         url = self._searches_url()
 
         # TODO: validate item_types
-        request_json = {
+        request_json: typing.Dict[str, typing.Any] = {
             'name': name, 'filter': search_filter, 'item_types': item_types
         }
+        # QUESTION: can we just set the value to True or False above?
         if enable_email:
-            request_json['__daily_email_enabled'] = True
+            request_json['__daily_email_enabled'] = enable_email
 
         request = self._request(url, method='POST', json=request_json)
         response = await self._do_request(request)

planet/http.py

@@ -19,7 +19,7 @@
 
 import httpx
 
-from .auth import Auth
+from .auth import Auth, AuthType
 from . import exceptions, models
 from .__version__ import __version__
 
@@ -112,7 +112,7 @@ class Session(BaseSession):
     ```
     '''
 
-    def __init__(self, auth: Auth = None):
+    def __init__(self, auth: AuthType = None):
         """Initialize a Session.
 
         Parameters:

setup.py

@@ -34,7 +34,7 @@
     'pytest', 'pytest-asyncio==0.16', 'pytest-cov', 'respx==0.16.3'
 ]
 
-lint_requires = ['flake8', 'yapf']
+lint_requires = ['flake8', 'mypy', 'yapf']
 
 doc_requires = [
     'mkdocs==1.3',