Skip to content

NetApp SDK initial version#5094

Merged
dsgouda merged 4 commits intoAzure:psSdkJson6from
leonardbf:psSdkJson6
Jan 4, 2019
Merged

NetApp SDK initial version#5094
dsgouda merged 4 commits intoAzure:psSdkJson6from
leonardbf:psSdkJson6

Conversation

@leonardbf
Copy link
Copy Markdown
Contributor

@leonardbf leonardbf commented Dec 16, 2018

From new swagger spec Azure/azure-rest-api-specs#4891
(NetApp internal ticket NFSAAS-1504)

Description


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

General Guidelines

  • Title of the pull request is clear and informative.
  • There are a small number of commits, each of which have an informative message. This means that previously merged commits do not appear in the history of the PR. For more information on cleaning up the commits in your PR, see this page.

Testing Guidelines

  • Pull request includes test coverage for the included changes.

SDK Generation Guidelines

  • If an SDK is being regenerated based on a new swagger spec, a link to the pull request containing these swagger spec changes has been included above.
  • The generate.cmd file for the SDK has been updated with the version of AutoRest, as well as the commitid of your swagger spec or link to the swagger spec, used to generate the code.
  • The *.csproj and AssemblyInfo.cs files have been updated with the new version of the SDK.

Copy link
Copy Markdown
Contributor

@shahabhijeet shahabhijeet left a comment

Choose a reason for hiding this comment

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

@leonardbf you are releasing your first SDK + your swagger is still in preview.
Please make changes as suggested to publish your SDK in preview.
Please use the generate.ps1 to generate your SDK.
If you use generate.ps1, it creates the appropriate meta data that is required for the SDK.

<Description>Provides NetApp storage management capabilities for Microsoft Azure.</Description>
<AssemblyTitle>Microsoft Azure NetApp Management</AssemblyTitle>
<AssemblyName>Microsoft.Azure.Management.NetApp</AssemblyName>
<Version>1.0.0</Version>
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

@leonardbf if you are going as your v1, I recommend you go as preview and mark your version as 0.9.0-preview

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

ok, changed to 0.9.0-preview.

<PackageTags>MicrosoftAzure Management;NetApp</PackageTags>
<PackageReleaseNotes>
<![CDATA[
* Initial version
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

@leonardbf if this is your first version, please provide any links to your service or provide a description what this SDK will allow customers to do.
This is your first version that will let developers know what this service is about and what can be done with it.
If you have links to samples, provide that also.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

ok, description added, including some examples. Note that a more formal description is pending anyway.

<PropertyGroup>
<TargetFrameworks>net452;netstandard1.4</TargetFrameworks>
</PropertyGroup>
<ItemGroup Condition="'$(TargetFramework)' == 'net452'">
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

@leonardbf remove line 22 - 33

{
return new Tuple<string, string, string>[]
{
new Tuple<string, string, string>("NetApp", "Accounts", "2017-08-15"),
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

@leonardbf why your API version is not tagged appropriately.
I see the swagger is inside a preview directory, but the API itself is marked as stable.
Please clarify if your service is preview or is it stable?

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

The API is being made public but at this time is still subject to more change than will be expected later. Therefore prefer to leave as preview for now.

[assembly: AssemblyCulture("")]
[assembly: NeutralResourcesLanguage("en")]

[assembly: AssemblyVersion("1.0.0.0")]
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Please update the version number here too

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Done.

<!-- Please do not move/edit code below this line -->
<Import Condition=" Exists('$([MSBuild]::GetPathOfFileAbove(AzSdk.RP.props))') " Project="$([MSBuild]::GetPathOfFileAbove('AzSdk.RP.props'))" />
<!-- Please do not move/edit code above this line -->
</Project>
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

nit: remove trailing lines

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Done.

<PropertyGroup>
<PackageId>NetApp.Tests</PackageId>
<Description>NetApp.Tests Class Library</Description>
<VersionPrefix>1.0.0</VersionPrefix>
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Replace VersionPrefix with Version

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Done.

<Description>NetApp.Tests Class Library</Description>
<VersionPrefix>1.0.0</VersionPrefix>
<Authors>Microsoft Corporation</Authors>
<AssemblyName>NetApp.Tests</AssemblyName>
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Please add <TreatWarningsAsErrors>true</TreatWarningsAsErrors> here and fix all errors

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Done.

netAppMgmtClient.Accounts.CreateOrUpdate(netAppAccount, ResourceUtils.resourceGroup, ResourceUtils.accountName1);
Assert.True(false);
}
catch (Exception ex)
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Consider using Assert.Exception here

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

This was actually already considered but was unavailable. Leaving as is.

With review corrections.
Copy link
Copy Markdown
Contributor

@dsgouda dsgouda left a comment

Choose a reason for hiding this comment

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

LGTM

Copy link
Copy Markdown
Contributor

@dsgouda dsgouda left a comment

Choose a reason for hiding this comment

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

Looks good apart from a minor comment. Please address it in a later commit,

<PackageId>NetApp.Tests</PackageId>
<Description>NetApp.Tests Class Library</Description>
<AssemblyName>NetApp.Tests</AssemblyName>
<Version>1.0.0-preview</Version>
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

nit: Test projects must always be versioned as 1.0.0

@dsgouda dsgouda merged commit 3328ef7 into Azure:psSdkJson6 Jan 4, 2019
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants