Create azure-multiapi-storage package.

- Include set up docs.
- Support wheel building
- Add storage 0.30.0 and storage 0.34.0

Author: derekbekoe

.gitignore

@@ -0,0 +1,79 @@
+# Python cache
+__pycache__/
+*.pyc
+
+# Virtual environment
+env/
+env27/
+.python-version
+
+# PTVS analysis
+.ptvs/
+
+# Build results
+obj/
+dist/
+MANIFEST
+packaged_releases/windows/out
+
+# Result of running python setup.py install/pip install -e
+RECORD.txt
+build/
+*.egg-info/
+
+# Test results
+TestResults/
+
+# Credentials 
+credentials_real.json
+testsettings_local.json
+servicebus_settings_real.py
+storage_settings_real.py
+legacy_mgmt_settings_real.py
+mgmt_settings_real.py
+app_creds_real.py
+
+# User-specific files
+*.suo
+*.user
+*.sln.docstates
+.vs/
+
+# Windows image file caches
+Thumbs.db
+ehthumbs.db
+
+# Folder config file
+Desktop.ini
+
+# Recycle Bin used on file shares
+$RECYCLE.BIN/
+
+# Mac desktop service store files
+.DS_Store
+
+.idea
+src/build
+*.iml
+/doc/_build
+/doc/sphinx/_build
+/.vs/config/applicationhost.config
+.vscode/settings.json
+.vscode/.ropeproject/
+.project
+.pydevproject
+
+# Azure deployment credentials
+*.pubxml
+
+# Auxiliary files
+command_coverage.txt
+
+# Test artifacts
+private_config.json
+scripts/smart_create_gen/config.ini
+debug.log
+test_results/
+
+# Code coverage
+.coverage

LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2017 Derek Bekoe
+Copyright (c) 2017 Microsoft Corporation
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

MANIFEST.in

@@ -0,0 +1,2 @@
+include *.rst
+exclude azure/__init__.py

README.md

@@ -0,0 +1,15 @@
+Microsoft Azure Storage Client Library for Python - with Multi API version Support
+==================================================================================
+
+Handles multi-API versions of Azure Storage Data Plane originally from https://github.com/Azure/azure-storage-python.
+
+Change Log
+----------
+
+0.1.0
++++++
+* Initial release.  
+* Supported API versions:  
+    - 2016-05-31 (from 0.34.0 of azure-storage)  
+    - 2015-04-05 (from 0.30.0 of azure-storage)  
+

README.rst

@@ -0,0 +1 @@
+__import__('pkg_resources').declare_namespace(__name__)

azure/__init__.py

@@ -0,0 +1 @@
+__import__('pkg_resources').declare_namespace(__name__)

azure/multiapi/__init__.py

@@ -0,0 +1 @@
+__import__('pkg_resources').declare_namespace(__name__)

azure/multiapi/storage/__init__.py

@@ -0,0 +1,37 @@
+#-------------------------------------------------------------------------
+# Copyright (c) Microsoft.  All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#--------------------------------------------------------------------------
+from ._constants import (
+    __author__,
+    __version__,
+    X_MS_VERSION,
+)
+
+from .models import (
+    RetentionPolicy,
+    Logging,
+    Metrics,
+    CorsRule,
+    ServiceProperties,
+    AccessPolicy,
+    ResourceTypes,
+    Services,
+    AccountPermissions,
+    Protocol,
+)
+
+from .cloudstorageaccount import CloudStorageAccount
+from .sharedaccesssignature import (
+    SharedAccessSignature,
+)

azure/multiapi/storage/v2015_04_05/__init__.py

