This PR contains the following updates:

Package	Change	Age	Confidence
github.com/kataras/iris/v12	v12.2.6-0.20230908161203-24ba4e8933b9 → v12.2.11

Release Notes

v12.2.11

Compare Source

Dear Iris Community,

You might have noticed a recent lull in activity on the Iris repository. I want to assure you that this silence is not without reason. For the past 3-4 months, I've been diligently working on the next major release of Iris.

This upcoming version is poised to be a significant leap forward, fully embracing the Generics feature introduced in Go. We're not just stopping at Generics, though. Expect a suite of new features, enhancements, and optimizations that will elevate your development experience to new heights.

My journey with Go spans over 8 years, and with each year, my expertise and understanding of the language deepen. This accumulated knowledge is being poured into Iris, ensuring that the framework not only evolves with the language but also with the community's growing needs.

Stay tuned for more updates, and thank you for your continued support and patience. The wait will be worth it.

Warm regards,

Gerasimos (Makis) Maropoulos

This is the last release for the version 12 family.

• Security improvements and dependencies upgrade.

• New Application/Party.MiddlewareExists(handlerNameOrHandler) method added, example:

package main

import (
	"fmt"

	"github.com/kataras/iris/v12"
	"github.com/kataras/iris/v12/x/errors"
)

func main() {
	app := iris.New()

	app.UseRouter(errors.RecoveryHandler)

	if app.MiddlewareExists(errors.RecoveryHandler) { // <- HERE.
		fmt.Println("errors.RecoveryHandler exists")
	}
	// OR:
	// if app.MiddlewareExists("iris.errors.recover") {
	// 	fmt.Println("Iris.Errors.Recovery exists")
	// }

	app.Get("/", indexHandler)

	app.Listen(":8080")
}

func indexHandler(ctx iris.Context) {
	panic("an error here")
	ctx.HTML("<h1>Index</h1>")
}

• New x/errors.Intercept(func(ctx iris.Context, req *CreateRequest, resp *CreateResponse) error{ ... }) package-level function.

func main() {
    app := iris.New()

    // Create a new service and pass it to the handlers.
    service := new(myService)

    app.Post("/", errors.Intercept(responseHandler), errors.CreateHandler(service.Create))

    // [...]
}

func responseHandler(ctx iris.Context, req *CreateRequest, resp *CreateResponse) error {
    fmt.Printf("intercept: request got: %+v\nresponse sent: %#+v\n", req, resp)
    return nil
}

• Rename x/errors/ContextValidator.ValidateContext(iris.Context) error to x/errors/RequestHandler.HandleRequest(iris.Context) error.

v12.2.10

Compare Source

• Simplify the /core/host subpackage and remove its DeferFlow and RestoreFlow methods. These methods are replaced with: Supervisor.Configure(host.NonBlocking()) before Serve and Supervisor.Wait(context.Context) error after Serve.
• Fix internal trimHandlerName and other minor stuff.
• New iris.NonBlocking() configuration option to run the server without blocking the main routine, Application.Wait(context.Context) error method can be used to block and wait for the server to be up and running. Example:

func main() {
    app := iris.New()
    app.Get("/", func(ctx iris.Context) {
        ctx.Writef("Hello, %s!", "World")
    })

    app.Listen(":8080", iris.NonBlocking(), iris.WithoutServerError(iris.ErrServerClosed))

    ctx, cancel := context.WithTimeout(context.Background(), 15*time.Second)
    defer cancel()

    if err := app.Wait(ctx); err != nil {
        log.Fatal(err)
    }

    // [Server is up and running now, you may continue with other functions below].
}

• Add x/mathx.RoundToInteger math helper function.

v12.2.9

Compare Source

• Add x/errors.RecoveryHandler package-level function.
• Add x/errors.Validation package-level function to add one or more validations for the request payload before a service call of the below methods.
• Add x/errors.Handler, CreateHandler, NoContentHandler, NoContentOrNotModifiedHandler and ListHandler ready-to-use handlers for service method calls to Iris Handler.
• Add x/errors.List package-level function to support ListObjects(ctx context.Context, opts pagination.ListOptions, f Filter) ([]Object, int64, error) type of service calls.
• Simplify how validation errors on /x/errors package works. A new x/errors/validation sub-package added to make your life easier (using the powerful Generics feature).
• Add x/errors.OK, Create, NoContent and NoContentOrNotModified package-level generic functions as custom service method caller helpers. Example can be found here.
• Add x/errors.ReadPayload, ReadQuery, ReadPaginationOptions, Handle, HandleCreate, HandleCreateResponse, HandleUpdate and HandleDelete package-level functions as helpers for common actions.
• Add x/jsonx.GetSimpleDateRange(date, jsonx.WeekRange, time.Monday, time.Sunday) which returns all dates between the given range and start/end weekday values for WeekRange.
• Add x/timex.GetMonthDays and x/timex.GetMonthEnd functions.
• Add iris.CookieDomain and iris.CookieOverride cookie options to handle #​2309.
• New x/errors.ErrorCodeName.MapErrorFunc, MapErrors, Wrap methods and x/errors.HandleError package-level function.

v12.2.8

Compare Source

• A new way to customize the handler's parameter among with the hero and mvc packages. New iris.NewContextWrapper and
  iris.NewContextPool methods were added to wrap a handler (.Handler, .Handlers, .HandlerReturnError, HandlerReturnDuration, Filter and FallbackViewFunc methods) and use a custom context instead of the iris.Context directly. Example at: https://github.com/kataras/iris/tree/main/_examples/routing/custom-context.

• The cache sub-package has an update, 4 years after:

  • Add support for custom storage on cache package, through the Handler#Store method.
  • Add support for custom expiration duration on cache package, trough the Handler#MaxAge method.
  • Improve the overral performance of the cache package.
  • The cache.Handler input and output arguments remain as it is.
  • The cache.Cache input argument changed from time.Duration to func(iris.Context) time.Duration.

Configuration

📅 Schedule: (UTC)

• Branch creation
  • At any time (no schedule defined)
• Automerge
  • At any time (no schedule defined)

🚦 Automerge: Disabled by config. Please merge this manually once you are satisfied.

♻ Rebasing: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox.

🔕 Ignore: Close this PR and you won't be reminded about this update again.

• If you want to rebase/retry this PR, check this box

This PR was generated by Mend Renovate. View the repository job log.