From 03bcadadec9e313216d9ecd056c2e3bb5be155b5 Mon Sep 17 00:00:00 2001 From: kataras Date: Sat, 3 Jun 2017 22:18:43 +0300 Subject: [PATCH] add history note for the next published version Former-commit-id: 07968f30448447994ea28c60d9f07916fdf74a4c --- .gitignore | 7 +-- HISTORY.md | 91 +++---------------------------- README.md | 156 +++-------------------------------------------------- 3 files changed, 16 insertions(+), 238 deletions(-) diff --git a/.gitignore b/.gitignore index 842c9846..e2d21c23 100644 --- a/.gitignore +++ b/.gitignore @@ -1,8 +1,5 @@ .settings .project .vscode -2M_donation_timeline.cpd -performance_tips.txt -notes.txt -organisations_using_iris.txt -independent_developers_using_iris.txt +specs +.github diff --git a/HISTORY.md b/HISTORY.md index 6663e71b..a30b6f4d 100644 --- a/HISTORY.md +++ b/HISTORY.md @@ -6,88 +6,25 @@ http://support.iris-go.com -_Update: 18 May 2017_ +## Sa, 03 June 2017 -Hello Community, @kataras sent me a report of some of the improvements he was coding for the last two months. -Here is a small preview of that report: - -Website -Thanks to [Santosh Anand](https://github.com/santoshanand) the http://iris-go.com has been upgraded and it's awesome! +New version 7 released. -[Santosh](https://github.com/santoshanand) is a freelancer, he has a good knowledge of nodejs and express js, Android, iOS, React Native, Vue.js etc, if you need a developer to find or create a solution for your problem or task, please contact with him. +Navigate to the [master](https://github.com/kataras/iris/tree/master) branch for more. -As Gerasimos explained to me, he will provide you more information about [Santosh Anand](https://github.com/santoshanand)'s profile later on. +This version, v6, will work "forever" by-design, it uses the vendor directory feature, so you get truly reproducible builds, as this method guards against upstream renames and delete. -People -- Some specifications will be published to help people with interest to understand how Iris works under the hood -- Every level of the framework's API has been simplified, code is a lot easier to read -- Guidelines for people who wants to contribute to the Iris project will be, finally, published. PRs can be approved after 2 or more code reviews +Developers are not forced to upgrade to the version 7 if they don't really need it. -General -- Desktop notifications for common errors, online solution is visible when user click on the "Balloon" (Can be turned off) -- Tray icon with useful links, including "docs and examples", "get free support", "chat with us" (Can be turned off) -- Several enhancements for typescript transpiler, view engine, websocket server and sessions manager +## v5 -> v6 -Routing -- New custom interpreter including parser and evaluator for routes' path, i.e `/users/{userid:int min(1)}`, `/users/{username:string regexp(...)`, `/assets/{file:path}` with custom "macros" and more (Optional, the old syntax is totally valid and safe) -- Remove of gorillamux, it's useless. The new way is faster than anything else we have seen in Go so far. -- Subdomains matching improvements -- Simplify API, i.e Handlers are now standalone functions, no need for `HandleFunc,UseFunc,DoneFunc,UseGlobalFunc`, only `Handle,Use,Done,UseGlobal` -- General speed improvements -- Cache with expiration, rules can be setted per route or globally +Users already notified for some breaking-changes, this section will help you +to adapt the new changes to your application, it contains an overview of the new features too. -Server -- Performance boost up to 8-12% on 5kkk+ connections -- Schedule custom tasks(with cancelation) when server is running -- Future Go1.9's [ServeTLS](https://go-review.googlesource.com/c/38114/2/src/net/http/server.go) has already adopted here -- New `Done` and `Err` channels to catch shutdown or any errors -- Able to set custom underline *http.Server(s) under the Iris' Server Supervisor -- Proxy removed, net/http has its own and it's good -- New tcp listening methods are easier to use, simplier to read - -Context -- Easy way to change Iris' default `Context` with a custom one -- Custom HTTP errors are fired when request is done , automatically -- `ResponseWriter().SetBeforeFlush(...)` works for Flush and HTTP/2 Push, respectfully -- `JSON, JSONP, XML, Markdown, HTML` faster -- Able to set `ViewData` and `ViewLayout` via middleware when executing a template -- Several improvements under the `Request transactions` -- And 16+ more additions, new features and API simplifications, will be documented when @kataras decide to publish the new release at github. - - -## 6.1.4 -> 6.2.0 (√Νεxτ) - -_Update: 12 April 2017_ - -``` -Many of you, including myself, thought that Gerasimos is not accepting any PRs, this is wrong. - -I did a long PR, which actually fixes some bugs and integrations with the godep tool, on a project that he's contributing too. - -The next day I'm logged into my personal twitter and I saw a message written by him. - -He, @kataras, wrote me that he was really impressed by the time I spent to actually fix a bug on an Iris sub-project. -He told me that no one did that before and he asked me if I have more time to help these days on the Iris project too. - -And, Here I am! Introducing myself to the most clever community! -``` - -``` -Hello, -my name is Esemplastic. - -Iris' author, @kataras, is very busy these days on designing the new Iris' release which will contain even more prototypes and it will break any rules you knew so far. -I took a sneak preview of it, don't tell to him! - - -I'm the temporary maintainer of this open-source project and your new friend. -``` - **FIX**: Upgrade the [httpcache](https://github.com/geekypanda/httpcache) vendor. As requested [here](http://support.iris-go.com/d/44-upgrade-httpcache-module). -_Update: 28 March 2017_ - - **View**: Provide an easier method on the community's question about "injecting" additional data outside of the route's main handler which calls the .Render, via middleware. - As discussed [above](http://support.iris-go.com/d/27-using-middleware-to-inject-properties-for-templates). - Click [here](https://github.com/kataras/iris/tree/v6/_examples/intermediate/view/context-view-data) for an example. @@ -103,18 +40,6 @@ _Update: 12 March 2017_ - Add a third parameter on `app.OnError(...)` for custom http errors with regexp validation, see [status_test.go](https://github.com/kataras/iris/blob/v6/status_test.go) for an example. - Add a `context.ParamIntWildcard(...)` to skip the first slash, useful for wildcarded paths' parameters. - -> Prepare for nice things, tomorrow is Iris' first birthday! - - -_Update: 28 Feb 2017_ - -> Note: I want you to know that I spent more than 200 hours (16 days of ~10-15 hours per-day, do the math) for this release, two days to write these changes, please read the sections before think that you have an issue and post a new question, thanks! - - -Users already notified for some breaking-changes, this section will help you -to adapt the new changes to your application, it contains an overview of the new features too. - - Shutdown with `app.Shutdown(context.Context) error`, no need for any third-parties, with `EventPolicy.Interrupted` and Go's 1.8 Gracefully Shutdown feature you're ready to go! - HTTP/2 Go 1.8 `context.Push(target string, opts *http.PushOptions) error` is supported, example can be found [here](https://github.com/kataras/iris/blob/v6/adaptors/websocket/_examples/websocket_secure/main.go) diff --git a/README.md b/README.md index 0651cea1..aca86cf9 100644 --- a/README.md +++ b/README.md @@ -1,44 +1,15 @@ -

