Extending goa with Plugin DSLs
goa plugins make it possible to create new DSL and accompanying generators. Since DSLs are nothing more than Go functions their syntax is completely open. Plugins also make it possible to generate new...
View ArticleGetting Started with goa
This guide walks you through writing a complete service in goa. The simple service implements a small subset of the cellar example found in the github repository. The service deals with wine bottles,...
View ArticleWorking with Data Types
An important aspect of the goa DSL resides around how types are defined and used. The Overview covers the basics of working with types and media types. This document takes a step back and explains the...
View Articlegoa v1.3.0
Another 4 months and another goa release! goa v1.3.0 is out! This version includes new features and a slew of bug fixes. Thank you to all the contributors that spent a lot of time writing (and...
View ArticleGoa v3.0.0
After more than 2 years of work and contributions from 40 different authors, I am really proud to announce the official release of Goa v2 (and v3 see Go Modules Support below). This release includes...
View ArticlePlugins
Goa plugins make it possible to create new DSLs and accompanying generators. They run before rendering the final artifacts which makes it possible to alter the templates exposed by the Goa code...
View ArticleMiddleware
A middleware consists of a function that accepts and returns a endpoint or a transport specific handler. Endpoint Middlewares Endpoint middlewares operate at the endpoint level and are transport...
View ArticleIntroduction
What is Goa? Goa is a Go framework for writing microservices that promotes best practice by providing a single source of truth from which server code, client code, and documentation is derived. The...
View ArticleDesign Overview
The following sections describe how to use the goa DSL to describe services. They provide an overview of the key concepts. Review the GoDocs for a complete reference. API Expression The API function is...
View ArticleImplementing goa Services
Once the design of the API is completed and goagen has generated the low level handlers the next step consists of implementing the actual action handlers. goagen generates a controller interface for...
View Articlegoa Plugin Generators
goa Plugins make it possible to generate new kinds of outputs from any DSL. The possibilities are really endless, clients in different languages, domain specific type conversions, database bindings...
View ArticleIntroduction to goa
What is goa? goa provides a novel approach for developing microservices that saves time when working on independent services and helps with keeping the overall system consistent. goa uses code...
View ArticleThe goa API Design Language
The goa API Design Language is a DSL implemented in Go that makes it possible to describe arbitrary microservice APIs. While the main focus is REST based HTTP APIs, the language is flexible enough to...
View Articlegoa v1.4.0
It’s been almost a year since the last official release of goa. During that year many contributions have been made including both new features and bug fixes. The team has also been hard at work on v2...
View ArticleGoa v3.0.3
The Goa community has contributed many fixes to Goa as adoption of v3 grows. This release builds on v3.0.1 and v3.0.2 and adds several more fixes. In particular: Nitin Mohan fixed a couple of issues...
View ArticleError Handling
Overview Goa makes it possible to describe precisely the potential errors returned by service methods. This allows for defining a clear contract between the server and its clients that gets reflected...
View ArticleGoa v3.2.0
I am very excited to announce the release of Goa v3.2.0! This release includes a few key improvements as well as many bug fixes. HTTP Cookies v3.2.0 adds native support for HTTP cookies in Goa designs....
View ArticleGoa v3.6.0
Go v3.6.0 is out! There were many bug fixes made in the past 6 months (since 3.5.0), see the complete list on GitHub. v3.6.0 also brings many new features and improvements. New Features Multi-Server...
View ArticleOneOf: Union Attributes in Goa
Goa v3.7.0: Union Attributes in Goa Goa v3.7.0 adds the ability to define union attributes in the Goa DSL. Union attributes enumerate multiple potential attribute values for a single type attribute....
View ArticleImplementing a Goa Service
Overview Once the service design is complete, it is time to run the goa tool to generate the code: goa gen <Go import path of design package> The goa tool creates a gen directory containing all...
View Article