README.md

source-generator

This repository generates code from GitHub's OpenAPI specification, built on Kiota. If you're looking for the repositories generated from this code, you may want:

• Go
  • For the standard GitHub.com product
    • go-sdk repository
    • pkg.go.dev docs link
  • For GitHub Enterprise Cloud
    • go-sdk-enterprise-cloud repository
    • pkg.go.dev docs link
  • For GitHub Enterprise Server
    • go-sdk-enterprise-server repository
    • pkg.go.dev docs link
• .NET
  • For the standard GitHub.com product
    • dotnet-sdk repository
    • NuGet link
  • For GitHub Enterprise Cloud
    • dotnet-sdk-enterprise-cloud repository
    • NuGet link
  • For GitHub Enterprise Server
    • dotnet-sdk-enterprise-server repository
    • NuGet link
  • For our classic non-generated, hand-maintained Octokit.net project
    • Octokit.net repository
    • NuGet link

Development

• Install
  • .NET 7
  • Latest version of Go
  • Kiota: dotnet tool install --global Microsoft.OpenApi.Kiota --prerelease
• For the latest versions of tooling, the .github/workflows/build-go.yml file is the source of truth.

Usage

Go

Run ./scripts/generate-go.sh. You may also run individual steps from the .github/workflows/build-go.yml file. If you're using VSCode, there are some pre-setup tasks and debugging configurations in the .vscode folder.

C#

Run ./scripts/generate-csharp.sh

Design

For more information on our approach to generative SDKs please read our design doc.

For more information on why we have made a move toward Generative SDKs, please take a moment and head over to the GitHub blog to read more there.