Update CreatePipelineConfigurationParameters model

.gitattributes

@@ -14,3 +14,6 @@
 
 # Shell scripts
 *.sh eol=lf
+
+# Python
+*.py eol=lf

.github/workflows/pythonpackage.yml

@@ -0,0 +1,35 @@
+name: Python package
+
+on: [push]
+
+jobs:
+  build:
+
+    runs-on: ubuntu-latest
+    strategy:
+      max-parallel: 5
+      matrix:
+        python-version: [2.7, 3.5, 3.6, 3.7, 3.8]
+
+    steps:
+    - uses: actions/checkout@v1
+    - name: Set up Python ${{ matrix.python-version }}
+      uses: actions/setup-python@v1
+      with:
+        python-version: ${{ matrix.python-version }}
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install msrest
+    - name: Python compile
+      run: |
+        python -m compileall .
+    - name: Lint with flake8
+      run: |
+        pip install flake8
+        # stop the build if there are Python syntax errors or undefined names
+        flake8 . --count --select=E9,F63,F7,F82 --show-source --statistics
+    - name: Test with pytest
+      run: |
+        pip install pytest
+        pytest

.gitignore

@@ -17,6 +17,7 @@
 env/**
 dist/
 lib/
+.eggs/
 
 # Build results
 [Dd]ebug/
@@ -293,3 +294,13 @@ __pycache__/
 *.btm.cs
 *.odx.cs
 *.xsd.cs
+.vscode/
+vsts/build/bdist.win32/
+
+# don't ignore release management client
+!azure-devops/azure/devops/released/release
+!azure-devops/azure/devops/v5_1/release
+!azure-devops/azure/devops/v6_0/release
+
+# ignore private folder for testing reported issues
+issues/

README.md

@@ -1,5 +1,62 @@
+[![Python package](https://github.com/microsoft/azure-devops-python-api/workflows/Python%20package/badge.svg)](https://github.com/microsoft/azure-devops-python-api/actions)
+[![Build Status](https://dev.azure.com/mseng/vsts-cli/_apis/build/status/vsts-python-api?branchName=dev)](https://dev.azure.com/mseng/vsts-cli/_build/latest?definitionId=5904&branchName=dev)
+[![Python](https://img.shields.io/pypi/pyversions/azure-devops.svg)](https://pypi.python.org/pypi/azure-devops)
 
-# Contributing
+# Azure DevOps Python API
+
+This repository contains Python APIs for interacting with and managing Azure DevOps. These APIs power the Azure DevOps Extension for Azure CLI. To learn more about the Azure DevOps Extension for Azure CLI, visit the [Microsoft/azure-devops-cli-extension](https://github.com/Microsoft/azure-devops-cli-extension) repo.
+
+## Install 
+
+```
+pip install azure-devops
+```
+
+## Get started
+
+
+To use the API, establish a connection using a [personal access token](https://docs.microsoft.com/azure/devops/organizations/accounts/use-personal-access-tokens-to-authenticate?view=vsts) and the URL to your Azure DevOps organization. Then get a client from the connection and make API calls.
+
+```python
+from azure.devops.connection import Connection
+from msrest.authentication import BasicAuthentication
+import pprint
+
+# Fill in with your personal access token and org URL
+personal_access_token = 'YOURPAT'
+organization_url = 'https://dev.azure.com/YOURORG'
+
+# Create a connection to the org
+credentials = BasicAuthentication('', personal_access_token)
+connection = Connection(base_url=organization_url, creds=credentials)
+
+# Get a client (the "core" client provides access to projects, teams, etc)
+core_client = connection.clients.get_core_client()
+
+# Get the first page of projects
+get_projects_response = core_client.get_projects()
+index = 0
+while get_projects_response is not None:
+    for project in get_projects_response.value:
+        pprint.pprint("[" + str(index) + "] " + project.name)
+        index += 1
+    if get_projects_response.continuation_token is not None and get_projects_response.continuation_token != "":
+        # Get the next page of projects
+        get_projects_response = core_client.get_projects(continuation_token=get_projects_response.continuation_token)
+    else:
+        # All projects have been retrieved
+        get_projects_response = None
+```
+
+## API documentation
+
+This Python library provides a thin wrapper around the Azure DevOps REST APIs. See the [Azure DevOps REST API reference](https://docs.microsoft.com/en-us/rest/api/azure/devops/?view=azure-devops-rest-5.1) for details on calling different APIs.
+
+## Samples
+
+Learn how to call different APIs by viewing the samples in the [Microsoft/azure-devops-python-samples](https://github.com/Microsoft/azure-devops-python-samples) repo.
+
+## Contributing
 
 This project welcomes contributions and suggestions.  Most contributions require you to agree to a
 Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us

azure-devops/MANIFEST.in

@@ -0,0 +1 @@
+include LICENSE.txt

azure-devops/azure/devops/__init__.py

@@ -0,0 +1,6 @@
+# --------------------------------------------------------------------------------------------
+# Copyright (c) Microsoft Corporation. All rights reserved.
+# Licensed under the MIT License. See License.txt in the project root for license information.
+# --------------------------------------------------------------------------------------------
+import pkg_resources
+pkg_resources.declare_namespace(__name__)

vsts/vsts/_file_cache.py → azure-devops/azure/devops/_file_cache.py

@@ -14,6 +14,9 @@
     import collections
 
 
+logger = logging.getLogger(__name__)
+
+
 class FileCache(collections.MutableMapping):
     """A simple dict-like class that is backed by a JSON file.
 
@@ -32,21 +35,21 @@ def load(self):
         self.data = {}
         try:
             if os.path.isfile(self.file_name):
-                if self.max_age > 0 and os.stat(self.file_name).st_mtime + self.max_age < time.clock():
-                    logging.info('Cache file expired: {file}'.format(file=self.file_name))
+                if self.max_age > 0 and os.stat(self.file_name).st_mtime + self.max_age < time.time():
+                    logger.debug('Cache file expired: %s', self.file_name)
                     os.remove(self.file_name)
                 else:
-                    logging.info('Loading cache file: {file}'.format(file=self.file_name))
+                    logger.debug('Loading cache file: %s', self.file_name)
                     self.data = get_file_json(self.file_name, throw_on_empty=False) or {}
             else:
-                logging.info('Cache file does not exist: {file}'.format(file=self.file_name))
-        except Exception as e:
-            logging.exception(e)
+                logger.debug('Cache file does not exist: %s', self.file_name)
+        except Exception as ex:
+            logger.debug(ex, exc_info=True)
             # file is missing or corrupt so attempt to delete it
             try:
                 os.remove(self.file_name)
-            except Exception as e2:
-                logging.exception(e2)
+            except Exception as ex2:
+                logger.debug(ex2, exc_info=True)
         self.initial_load_occurred = True
 
     def save(self):
@@ -71,10 +74,10 @@ def save_with_retry(self, retries=5):
 
     def clear(self):
         if os.path.isfile(self.file_name):
-            logging.info("Deleting file: " + self.file_name)
+            logger.info("Deleting file: " + self.file_name)
             os.remove(self.file_name)
         else:
-            logging.info("File does not exist: " + self.file_name)
+            logger.info("File does not exist: " + self.file_name)
 
     def get(self, key, default=None):
         self._check_for_initial_load()
@@ -108,11 +111,17 @@ def _check_for_initial_load(self):
 
 
 def get_cache_dir():
-    vsts_cache_dir = os.getenv('VSTS_CACHE_DIR', None) or os.path.expanduser(os.path.join('~', '.vsts', 'python-sdk',
-                                                                                          'cache'))
-    if not os.path.exists(vsts_cache_dir):
-        os.makedirs(vsts_cache_dir)
-    return vsts_cache_dir
+    azure_devops_cache_dir = os.getenv('AZURE_DEVOPS_CACHE_DIR', None)\
+                             or os.path.expanduser(os.path.join('~', '.azure-devops', 'python-sdk', 'cache'))
+    if not os.path.exists(azure_devops_cache_dir):
+        try:
+            os.makedirs(azure_devops_cache_dir)
+        except OSError:
+            # https://github.com/microsoft/azure-devops-python-api/issues/354
+            # FileExistsError is not available in python 2.7
+            if not os.path.exists(azure_devops_cache_dir):
+                raise
+    return azure_devops_cache_dir
 
 
 DEFAULT_MAX_AGE = 3600 * 12  # 12 hours
@@ -144,12 +153,12 @@ def read_file_content(file_path, allow_binary=False):
     for encoding in ['utf-8-sig', 'utf-8', 'utf-16', 'utf-16le', 'utf-16be']:
         try:
             with codecs_open(file_path, encoding=encoding) as f:
-                logging.debug("attempting to read file %s as %s", file_path, encoding)
+                logger.debug("attempting to read file %s as %s", file_path, encoding)
                 return f.read()
         except UnicodeDecodeError:
             if allow_binary:
                 with open(file_path, 'rb') as input_file:
-                    logging.debug("attempting to read file %s as binary", file_path)
+                    logger.debug("attempting to read file %s as binary", file_path)
                     return base64.b64encode(input_file.read()).decode("utf-8")
             else:
                 raise