Description

While the existing Ctx.Format provides a concise convenience method for basic content negotiation on simple structures, res.format allows developers to set their own custom handlers for each content type.

Docs: moved the existing Ctx.Format docs to a section called AutoFormat and added docs for the new Ctx.Format.

I'm taking suggestions for better names than Fmt for the mediaType-handler struct...was just worried about making it overly long since people will need to type it over and over.

Benchmark_Ctx_Format/with_arg_allocation-8               2578868               464.5 ns/op            96 B/op          1 allocs/op
Benchmark_Ctx_Format/with_arg_allocation-8               2577880               466.9 ns/op            96 B/op          1 allocs/op
Benchmark_Ctx_Format/with_arg_allocation-8               2596575               462.0 ns/op            96 B/op          1 allocs/op
Benchmark_Ctx_Format/with_arg_allocation-8               2564602               460.6 ns/op            96 B/op          1 allocs/op
Benchmark_Ctx_Format/pre-allocated_args-8                2983128               407.3 ns/op             0 B/op          0 allocs/op
Benchmark_Ctx_Format/pre-allocated_args-8                3031767               400.3 ns/op             0 B/op          0 allocs/op
Benchmark_Ctx_Format/pre-allocated_args-8                3045684               397.7 ns/op             0 B/op          0 allocs/op
Benchmark_Ctx_Format/pre-allocated_args-8                2986521               407.1 ns/op             0 B/op          0 allocs/op
Benchmark_Ctx_Format/text/plain-8                       12827778                92.41 ns/op            0 B/op          0 allocs/op
Benchmark_Ctx_Format/text/plain-8                       13453144                93.66 ns/op            0 B/op          0 allocs/op
Benchmark_Ctx_Format/text/plain-8                       13534003                86.67 ns/op            0 B/op          0 allocs/op
Benchmark_Ctx_Format/text/plain-8                       13168622                88.81 ns/op            0 B/op          0 allocs/op
Benchmark_Ctx_Format/json-8                              9903925               128.8 ns/op             0 B/op          0 allocs/op
Benchmark_Ctx_Format/json-8                              9780688               124.1 ns/op             0 B/op          0 allocs/op
Benchmark_Ctx_Format/json-8                              9499648               128.1 ns/op             0 B/op          0 allocs/op
Benchmark_Ctx_Format/json-8                              9510656               122.2 ns/op             0 B/op          0 allocs/op

Related to #2745

Migration

To make their code compatible with Fiber v3, users need only replace their uses of c.Format to c.AutoFormat.
To make full use of the new c.Format, users should note where in their application they are performing manual content negotiation and consider if c.Format will simplify their code.

Changes Introduced

• Benchmarks: Describe any performance benchmarks and improvements related to the changes.
• Documentation Update: Detail the updates made to the documentation and links to the changed files.
• Changelog/What's New: Include a summary of the additions for the upcoming release notes.
• Migration Guide: If necessary, provide a guide or steps for users to migrate their existing code to accommodate these changes.
• API Alignment with Express: Explain how the changes align with the Express API.
• API Longevity: Discuss the steps taken to ensure that the new or updated APIs are consistent and not prone to breaking changes.
• Examples: Provide examples demonstrating the new features or changes in action.

Type of Change

• New feature (non-breaking change which adds functionality)
• Documentation update (changes to documentation)

Checklist

Before you submit your pull request, please make sure you meet these requirements:

• Followed the inspiration of the Express.js framework for new functionalities, making them similar in usage.
• Conducted a self-review of the code and provided comments for complex or critical parts.
• Updated the documentation in the /docs/ directory for Fiber's documentation.
• Added or updated unit tests to validate the effectiveness of the changes or new features.
• Ensured that new and existing unit tests pass locally with the changes.
• Aimed for optimal performance with minimal allocations in the new code.
• Provided benchmarks for the new code to analyze and improve upon.