The C based gRPC (C++, Python, Ruby, Objective-C, PHP, C#) https://grpc.io/
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
 
Jan Tattermusch 1a47fd02f6 lazy initialize streamingResponseCallFinishedTcs 8 years ago
..
Grpc.Auth provide framework independent version of Task.CompletedTask 8 years ago
Grpc.Core lazy initialize streamingResponseCallFinishedTcs 8 years ago
Grpc.Core.Tests add copyrights for AssemblyInfo.cs files 9 years ago
Grpc.Examples regenerate C# protos 8 years ago
Grpc.Examples.MathClient add copyrights for AssemblyInfo.cs files 9 years ago
Grpc.Examples.MathServer add copyrights for AssemblyInfo.cs files 9 years ago
Grpc.Examples.Tests add copyrights for AssemblyInfo.cs files 9 years ago
Grpc.HealthCheck regenerate C# protos 8 years ago
Grpc.HealthCheck.Tests add copyrights for AssemblyInfo.cs files 9 years ago
Grpc.IntegrationTesting Merge pull request #8453 from jtattermusch/csharp_task_utils 8 years ago
Grpc.IntegrationTesting.Client add copyrights for AssemblyInfo.cs files 9 years ago
Grpc.IntegrationTesting.QpsWorker use Server mode for GC in C# QpsWorker 8 years ago
Grpc.IntegrationTesting.Server add copyrights for AssemblyInfo.cs files 9 years ago
Grpc.IntegrationTesting.StressClient add copyrights for AssemblyInfo.cs files 9 years ago
doc polishing public docs 10 years ago
ext introduce separate grpcsharp_request_call_context 8 years ago
keys include assembly signing key in the repo 9 years ago
.gitignore add support for CoreCLR 9 years ago
Grpc.Dotnet.sln improve project.json files 9 years ago
Grpc.Tools.nuspec change back slashes to forward slashes in grpc.tool nuspec 8 years ago
Grpc.nuspec pick up nuget package version from cmdline param and fix nuget build 10 years ago
Grpc.sln Add C# stress test client 9 years ago
README.md Update README.md 8 years ago
Settings.StyleCop Setting up stylecop to ignore generated files and fixing style 10 years ago
build_packages.bat switch distribtests to use nugets generated by dotnet cli 9 years ago
build_packages_dotnetcli.sh regenerate C# related files after backporting from master 9 years ago
buildall.bat add missing copyrights to .bat files 9 years ago
generate_proto_csharp.sh Add C# stress test client 9 years ago
tests.json add appdomain unload test 9 years ago

README.md

Nuget gRPC C#

A C# implementation of gRPC.

SUPPORTED PLATFORMS

  • .NET Framework 4.5+ (Windows)
  • .NET Core on Linux, Windows and Mac OS X (starting from version 1.0.1)
  • Mono 4+ on Linux, Windows and Mac OS X

PREREQUISITES

  • Windows: .NET Framework 4.5+, Visual Studio 2013 or 2015
  • Linux: Mono 4+, MonoDevelop 5.9+ (with NuGet add-in installed)
  • Mac OS X: Xamarin Studio 5.9+

HOW TO USE

Windows, Linux, Mac OS X

  • Open Visual Studio / MonoDevelop / Xamarin Studio and start a new project/solution.

  • Add the Grpc NuGet package as a dependency (Project options -> Manage NuGet Packages).

  • To be able to generate code from Protocol Buffer (.proto) file definitions, add the Grpc.Tools NuGet package that contains Protocol Buffers compiler (protoc) and the gRPC protoc plugin.

BUILD FROM SOURCE

You only need to go through these steps if you are planning to develop gRPC C#. If you are a user of gRPC C#, go to Usage section above.

Windows

  • The grpc_csharp_ext native library needs to be built so you can build the gRPC C# solution. Open the solution vsprojects/grpc_csharp_ext.sln in Visual Studio and build it.

  • Open src\csharp\Grpc.sln (path is relative to gRPC repository root) using Visual Studio

Linux and Mac OS X

  • The grpc_csharp_ext native library needs to be built so you can build the gRPC C# solution:

    # from the gRPC repository root
    $ tools/run_tests/run_tests.py -c dbg -l csharp --build_only
    
  • Use MonoDevelop / Xamarin Studio to open the solution Grpc.sln

RUNNING TESTS

gRPC C# is using NUnit as the testing framework.

Under Visual Studio, make sure NUnit test adapter is installed (under "Extensions and Updates"). Then you should be able to run all the tests using Test Explorer.

Under Monodevelop or Xamarin Studio, make sure you installed "NUnit support" in Add-in manager. Then you should be able to run all the test from the Test View.

gRPC team uses a Python script to simplify facilitate running tests for different languages.

tools/run_tests/run_tests.py -l csharp

DOCUMENTATION

CONTENTS

  • ext: The extension library that wraps C API to be more digestible by C#.
  • Grpc.Auth: gRPC OAuth2/JWT support.
  • Grpc.Core: The main gRPC C# library.
  • Grpc.Examples: API examples for math.proto
  • Grpc.Examples.MathClient: An example client that sends requests to math server.
  • Grpc.Examples.MathServer: An example server that implements a simple math service.
  • Grpc.IntegrationTesting: Cross-language gRPC implementation testing (interop testing).

THE NATIVE DEPENDENCY

Internally, gRPC C# uses a native library written in C (gRPC C core) and invokes its functionality via P/Invoke. The fact that a native library is used should be fully transparent to the users and just installing the Grpc.Core NuGet package is the only step needed to use gRPC C# on all supported platforms.