go core libraries

.github/workflows/abstractions-go.yml

@@ -17,7 +17,7 @@ jobs:
       - uses: actions/checkout@v2.3.5
       - uses: actions/setup-go@v2
         with:
-          go-version: '^1.16.6'
+          go-version: '^1.17.2'
       - name: Install dependencies
         run: go install
         working-directory: ${{ env.relativePath }}

.github/workflows/authentication-dotnet-azure.yml

@@ -49,7 +49,7 @@ jobs:
           name: drop
           path: |
             ${{ env.relativePath }}/src/bin/Release/*.nupkg
-      - run: git checkout ${{ env.relativePath }}/nuget.config
+      - run: rm ${{ env.relativePath }}/nuget.config
         if: always()
   deploy:
     if: ${{ github.event_name == 'push' && github.ref == 'refs/heads/main' }}

.github/workflows/authentication-go-azure.yml

@@ -0,0 +1,26 @@
+name: Go Authentication Azure
+
+on:
+  workflow_dispatch:
+  push:
+    branches: [ main ]
+    paths: ['authentication/go/azure/**', '.github/workflows/**']
+  pull_request:
+    paths: ['authentication/go/azure/**', '.github/workflows/**']
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    env:
+      relativePath: ./authentication/go/azure
+    steps:
+      - uses: actions/checkout@v2.3.4
+      - uses: actions/setup-go@v2
+        with:
+          go-version: '^1.17.2'
+      - name: Install dependencies
+        run: go install
+        working-directory: ${{ env.relativePath }}
+      - name: Build SDK project
+        run: go build
+        working-directory: ${{ env.relativePath }}

.github/workflows/http-dotnet-httpclient.yml

@@ -49,7 +49,7 @@ jobs:
           name: drop
           path: |
             ${{ env.relativePath }}/src/bin/Release/*.nupkg
-      - run: git checkout ${{ env.relativePath }}/nuget.config
+      - run: rm ${{ env.relativePath }}/nuget.config
         if: always()
   deploy:
     if: ${{ github.event_name == 'push' && github.ref == 'refs/heads/main' }}

.github/workflows/http-go-nethttp.yml

@@ -0,0 +1,26 @@
+name: Go Http NetHttp
+
+on:
+  workflow_dispatch:
+  push:
+    branches: [ main ]
+    paths: ['http/go/nethttp/**', '.github/workflows/**']
+  pull_request:
+    paths: ['http/go/nethttp/**', '.github/workflows/**']
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    env:
+      relativePath: ./http/go/nethttp
+    steps:
+      - uses: actions/checkout@v2.3.4
+      - uses: actions/setup-go@v2
+        with:
+          go-version: '^1.17.2'
+      - name: Install dependencies
+        run: go install
+        working-directory: ${{ env.relativePath }}
+      - name: Build SDK project
+        run: go build
+        working-directory: ${{ env.relativePath }}

.github/workflows/serialization-dotnet-json.yml

@@ -49,7 +49,7 @@ jobs:
           name: drop
           path: |
             ${{ env.relativePath }}/src/bin/Release/*.nupkg
-      - run: git checkout ${{ env.relativePath }}/nuget.config
+      - run: rm ${{ env.relativePath }}/nuget.config
         if: always()
   deploy:
     if: ${{ github.event_name == 'push' && github.ref == 'refs/heads/main' }}

.github/workflows/serialization-go-json.yml

@@ -0,0 +1,29 @@
+name: Go Serialization Json
+
+on:
+  workflow_dispatch:
+  push:
+    branches: [ main ]
+    paths: ['serialization/go/json/**', '.github/workflows/**']
+  pull_request:
+    paths: ['serialization/go/json/**', '.github/workflows/**']
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    env:
+      relativePath: ./serialization/go/json
+    steps:
+      - uses: actions/checkout@v2.3.4
+      - uses: actions/setup-go@v2
+        with:
+          go-version: '^1.17.2'
+      - name: Install dependencies
+        run: go install
+        working-directory: ${{ env.relativePath }}
+      - name: Build SDK project
+        run: go build
+        working-directory: ${{ env.relativePath }}
+      - name: Run unit tests
+        run: go test
+        working-directory: ${{ env.relativePath }}

CHANGELOG.md

@@ -9,6 +9,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Added
 
+- Adds Go authentication, http and serialization libraries and finalizes the generation #716
+
 ### Changed
 
 ## [0.0.11] - 2021-10-27

README.md

@@ -22,7 +22,7 @@ The following table provides an overview of the languages supported by Kiota and
 | Language | Generation | Abstractions | Serialization | Authentication | HTTP | Required tools & dependencies |
 | -------- | ---------- | ------------ | ------------- | -------------- | ---- | -------------- |
 | CSharp | [✔](https://github.com/microsoft/kiota/projects/5) | [✔](./abstractions/dotnet) | [JSON](./serialization/dotnet/json) | [Anonymous](./abstractions/dotnet/src/authentication/AnonymousAuthenticationProvider.cs), [Azure](./authentication/dotnet/azure) | [✔](./http/dotnet/httpclient) | [link](./docs/requiredtools/dotnet.md) |
-| Go | [✔](https://github.com/microsoft/kiota/projects/8) | [✔](./abstractions/go)  | ❌ | ❌ | ❌ | [link](./docs/requiredtools/go.md) |
+| Go | [✔](https://github.com/microsoft/kiota/projects/8) | [✔](./abstractions/go)  | [Azure](./authentication/go/azure) | [✔](./http/go/nethttp) | [JSON](./serialization/go/json) | [link](./docs/requiredtools/go.md) |
 | Java | [✔](https://github.com/microsoft/kiota/projects/7) | [✔](./abstractions/java) | [JSON](./serialization/java/json) | [Anonymous](./abstractions/java/lib/src/main/java/com/microsoft/kiota/authentication/AnonymousAuthenticationProvider.java), [Azure](./authentication/java/azure) | [✔](./http/java/okhttp) | [link](./docs/requiredtools/java.md) |
 | PHP | [❌](https://github.com/microsoft/kiota/projects/4) | [▶](https://github.com/microsoft/kiota/pull/321) | ❌ | ❌ | ❌ |  |
 | Python | [❌](https://github.com/microsoft/kiota/projects/3) | ❌ | ❌ | ❌ | ❌ |  |

abstractions/go/README.md

@@ -3,6 +3,9 @@
 ![Go](https://github.com/microsoft/kiota/actions/workflows/abstractions-go.yml/badge.svg)
 
 - [ ] unit tests
+- [ ] move to its own repo and implement [the guidelines](https://golang.org/doc/#developing-modules) to make referencing the module easier
+- [ ] add doc.go
+- [ ] rename module name, update reference and remove the replace directive
 
 ## Using the abstractions
 

abstractions/go/api_client_builder.go

@@ -4,6 +4,9 @@ import (
 	s "github.com/microsoft/kiota/abstractions/go/serialization"
 )
 
+// Registers the default serializer to the registry.
+// Parameters:
+// 		metaFactory: the factory function that creates the serialization writer factory.
 func RegisterDefaultSerializer(metaFactory func() s.SerializationWriterFactory) {
 	factory := metaFactory()
 	contentType, err := factory.GetValidContentType()
@@ -12,6 +15,9 @@ func RegisterDefaultSerializer(metaFactory func() s.SerializationWriterFactory)
 	}
 }
 
+// Registers the default deserializer to the registry.
+// Parameters:
+// 		metaFactory: the factory function that creates the serialization reader factory.
 func RegisterDefaultDeserializer(metaFactory func() s.ParseNodeFactory) {
 	factory := metaFactory()
 	contentType, err := factory.GetValidContentType()

abstractions/go/authentication/anonymous_authentication_provider.go

@@ -2,9 +2,15 @@ package authentication
 
 import abs "github.com/microsoft/kiota/abstractions/go"
 
+// This authentication provider does not perform any authentication.
 type AnonymousAuthenticationProvider struct {
 }
 
-func (provider *AnonymousAuthenticationProvider) Authenticate(request abs.RequestInformation) error {
+// Authenticates the Request information instance
+// Parameters:
+//		request: Request information instance
+// Returns:
+//		error: nil if authentication is successful, otherwise an error
+func (provider *AnonymousAuthenticationProvider) AuthenticateRequest(request abs.RequestInformation) error {
 	return nil
 }

abstractions/go/authentication/authentication_provider.go

@@ -4,6 +4,12 @@ import (
 	abs "github.com/microsoft/kiota/abstractions/go"
 )
 
+// Authenticates the application request.
 type AuthenticationProvider interface {
-	Authenticate(request abs.RequestInformation) error
+	// Authenticates the Request information instance
+	// Parameters:
+	//		request: Request information instance
+	// Returns:
+	//		error: nil if authentication is successful, otherwise an error
+	AuthenticateRequest(request abs.RequestInformation) error
 }

abstractions/go/authentication/base_bearer_token_authentication_provider.go

@@ -8,28 +8,45 @@ import (
 
 const authorizationHeader = "Authorization"
 
+// Provides a base class for implementing AuthenticationProvider for Bearer token scheme.
 type BaseBearerTokenAuthenticationProvider struct {
+	// This method is called by the BaseBearerTokenAuthenticationProvider class to authenticate the request via the returned access token.
+	// Parameters:
+	//		request: Request information instance
+	// Returns:
+	//		string: Access token
+	//		error: nil if authentication is successful, otherwise an error
 	getAuthorizationToken func(request abs.RequestInformation) (string, error)
 }
 
+// Creates a new instance of the BaseBearerTokenAuthenticationProvider class.
+// Parameters:
+//		getAuthorizationToken: This method is called by the BaseBearerTokenAuthenticationProvider class to authenticate the request via the returned access token.
+// Returns:
+//		*BaseBearerTokenAuthenticationProvider: A new instance of the BaseBearerTokenAuthenticationProvider class.
 func NewBaseBearerTokenAuthenticationProvider(getAuthorizationToken func(request abs.RequestInformation) (string, error)) *BaseBearerTokenAuthenticationProvider {
 	return &BaseBearerTokenAuthenticationProvider{getAuthorizationToken}
 }
 
-func (provider *BaseBearerTokenAuthenticationProvider) Authenticate(request abs.RequestInformation) error {
+// Authenticates the Request information instance
+// Parameters:
+//		request: Request information instance
+// Returns:
+//		error: nil if authentication is successful, otherwise an error
+func (provider *BaseBearerTokenAuthenticationProvider) AuthenticateRequest(request abs.RequestInformation) error {
 	if request.Headers == nil {
 		request.Headers = make(map[string]string)
 	}
 	if provider.getAuthorizationToken == nil {
-		return errors.New("This class is abstract, you need to derive from it and implement the GetAuthorizationToken method.")
+		return errors.New("this class is abstract, you need to derive from it and implement the GetAuthorizationToken method.")
 	}
 	if request.Headers[authorizationHeader] == "" {
 		token, err := provider.getAuthorizationToken(request)
 		if err != nil {
 			return err
 		}
 		if token == "" {
-			return errors.New("Could not get an authorization token")
+			return errors.New("could not get an authorization token")
 		}
 		request.Headers[authorizationHeader] = "Bearer " + token
 	}

abstractions/go/http_method.go

@@ -1,19 +1,30 @@
 package abstractions
 
+// Represents the HTTP method used by a request.
 type HttpMethod int
 
 const (
+	// The HTTP GET method.
 	GET HttpMethod = iota
+	// The HTTP POST method.
 	POST
+	// The HTTP PATCH method.
 	PATCH
+	// The HTTP DELETE method.
 	DELETE
+	// The HTTP OPTIONS method.
 	OPTIONS
+	// The HTTP CONNECT method.
 	CONNECT
+	// The HTTP PUT method.
 	PUT
+	// The HTTP TRACE method.
 	TRACE
+	// The HTTP HEAD method.
 	HEAD
 )
 
+// Returns the string representation of the HTTP method.
 func (m HttpMethod) String() string {
 	return []string{"GET", "POST", "PATCH", "DELETE", "OPTIONS", "CONNECT", "PUT", "TRACE", "HEAD"}[m]
 }

abstractions/go/query_parameters_base.go

@@ -5,9 +5,15 @@ import (
 	"reflect"
 )
 
+// The base implementation of the Query Parameters
 type QueryParametersBase struct {
 }
 
+// Vanity method to add the query parameters to the request query parameters dictionary.
+// Parameters:
+//  - target: The target map to add the query parameters to.
+// Returns:
+//  - error: An error if the target is nil.
 func (p *QueryParametersBase) AddQueryParameters(target map[string]string) error {
 	if target == nil {
 		return errors.New("target cannot be nil")

abstractions/go/request_adapter.go

@@ -4,12 +4,55 @@ import (
 	s "github.com/microsoft/kiota/abstractions/go/serialization"
 )
 
+// Service responsible for translating abstract Request Info into concrete native HTTP requests.
 type RequestAdapter interface {
-	SendAsync(requestInfo RequestInformation, constructor func() s.Parsable, responseHandler ResponseHandler) func() (s.Parsable, error)
-	SendCollectionAsync(requestInfo RequestInformation, constructor func() s.Parsable, responseHandler ResponseHandler) func() ([]s.Parsable, error)
-	SendPrimitiveAsync(requestInfo RequestInformation, typeName string, responseHandler ResponseHandler) func() (interface{}, error)
-	SendPrimitiveCollectionAsync(requestInfo RequestInformation, typeName string, responseHandler ResponseHandler) func() ([]interface{}, error)
-	SendNoContentAsync(requestInfo RequestInformation, responseHandler ResponseHandler) func() error
-	GetSerializationWriterFactory() (s.SerializationWriterFactory, error)
+	// Executes the HTTP request specified by the given RequestInformation and returns the deserialized response model.
+	// Parameters:
+	//  - requestInfo: The RequestInformation object to use for the HTTP request.
+	//  - constuctor: The factory for the result Parsable object
+	//  - responseHandler: The response handler to use for the HTTP request instead of the default handler.
+	// Returns:
+	//  - The deserialized response model.
+	//  - An error if any.
+	SendAsync(requestInfo RequestInformation, constructor func() s.Parsable, responseHandler ResponseHandler) (s.Parsable, error)
+	// Executes the HTTP request specified by the given RequestInformation and returns the deserialized response model collection.
+	// Parameters:
+	//  - requestInfo: The RequestInformation object to use for the HTTP request.
+	//  - constuctor: The factory for the result Parsable object
+	//  - responseHandler: The response handler to use for the HTTP request instead of the default handler.
+	// Returns:
+	//  - The deserialized response model collection.
+	//  - An error if any.
+	SendCollectionAsync(requestInfo RequestInformation, constructor func() s.Parsable, responseHandler ResponseHandler) ([]s.Parsable, error)
+	// Executes the HTTP request specified by the given RequestInformation and returns the deserialized primitive response model.
+	// Parameters:
+	//  - requestInfo: The RequestInformation object to use for the HTTP request.
+	//  - typeName: The type name of the response model.
+	//  - responseHandler: The response handler to use for the HTTP request instead of the default handler.
+	// Returns:
+	//  - The deserialized response model.
+	//  - An error if any.
+	SendPrimitiveAsync(requestInfo RequestInformation, typeName string, responseHandler ResponseHandler) (interface{}, error)
+	// Executes the HTTP request specified by the given RequestInformation and returns the deserialized primitive response model collection.
+	// Parameters:
+	//  - requestInfo: The RequestInformation object to use for the HTTP request.
+	//  - typeName: The type name of the response model.
+	//  - responseHandler: The response handler to use for the HTTP request instead of the default handler.
+	// Returns:
+	//  - The deserialized response model collection.
+	//  - An error if any.
+	SendPrimitiveCollectionAsync(requestInfo RequestInformation, typeName string, responseHandler ResponseHandler) ([]interface{}, error)
+	// Executes the HTTP request specified by the given RequestInformation with no return content.
+	// Parameters:
+	//  - requestInfo: The RequestInformation object to use for the HTTP request.
+	//  - responseHandler: The response handler to use for the HTTP request instead of the default handler.
+	// Returns:
+	//  - An error if any.
+	SendNoContentAsync(requestInfo RequestInformation, responseHandler ResponseHandler) error
+	// Gets the serialization writer factory currently in use for the request adapter service.
+	// Returns:
+	//  - The serialization writer factory currently in use for the request adapter service.
+	GetSerializationWriterFactory() s.SerializationWriterFactory
+	// Enables the backing store proxies for the SerializationWriters and ParseNodes in use.
 	EnableBackingStore()
 }