chore(main): release 1.4.0

[github-actions]

🤖 I have created a release beep boop

1.4.0 (2024-01-23)

🐛 Bug Fixes

• Fix ArgumentOutOfRangeException for empty hooks (#187) (950775b)
• More robust shutdown/cleanup/reset (#188) (a790f78)
• Remove upper-bound version constraint from SCI (#171) (8f8b661)

✨ New Features

• Add dx to catch ConfigureAwait(false) (#152) (9c42d4a)
• add support for eventing (#166) (f5fc1dd)
• Add support for provider shutdown and status. (#158) (24c3441)

🧹 Chore

• Add GitHub Actions logger for CI (#174) (c1a189a)
• add placeholder eventing and shutdown sections (#156) (5dfea29)
• Add support for GitHub Packages (#173) (26cd5cd)
• Adding sealed keyword to classes (#191) (1a14f6c)
• deps: update actions/checkout action to v4 (#144) (90d9d02)
• deps: update actions/setup-dotnet action to v4 (#162) (0b0bb10)
• deps: update dependency dotnet-sdk to v7.0.404 (#148) (e8ca1da)
• deps: update github/codeql-action action to v3 (#163) (c85e93e)
• fix alt text for NuGet on the readme (2cbdba8)
• Fix FieldCanBeMadeReadOnly (#183) (18a092a)
• Fix props to support more than one project (#177) (f47cf07)
• minor formatting cleanup (#168) (d0c25af)
• Reduce dependency on MEL -> MELA (#176) (a6062fe)
• remove duplicate eventing section in readme (1efe09d)
• remove test sleeps, fix flaky test (#194) (f2b9b03)
• revert breaking setProvider (#190) (2919c2f)
• update spec release link (a2f70eb)
• updated readme for inclusion in the docs (6516866)

📚 Documentation

• Add README.md to the nuget package (#164) (b6b0ee2)
• fixed the contrib url on the readme (9d8939e)
• remove duplicate a tag from readme (2687cf0)
• update README.md (#155) (b62e21f)

🔄 Refactoring

• Add TFMs for net{6,7,8}.0 (#172) (cf2baa8)

---

This PR was generated with Release Please. See documentation.

[toddbaert]

If possible, we should release this along with events. This isn't necessary though.

[toddbaert]

@austindrenski This release is substantial, particularly it adds events and init / shutdown. Unfortunately along with your recent changes, there's also a breaking change, though absorbing it should be fairly straightforward.

[lukas-reining]

I think modifying the signatures to include the cancellation and have the "Async" suffix makes sense, and I do like that it will look more like the .NET standard library, but this is a change that will break every existing provider. If we are going to do this as a breaking change, 2.0 is probably the time.

I think so too, and now might be a good moment to do it.
Cancellation tokens and idiomatic naming makes it feel better to me, and having no cancelation tokens could otherwise even be problematic.

[beeme1mr]

Another thing to consider is that a provider will need to be updated to leverage events, init, and shutdown. If we think this is a good change, I think now is the time to include it.

[toddbaert]

What do you folks think about this?

This PR makes the breaking change here non breaking, by adding a new method instead. This means our pending release will no longer be breaking.

This will allow us to release all the pending .NET work, without merging #184. I like the idea of #184, but I think I'd like us all to take some time to discuss exactly what we expect the cancellationToken to do in all circumstances (what should the SDK do on SDK methods like init()/shutdown()?, and what should providers do?).

I think buys us some without sacrificing too much, and we can release a 2.0.0 in the coming weeks.

Interested to hear the opinion of others.

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Comparison is base (2919c2f) 93.50% compared to head (8d0660b) 93.50%.

Additional details and impacted files

@@           Coverage Diff           @@
##             main     open-feature/dotnet-sdk-contrib#154   +/-   ##
=======================================
  Coverage   93.50%   93.50%           
=======================================
  Files          23       23           
  Lines         954      954           
  Branches      105      105           
=======================================
  Hits          892      892           
  Misses         38       38           
  Partials       24       24           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

[toddbaert]

I've amended this: 2.0.0 to 1.4.0, and remove the breaking change section, since we reverted that.

[github-actions]

🤖 Release is at https://github.com/open-feature/dotnet-sdk/releases/tag/v1.4.0 🌻