160 feature c bindings and semantic kernel integration

[alexbarev]

@ashvardanian, I've submitted a new pull request and released a NuGet package on the test servers.

Changes

• Added three .yml workflows: libs-build.yml, csharp-release.yml, and csharp-build-and-test.yml. All workflows ran successfully prior to merging changes from main-dev. See notes below.
• Updated the update_version.sh to modify the C# project version.
• Renamed projects within the code.

Notes

• The new NuGet package is available for testing at https://int.nugettest.org/packages/USearch.NET
• I've marked future changes for production as TODOs in the .yml files.

Issues

• There's an issue with the C# tests failing across all platforms for libraries built from main-dev. The errors stem from the USearch libraries. Interestingly, some tests do pass on Windows. Everything works fine when using older versions from early August (>=1.0.0). Updated: The usearch.h API has changed. I'll update the code soon.

Next Steps:

• Add support for custom metrics.
• Create a script for building the USearch library on Windows.

Should we also consider adding tests for x86 architectures, or focus mainly on x64?"

Let me know your thoughts.

[ashvardanian]

@AleksandrKent, we generally prefer fewer actions, as GitHub is a little slow in running them. Can we consolidate everything into release.yml and prerelease.yml? Have you tried uploading the NuGet package to the GitHub registry like we do with Maven? Is there a difference from users perspective?

[alexbarev]

@ashvardanian

New Changes:

1. Moved 'Build and Test' jobs in the prerelease.yml.
2. Moved a 'Push to NuGet' jobs in the releases.yml.
3. Verified the workflow locally.
4. For additional changes, see the commit messages.

Notes:

• Current package version on NuGet test server https://int.nugettest.org/packages/USearch.NET
• The version is manually read from the VERSION file.
• The NUGET_APIKEY secret must be set.
• Publish to NuGet job will fail if there is already package with the same version. To ignore this --skip-duplicate arg can be provided to dotnet command in future.
• There is also an option to reserve a prefix (for instance, USearch.*) to protect identity on nuget.org https://learn.microsoft.com/en-us/nuget/nuget-org/id-prefix-reservation?WT.mc_id=DT-MVP-5003978 . Tell me if I should try to do it.
• I added README.md with examples for quickstart. And DEV_SETUP.md with notes for dev purposes.

Regarding GitHub Package Registry: Publishing to the GitHub Package Registry is an option. However, this source is not the default for the dotnet nuget command. Users would need to manually add this source to their projects. Additionally, the package won't appear on nuget.org.

We could publish to both NuGet and GitHub if it serves project needs. I haven't checked out the Maven yet. I'll look into possible ways of connecting NuGet and GitHub Registry later.

[alexbarev]

@ashvardanian, I've rebased the pull request to include dluc's changes and have merged the latest updates from main-dev. I've verified that the jobs related to C# run successfully on both the release and prerelease worfklows.

• In prerelease.yml, I added a test_csharp job that builds and tests the C# project.
• In release.yml, there are two jobs: 1) build_usearch_libs, which produces an artifact of the built usearch libraries. 2) publish_csharp, which depends on the previous step. It downloads the artifact and publishes it to https://api.nuget.org/v3/index.json using GitHub secrets named NUGET_APIKEY.

Although I updated update_version.sh to edit C# project files to update version, in jobs I just grab version from VERSION file in the repository root. That is because I did not find out when update_version.sh executes.

Here's how the package looks now on the test NuGet server: https://int.nugettest.org/packages/Cloud.Unum.USearch

There is also instruction on local build, test and publish NuGet package.

[ashvardanian]

:tada: This PR is included in version 2.0.0 :tada:

The release is available on GitHub release

Your semantic-release bot :package::rocket: