update examples to latest Iris version

Author: kataras

.gitignore

@@ -1,3 +1,4 @@
+.DS_STORE
 .vscode
 /issue-*/
 /feature-*/

.travis.gofmt.sh

@@ -1,6 +1,6 @@
 The MIT License (MIT)
 
-Copyright (c) 2016-2021 Gerasimos Maropoulos and contributors.
+Copyright (c) 2016-2022 Gerasimos Maropoulos and contributors.
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

.travis.gotest.sh

@@ -2,15 +2,15 @@
 
 <a href="https://iris-go.com"> <img align="right" width="115px" src="https://iris-go.com/images/icon.svg?v=a" title="logo created by @merry.dii" /> </a>
 
-<a href="https://travis-ci.org/kataras/iris"><img src="https://img.shields.io/travis/kataras/iris.svg?style=flat-square" alt="Build Status"></a>
+<a href="https://github.com/kataras/iris/actions"><img src="https://img.shields.io/github/workflow/status/kataras/iris/CI/master?style=flat-square" alt="Build Status"></a>
 <a href="https://github.com/iris-contrib/examples/blob/v12/LICENSE"><img src="https://img.shields.io/badge/%20license-MIT%20%20License%20-E91E63.svg?style=flat-square" alt="License"></a>
 <a href="https://github.com/kataras/iris/blob/master/HISTORY.md"><img src="https://img.shields.io/badge/version-v12.2.x%20-blue.svg?style=flat-square" alt="CHANGELOG/HISTORY"></a>
 
 This repository provides easy to understand code snippets on how to get started with web development with the Go programming language using the [Iris](https://github.com/kataras/iris) web framework. This branch contains the latest [iris master examples](github.com/kataras/iris/tree/master). For the stable's version examples navigate through the [v12 branch](https://github.com/iris-contrib/examples/tree/v12).
 
 To read the Iris documentation please navigate to [the wiki pages](https://github.com/kataras/iris/wiki) instead.
 
-> Examples are tested using Windows 10, Ubuntu 20.04 with [Microsoft's Visual Studio Code](https://code.visualstudio.com/) and built using the [Go 1.15.0](https://golang.org/dl).
+> Examples are tested using Windows 11, Ubuntu 22.04 LTS, macOS 12 Monterey with [Microsoft's Visual Studio Code](https://code.visualstudio.com/) and built using the [Go 1.19.rc2](https://go.dev/dl/).
 
 # Table of Contents
 
@@ -19,13 +19,18 @@ To read the Iris documentation please navigate to [the wiki pages](https://githu
 * [URL Shortener](url-shortener)
 * [Dropzone.js](dropzonejs)
 * [Caddy](caddy)
+* [Bootstrapper](bootstrapper)
+* [Project Structure](project) :fire:
+* Monitor
+    * [Simple Process Monitor (includes UI)](monitor/monitor-middleware/main.go) **NEW**
+    * [Heap, MSpan/MCache, Size Classes, Objects, Goroutines, GC/CPU fraction (includes UI)](monitor/statsviz/main.go) **NEW**
 * Database
     * [MySQL, Groupcache & Docker](database/mysql)
     * [MongoDB](database/mongodb)
     * [Sqlx](database/orm/sqlx/main.go)
-    * [Xorm](database/orm/xorm/main.go)
     * [Gorm](database/orm/gorm/main.go)
     * [Reform](database/orm/reform/main.go)
+    * [x/sqlx](database/sqlx/main.go) **NEW**
 * HTTP Server
     * [HOST:PORT](http-server/listen-addr/main.go)
     * [Public Test Domain](http-server/listen-addr-public/main.go)
@@ -42,17 +47,25 @@ To read the Iris documentation please navigate to [the wiki pages](https://githu
         * [Use Iris as a single http.Handler](http-server/custom-httpserver/std-way/main.go)
         * [Multi Instances](http-server/custom-httpserver/multi/main.go)
         * [HTTP/3 Quic](http-server/http3-quic)
+        * [H2C](http-server/h2c/main.go) **NEW**
+    * [Timeout](http-server/timeout/main.go)
+* HTTP Client
+    * [Weather Client](http-client/weatherapi)
 * Configuration
     * [Functional](configuration/functional/main.go)
     * [Configuration Struct](configuration/from-configuration-structure/main.go)
     * [Using Viper](configuration/viper)
     * [Import from YAML](configuration/from-yaml-file/main.go)
         * [Share Configuration across instances](configuration/from-yaml-file/shared-configuration/main.go)
     * [Import from TOML](configuration/from-toml-file/main.go)
+    * [Multi Environment Configuration](configuration/multi-environments) **NEW**
 * Routing
+    * [Party Controller](routing/party-controller) **NEW**
     * [Overview](routing/overview/main.go)
     * [Basic](routing/basic/main.go)
     * [Custom HTTP Errors](routing/http-errors/main.go)
+    * [HTTP Wire Errors](routing/http-wire-errors/main.go) **NEW**
+        * [Custom Validation Errors](routing/http-wire-errors/custom-validation-errors/main.go)
     * [Not Found - Intelligence](routing/intelligence/main.go)
         * [Not Found - Suggest Closest Paths](routing/intelligence/manual/main.go)
     * [Dynamic Path](routing/dynamic-path/main.go)
@@ -62,6 +75,7 @@ To read the Iris documentation please navigate to [the wiki pages](https://githu
     * Middleware
         * [Per Route](routing/writing-a-middleware/per-route/main.go)
         * [Globally](routing/writing-a-middleware/globally/main.go)
+        * [Remove a Handler](routing/remove-handler/main.go)
         * Share Values
             * [Share Services](routing/writing-a-middleware/share-services/main.go)
             * [Share Functions](routing/writing-a-middleware/share-funcs/main.go)
@@ -70,9 +84,11 @@ To read the Iris documentation please navigate to [the wiki pages](https://githu
         * Convert net/http Handlers
             * [From func(w http.ResponseWriter, r *http.Request, next http.HandlerFunc)](convert-handlers/negroni-like/main.go)
             * [From http.Handler or http.HandlerFunc](convert-handlers/nethttp/main.go)
-            * [From func(http.HandlerFunc) http.HandlerFunc](convert-handlers/real-usecase-raven/writing-middleware/main.go)
+            * [From func(http.Handler) http.Handler](convert-handlers/wrapper/main.go)
+            * [Convert by your own: sentry/raven middleware](convert-handlers/real-usecase-raven/writing-middleware/main.go)
     * [Rewrite Middleware](routing/rewrite/main.go)
     * [Route State](routing/route-state/main.go)
+    * [Remove Route](routing/remove-route/main.go)
     * [Reverse Routing](routing/reverse/main.go)
     * [Router Wrapper](routing/custom-wrapper/main.go)
     * [Custom Router](routing/custom-router/main.go)
@@ -100,11 +116,13 @@ To read the Iris documentation please navigate to [the wiki pages](https://githu
         * [The CSV Formatter](logging/request-logger/accesslog-csv/main.go)
         * [Create your own Formatter](logging/request-logger/accesslog-formatter/main.go)
         * [Root and Proxy AccessLog instances](logging/request-logger/accesslog-proxy/main.go)
+        * [Slack integration example](logging/request-logger/accesslog-slack/main.go)
 * API Documentation
     * [Yaag](apidoc/yaag/main.go)
-    * [Swagger](https://github.com/iris-contrib/swagger/tree/master/example)
+    * [Swagger](https://github.com/iris-contrib/swagger/tree/master/_examples/basic)
 * [Testing](testing/httptest/main_test.go)
 * [Recovery](recover/main.go)
+    * [Panic and custom Error Handler with Compression](recover/panic-and-custom-error-handler-with-compression/main.go)
 * [Profiling](pprof/main.go)
 * File Server
     * [File Server](file-server/file-server/main.go)
@@ -123,6 +141,7 @@ To read the Iris documentation please navigate to [the wiki pages](https://githu
         * [Embedded Single Page Application with other routes](file-server/single-page-application/embedded-single-page-application-with-other-routes/main.go)
     * [Upload File](file-server/upload-file/main.go)
     * [Upload Multiple Files](file-server/upload-files/main.go)
+    * [WebDAV](file-server/webdav/main.go)
 * View
     * [Overview](view/overview/main.go)
     * [Layout](view/layout)
@@ -174,6 +193,7 @@ To read the Iris documentation please navigate to [the wiki pages](https://githu
 * [Webassembly](webassembly/main.go)
 * Request Body
     * [Bind JSON](request-body/read-json/main.go)
+    *   * [JSON Stream and disable unknown fields](request-body/read-json-stream/main.go)
     *   * [Struct Validation](request-body/read-json-struct-validation/main.go)
     * [Bind XML](request-body/read-xml/main.go)
     * [Bind MsgPack](request-body/read-msgpack/main.go)
@@ -195,9 +215,9 @@ To read the Iris documentation please navigate to [the wiki pages](https://githu
     * [Protocol Buffers](response-writer/protobuf/main.go)
     * [HTTP/2 Server Push](response-writer/http2push/main.go)
     * [Stream Writer](response-writer/stream-writer/main.go)
-    * [Transactions](response-writer/transactions/main.go)
-    * [SSE](response-writer/sse/main.go)
-    * [SSE (third-party package usage for server sent events)](response-writer/sse-third-party/main.go)
+    * [Server-Sent Events](response-writer/sse/main.go)
+        * [SSE 3rd-party (r3labs/sse)](response-writer/sse-third-party/main.go)
+        * [SSE 3rd-party (alexandrevicenzi/go-sse)](response-writer/sse-third-party-2/main.go)
     * Cache
         * [Simple](response-writer/cache/simple/main.go)
         * [Client-Side (304)](response-writer/cache/client-side/main.go)
@@ -209,7 +229,8 @@ To read the Iris documentation please navigate to [the wiki pages](https://githu
     * [Basic](i18n/basic)
     * [Ttemplates and Functions](i18n/template)
     * [Pluralization and Variables](i18n/plurals)
-* Authentication, Authorization & Bot Detection 
+* Authentication, Authorization & Bot Detection
+    * [Recommended: Auth package and Single-Sign-On](auth/auth) **NEW (GO 1.18 Generics required)**
     * Basic Authentication
         * [Basic](auth/basicauth/basic)
         * [Load from a slice of Users](auth/basicauth/users_list)
@@ -267,12 +288,14 @@ To read the Iris documentation please navigate to [the wiki pages](https://githu
     * [Hello world](mvc/hello-world/main.go)
     * [Basic](mvc/basic/main.go)
         * [Wildcard](mvc/basic/wildcard/main.go)
+    * [Default request values](mvc/request-default-values/main.go)
     * [Singleton](mvc/singleton)
     * [Regexp](mvc/regexp/main.go)
     * [Session Controller](mvc/session-controller/main.go)
     * [Authenticated Controller](mvc/authenticated-controller/main.go)
     * [Versioned Controller](mvc/versioned-controller/main.go)
     * [Websocket Controller](mvc/websocket)
+        * [Websocket + Authentication (Single-Sign-On)](mvc/websocket-auth) **NEW (GO 1.18 Generics required)**
     * [Register Middleware](mvc/middleware)
     * [gRPC](mvc/grpc-compatible)
     * [gRPC Bidirectional Stream](mvc/grpc-compatible-bidirectional-stream)
@@ -284,7 +307,6 @@ To read the Iris documentation please navigate to [the wiki pages](https://githu
     * [Handle errors using mvc.Result](mvc/error-handler-custom-result)
     * [Handle errors using PreflightResult](mvc/error-handler-preflight)
     * [Handle errors by hijacking the result](mvc/error-handler-hijack)
-* [Bootstrapper](bootstrapper)
 * Desktop Applications
     * [The blink package](desktop/blink)
     * [The lorca package](desktop/lorca)
@@ -293,9 +315,9 @@ To read the Iris documentation please navigate to [the wiki pages](https://githu
 
 ## Run
 
-1. Install the Go Programming Language, version 1.15+ from [here](https://golang.org/dl).
+1. Install the Go Programming Language, version 1.18+ from [here](https://go.dev/dl/).
 2. [Download the examples](https://github.com/iris-contrib/examples/archive/master.zip) and copy-paste them to your `$GOPATH/src/github.com/iris-contrib/examples`
-3. Install Iris with `go get -u github.com/kataras/iris/[email protected]alpha2` 
+3. Install Iris with `go get -u github.com/kataras/iris/[email protected]beta3` 
 
 To run an example, open a terminal session and execute:
 

.travis.yml

@@ -1,8 +1,56 @@
 module github.com/iris-contrib/examples/apidoc/yaag
 
-go 1.15
+go 1.18
 
 require (
 	github.com/betacraft/yaag v1.0.1-0.20200719063524-47d781406108
-	github.com/kataras/iris/v12 master
+	github.com/kataras/iris/v12 v12.2.0-beta3
+)
+
+require (
+	github.com/BurntSushi/toml v1.1.0 // indirect
+	github.com/CloudyKit/fastprinter v0.0.0-20200109182630-33d98a066a53 // indirect
+	github.com/CloudyKit/jet/v6 v6.1.0 // indirect
+	github.com/Shopify/goreferrer v0.0.0-20210630161223-536fa16abd6f // indirect
+	github.com/andybalholm/brotli v1.0.4 // indirect
+	github.com/aymerick/douceur v0.2.0 // indirect
+	github.com/eknkc/amber v0.0.0-20171010120322-cdade1c07385 // indirect
+	github.com/fatih/structs v1.1.0 // indirect
+	github.com/flosch/pongo2/v4 v4.0.2 // indirect
+	github.com/goccy/go-json v0.9.8-0.20220506185958-23bd66f4c0d5 // indirect
+	github.com/golang/snappy v0.0.4 // indirect
+	github.com/google/uuid v1.3.0 // indirect
+	github.com/gorilla/css v1.0.0 // indirect
+	github.com/iris-contrib/jade v1.1.4 // indirect
+	github.com/iris-contrib/schema v0.0.6 // indirect
+	github.com/josharian/intern v1.0.0 // indirect
+	github.com/json-iterator/go v1.1.12 // indirect
+	github.com/kataras/blocks v0.0.5 // indirect
+	github.com/kataras/golog v0.1.7 // indirect
+	github.com/kataras/pio v0.0.10 // indirect
+	github.com/kataras/sitemap v0.0.5 // indirect
+	github.com/kataras/tunnel v0.0.4 // indirect
+	github.com/klauspost/compress v1.15.5 // indirect
+	github.com/mailgun/raymond/v2 v2.0.46 // indirect
+	github.com/mailru/easyjson v0.7.7 // indirect
+	github.com/microcosm-cc/bluemonday v1.0.18 // indirect
+	github.com/modern-go/concurrent v0.0.0-20180228061459-e0a39a4cb421 // indirect
+	github.com/modern-go/reflect2 v1.0.2 // indirect
+	github.com/russross/blackfriday/v2 v2.1.0 // indirect
+	github.com/schollz/closestmatch v2.1.0+incompatible // indirect
+	github.com/sirupsen/logrus v1.8.1 // indirect
+	github.com/tdewolff/minify/v2 v2.11.7 // indirect
+	github.com/tdewolff/parse/v2 v2.5.32 // indirect
+	github.com/valyala/bytebufferpool v1.0.0 // indirect
+	github.com/vmihailenco/msgpack/v5 v5.3.5 // indirect
+	github.com/vmihailenco/tagparser/v2 v2.0.0 // indirect
+	github.com/yosssi/ace v0.0.5 // indirect
+	golang.org/x/crypto v0.0.0-20220507011949-2cf3adece122 // indirect
+	golang.org/x/net v0.0.0-20220425223048-2871e0cb64e4 // indirect
+	golang.org/x/sys v0.0.0-20220503163025-988cb79eb6c6 // indirect
+	golang.org/x/text v0.3.7 // indirect
+	golang.org/x/time v0.0.0-20220411224347-583f2d630306 // indirect
+	google.golang.org/protobuf v1.28.0 // indirect
+	gopkg.in/ini.v1 v1.66.6 // indirect
+	gopkg.in/yaml.v3 v3.0.0-20210107192922-496545a6307b // indirect
 )

LICENSE

@@ -0,0 +1,12 @@
+# Auth Package (+ Single Sign On)
+
+```sh
+$ go run .
+```
+
+1. GET/POST: http://localhost:8080/signin
+2. GET: http://localhost:8080/member
+3. GET: http://localhost:8080/owner
+4. POST: http://localhost:8080/refresh
+5. GET: http://localhost:8080/signout
+6. GET: http://localhost:8080/signout-all

README.md

@@ -0,0 +1,36 @@
+Headers: # required.
+  - "Authorization"
+  - "X-Authorization"
+Cookie: # optional.
+  Name: "iris_auth_cookie"
+  Secure: false
+  Hash: "D*G-KaPdSgUkXp2s5v8y/B?E(H+MbQeThWmYq3t6w9z$C&F)J@NcRfUjXn2r4u7x" # length of 64 characters (512-bit).
+  Block: "VkYp3s6v9y$B&E)H@McQfTjWmZq4t7w!" # length of 32 characters (256-bit).
+Keys:
+  - ID: IRIS_AUTH_ACCESS # required.
+    Alg: EdDSA
+    MaxAge: 2h # 2 hours lifetime for access tokens. 
+    Private: |+
+      -----BEGIN PRIVATE KEY-----
+      MC4CAQAwBQYDK2VwBCIEIFdZWoDdFny5SMnP9Fyfr8bafi/B527EVZh8JJjDTIFO
+      -----END PRIVATE KEY-----
+    Public: |+
+      -----BEGIN PUBLIC KEY-----
+      MCowBQYDK2VwAyEAzpgjKSr9E032DX+foiOxq1QDsbzjLxagTN+yVpGWZB4=
+      -----END PUBLIC KEY-----
+  - ID: IRIS_AUTH_REFRESH # optional. Good practise to have it though.
+    Alg: EdDSA
+    # 1 month lifetime for refresh tokens,
+    # after that period the user has to signin again.
+    MaxAge: 720h
+    Private: |+
+      -----BEGIN PRIVATE KEY-----
+      MC4CAQAwBQYDK2VwBCIEIHJ1aoIjA2sRp5eqGjGR3/UMucrHbBdBv9p8uwfzZ1KZ
+      -----END PRIVATE KEY-----
+    Public: |+
+      -----BEGIN PUBLIC KEY-----
+      MCowBQYDK2VwAyEAsKKAr+kDtfAqwG7cZdoEAfh9jHt9W8qi9ur5AA1KQAQ=
+      -----END PUBLIC KEY-----
+    # Example of setting a binary form of the encryption key for refresh tokens,
+    # it could be a "string" as well.
+    EncryptionKey: !!binary stSNLTu91YyihPxzeEOXKwGVMG00CjcC/68G8nMgmqA=