- - Navigate to http://support.iris-go.com - +# Iris +

+Iris is an efficient and well-designed, cross-platform, web framework with robust set of features.
Build your own high-performance web applications and APIs powered by unlimited potentials and portability.
Build Status http://goreportcard.com/report/kataras/iris Iris support forum Examples for new Gophers Docs Chat Buy me a cup of coffee -
-Iris is an efficient and well-designed, cross-platform, web framework with robust set of features.
Build your own high-performance web applications and APIs powered by unlimited potentials and portability. - -If you're coming from Node.js world, this is the expressjs equivalent for the Go Programming Language.

-
-News - -Upcoming release - Calliope ------------ - -Hello people, I'm designing the new Iris version with the codename of "**Calliope**". - -Based on the **Greek goddesses** of ancient mythology, **Calliope** was one of the Muses, the muse of epic poetry, daughter of Zeus and Mnemosyne and the wisest of the Muses. - -The next, tactical, month release *should be published at the **1 May of 2017** *. - -I am making my bests to catch up this deadline, so I'm very busy these days. Sorry for being late to answer to your questions! - -**UPDATE: 6 May 2017** - -The release could be published at the first may of 2017 but it was postponed. - -The below tasks should be completed before publishing the new release: -- The review, of the new release's specifications that I wrote, should be ready at the next couple of days. -- The results from our beta testers may take a little more but it worths the waiting. -
- What you say about Iris ✌ -----------

@@ -71,6 +42,9 @@ src="https://github.com/iris-contrib/website/raw/gh-pages/assets/gif_link_to_yt. What people say +
+ +If you're coming from Node.js world, this is the expressjs equivalent for the Go Programming Language.

@@ -227,9 +201,6 @@ The only requirement is the [Go Programming Language](https://golang.org/dl/), a $ go get gopkg.in/kataras/iris.v6 ``` -For further installation support, navigate [here](http://support.iris-go.com/d/16-how-to-install-iris-web-framework). - - Overview ----------- @@ -385,17 +356,6 @@ Support - :earth_americas: post [an article](https://dzone.com/articles/a-url-shortener-service-using-go-iris-and-bolt-ger) or [tweet](https://twitter.com/gelnior/status/769100480706379776) and share it with your neighbor - - Buy me a cup of coffee? ------------ @@ -413,29 +373,6 @@ Feel free to send **any** amount through paypal Thanks for your gratitude and finance help ♡ - - - - - - Third Party Middleware ------------ @@ -466,87 +403,6 @@ Here is a small list of Iris compatible middleware, I'm sure you can find more: Feel free to put up a [PR](https://github.com/iris-contrib/middleware) your middleware! - - Testing ------------