negroni v0.3.0 Release Notes

Release Date: 2017-11-11 // over 6 years ago
  • ➕ Added

    • 🏗 With() helper for building a new Negroni struct chaining handlers from
      existing Negroni structs
    • 🔧 Format log output in Logger middleware via a configurable text/template
      0️⃣ string injectable via .SetFormat. Added LoggerDefaultFormat and
      🔧 LoggerDefaultDateFormat to configure the default template and date format
      👉 used by the Logger middleware.
    • 👌 Support for HTTP/2 pusher support via http.Pusher interface for Go 1.8+.
    • WrapFunc to convert http.HandlerFunc into a negroni.Handler
    • 🔧 Formatter field added to Recovery middleware to allow configuring how
      0️⃣ panics are output. Default of TextFormatter (how it was output in
      0.2.0) used. HTMLPanicFormatter also added to allow easy outputing of
      panics as HTML.

    🛠 Fixed

    • Written() correct returns false if no response header has been written
    • Only implement http.CloseNotifier with the negroni.ResponseWriter if the
      underlying http.ResponseWriter implements it (previously would always
      implement it and panic if the underlying http.ResponseWriter did not.

    🔄 Changed

    • 0️⃣ Set default status to 0 in the case that no handler writes status -- was
      previously 200 (in 0.2.0, before that it was 0 so this reestablishes that
      behavior)
    • Catch panics thrown by callbacks provided to the Recovery handler
    • Recovery middleware will set text/plain content-type if none is set
    • ALogger interface to allow custom logger outputs to be used with the
      Logger middleware. Changes embeded field in negroni.Logger from Logger
      to ALogger.
    • 0️⃣ Default Logger middleware output changed to be more structure and verbose
      👀 (also now configurable, see Added)
    • Automatically bind to port specified in $PORT in .Run() if an address is
      not passed in. Fall back to binding to :8080 if no address specified
      0️⃣ (configuable via DefaultAddress).
    • PanicHandlerFunc added to Recovery middleware to enhance custom handling
      of panics by providing additional information to the handler including the
      stack and the http.Request. Recovery.ErrorHandlerFunc was also added, but
      🗄 deprecated in favor of the new PanicHandlerFunc.