История

Vishrut Shah 31344d47a4 Release ms_rest_azure version 0.9.0 (#963 )		2017-09-11 11:41:40 -07:00
..
lib	Merge branch 'bug-fix' of https://github.com/vishrutshah/azure-sdk-for-ruby into bug-fix	2017-09-07 09:13:11 -07:00
spec	No need to provide authority for MSI authentication	2017-09-06 00:26:22 +00:00
.gitignore	Move client runtimes from AutoRest repo to here (#492 )	2016-10-20 11:05:05 -07:00
CHANGELOG.md	Release ms_rest_azure version 0.9.0 (#963 )	2017-09-11 11:41:40 -07:00
Gemfile	Extend user_agent_extended array to add telemetry information (#543 )	2016-11-08 17:40:36 -08:00
LICENSE.txt	Move client runtimes from AutoRest repo to here (#492 )	2016-10-20 11:05:05 -07:00
README.md	Updating version of ms_rest_azure to 0.9.0	2017-09-07 09:12:40 -07:00
Rakefile	Move client runtimes from AutoRest repo to here (#492 )	2016-10-20 11:05:05 -07:00
ms_rest_azure.gemspec	Release next version of ms_rest & ms_rest_azure gems (#819 )	2017-06-30 13:22:25 -07:00

README.md

Intro

MsRestAzure is a library which supports the Azure clients (SDKs) generated with Autorest tool. It contains core logic and helper classes for error handling and authentication. Also it includes azure specific logic like long polling functionality and Azure application authentication. Usually it is not supposed to be used as a standalone gem but only as a dependency for generated client gems.

Supported Ruby Versions

Ruby 2.0
Ruby 2.1
Ruby 2.2

Note: x64 Ruby for Windows is known to have some compatibility issues.

Installation

install the appropriate gem:

gem install ms_rest_azure

and reference it in your code:

require 'ms_rest_azure'

Running tests

MsRestAzure has only unit tests which doesn't require any preparation, just run 'rspec' command from the gem directory.

Contribution

To start working on the gem the only additional dev dependecy is required - rspec. After you've added a new feature and all specs pass - you're good to go with PR. But before starting any bug/feature - please make sure you've thoroughly discussed it with repository maintainers. This gem already powers a few SDKs and backward compatibility should taken in account.

Adding gem to you generated SDK

Reference it in the gemfile and also add this line to your client's gemspec file:

spec.add_runtime_dependency 'ms_rest_azure', '~> 0.9.0'

Don't forget to correct the version.

Utilizing MSI(Managed Service Identity) Token Provider

MSI support has been enabled in ms_rest_azure version 0.9.0. Below code snippet demonstrates how to use MSITokenProvider with default port 50342:

provider = MsRestAzure::MSITokenProvider.new()
credentials = MsRest::TokenCredentials.new(provider)

Utilizing Telemetry Extension in your SDK

We encourage the customer of ms_rest_azure library to provide information about their product sent via telemetry extension point as below:

additional_user_agent_information = 'fog-azure-rm/0.2.0' # Refer https://github.com/Azure/azure-sdk-for-ruby/issues/517 for more info.
azure_service_client.add_user_agent_information(additional_user_agent_information)

Provide feedback

Send email to the azsdkteam@microsoft.com or file new issue in this repository.