isabella232 / dotnet-eventsource

Server-sent events (SSE) client implementation for .NET

.NET EventSource implementation

Project Information

This libary allows .NET developers to consume Server Sent Events from a remote API. The server sent events spec is defined here: https://html.spec.whatwg.org/multipage/server-sent-events.html

This library supports .NET 4.5+ and .NET Standard 1.4+.

Quick setup

Nuget Restore

1. If you have nuget package restore automatically enabled, Visual Studio will attempt to restore the nuget packages upon opening the LaunchDarkly.EventSource.sln
2. Otherwise, after you open LaunchDarkly.EventSource.sln, Right+Click on the solution and select "Restore NuGet Packages"

Build Solution

1. In Visual Studio, Build the LaunchDarkly.EventSource.sln solution

Usage Included are tests which show example usage for using the LaunchDarkly EventSource library (specifically, LaunchDarkly.EventSource.Tests.EventSourceTests).

Signing

The published version of this assembly is digitally signed by LaunchDarkly and strong-named. Building the code locally in the default Debug configuration does not sign the assembly and does not require a key file. The public key file is in this repo at LaunchDarkly.EventSource.pk as well as here:

Public key (hash algorithm: sha1):
002400000480000094000000060200000024000052534131000400000100010015ba095c5a95ac
efa557867cec3f488906ec0ef6fe6728a7cfdeef861fcce49ea79357ba825d95d56d67597bc9cc
9a473438f5607908186fc477fdeafc68f387552061ebf57d6e585317d5047a57bd496034ff854a
417236776003bcba328fa8bf4a024c4d212ba4fb4033ebfb14116c12cde63d16551b9f48c20ee5
4a417deb

Public key token is 18e8c36453e3060f

Development notes

This project imports the dotnet-base repository as a subtree. See the README.md file in that directory for more information.

Releases are done using the release script in dotnet-base. Since the published package includes a .NET Framework 4.5 build, the release must be done from Windows.

About LaunchDarkly

• LaunchDarkly is a continuous delivery platform that provides feature flags as a service and allows developers to iterate quickly and safely. We allow you to easily flag your features and manage them from the LaunchDarkly dashboard. With LaunchDarkly, you can:
  • Roll out a new feature to a subset of your users (like a group of users who opt-in to a beta tester group), gathering feedback and bug reports from real-world use cases.
  • Gradually roll out a feature to an increasing percentage of users, and track the effect that the feature has on key metrics (for instance, how likely is a user to complete a purchase if they have feature A versus feature B?).
  • Turn off a feature that you realize is causing performance problems in production, without needing to re-deploy, or even restart the application with a changed configuration file.
  • Grant access to certain features based on user attributes, like payment plan (eg: users on the ‘gold’ plan get access to more features than users in the ‘silver’ plan). Disable parts of your application to facilitate maintenance, without taking everything offline.
• LaunchDarkly provides feature flag SDKs for
  • Java
  • JavaScript
  • PHP
  • Python
  • Go
  • Node.JS
  • Electron
  • .NET
  • Ruby
  • iOS
  • Android
• Explore LaunchDarkly
  • launchdarkly.com for more information
  • docs.launchdarkly.com for our documentation and SDKs
  • apidocs.launchdarkly.com for our API documentation
  • blog.launchdarkly.com for the latest product updates
  • Feature Flagging Guide for best practices and strategies