Skip to content

Commit

Permalink
Azure 2.0.0
Browse files Browse the repository at this point in the history
  • Loading branch information
lmazuel committed May 16, 2017
1 parent c51a79c commit 8255d55
Show file tree
Hide file tree
Showing 5 changed files with 121 additions and 66 deletions.
85 changes: 85 additions & 0 deletions ChangeLog.rst
Original file line number Diff line number Diff line change
@@ -1,3 +1,88 @@
2017-04-27 azure 2.0.0rc7
+++++++++++++++++++++++++

**Disclaimer**

Starting with this release, we fixed several packaging issues to improve our package generation system
- Uninstalling of packages using "pip uninstall" now work properly (#1150)
- setuptools install of "azure" works properly (#728)

Update from 2.0.0rc6 *might* work, but we strongly suggest to create a fresh virtual environment.

**Features**

***CLI configuration***

You can now execute your SDK script using the configuration of the `AzureCLI <https://github.com/Azure/azure-cli>`__

Example:

from azure.common.client_factory import get_client_from_cli_profile
from azure.mgmt.compute import ComputeManagementClient
client = get_client_from_cli_profile(ComputeManagementClient)
client.virtual_machines.get('rg', 'vm')

Configuration from the CLI is:
- `az login <https://docs.microsoft.com/en-us/cli/azure/authenticate-azure-cli>`__: access to credentials
- `az account set --subscriptions <https://docs.microsoft.com/en-us/cli/azure/manage-azure-subscriptions-azure-cli>`__: access to subscription_id
- `az cloud set --name <https://docs.microsoft.com/en-us/cli/azure/cloud#set>`__: access to base_url (sovereign cloud, Government, Germany, etc.)

Note: CLI and SDK have different versionning story. We do recommend using two different virtual environment. Information will be shared
automatically since the CLI saves them in the $HOME folder. You do require to install the `azure-cli-core` package in your SDK environment to use this feature.

***Multiple ApiVersion support***

To help support of sovereign cloud (i.e. AzureStack, Azure Government, Azure Germany, Microsoft Azure operated by 21Vianet - China), the following packages
now support officially several ApiVersion in the same package:

- `azure-mgmt-resource v1.1.x <https://pypi.python.org/pypi/azure-mgmt-resource/1.1.0>`__
- `azure-mgmt-compute v1.0.x <https://pypi.python.org/pypi/azure-mgmt-compute/1.0.0>`__
- `azure-mgmt-network v1.0.x <https://pypi.python.org/pypi/azure-mgmt-network/1.0.0>`__
- `azure-mgmt-storage v1.0.x <https://pypi.python.org/pypi/azure-mgmt-storage/1.0.0>`__

Please refer to the PyPI page of these packages for supported ApiVersion.

**Breaking changes**

The Azure SDK for Python has now too much services to provide an unique ChangeLog. Please refer to each package HISTORY.txt for details compared to 2.0.0rc6.

The complete list of packages installed is:
- `azure-batch v3.0.0 <https://pypi.python.org/pypi/azure-batch/3.0.0>`__
- `azure-datalake-store v0.0.x <https://pypi.python.org/pypi/azure-datalake-store/0.0.9>`__
- `azure-graphrbac v0.30.x <https://pypi.python.org/pypi/azure-graphrbac/0.30.0>`__
- `azure-keyvault v0.3.x <https://pypi.python.org/pypi/azure-keyvault/0.3.3>`__
- `azure-servicebus v0.21.x <https://pypi.python.org/pypi/azure-servicebus/0.21.1>`__
- `azure-servicefabric v5.6.130 <https://pypi.python.org/pypi/azure-servicefabric/5.6.130>`__
- `azure-servicemanagement-legacy v0.20.x <https://pypi.python.org/pypi/azure-servicemanagement-legacy/0.20.6>`__
- `azure-storage v0.34.x <https://pypi.python.org/pypi/azure-storage/0.34.2>`__
- `azure-mgmt-authorization v0.30.x <https://pypi.python.org/pypi/azure-mgmt-authorization/0.30.0>`__
- `azure-mgmt-batch v4.0.x <https://pypi.python.org/pypi/azure-mgmt-batch/4.0.0>`__
- `azure-mgmt-cdn v0.30.x <https://pypi.python.org/pypi/azure-mgmt-cdn/0.30.3>`__
- `azure-mgmt-cognitiveservices v1.0.x <https://pypi.python.org/pypi/azure-mgmt-cognitiveservices/1.0.0>`__
- `azure-mgmt-compute v1.0.x <https://pypi.python.org/pypi/azure-mgmt-compute/1.0.0>`__
- `azure-mgmt-containerregistry v0.2.x <https://pypi.python.org/pypi/azure-mgmt-containerregistry/0.2.1>`__
- `azure-mgmt-datalake-analytics v0.1.x <https://pypi.python.org/pypi/azure-mgmt-datalake-analytics/0.1.4>`__
- `azure-mgmt-datalake-store v0.1.x <https://pypi.python.org/pypi/azure-mgmt-datalake-store/0.1.4>`__
- `azure-mgmt-devtestlabs v2.0.x <https://pypi.python.org/pypi/azure-mgmt-devtestlabs/2.0.0>`__
- `azure-mgmt-dns v1.0.x <https://pypi.python.org/pypi/azure-mgmt-dns/1.0.1>`__
- `azure-mgmt-documentdb v0.1.x <https://pypi.python.org/pypi/azure-mgmt-documentdb/0.1.3>`__
- `azure-mgmt-iothub v0.2.x <https://pypi.python.org/pypi/azure-mgmt-iothub/0.2.2>`__
- `azure-mgmt-keyvault v0.31.x <https://pypi.python.org/pypi/azure-mgmt-keyvault/0.31.0>`__
- `azure-mgmt-logic v2.1.x <https://pypi.python.org/pypi/azure-mgmt-logic/2.1.0>`__
- `azure-mgmt-network v1.0.x <https://pypi.python.org/pypi/azure-mgmt-network/1.0.0>`__
- `azure-mgmt-rdbms v0.1.x <https://pypi.python.org/pypi/azure-mgmt-rdbms/0.1.0>`__
- `azure-mgmt-redis v4.1.x <https://pypi.python.org/pypi/azure-mgmt-redis/4.1.0>`__
- `azure-mgmt-resource v1.1.x <https://pypi.python.org/pypi/azure-mgmt-resource/1.1.0>`__
- `azure-mgmt-scheduler v1.1.x <https://pypi.python.org/pypi/azure-mgmt-scheduler/1.1.2>`__
- `azure-mgmt-sql v0.5.x <https://pypi.python.org/pypi/azure-mgmt-sql/0.5.1>`__
- `azure-mgmt-storage v1.0.x <https://pypi.python.org/pypi/azure-mgmt-storage/1.0.0>`__
- `azure-mgmt-trafficmanager v0.30.x <https://pypi.python.org/pypi/azure-mgmt-trafficmanager/0.30.0>`__
- `azure-mgmt-web v0.32.x <https://pypi.python.org/pypi/azure-mgmt-web/0.32.0>`__

More packages are available, but they are in preview with not enough tests currently and are not included in this bundle. More details here:
http://azure-sdk-for-python.readthedocs.io/en/latest/installation.html


2016-08-30 Version 2.0.0rc6 / 0.30.0rc6
+++++++++++++++++++++++++++++++++++++++

Expand Down
27 changes: 9 additions & 18 deletions README.rst
Original file line number Diff line number Diff line change
Expand Up @@ -27,40 +27,31 @@ If you're currently using the ``azure`` package < 1.0 then please read important
INSTALLATION
============

You can install each library individually for each Azure service:
You can install individually each library for each Azure service:

.. code-block:: console
$ pip install azure-batch # Install the latest Batch runtime library
$ pip install azure-mgmt-storage # Install the latest Storage management library
$ pip install azure-batch # Install the latest Batch runtime library
$ pip install azure-mgmt-scheduler # Install the latest Storage management library
Preview packages can be installed using the ``--pre`` flag:

.. code-block:: console
$ pip install --pre azure-mgmt-trafficmanager # will install the latest Traffic Manager
$ pip install --pre azure-mgmt-compute # will install only the latest Compute Management library
You can also install a set of Azure libraries in a single line using the ``azure`` meta-package.
Since not all packages in this meta-package are
published as stable yet, the ``azure`` meta-package is still a release candidate and not final yet.
However, the core packages, from code quality/completeness perspectives can at this time be considered "stable"
The ``azure`` package will be officially labeled stable in sync with other language SDKs as soon as possible.
We are not planning on any further major changes until then.

**Since it's a preview release, you need to use the ``--pre`` flag:**
You can also install a set of Azure libraries in a single line using the ``azure`` meta-package.

.. code-block:: console
$ pip install --pre azure
or directly
$ pip install azure
.. code-block:: console
We publish preview version of this package, that you can access using the `--pre` flag:

$ pip install azure==2.0.0rc6
.. code-block:: console
**The azure meta-package 1.0.3 is deprecated and no longer properly functions.**
$ pip install --pre azure
The full list of available packages and their latest version can be found on our
`installation page on ReadTheDocs <http://azure-sdk-for-python.rtfd.io/en/latest/installation.html>`__.
Expand Down
47 changes: 15 additions & 32 deletions azure/README.rst
Original file line number Diff line number Diff line change
Expand Up @@ -6,20 +6,28 @@ This is the Microsoft Azure bundle.
This package does not contain any code in itself. It installs a set
of packages that provide Microsoft Azure functionality.

All packages in this bundle have been tested with Python 2.7, 3.3, 3.4 and 3.5.
All packages in this bundle have been tested with Python 2.7, 3.3, 3.4, 3.5 and 3.6.

This package uses PEP440 syntax, and then requires pip >= 6.0 and/or setuptools >= 8.0
to be installed.


Features
========

This version of the Azure package bundle consists of the following
packages. Follow the links for more information on each package.

- `azure-mgmt v0.30.0rc6 <https://pypi.python.org/pypi/azure-mgmt/0.30.0rc6>`__
- `azure-batch v1.0.0 <https://pypi.python.org/pypi/azure-batch/1.0.0>`__
- `azure-servicebus v0.20.3 <https://pypi.python.org/pypi/azure-servicebus/0.20.3>`__
- `azure-servicemanagement-legacy v0.20.4 <https://pypi.python.org/pypi/azure-servicemanagement-legacy/0.20.4>`__
- `azure-storage v0.33.0 <https://pypi.python.org/pypi/azure-storage/0.33.0>`__
Note that versions are fixed at the patch version number level.

- `azure-mgmt v1.0.x <https://pypi.python.org/pypi/azure-mgmt/1.0.0>`__
- `azure-batch v3.0.0 <https://pypi.python.org/pypi/azure-batch/3.0.0>`__
- `azure-datalake-store v0.0.x <https://pypi.python.org/pypi/azure-datalake-store/0.0.9>`__
- `azure-graphrbac v0.30.x <https://pypi.python.org/pypi/azure-graphrbac/0.30.0>`__
- `azure-keyvault v0.3.x <https://pypi.python.org/pypi/azure-keyvault/0.3.3>`__
- `azure-servicebus v0.21.x <https://pypi.python.org/pypi/azure-servicebus/0.21.1>`__
- `azure-servicefabric v5.6.130 <https://pypi.python.org/pypi/azure-servicefabric/5.6.130>`__
- `azure-servicemanagement-legacy v0.20.x <https://pypi.python.org/pypi/azure-servicemanagement-legacy/0.20.6>`__
- `azure-storage v0.34.x <https://pypi.python.org/pypi/azure-storage/0.34.2>`__

Note that if you don't need all of these packages, you can install/uninstall them individually.

Expand Down Expand Up @@ -55,28 +63,3 @@ to change some import statements and rename exception classes.

For details on the breaking changes, see the
`change log <https://github.com/Azure/azure-sdk-for-python/blob/master/ChangeLog.txt>`__.


Uninstall
=========

Installing the azure bundle package installs several packages.

Use the following script to uninstall all of them.

.. code:: shell
pip uninstall azure
pip uninstall azure-mgmt
pip uninstall azure-mgmt-batch
pip uninstall azure-mgmt-compute
pip uninstall azure-mgmt-keyvault
pip uninstall azure-mgmt-network
pip uninstall azure-mgmt-resource
pip uninstall azure-mgmt-storage
pip uninstall azure-mgmt-nspkg
pip uninstall azure-batch
pip uninstall azure-servicebus
pip uninstall azure-storage
pip uninstall azure-common
pip uninstall azure-nspkg
12 changes: 8 additions & 4 deletions azure/setup.py
Original file line number Diff line number Diff line change
Expand Up @@ -26,7 +26,7 @@

setup(
name='azure',
version='2.0.0rc7',
version='2.0.0',
description='Microsoft Azure Client Libraries for Python',
long_description=open('README.rst', 'r').read(),
license='MIT License',
Expand All @@ -47,10 +47,14 @@
],
zip_safe=False,
install_requires=[
'azure-mgmt~=1.0.0rc1',
'azure-batch~=2.0.1',
'azure-mgmt~=1.0.0',
'azure-batch~=3.0.0',
'azure-datalake-store~=0.0.9',
'azure-graphrbac~=0.30.0',
'azure-keyvault~=0.3.3',
'azure-servicebus~=0.21.1',
'azure-storage~=0.34.0',
'azure-servicefabric~=5.6.130',
'azure-storage~=0.34.2',
'azure-servicemanagement-legacy~=0.20.6',
],
)
16 changes: 4 additions & 12 deletions doc/installation.rst
Original file line number Diff line number Diff line change
Expand Up @@ -18,26 +18,18 @@ Preview packages can be installed using the ``--pre`` flag:
$ pip install --pre azure-mgmt-compute # will install only the latest Compute Management library
You can also install a set of Azure libraries in a single line using the ``azure`` meta-package. Since not all packages in this meta-package are
published as stable yet, the ``azure`` meta-package is still in preview.
However, the core packages, from code quality/completeness perspectives can at this time be considered "stable"
- it will be officially labeled as such in sync with other languages as soon as possible.
We are not planning on any further major changes until then.

Since it's a preview release, you need to use the ``--pre`` flag:
You can also install a set of Azure libraries in a single line using the ``azure`` meta-package.

.. code-block:: console
$ pip install --pre azure
$ pip install azure
or directly
We publish preview version of this package, that you can access using the `--pre` flag:

.. code-block:: console
$ pip install azure==2.0.0rc6
$ pip install --pre azure
.. important:: The azure meta-package 1.0.3 is deprecated and is not working anymore.

Available packages
------------------

Expand Down

0 comments on commit 8255d55

Please sign in to comment.