Merge pull request #2 from kataras/master

Merge main

.github/ISSUE_TEMPLATE/bug_report.md

@@ -24,7 +24,7 @@ If applicable, add screenshots to help explain your problem.
  - OS: [e.g. ubuntu, windows]
 
 **iris.Version**
-- e.g. v12.2.0-beta4 or master
+- e.g. v12.2.0 or master
 
 Please make sure the bug is reproducible over the `master` branch:
 

.gitignore

@@ -1,3 +1,4 @@
+.idea
 .vscode
 .directory
 coverage.out

CONTRIBUTING.md

@@ -26,7 +26,7 @@ Instructions can be found at: https://github.com/kataras/iris/issues/796
 
 ### Writing
 
-Write an article about Iris in https://medium.com, https://dev.to or if you're being a hackathon at https://hackernoon.com, some [examples](https://github.com/kataras/iris/wiki/Publications).
+Write an article about Iris in https://medium.com, https://dev.to or if you're being a hackathon at https://hackernoon.com and send us the link on iris-go@outlook.com.
 
 ### Social networks
 

FAQ.md

@@ -19,18 +19,18 @@ Add a `badge` to your open-source projects powered by [Iris](https://iris-go.com
 ## How to upgrade
 
 ```sh
-go get -u github.com/kataras/iris/v12@master
+go get github.com/kataras/iris/v12@latest
 ```
 
-Go version 1.13 and above is required.
+Go version 1.20 and above is required.
 
 ## Learning
 
-More than 180 practical examples, tutorials and articles at:
+More than 280 practical examples, tutorials and articles at:
 
 - https://www.iris-go.com/docs
 - https://www.iris-go.com/#ebookDonateForm
-- https://github.com/kataras/iris/wiki/Starter-kits
+<!-- - https://github.com/kataras/iris/wiki/Starter-kits -->
 - https://github.com/kataras/iris/tree/master/_examples
 - https://pkg.go.dev/github.com/kataras/iris/v12@master
 

HISTORY.md

@@ -1,5 +1,3 @@
-<!-- # History/Changelog <a href="HISTORY_ZH.md"> <img width="20px" src="https://iris-go.com/images/flag-china.svg?v=10" /></a><a href="HISTORY_ID.md"> <img width="20px" src="https://iris-go.com/images/flag-indonesia.svg?v=10" /></a><a href="HISTORY_GR.md"> <img width="20px" src="https://iris-go.com/images/flag-greece.svg?v=10" /></a> -->
-
 # Changelog
 
 ### Looking for free and real-time support?
@@ -19,14 +17,35 @@
 
 Developers are not forced to upgrade if they don't really need it. Upgrade whenever you feel ready.
 
-**How to upgrade**: Open your command-line and execute this command: `go get github.com/kataras/iris/v12@latest`.
+**How to upgrade**: Open your command-line and execute this command: `go get github.com/kataras/iris/v12@latest` and `go mod tidy -compat=1.20`.
 
-# Next
+# Sa, 11 March 2023 | v12.2.0
 
 This release introduces new features and some breaking changes.
 The codebase for Dependency Injection, Internationalization and localization and more have been simplified a lot (fewer LOCs and easier to read and follow up).
 
+## 24 Dec 2022
+
+All new features have been tested in production and seem to work fine. Fixed all reported and reproducible bugs. The `v12.2.0-beta7` is the latest beta release of v12.2.0. Expect the final public and stable release of v12.2.0 shortly after February 2023.
+
 ## Fixes and Improvements
+
+- Add `iris.TrimParamFilePart` to handle cases like [#2024](https://github.com/kataras/iris/issues/2024) and improve the [_examples/routing/dynamic-path/main.go](_examples/routing/dynamic-path/main.go#L356) example to include that case as well.
+
+- **Breaking-change**: HTML template functions `yield`, `part`, `partial`, `partial_r` and `render` now accept (and require for some cases) a second argument of the binding data context too. Convert: `{{ yield }}` to `{{ yield . }}`, `{{ render "templates/mytemplate.html" }}` to `{{ render "templates/mytemplate.html" . }}`, `{{ partial "partials/mypartial.html" }}` to `{{ partial "partials/mypartial.html" . }}` and so on.
+
+- Add new `URLParamSeparator` to the configuration. Defaults to "," but can be set to an empty string to disable splitting query values on `Context.URLParamSlice` method.
+
+- [PR #1992](https://github.com/kataras/iris/pull/1992): Added support for third party packages on [httptest](https://github.com/kataras/iris/tree/master/httptest). An example using 3rd-party module named [Ginkgo](github.com/onsi/ginkgo) can be found [here](https://github.com/kataras/iris/blob/master/_examples/testing/ginkgotest). 
+
+- Add `Context.Render` method for compatibility.
+
+- Support of embedded [locale files](https://github.com/kataras/iris/blob/master/_examples/i18n/template-embedded/main.go) using standard `embed.FS` with the new `LoadFS` function.
+- Support of direct embedded view engines (`HTML, Blocks, Django, Handlebars, Pug, Amber, Jet` and `Ace`) with `embed.FS` or `fs.FS` (in addition to `string` and `http.FileSystem` types).
+- Add support for `embed.FS` and `fs.FS` on `app.HandleDir`.
+
+- Add `iris.Patches()` package-level function to customize Iris Request Context REST (and more to come) behavior.
+- Minor fixes.
 
 - Enable setting a custom "go-redis" client through `SetClient` go redis driver method or `Client` struct field on sessions/database/redis driver as requested at [chat](https://chat.iris-go.com).
 - Ignore `"csrf.token"` form data key when missing on `ctx.ReadForm` by default as requested at [#1941](https://github.com/kataras/iris/issues/1941).
@@ -713,7 +732,7 @@ Prior to this version the `iris.Context` was the only one dependency that has be
 | `uint, uint8, uint16, uint32, uint64`, | |
 | `float, float32, float64`, | |
 | `bool`, | |
-| `slice` | [Path Parameter](https://github.com/kataras/iris/wiki/Routing-path-parameter-types) |
+| `slice` | [Path Parameter](https://github.com/kataras/iris/blob/master/_examples/routing/dynamic-path/main.go#L20) |
 | Struct | [Request Body](https://github.com/kataras/iris/tree/master/_examples/request-body) of `JSON`, `XML`, `YAML`, `Form`, `URL Query`, `Protobuf`, `MsgPack` |
 
 Here is a preview of what the new Hero handlers look like:
@@ -985,7 +1004,7 @@ Various improvements and linting.
 
 # Su, 29 December 2019 | v12.1.4
 
-Minor fix on serving [embedded files](https://github.com/kataras/iris/wiki/File-server).
+Minor fix on serving embedded files.
 
 # We, 25 December 2019 | v12.1.3
 
@@ -1050,15 +1069,13 @@ All known issues.
 
 ### Internationalization and localization
 
-Support for i18n is now a **builtin feature** and is being respected across your entire application, per say [sitemap](https://github.com/kataras/iris/wiki/Sitemap) and [views](https://github.com/kataras/iris/blob/master/_examples/i18n/basic/main.go#L50).
-
-Refer to the wiki section: https://github.com/kataras/iris/wiki/Sitemap for details.
+Support for i18n is now a **builtin feature** and is being respected across your entire application, per say [sitemap](https://github.com/kataras/iris/blob/master/_examples/routing/sitemap/main.go) and [views](https://github.com/kataras/iris/blob/master/_examples/i18n/basic/main.go#L50).
 
 ### Sitemaps
 
 Iris generates and serves one or more [sitemap.xml](https://www.sitemaps.org/protocol.html) for your static routes.
 
-Navigate through: https://github.com/kataras/iris/wiki/Sitemap for more.
+Navigate through: https://github.com/kataras/iris/blob/master/_examples/routing/sitemap/main.go for more.
 
 ## New Examples
 
@@ -1110,7 +1127,7 @@ This minor version contains improvements on the Problem Details for HTTP APIs im
 - Add `ProblemOptions` with `RetryAfter` as requested at: https://github.com/kataras/iris/issues/1335#issuecomment-521330994.
 - Add `iris.JSON` alias for `context#JSON` options type.
 
-[Example](https://github.com/kataras/iris/blob/45d7c6fedb5adaef22b9730592255f7bb375e809/_examples/routing/http-errors/main.go#L85) and [wikis](https://github.com/kataras/iris/wiki/Routing-error-handlers#the-problem-type) updated. 
+[Example](https://github.com/kataras/iris/blob/45d7c6fedb5adaef22b9730592255f7bb375e809/_examples/routing/http-errors/main.go#L85) updated. 
 
 References:
 

LICENSE

@@ -1,6 +1,6 @@
 BSD 3-Clause License
 
-Copyright (c) 2016-2022, Gerasimos (Makis) Maropoulos
+Copyright (c) 2016-2023, Gerasimos (Makis) Maropoulos
 All rights reserved.
 
 Redistribution and use in source and binary forms, with or without