3 Releases 13 Tags

• v0.4.0 77a1f3b11d

  Compare

  Beta 4 Pre-Release

  xdrm-brackets released this 2021-06-20 08:35:45 +00:00 | 28 commits to 0.4.0 since this release

  Going a bit deeper in the idiomatic go direction.

  Service handlers

  Service handler signature has changed in favor of:

  func(context.Context, in) (*out, api.Err)
  

  • the context.Context argument is the current http request's context. It contains pre-filled information accessible through api.GetRequest(ctx), api.GetResponseWriter(ctx) and api.GetAuth(ctx)
  • the in argument is the input struct (unchanged)
  • the out argument is the output struct (unchanged)
  • the api.Err argument is the handler's error status (unchanged)

  Middlewares

  Custom middleware types have been dropped in favor of using func(api.Handler) api.Handler.

  standard

  Standard http middlewares are added with builder.With() and wrap the full http connection as you would expect an http middleware would. It can be used for logging, recovering requests, etc.

  contextual

  Authentication middlewares have been dropped in favor of a less specific type: contextual middlewares.

  They only wrap the call to the service handler. The http request argument has a context pre-filled with useful information that is accessible through api.GetRequest(ctx), api.GetResponseWriter(ctx) and api.GetAuth(ctx).

  Migration example

  Handlers before:

  type Services struct{}
  
  func (s Services) GetUsers(api.Ctx) (*[]UserModel, api.Err) {}
  func (s Services) GetUserByID(api.Ctx, struct{ ID int }) (*UserModel, api.Err) {}
  func (s Services) CreateUser(struct{ Name string }) (*UserModel, api.Err) {}
  

  Handler after:

  type Services struct{}
  
  func (s Services) GetUsers(context.Context) (*[]UserModel, api.Err) {}
  func (s Services) GetUserByID(context.Context, struct{ ID int }) (*UserModel, api.Err) {}
  func (s Services) CreateUser(context.Context, struct{ Name string }) (*UserModel, api.Err) {}
  

  Standard middlewares before:

  builder := &aicra.Builder{}
  err := builder.Setup(configReader)
  if err != nil {
  	log.Fatalf("cannot setup aicra: %s", err)
  }
  
  builder.With(func(next api.AdapterFunc) api.AdapterFunc {
  	return func(w http.ResponseWriter, r *http.Request) {
      	next(r, w)
      }
  }
  

  Standard middlewares after:

  builder := &aicra.Builder{}
  err := builder.Setup(configReader)
  if err != nil {
  	log.Fatalf("cannot setup aicra: %s", err)
  }
  
  builder.With(func(next http.Handler) http.Handler {
  	return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
      	next.ServeHTTP(r, w)
      })
  }
  

  Authentication middlewares before:

  err := builder.Setup(configReader)
  if err != nil {
  	log.Fatalf("cannot setup aicra: %s", err)
  }
  
  builder.WithAuth(func(next api.AuthHandlerFunc) api.AuthHandlerFunc {
  	return func(a api.Auth, w http.ResponseWriter, r *http.Request) {
  		// add active request permission
  		a.Active = append(a.Active, "admin");
      	next(r, w)
      }
  }
  

  Authentication middlewares after:

  builder := &aicra.Builder{}
  err := builder.Setup(configReader)
  if err != nil {
  	log.Fatalf("cannot setup aicra: %s", err)
  }
  
  builder.WithContext(func(next http.Handler) http.Handler {
  	return http.Handlerfunc(func(w http.ResponseWriter, r *http.Request) {
  		// get auth from context
  		auth := api.GetAuth(r.Context());
  
  		// add active request permission
  		auth.Active = append(auth.Active, "admin");
  		
      	next.ServeHTTP(r, w)
      })
  }
  

  Downloads

  • Source Code (ZIP)
  • Source Code (TAR.GZ)
• v0.3.1 fb69dbb903

  Compare

  Refactor and tests Pre-Release

  xdrm-brackets released this 2020-04-04 15:33:43 +00:00 | 38 commits to 0.3.0 since this release

  Refactor and simplify architecture, unexport internal packages, hide most of the API that does not need to be exported, standardize file names, move types closer to their usage, enforce aicra.Server usage with aicra.Builder.

  Downloads

  • Source Code (ZIP)
  • Source Code (TAR.GZ)
• v0.3.0 4877d0ea23

  Compare

  Beta 3 Pre-Release

  xdrm-brackets released this 2020-03-29 15:10:04 +00:00 | 71 commits to 0.3.0 since this release

  Breaking changes release.

  • update the configuration file format to allow for nested uri arguments.
  • allow for type checkers to cast values for more consistent extraction in controllers
  • more checks
  • optimize by "compiling" when reading configuration; less work for each request management
    • type checkers are bound to parameters when reading the configuration
    • request parameters are read from the configuration, no need to check actual vs config afterwards, we only extract config parameters
  • add more checks and guard values, service collision, parameter names, etc before listening for incoming requests

  Downloads

  • Source Code (ZIP)
  • Source Code (TAR.GZ)