Final Key Vault 4.0.0b3 updates

sdk/keyvault/azure-keyvault-certificates/HISTORY.md

@@ -1,6 +1,6 @@
 # Release History
 
-## 4.0.0b3 (2019-09-10)
+## 4.0.0b3 (2019-09-11)
 Version 4.0.0b3 is the first preview of our efforts to create a user-friendly and Pythonic client library for Azure Key Vault.
 For more information about preview releases of other Azure SDK libraries, please visit https://aka.ms/azure-sdk-preview1-python.
 

sdk/keyvault/azure-keyvault-certificates/azure/keyvault/certificates/_version.py

@@ -3,4 +3,4 @@
 # Licensed under the MIT License.
 # ------------------------------------
 
-VERSION = "4.0.0b1"
+VERSION = "4.0.0b3"

sdk/keyvault/azure-keyvault-certificates/setup.py

@@ -79,5 +79,9 @@
         ]
     ),
     install_requires=["azure-core<2.0.0,>=1.0.0b2", "azure-common~=1.1", "msrest>=0.5.0"],
-    extras_require={":python_version<'3.0'": ["azure-keyvault-nspkg"], ":python_version<'3.5'": ["typing"]},
+    extras_require={
+        ":python_version<'3.0'": ["azure-keyvault-nspkg"],
+        ":python_version<'3.4'": ["enum34>=1.0.4"],
+        ":python_version<'3.5'": ["typing"],
+    },
 )

sdk/keyvault/azure-keyvault-keys/HISTORY.md

@@ -1,5 +1,15 @@
 # Release History
 
+## 4.0.0b3 (2019-09-11)
+### Breaking changes:
+- `CryptographyClient` methods `wrap` and `unwrap` are renamed `wrap_key` and
+`unwrap_key`, respectively.
+
+### New features:
+- `CryptographyClient` performs encrypt, verify and wrap operations locally
+when its key's public material is available (i.e., when it has keys/get
+permission).
+
 ## 4.0.0b2 (2019-08-06)
 ### Breaking changes:
 - Removed `azure.core.Configuration` from the public API in preparation for a

sdk/keyvault/azure-keyvault-keys/azure/keyvault/keys/_version.py

@@ -3,4 +3,4 @@
 # Licensed under the MIT License.
 # ------------------------------------
 
-VERSION = "4.0.0b2"
+VERSION = "4.0.0b3"

sdk/keyvault/azure-keyvault-keys/azure/keyvault/keys/crypto/aio/client.py

@@ -28,14 +28,43 @@ class CryptographyClient(AsyncKeyVaultClientBase):
 
     :param key:
         Either a :class:`~azure.keyvault.keys.models.Key` instance as returned by
-        :func:`~azure.keyvault.keys.KeyClient.get_key`, or a string.
+        :func:`~azure.keyvault.keys.aio.KeyClient.get_key`, or a string.
         If a string, the value must be the full identifier of an Azure Key Vault key with a version.
     :type key: str or :class:`~azure.keyvault.keys.models.Key`
     :param credential: An object which can provide an access token for the vault, such as a credential from
-        :mod:`azure.identity`
+        :mod:`azure.identity.aio`
 
     Keyword arguments
-        - *api_version* - version of the Key Vault API to use. Defaults to the most recent.
+        - **api_version** - version of the Key Vault API to use. Defaults to the most recent.
+
+    Creating a ``CryptographyClient``:
+
+    .. code-block:: python
+
+        from azure.identity.aio import DefaultAzureCredential
+        from azure.keyvault.keys.crypto.aio import CryptographyClient
+
+        credential = DefaultAzureCredential()
+
+        # create a CryptographyClient using a Key instance
+        key = await key_client.get_key("mykey")
+        crypto_client = CryptographyClient(key, credential)
+
+        # or a Key's id, which must include a version
+        key_id = "https://<your vault>.vault.azure.net/keys/mykey/fe4fdcab688c479a9aa80f01ffeac26"
+        crypto_client = CryptographyClient(key_id, credential)
+
+    You can also obtain a ``CryptographyClient`` from a :class:`~azure.keyvault.keys.aio.KeyClient`:
+
+    .. code-block:: python
+
+        from azure.identity.aio import DefaultAzureCredential
+        from azure.keyvault.keys.aio import KeyClient
+
+        credential = DefaultAzureCredential()
+        key_client = KeyClient(vault_url=<your vault url>, credential=credential)
+        crypto_client = key_client.get_cryptography_client("mykey")
+
     """
 
     def __init__(self, key: "Union[Key, str]", credential: "TokenCredential", **kwargs: "**Any") -> None:

sdk/keyvault/azure-keyvault-keys/azure/keyvault/keys/crypto/client.py

@@ -36,7 +36,36 @@ class CryptographyClient(KeyVaultClientBase):
         :mod:`azure.identity`
 
     Keyword arguments
-        - *api_version* - version of the Key Vault API to use. Defaults to the most recent.
+        - **api_version** - version of the Key Vault API to use. Defaults to the most recent.
+
+    Creating a ``CryptographyClient``:
+
+    .. code-block:: python
+
+        from azure.identity import DefaultAzureCredential
+        from azure.keyvault.keys.crypto import CryptographyClient
+
+        credential = DefaultAzureCredential()
+
+        # create a CryptographyClient using a Key instance
+        key = key_client.get_key("mykey")
+        crypto_client = CryptographyClient(key, credential)
+
+        # or a Key's id, which must include a version
+        key_id = "https://<your vault>.vault.azure.net/keys/mykey/fe4fdcab688c479a9aa80f01ffeac26"
+        crypto_client = CryptographyClient(key_id, credential)
+
+    You can also obtain a ``CryptographyClient`` from a :class:`~azure.keyvault.keys.KeyClient`:
+
+    .. code-block:: python
+
+        from azure.identity import DefaultAzureCredential
+        from azure.keyvault.keys import KeyClient
+
+        credential = DefaultAzureCredential()
+        key_client = KeyClient(vault_url=<your vault url>, credential=credential)
+        crypto_client = key_client.get_cryptography_client("mykey")
+
     """
 
     def __init__(self, key, credential, **kwargs):

sdk/keyvault/azure-keyvault-keys/setup.py

@@ -79,5 +79,9 @@
         ]
     ),
     install_requires=["azure-core<2.0.0,>=1.0.0b2", "azure-common~=1.1", "msrest>=0.5.0"],
-    extras_require={":python_version<'3.0'": ["azure-keyvault-nspkg"], ":python_version<'3.5'": ["typing"]},
+    extras_require={
+        ":python_version<'3.0'": ["azure-keyvault-nspkg"],
+        ":python_version<'3.4'": ["enum34>=1.0.4"],
+        ":python_version<'3.5'": ["typing"],
+    },
 )

sdk/keyvault/azure-keyvault-secrets/HISTORY.md

@@ -1,4 +1,6 @@
 # Release History
+## 4.0.0b3 (2019-09-11)
+This release includes only internal changes.
 
 ## 4.0.0b2 (2019-08-06)
 ### Breaking changes: