CI Update

 Build.Reason:Schedule
 Build.Url:https://apidrop.visualstudio.com/Content%20CI/_build/results?buildId=434085&view=results

Author: [email protected]

python/docs-ref-autogen/msal/msal.application.ClientApplication.yml

@@ -56,10 +56,17 @@ constructor:
       : [], \"names\": [], \"dupnames\": [], \"backrefs\": [], \"xml:space\": \"preserve\"\
       , \"language\": \"default\", \"force\": false, \"linenos\": false} -->\n\n````default\n\
       \n   {\n       \"client_assertion\": \"...a JWT with claims aud, exp, iss, jti,\
-      \ nbf, and sub...\"\n   }\n   ````"
+      \ nbf, and sub...\"\n   }\n   ````\n\n\n\n## Supporting reading client cerficates\
+      \ from PFX files*Added in version 1.29.0*:\nFeed in a dictionary containing\
+      \ the path to a PFX file:\n\n<!-- literal_block {\"ids\": [], \"classes\": [],\
+      \ \"names\": [], \"dupnames\": [], \"backrefs\": [], \"xml:space\": \"preserve\"\
+      , \"language\": \"default\", \"force\": false, \"linenos\": false} -->\n\n````default\n\
+      \n   {\n       \"private_key_pfx_path\": \"/path/to/your.pfx\",\n       \"passphrase\"\
+      : \"Passphrase if the private_key is encrypted (Optional. Added in version 1.6.0)\"\
+      ,\n   }\n   ````"
     defaultValue: None
     types:
-    - <xref:typing.Union>[<xref:str>, <xref:dict>]
+    - <xref:typing.Union>[<xref:dict>, <xref:str>]
   - name: client_claims
     description: "*Added in version 0.5.0*:\nIt is a dictionary of extra claims that\
       \ would be signed by\nby this <xref:msal.application.ConfidentialClientApplication>\

python/docs-ref-autogen/msal/msal.application.ConfidentialClientApplication.yml

@@ -56,10 +56,17 @@ constructor:
       : [], \"names\": [], \"dupnames\": [], \"backrefs\": [], \"xml:space\": \"preserve\"\
       , \"language\": \"default\", \"force\": false, \"linenos\": false} -->\n\n````default\n\
       \n   {\n       \"client_assertion\": \"...a JWT with claims aud, exp, iss, jti,\
-      \ nbf, and sub...\"\n   }\n   ````"
+      \ nbf, and sub...\"\n   }\n   ````\n\n\n\n## Supporting reading client cerficates\
+      \ from PFX files*Added in version 1.29.0*:\nFeed in a dictionary containing\
+      \ the path to a PFX file:\n\n<!-- literal_block {\"ids\": [], \"classes\": [],\
+      \ \"names\": [], \"dupnames\": [], \"backrefs\": [], \"xml:space\": \"preserve\"\
+      , \"language\": \"default\", \"force\": false, \"linenos\": false} -->\n\n````default\n\
+      \n   {\n       \"private_key_pfx_path\": \"/path/to/your.pfx\",\n       \"passphrase\"\
+      : \"Passphrase if the private_key is encrypted (Optional. Added in version 1.6.0)\"\
+      ,\n   }\n   ````"
     defaultValue: None
     types:
-    - <xref:typing.Union>[<xref:str>, <xref:dict>]
+    - <xref:typing.Union>[<xref:dict>, <xref:str>]
   - name: client_claims
     description: "*Added in version 0.5.0*:\nIt is a dictionary of extra claims that\
       \ would be signed by\nby this <xref:msal.application.ConfidentialClientApplication>\

python/docs-ref-autogen/msal/msal.token_cache.SerializableTokenCache.yml

@@ -11,9 +11,12 @@ summary: "This serialization can be a starting point to implement your own persi
   \n<!-- literal_block {\"ids\": [], \"classes\": [], \"names\": [], \"dupnames\"\
   : [], \"backrefs\": [], \"xml:space\": \"preserve\", \"language\": \"default\",\
   \ \"force\": false, \"linenos\": false} -->\n\n````default\n\n   import os, atexit,\
-  \ msal\n   cache = msal.SerializableTokenCache()\n   if os.path.exists(\"my_cache.bin\"\
-  ):\n       cache.deserialize(open(\"my_cache.bin\", \"r\").read())\n   atexit.register(lambda:\n\
-  \       open(\"my_cache.bin\", \"w\").write(cache.serialize())\n       # Hint: The\
+  \ msal\n   cache_filename = os.path.join(  # Persist cache into this file\n    \
+  \   os.getenv(\"XDG_RUNTIME_DIR\", \"\"),  # Automatically wipe out the cache from\
+  \ Linux when user's ssh session ends. See also https://github.com/AzureAD/microsoft-authentication-library-for-python/issues/690\n\
+  \       \"my_cache.bin\")\n   cache = msal.SerializableTokenCache()\n   if os.path.exists(cache_filename):\n\
+  \       cache.deserialize(open(cache_filename, \"r\").read())\n   atexit.register(lambda:\n\
+  \       open(cache_filename, \"w\").write(cache.serialize())\n       # Hint: The\
   \ following optional line persists only when state changed\n       if cache.has_state_changed\
   \ else None\n       )\n   app = msal.ClientApplication(..., token_cache=cache)\n\
   \   ...\n   ````"