common

README

Azure AMQP Common

This project contains reusable components for AMQP based services like Event Hub and Service Bus. You will find abstractions over authentication, claims-based security, connection string parsing and RPC for AMQP.

If you are looking for the Azure Event Hub library for go, you can find it here.

If you are looking for the Azure Service Bus library for go, you can find it here.

Install with Go modules

If you want to use stable versions of the library, please use Go modules.

NOTE: versions prior to 3.0.0 depend on pack.ag/amqp which is no longer maintained. Any new code should not use versions prior to 3.0.0.

Using go get targeting version 3.x.x

go get -u github.com/Azure/azure-amqp-common-go/v3

Using go get targeting version 2.x.x

go get -u github.com/Azure/azure-amqp-common-go/v2

Using go get targeting version 1.x.x

go get -u github.com/Azure/azure-amqp-common-go

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.

License

MIT, see LICENSE.

Contribute

See CONTRIBUTING.md.

Documentation

Index

• func PtrBool(toPtr bool) *bool
• func PtrInt32(number int32) *int32
• func PtrInt64(number int64) *int64
• func PtrString(toPtr string) *string
• func Retry(times int, delay time.Duration, action func() (interface{}, error)) (interface{}, error)
• type Retryable
  • func (r Retryable) Error() string

Functions

func PtrBool

func PtrBool(toPtr bool) *bool

PtrBool takes a boolean and returns a pointer to that bool. For use in literal pointers, ptrBool(true) -> *bool

func PtrInt32

func PtrInt32(number int32) *int32

PtrInt32 takes a int32 and returns a pointer to that int32. For use in literal pointers, ptrInt32(1) -> *int32

func PtrInt64

func PtrInt64(number int64) *int64

PtrInt64 takes a int64 and returns a pointer to that int64. For use in literal pointers, ptrInt64(1) -> *int64

func PtrString

func PtrString(toPtr string) *string

PtrString takes a string and returns a pointer to that string. For use in literal pointers, PtrString(fmt.Sprintf("..", foo)) -> *string

func Retry

func Retry(times int, delay time.Duration, action func() (interface{}, error)) (interface{}, error)

Retry will attempt to retry an action a number of times if the action returns a retryable error

Types

type Retryable

type Retryable string

Retryable represents an error which should be able to be retried

func (Retryable) Error

func (r Retryable) Error() string

Error implementation for Retryable