An "alpha" version of a generated .NET SDK in C# from GitHub's OpenAPI spec, built on Kiota. View on NuGet.
To install the package, you can use either of the following options:
GitHub.Octokit.SDK
, orInstall-Package GitHub.Octokit.SDK
into the Package Manager Console, ordotnet add ./path/to/myproject.csproj package GitHub.Octokit.SDK
in a terminal (replace ./path/to/myproject.csproj
by the path to the *.csproj file you want to add the dependency)using GitHub;
using GitHub.Octokit.Client;
using GitHub.Octokit.Client.Authentication;
var token = Environment.GetEnvironmentVariable("GITHUB_TOKEN") ?? "";
var request = RequestAdapter.Create(new TokenAuthProvider(new TokenProvider(token)));
var gitHubClient = new GitHubClient(request);
var pullRequests = await gitHubClient.Repos["octokit"]["octokit.net"].Pulls.GetAsync();
foreach (var pullRequest in pullRequests)
{
Console.WriteLine($"#{pullRequest.Number} {pullRequest.Title}");
}
[!IMPORTANT] This SDK is not yet stable. Breaking changes may occur at any time.
This SDK supports Personal Access Tokens (classic), fine-grained Personal Access Tokens, and GitHub Apps authentication.
In order to use either type of Personal Access token, you can use the TokenAuthProvider
constructor option when constructing a new token provider, like so:
var tokenProvider = new TokenProvider(Environment.GetEnvironmentVariable("GITHUB_TOKEN") ?? "");
var adapter = RequestAdapter.Create(new TokenAuthProvider(tokenProvider));
var gitHubClient = new GitHubClient(adapter);
In order to authenticate as a GitHub App, you can use the AppInstallationAuthProvider
constructor option:
var githubAppTokenProvider = new GitHubAppTokenProvider();
var rsa = RSA.Create();
rsa.ImportFromPem(PRIVATE_KEY_PATH);
var aiAccessTokenProvider = new AppInstallationTokenProvider(CLIENT_ID, rsa, INSTALLATION_ID, githubAppTokenProvider);
var aiAdapter = RequestAdapter.Create(new AppInstallationAuthProvider(aiAccessTokenProvider));
var aiGitHubClient = new GitHubClient(aiAdapter);
To see more detailed examples, view the cli/ directory in this repo.
⚠️ Note: There are three types of GitHub App authentication:
Authenticating on behalf of a user is not supported in an SDK, as it requires a UI authentication flow with redirects. This SDK supports authenticating as the App itself and as an App installation.
Note that the SDK does not yet support authenticating as the App itself and as an App installation using the same client transparently to the user. Authenticating as the App itself requires creating a JSON Web Token (JWT) and using that as token authentication. For helpers to create and sign a JWT in .NET, you may use the helpers in the GitHubAppTokenProvider
class.
We want to...
We have a substantial userbase that uses .NET and we wanted them to get access to our generated SDK as early as possible.
Please use this project's issues!
Currently this project is fairly simple (we hope it can stay that way). All of the package based source is contained in the GitHub
folder.
dotnet test
dotnet test -p:CollectCoverage=true -p:CoverletOutput=coverage/ -p:CoverletOutputFormat=opencover -p:ExcludeByFile="$(pwd)/src/GitHub/**/*.cs"
dotnet reportgenerator -targetdir:$(pwd)/test/coverage/Report/ -reports:$(pwd)/test/coverage/coverage.opencover.xml
dotnet-reportgenerator-globaltool
, so follow that set of installation instructions/path/to/your/repo/dotnet-sdk/test/coverage/Report/index.html
) in a browser