azure-functions-devops-build/README.md

Azure Devops Build Manager For Azure Functions

This project provides the class AzureDevopsBuildManager and supporting classes. This manager class allows the caller to manage Azure Devops pipelines that are maintained within an Azure Devops account. This project was created to be able to support command line tooling for the AZ Cli.

Install

To install the package from pip:

pip install azure-functions-devops-build

Get started

To use the API, you need to first establish a connection to azure by loging into your azure account using az login. You can then follow the example as below. Firstly we get the token from login and use this to authenticate the different python function calls.

from azure.cli.core import get_default_cli
from azure.cli.core._profile import Profile
from azure_functions_devops_build.organization.organization_manager import OrganizationManager
import pprint

# Get your token from the az login cache
cli_ctx = get_default_cli()
profile = Profile(cli_ctx=cli_ctx)
creds, _, _ = profile.get_login_credentials(subscription_id=None)

# Create an organization manager using your credentials
organization_manager = OrganizationManager(creds=creds)

# Get the list of organizations for your user
organizations = organization_manager.list_organizations()

# Show details about each organization in the console
for organization in organizations.value:
    pprint.pprint(organization.__dict__)

API documentation

This Python library extensively uses the Azure DevOps REST APIs and Azure Devops Python API. See the Azure DevOps REST API reference for details on calling different APIs and Azure DevOps Python SDK for details on the azure-devops-python-api.

Samples

See samples by looking at tests or viewing the az-cli functionapp devops-build module.

Testing

Several things need to be setup before you can run the tests:

1. Signed into the az cli. You can do this by using az login.
2. Since this directly deploys to azure functions, create an azure functions functionapp using the azure portal. You need to make a functionapp for these tests to successfully run and make sure you record the details of the subscription name, project name, application type and storage name.
3. Follow the tests/_config_example.py file, create a tests/_config.py with your own testing environment.
4. Run the full test suite using python -m tests.suite
5. To run specific manager tests run python -m tests.{NAME_OF_MANAGER} eg. python -m tests.test_builder_manager

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 the rights to use your contribution. For details, visit https://cla.microsoft.com.

When you submit a pull request, a CLA-bot will automatically determine whether you need to provide a CLA and decorate the PR appropriately (e.g., label, comment). Simply follow the instructions provided by the bot. You will only need to do this once across all repos using our CLA.

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.