Adding app_name and app_version headers (#136)

Author: abhidnya13

msal/application.py

@@ -73,7 +73,7 @@ def __init__(
             client_credential=None, authority=None, validate_authority=True,
             token_cache=None,
             verify=True, proxies=None, timeout=None,
-            client_claims=None):
+            client_claims=None, app_name=None, app_version=None):
         """Create an instance of application.
 
         :param client_id: Your app has a client_id after you register it on AAD.
@@ -131,13 +131,21 @@ def __init__(
             It will be passed to the
             `timeout parameter in the underlying requests library
             <http://docs.python-requests.org/en/v2.9.1/user/advanced/#timeouts>`_
+        :param app_name: (optional)
+            You can provide your application name for Microsoft telemetry purposes.
+            Default value is None, means it will not be passed to Microsoft.
+        :param app_version: (optional)
+            You can provide your application version for Microsoft telemetry purposes.
+            Default value is None, means it will not be passed to Microsoft.
         """
         self.client_id = client_id
         self.client_credential = client_credential
         self.client_claims = client_claims
         self.verify = verify
         self.proxies = proxies
         self.timeout = timeout
+        self.app_name = app_name
+        self.app_version = app_version
         self.authority = Authority(
                 authority or "https://login.microsoftonline.com/common/",
                 validate_authority, verify=verify, proxies=proxies, timeout=timeout)
@@ -149,6 +157,15 @@ def __init__(
     def _build_client(self, client_credential, authority):
         client_assertion = None
         client_assertion_type = None
+        default_headers = {
+            "x-client-sku": "MSAL.Python", "x-client-ver": __version__,
+            "x-client-os": sys.platform,
+            "x-client-cpu": "x64" if sys.maxsize > 2 ** 32 else "x86",
+        }
+        if self.app_name:
+            default_headers['x-app-name'] = self.app_name
+        if self.app_version:
+            default_headers['x-app-ver'] = self.app_version
         default_body = {"client_info": 1}
         if isinstance(client_credential, dict):
             assert ("private_key" in client_credential
@@ -174,11 +191,7 @@ def _build_client(self, client_credential, authority):
         return Client(
             server_configuration,
             self.client_id,
-            default_headers={
-                "x-client-sku": "MSAL.Python", "x-client-ver": __version__,
-                "x-client-os": sys.platform,
-                "x-client-cpu": "x64" if sys.maxsize > 2 ** 32 else "x86",
-                },
+            default_headers=default_headers,
             default_body=default_body,
             client_assertion=client_assertion,
             client_assertion_type=client_assertion_type,