@@ -0,0 +1,120 @@
+#-------------------------------------------------------------------------
+# Copyright (c) Microsoft.  All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#--------------------------------------------------------------------------
+from ._common_conversion import (
+    _sign_string,
+)
+
+
+class _StorageSharedKeyAuthentication(object):
+    def __init__(self, account_name, account_key):
+        self.account_name = account_name
+        self.account_key = account_key
+
+    def _get_headers(self, request, headers_to_sign):
+        headers = dict((name.lower(), value) for name, value in request.headers if value)
+        if 'content-length' in headers and headers['content-length'] == '0':
+            del headers['content-length']
+        return '\n'.join(headers.get(x, '') for x in headers_to_sign) + '\n'
+
+    def _get_verb(self, request):
+        return request.method + '\n'
+
+    def _get_canonicalized_resource(self, request):
+        uri_path = request.path.split('?')[0]
+        return '/' + self.account_name + uri_path
+
+    def _get_canonicalized_headers(self, request):
+        string_to_sign = ''
+        x_ms_headers = []
+        for name, value in request.headers:
+            if name.startswith('x-ms-'):
+                x_ms_headers.append((name.lower(), value))
+        x_ms_headers.sort()
+        for name, value in x_ms_headers:
+            if value is not None:
+                string_to_sign += ''.join([name, ':', value, '\n'])
+        return string_to_sign
+
+    def _add_authorization_header(self, request, string_to_sign):
+        signature = _sign_string(self.account_key, string_to_sign)
+        auth_string = 'SharedKey ' + self.account_name + ':' + signature
+        request.headers.append(('Authorization', auth_string))
+
+
+class _StorageSharedKeyAuthentication(_StorageSharedKeyAuthentication):
+    def sign_request(self, request):
+        string_to_sign = \
+            self._get_verb(request) + \
+            self._get_headers(
+                request,
+                [
+                    'content-encoding', 'content-language', 'content-length',
+                    'content-md5', 'content-type', 'date', 'if-modified-since',
+                    'if-match', 'if-none-match', 'if-unmodified-since', 'byte_range'
+                ]
+            ) + \
+            self._get_canonicalized_headers(request) + \
+            self._get_canonicalized_resource(request) + \
+            self._get_canonicalized_resource_query(request)
+
+        self._add_authorization_header(request, string_to_sign)
+
+    def _get_canonicalized_resource_query(self, request):
+        request.query.sort()
+
+        string_to_sign = ''
+        for name, value in request.query:
+            if value:
+                string_to_sign += '\n' + name.lower() + ':' + value
+
+        return string_to_sign
+
+
+class _StorageTableSharedKeyAuthentication(_StorageSharedKeyAuthentication):
+    def sign_request(self, request):
+        string_to_sign = \
+            self._get_verb(request) + \
+            self._get_headers(
+                request,
+                ['content-md5', 'content-type', 'x-ms-date'],
+            ) + \
+            self._get_canonicalized_resource(request) + \
+            self._get_canonicalized_resource_query(request)
+
+        self._add_authorization_header(request, string_to_sign)
+
+    def _get_canonicalized_resource_query(self, request):
+        for name, value in request.query:
+            if name == 'comp':
+                return '?comp=' + value
+        return ''
+
+
+class _StorageNoAuthentication(object):
+    def sign_request(self, request):
+        pass
+
+
+class _StorageSASAuthentication(object):
+    def __init__(self, sas_token):
+        self.sas_token = sas_token
+
+    def sign_request(self, request):
+        if '?' in request.path:
+            request.path += '&'
+        else:
+            request.path += '?'
+
+        request.path += self.sas_token

azure/multiapi/storage/v2015_04_05/_auth.py

@@ -0,0 +1,103 @@
+#-------------------------------------------------------------------------
+# Copyright (c) Microsoft.  All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#--------------------------------------------------------------------------
+
+import base64
+import hashlib
+import hmac
+import sys
+from dateutil.tz import tzutc
+
+from .models import (
+    _unicode_type,
+)
+
+
+if sys.version_info < (3,):
+    def _str(value):
+        if isinstance(value, unicode):
+            return value.encode('utf-8')
+
+        return str(value)
+else:
+    _str = str
+
+
+def _to_str(value):
+    return _str(value) if value is not None else None
+
+def _int_to_str(value):
+    return str(int(value)) if value is not None else None
+
+def _bool_to_str(value):
+    if value is None:
+        return None
+
+    if isinstance(value, bool):
+        if value:
+            return 'true'
+        else:
+            return 'false'
+
+    return str(value)
+
+def _to_utc_datetime(value):
+    return value.strftime('%Y-%m-%dT%H:%M:%SZ')
+
+def _datetime_to_utc_string(value):
+    # Azure expects the date value passed in to be UTC.
+    # Azure will always return values as UTC.
+    # If a date is passed in without timezone info, it is assumed to be UTC.
+    if value is None:
+        return None
+
+    if value.tzinfo:
+        value = value.astimezone(tzutc())
+
+    return value.strftime('%a, %d %b %Y %H:%M:%S GMT')
+
+def _encode_base64(data):
+    if isinstance(data, _unicode_type):
+        data = data.encode('utf-8')
+    encoded = base64.b64encode(data)
+    return encoded.decode('utf-8')
+
+
+def _decode_base64_to_bytes(data):
+    if isinstance(data, _unicode_type):
+        data = data.encode('utf-8')
+    return base64.b64decode(data)
+
+
+def _decode_base64_to_text(data):
+    decoded_bytes = _decode_base64_to_bytes(data)
+    return decoded_bytes.decode('utf-8')
+
+
+def _sign_string(key, string_to_sign, key_is_base64=True):
+    if key_is_base64:
+        key = _decode_base64_to_bytes(key)
+    else:
+        if isinstance(key, _unicode_type):
+            key = key.encode('utf-8')
+    if isinstance(string_to_sign, _unicode_type):
+        string_to_sign = string_to_sign.encode('utf-8')
+    signed_hmac_sha256 = hmac.HMAC(key, string_to_sign, hashlib.sha256)
+    digest = signed_hmac_sha256.digest()
+    encoded_digest = _encode_base64(digest)
+    return encoded_digest
+
+
+def _lower(text):
+    return text.lower()