[event-hubs] Review samples from other languages, find gaps

Core samples (apparently):

• Sending using a batch (bare-minimum)
  • Java
  • JavaScript
  • .NET
  • Python
• Streaming send (ie, add messages to batch, handle overflow, loop through and send)
  • Java
  • JavaScript
  • .NET
  • Python
• Limited batch size
  • Java
  • JavaScript
  • .NET
  • Python
• Produce to a single partition
  • Java
  • JavaScript
  • .NET
  • Python
• Produce with a partition key
  • Java
  • JavaScript
  • .NET
  • Python
• Retry options
  • Java
  • JavaScript
  • .NET
  • Python
• WebSockets
  • Java
  • JavaScript
  • .NET
  • Python
• Publish with custom data
  • Java
  • JavaScript
  • .NET
  • Python
• Start from a custom position (sequence numbers)
  • Java
  • JavaScript
  • .NET
  • Python
• Start from a custom position (latest/earliest)
  • Java
  • JavaScript
  • .NET
  • Python
• Demonstration on how to write your own CheckpointStore
  • Java (just by having InMemoryCheckpointStore in the samples folder)
  • JavaScript
  • .NET (concept does not apply)
  • Python
• Authenticate using an Azure Identity (such as client secret)
  • Java
  • JavaScript
  • .NET
  • Python
• Basic Checkpointing while processing
  • Java
  • JavaScript
  • .NET
  • Python
• Initialize a partition using Event Processor
  • Java
  • JavaScript
  • .NET
  • Python
• Track when a partition is closed
  • Java
  • JavaScript
  • .NET
  • Python
• Process events by batch using Event Processor
  • Java
  • JavaScript
  • .NET
  • Python

Inconsistencies:

• Samples are all using different batch sizes and I think they’re all arbitrary. I’ve seen some sized at 10000, some sized at 150, etc…
• Sample file names aren’t consistent across languages which would have made this review more obvious and easier. Java’s are named ConsumeXYZ, Python is recv, ours is receive, .NET is using a numbering scheme.
• .NET’s sample are very detailed about why things happen, etc… This does bring up that we’re all inconsistent in our comments about how we explain concepts.

Links:

.NET

• https://github.com/Azure/azure-sdk-for-net/tree/master/sdk/eventhub/Azure.Messaging.EventHubs/samples
• https://github.com/Azure/azure-sdk-for-net/tree/master/sdk/eventhub/Azure.Messaging.EventHubs.Processor/samples

Java

• https://github.com/Azure/azure-sdk-for-java/blob/master/sdk/eventhubs/azure-messaging-eventhubs/src/samples/README.md
• https://github.com/Azure/azure-sdk-for-java/blob/master/sdk/eventhubs/azure-messaging-eventhubs-checkpointstore-blob/src/samples/README.md

Javascript

• https://github.com/Azure/azure-sdk-for-js/tree/master/sdk/eventhub/event-hubs/samples

Python

• https://github.com/Azure/azure-sdk-for-python/tree/master/sdk/eventhub/azure-eventhub/samples

[jsquire]

The filenames for .NET are outlined in our guidelines. We’re required to use the “SampleXX_Scenario” scheme.

[jsquire]

You’re right @jsquire, I’m not sure why I didn’t see those. No excuse except that after awhile of reviewing samples your mind tends to wander… (stares off into distance)

No worries. Always easier to critique than do the initial legwork. 😄

Do you mind editing the issue and adding in ones you think are critical and shared?

Done; though I took the lazy route of adding them without looking across the other languages.