Skip to content

{Core} Use semver for azure-mgmt-core#16074

Merged
jiasli merged 2 commits intoAzure:devfrom
jonringer:patch-1
Jan 20, 2021
Merged

{Core} Use semver for azure-mgmt-core#16074
jiasli merged 2 commits intoAzure:devfrom
jonringer:patch-1

Conversation

@jonringer
Copy link
Contributor

@jonringer jonringer commented Nov 28, 2020

Description
Trying to package this for nixpkgs, but I get:

ERROR: No matching distribution found for azure-mgmt-core==1.2.1 (from azure-cli-core==2.15.1)

when it's being given 1.2.2

Azure-sdk generally follows semver, so no need to pin.

Testing Guide

History Notes


This checklist is used to make sure that common guidelines for a pull request are followed.

Azure-sdk generally follows semver. No need to pin.
@ghost ghost added the customer-reported Issues that are reported by GitHub users external to the Azure organization. label Nov 28, 2020
@ghost
Copy link

ghost commented Nov 28, 2020

Thank you for your contribution jonringer! We will review the pull request and get back to you soon.

@jonringer jonringer mentioned this pull request Nov 28, 2020
10 tasks
@yonzhan yonzhan added this to the S180 milestone Nov 29, 2020
@yonzhan
Copy link
Collaborator

yonzhan commented Nov 29, 2020

Core

'requests~=2.22',
'six~=1.12',
'pkginfo>=1.5.0.1',
'azure-mgmt-core==1.2.1',
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

azure-mgmt-core was pinned by #15780. @jsntcy, is it necessary that we should pin it?

We does deliver azure-mgmt-core at https://pypi.org/project/azure-mgmt-core/1.2.1/. nixpkgs is not one of our supported delivery platform. @fengzhou-msft

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The Azure SDKs are in the transition of track 1 to track 2, there may be unexpected breaking changes. To play safe, we pinned the version for the transition period and a version bump even with the micro version needs full live tests.

Azure CLI relies on too many Azure SDKs and third-party dependencies, it is strongly recommended to use the all-in-one platform packages or install the wheel package in an isolated python environment.

Copy link
Contributor Author

@jonringer jonringer Nov 30, 2020

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

nixpkgs is not one of our supported delivery platform.

Yes, I maintain azure-cli for nixpkgs / NixOS.

The Azure SDKs are in the transition of track 1 to track 2, there may be unexpected breaking changes. To play safe, we pinned the version for the transition period and a version bump even with the micro version needs full live tests.

This should only be done if there's breaking changes between patch versions. Azure sdk doesn't.

it is strongly recommended to use the all-in-one platform packages or install the wheel package in an isolated python environment.

This is what I'm providing for nixpkgs. I already applied the correct patch NixOS/nixpkgs@d03b3c4, I'm just upstreaming the changes so that other azure-cli users can benefit from better dependency management.

To play safe, we pinned the version for the transition period and a version bump even with the micro version needs full live tests.

What I'm referring to is https://github.com/Azure/azure-sdk-for-python/blob/master/doc/dev/mgmt/mgmt_release.md#version in which python sdk is guaranteeing not to break downstream packages until the next the next major bump

cc @lmazuel , I no longer work at msft

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

What I'm referring to is https://github.com/Azure/azure-sdk-for-python/blob/master/doc/dev/mgmt/mgmt_release.md#version in which python sdk is guaranteeing not to break downstream packages until the next the next major bump

It's supposed to be, but not always true when developers are not aware of the breaking changes especially with Track 2 adoption. Add @jsntcy who works with this SDK to evaulate if we're confident to follow semver at this stage.

@jiasli
Copy link
Member

jiasli commented Dec 7, 2020

/azp run

@azure-pipelines
Copy link

Azure Pipelines successfully started running 2 pipeline(s).

'six~=1.12',
'pkginfo>=1.5.0.1',
'azure-mgmt-core==1.2.1',
'azure-mgmt-core~=1.2',
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We can at least use azure-mgmt-core~=1.2.1 to get our users unblocked.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@jiasli jiasli self-assigned this Jan 5, 2021
Copy link
Collaborator

@yonzhan yonzhan left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

@yonzhan yonzhan modified the milestones: S181, S182 Jan 16, 2021
@jiasli jiasli merged commit b1c58d6 into Azure:dev Jan 20, 2021
@jonringer jonringer deleted the patch-1 branch January 20, 2021 07:29
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

customer-reported Issues that are reported by GitHub users external to the Azure organization.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants