dapr
/
dotnet-sdk
mirror of https://github.com/dapr/dotnet-sdk.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
Dapr SDK for .NET
335 Commits 92 Branches 81 Tags 10 MiB
C# 99.9%
Go to file
Ryan Nowak 0aab615202
Add better test reporting (#591) 
Our experience right now is pretty bad when tests fail, you get a
generic `failed with exit code 1`.

This change adds more full-featured integration with GitHub Actions as
well as fixes a few minor issues:

- We were missing the codecov package on one project
- Updates to test SDK
- Annotations on failing tests
- Each test project as its own status check
- Separating a parallelizing steps of the build

Co-authored-by: vinayada1 <28875764+vinayada1@users.noreply.github.com>
 		2021-02-19 17:02:49 -08:00
.github Add better test reporting (#591) 2021-02-19 17:02:49 -08:00
docs Merge into release (#565) 2021-01-27 14:46:35 -08:00
properties Fix pattern for tests that use HttpClient (#589) 2021-02-16 10:09:34 -08:00
samples fixes for getting the samples to work (#570) 2021-01-29 18:40:23 -08:00
src Fix pattern for tests that use HttpClient (#589) 2021-02-16 10:09:34 -08:00
test Add better test reporting (#591) 2021-02-19 17:02:49 -08:00
.codecov.yml Added codecov integration (#436) 2020-10-19 19:06:21 -07:00
.editorconfig git gui, ading editor config and removing depenency on StyleCop.Analyzers (#228) 2020-02-18 13:21:12 -08:00
.gitignore Add better test reporting (#591) 2021-02-19 17:02:49 -08:00
CODEOWNERS Create CODEOWNERS 2020-09-25 14:28:32 -07:00
CONTRIBUTING.md Update Dapr docs links 2020-10-23 11:32:11 -07:00
LICENSE Updating license to MIT in all .cs files. (#81) 2019-10-08 14:54:46 -07:00
README.md Merge into release (#565) 2021-01-27 14:46:35 -08:00
all.sln Resurrecting Secret Store Configuration Provider (#465) 2020-12-07 10:43:45 -08:00
global.json Merge into release (#565) 2021-01-27 14:46:35 -08:00

README.md

Dapr SDK for .NET

Dapr is a portable, event-driven, serverless runtime for building distributed applications across cloud and edge.

Build Status Gitter codecov License: MIT

Dapr SDK for .NET allows you to implement the Virtual Actor model, based on the actor design pattern. This SDK can run locally, in a container and in any distributed systems environment.

This repo builds the following packages:

  • Dapr.Client
  • Dapr.AspNetCore
  • Dapr.Actors
  • Dapr.Actors.AspNetCore
  • Dapr.Extensions.Configuration

Getting Started

Prerequesites

Each project is a normal C# project. At minimum, you need .NET Core SDK 5.0 to build, test, and generate NuGet packages.

macOS/Linux:

On macOS or Linux we recommend Visual Studio Code with the C# Extension. See here for a getting started guide for VS Code and .NET.

Windows:

On Windows, we recommend installing the latest Visual Studio 2019 which will set you up with all the .NET build tools and allow you to open the solution files. Community Edition is free and can be used to build everything here.

Make sure you update Visual Studio to the most recent release.

Build

To build everything and generate NuGet packages, run dotnet cli commands. Binaries and NuGet packages will be dropped in a bin directory at the repo root.

# Build sdk, samples and tests.
dotnet build -c Debug  # for release, -c Release

# Run unit-test
dotnet test

# Generate nuget packages in /bin/Debug/nugets
dotnet pack

Each project can also be built individually directly through the CLI or your editor/IDE. You can open the solution file all.sln in repo root to load all sdk, samples and test projects.

Releases

We publish nuget packages to nuget.org for each release.

Using nugets built locally in your project

<RepoRoot> is the path where you cloned this repository. Nuget packages are dropped under /bin/<Debug|Release>/nugets when you build locally.

Examples:

# Add Dapr.Actors nuget package
dotnet add package Dapr.Actors -s <RepoRoot>/bin/<Debug|Release>/nugets

# Add Dapr.Actors.AspNetCore nuget package
dotnet add package Dapr.Actors.AspNetCore -s <RepoRoot>/bin/<Debug|Release>/nugets

Documentation

These articles will help get you started with Dapr runtime and Dapr Actors: