Merge pull request #50 from Microsoft/dev

Merge latest dev, including latest 4.0 and 4.1 apis.

Author: tedchamb

.gitignore

@@ -293,3 +293,8 @@ __pycache__/
 *.btm.cs
 *.odx.cs
 *.xsd.cs
+.vscode/
+vsts/build/bdist.win32/
+
+# don't ignore release managment client
+!vsts/vsts/release

README.md

@@ -5,6 +5,37 @@
 
 This repository contains Microsoft Visual Studio Team Services Python API. This API is used to build the Visual Studio Team Services CLI. To learn more about the VSTS CLI, check out our [github repo](https://github.com/Microsoft/vsts-cli).
 
+# Installation
+
+```pip install vsts```
+
+# Getting Started
+
+Following is an example how to use the API directly:
+
+```
+from vsts.vss_connection import VssConnection
+from msrest.authentication import BasicAuthentication
+import pprint
+
+token='REDACTED'
+team_instance='https://REDACTED.visualstudio.com'
+
+credentials = BasicAuthentication('', token)
+connection = VssConnection(base_url=team_instance, creds=credentials)
+core_client = connection.get_client('vsts.core.v4_0.core_client.CoreClient')
+
+team_projects = core_client.get_projects()
+
+for project in team_projects:
+    pprint.pprint(project.__dict__)
+```
+
+# VSTS REST API Documentation
+
+The python SDK is a thin wrapper around the VSTS REST APIs. Please consult our REST API documentation for API specific details while working with this python SDK.
+
+[VSTS REST API Documentation](https://docs.microsoft.com/en-us/rest/api/vsts)
 
 # Contributing
 

vsts/setup.py

@@ -6,7 +6,7 @@
 from setuptools import setup, find_packages
 
 NAME = "vsts"
-VERSION = "0.1.0b2"
+VERSION = "0.1.1"
 
 # To install the library, run the following
 #
@@ -16,7 +16,7 @@
 # http://pypi.python.org/pypi/setuptools
 
 REQUIRES = [
-    "msrest>=0.4.5"
+    "msrest~=0.4.19"
 ]
 
 CLASSIFIERS = [

vsts/vsts/accounts/__init__.py

@@ -0,0 +1,7 @@
+# --------------------------------------------------------------------------------------------
+# Copyright (c) Microsoft Corporation. All rights reserved.
+# Licensed under the MIT License. See License.txt in the project root for license information.
+# --------------------------------------------------------------------------------------------
+# Generated file, DO NOT EDIT
+# Changes may cause incorrect behavior and will be lost if the code is regenerated.
+# --------------------------------------------------------------------------------------------

vsts/vsts/accounts/v4_0/__init__.py

@@ -0,0 +1,7 @@
+# --------------------------------------------------------------------------------------------
+# Copyright (c) Microsoft Corporation. All rights reserved.
+# Licensed under the MIT License. See License.txt in the project root for license information.
+# --------------------------------------------------------------------------------------------
+# Generated file, DO NOT EDIT
+# Changes may cause incorrect behavior and will be lost if the code is regenerated.
+# --------------------------------------------------------------------------------------------

vsts/vsts/accounts/v4_0/accounts_client.py

@@ -0,0 +1,91 @@
+# --------------------------------------------------------------------------------------------
+# Copyright (c) Microsoft Corporation. All rights reserved.
+# Licensed under the MIT License. See License.txt in the project root for license information.
+# --------------------------------------------------------------------------------------------
+# Generated file, DO NOT EDIT
+# Changes may cause incorrect behavior and will be lost if the code is regenerated.
+# --------------------------------------------------------------------------------------------
+
+from msrest import Serializer, Deserializer
+from ...vss_client import VssClient
+from . import models
+
+
+class AccountsClient(VssClient):
+    """Accounts
+    :param str base_url: Service URL
+    :param Authentication creds: Authenticated credentials.
+    """
+
+    def __init__(self, base_url=None, creds=None):
+        super(AccountsClient, self).__init__(base_url, creds)
+        client_models = {k: v for k, v in models.__dict__.items() if isinstance(v, type)}
+        self._serialize = Serializer(client_models)
+        self._deserialize = Deserializer(client_models)
+
+    resource_area_identifier = '0d55247a-1c47-4462-9b1f-5e2125590ee6'
+
+    def create_account(self, info, use_precreated=None):
+        """CreateAccount.
+        :param :class:`<AccountCreateInfoInternal> <accounts.v4_0.models.AccountCreateInfoInternal>` info:
+        :param bool use_precreated:
+        :rtype: :class:`<Account> <accounts.v4_0.models.Account>`
+        """
+        query_parameters = {}
+        if use_precreated is not None:
+            query_parameters['usePrecreated'] = self._serialize.query('use_precreated', use_precreated, 'bool')
+        content = self._serialize.body(info, 'AccountCreateInfoInternal')
+        response = self._send(http_method='POST',
+                              location_id='229a6a53-b428-4ffb-a835-e8f36b5b4b1e',
+                              version='4.0',
+                              query_parameters=query_parameters,
+                              content=content)
+        return self._deserialize('Account', response)
+
+    def get_account(self, account_id):
+        """GetAccount.
+        :param str account_id:
+        :rtype: :class:`<Account> <accounts.v4_0.models.Account>`
+        """
+        route_values = {}
+        if account_id is not None:
+            route_values['accountId'] = self._serialize.url('account_id', account_id, 'str')
+        response = self._send(http_method='GET',
+                              location_id='229a6a53-b428-4ffb-a835-e8f36b5b4b1e',
+                              version='4.0',
+                              route_values=route_values)
+        return self._deserialize('Account', response)
+
+    def get_accounts(self, owner_id=None, member_id=None, properties=None):
+        """GetAccounts.
+        A new version GetAccounts API. Only supports limited set of parameters, returns a list of account ref objects that only contains AccountUrl, AccountName and AccountId information, will use collection host Id as the AccountId.
+        :param str owner_id: Owner Id to query for
+        :param str member_id: Member Id to query for
+        :param str properties: Only support service URL properties
+        :rtype: [Account]
+        """
+        query_parameters = {}
+        if owner_id is not None:
+            query_parameters['ownerId'] = self._serialize.query('owner_id', owner_id, 'str')
+        if member_id is not None:
+            query_parameters['memberId'] = self._serialize.query('member_id', member_id, 'str')
+        if properties is not None:
+            query_parameters['properties'] = self._serialize.query('properties', properties, 'str')
+        response = self._send(http_method='GET',
+                              location_id='229a6a53-b428-4ffb-a835-e8f36b5b4b1e',
+                              version='4.0',
+                              query_parameters=query_parameters,
+                              returns_collection=True)
+        return self._deserialize('[Account]', response)
+
+    def get_account_settings(self):
+        """GetAccountSettings.
+        [Preview API]
+        :rtype: {str}
+        """
+        response = self._send(http_method='GET',
+                              location_id='4e012dd4-f8e1-485d-9bb3-c50d83c5b71b',
+                              version='4.0-preview.1',
+                              returns_collection=True)
+        return self._deserialize('{str}', response)
+

vsts/vsts/accounts/v4_0/models/__init__.py

@@ -0,0 +1,17 @@
+# --------------------------------------------------------------------------------------------
+# Copyright (c) Microsoft Corporation. All rights reserved.
+# Licensed under the MIT License. See License.txt in the project root for license information.
+# --------------------------------------------------------------------------------------------
+# Generated file, DO NOT EDIT
+# Changes may cause incorrect behavior and will be lost if the code is regenerated.
+# --------------------------------------------------------------------------------------------
+
+from .account import Account
+from .account_create_info_internal import AccountCreateInfoInternal
+from .account_preferences_internal import AccountPreferencesInternal
+
+__all__ = [
+    'Account',
+    'AccountCreateInfoInternal',
+    'AccountPreferencesInternal',
+]

vsts/vsts/accounts/v4_0/models/account.py

@@ -0,0 +1,85 @@
+# --------------------------------------------------------------------------------------------
+# Copyright (c) Microsoft Corporation. All rights reserved.
+# Licensed under the MIT License. See License.txt in the project root for license information.
+# --------------------------------------------------------------------------------------------
+# Generated file, DO NOT EDIT
+# Changes may cause incorrect behavior and will be lost if the code is regenerated.
+# --------------------------------------------------------------------------------------------
+
+from msrest.serialization import Model
+
+
+class Account(Model):
+    """Account.
+
+    :param account_id: Identifier for an Account
+    :type account_id: str
+    :param account_name: Name for an account
+    :type account_name: str
+    :param account_owner: Owner of account
+    :type account_owner: str
+    :param account_status: Current account status
+    :type account_status: object
+    :param account_type: Type of account: Personal, Organization
+    :type account_type: object
+    :param account_uri: Uri for an account
+    :type account_uri: str
+    :param created_by: Who created the account
+    :type created_by: str
+    :param created_date: Date account was created
+    :type created_date: datetime
+    :param has_moved:
+    :type has_moved: bool
+    :param last_updated_by: Identity of last person to update the account
+    :type last_updated_by: str
+    :param last_updated_date: Date account was last updated
+    :type last_updated_date: datetime
+    :param namespace_id: Namespace for an account
+    :type namespace_id: str
+    :param new_collection_id:
+    :type new_collection_id: str
+    :param organization_name: Organization that created the account
+    :type organization_name: str
+    :param properties: Extended properties
+    :type properties: :class:`object <accounts.v4_0.models.object>`
+    :param status_reason: Reason for current status
+    :type status_reason: str
+    """
+
+    _attribute_map = {
+        'account_id': {'key': 'accountId', 'type': 'str'},
+        'account_name': {'key': 'accountName', 'type': 'str'},
+        'account_owner': {'key': 'accountOwner', 'type': 'str'},
+        'account_status': {'key': 'accountStatus', 'type': 'object'},
+        'account_type': {'key': 'accountType', 'type': 'object'},
+        'account_uri': {'key': 'accountUri', 'type': 'str'},
+        'created_by': {'key': 'createdBy', 'type': 'str'},
+        'created_date': {'key': 'createdDate', 'type': 'iso-8601'},
+        'has_moved': {'key': 'hasMoved', 'type': 'bool'},
+        'last_updated_by': {'key': 'lastUpdatedBy', 'type': 'str'},
+        'last_updated_date': {'key': 'lastUpdatedDate', 'type': 'iso-8601'},
+        'namespace_id': {'key': 'namespaceId', 'type': 'str'},
+        'new_collection_id': {'key': 'newCollectionId', 'type': 'str'},
+        'organization_name': {'key': 'organizationName', 'type': 'str'},
+        'properties': {'key': 'properties', 'type': 'object'},
+        'status_reason': {'key': 'statusReason', 'type': 'str'}
+    }
+
+    def __init__(self, account_id=None, account_name=None, account_owner=None, account_status=None, account_type=None, account_uri=None, created_by=None, created_date=None, has_moved=None, last_updated_by=None, last_updated_date=None, namespace_id=None, new_collection_id=None, organization_name=None, properties=None, status_reason=None):
+        super(Account, self).__init__()
+        self.account_id = account_id
+        self.account_name = account_name
+        self.account_owner = account_owner
+        self.account_status = account_status
+        self.account_type = account_type
+        self.account_uri = account_uri
+        self.created_by = created_by
+        self.created_date = created_date
+        self.has_moved = has_moved
+        self.last_updated_by = last_updated_by
+        self.last_updated_date = last_updated_date
+        self.namespace_id = namespace_id
+        self.new_collection_id = new_collection_id
+        self.organization_name = organization_name
+        self.properties = properties
+        self.status_reason = status_reason

vsts/vsts/accounts/v4_0/models/account_create_info_internal.py

@@ -0,0 +1,45 @@
+# --------------------------------------------------------------------------------------------
+# Copyright (c) Microsoft Corporation. All rights reserved.
+# Licensed under the MIT License. See License.txt in the project root for license information.
+# --------------------------------------------------------------------------------------------
+# Generated file, DO NOT EDIT
+# Changes may cause incorrect behavior and will be lost if the code is regenerated.
+# --------------------------------------------------------------------------------------------
+
+from msrest.serialization import Model
+
+
+class AccountCreateInfoInternal(Model):
+    """AccountCreateInfoInternal.
+
+    :param account_name:
+    :type account_name: str
+    :param creator:
+    :type creator: str
+    :param organization:
+    :type organization: str
+    :param preferences:
+    :type preferences: :class:`AccountPreferencesInternal <accounts.v4_0.models.AccountPreferencesInternal>`
+    :param properties:
+    :type properties: :class:`object <accounts.v4_0.models.object>`
+    :param service_definitions:
+    :type service_definitions: list of { key: str; value: str }
+    """
+
+    _attribute_map = {
+        'account_name': {'key': 'accountName', 'type': 'str'},
+        'creator': {'key': 'creator', 'type': 'str'},
+        'organization': {'key': 'organization', 'type': 'str'},
+        'preferences': {'key': 'preferences', 'type': 'AccountPreferencesInternal'},
+        'properties': {'key': 'properties', 'type': 'object'},
+        'service_definitions': {'key': 'serviceDefinitions', 'type': '[{ key: str; value: str }]'}
+    }
+
+    def __init__(self, account_name=None, creator=None, organization=None, preferences=None, properties=None, service_definitions=None):
+        super(AccountCreateInfoInternal, self).__init__()
+        self.account_name = account_name
+        self.creator = creator
+        self.organization = organization
+        self.preferences = preferences
+        self.properties = properties
+        self.service_definitions = service_definitions

vsts/vsts/accounts/v4_0/models/account_preferences_internal.py

@@ -0,0 +1,33 @@
+# --------------------------------------------------------------------------------------------
+# Copyright (c) Microsoft Corporation. All rights reserved.
+# Licensed under the MIT License. See License.txt in the project root for license information.
+# --------------------------------------------------------------------------------------------
+# Generated file, DO NOT EDIT
+# Changes may cause incorrect behavior and will be lost if the code is regenerated.
+# --------------------------------------------------------------------------------------------
+
+from msrest.serialization import Model
+
+
+class AccountPreferencesInternal(Model):
+    """AccountPreferencesInternal.
+
+    :param culture:
+    :type culture: object
+    :param language:
+    :type language: object
+    :param time_zone:
+    :type time_zone: object
+    """
+
+    _attribute_map = {
+        'culture': {'key': 'culture', 'type': 'object'},
+        'language': {'key': 'language', 'type': 'object'},
+        'time_zone': {'key': 'timeZone', 'type': 'object'}
+    }
+
+    def __init__(self, culture=None, language=None, time_zone=None):
+        super(AccountPreferencesInternal, self).__init__()
+        self.culture = culture
+        self.language = language
+        self.time_zone = time_zone

vsts/vsts/accounts/v4_1/__init__.py

@@ -0,0 +1,7 @@
+# --------------------------------------------------------------------------------------------
+# Copyright (c) Microsoft Corporation. All rights reserved.
+# Licensed under the MIT License. See License.txt in the project root for license information.
+# --------------------------------------------------------------------------------------------
+# Generated file, DO NOT EDIT
+# Changes may cause incorrect behavior and will be lost if the code is regenerated.
+# --------------------------------------------------------------------------------------------