Update to version 4.0.0

Author: grkek

docs/advanced_routing.md

@@ -19,8 +19,18 @@ end
 
 class Application < Grip::Application
   def initialize
-    super(environment: "development")
+        super(
+      environment: ENV["ENVIRONMENT"]? || "production"
+      handlers: [
+        Grip::Handlers::Pipeline.new,
+        Grip::Handlers::HTTP.new
+      ] of HTTP::Handler
+    )
+
+    routes()
+  end
 
+  def routes()
     pipeline :api, [
       AuthorizationHandler.new
     ]

docs/application.md

@@ -50,18 +50,6 @@ class Application < Grip::Application
 end
 ```
 
-### router
-
-The router of the application.
-
-```ruby
-class Application < Grip::Application
-  def router : Array(HTTP::Handler)
-    [] of HTTP::Handler
-  end
-end
-```
-
 ### server
 
 The server of the application.
@@ -76,7 +64,7 @@ end
 
 ### key_file
 
-The key_file of the application.
+The SSL key file location of the application.
 
 ```ruby
 class Application < Grip::Application
@@ -88,7 +76,7 @@ end
 
 ### cert_file
 
-The cert_file of the application.
+The SSL certificate file location of the application.
 
 ```ruby
 class Application < Grip::Application

docs/basic_routing.md

@@ -10,8 +10,18 @@ end
 
 class Application < Grip::Application
   def initialize
-    super(environment: "development")
+    def initialize
+        super(
+      environment: ENV["ENVIRONMENT"]? || "production"
+      handlers: [
+        Grip::Handlers::HTTP.new
+      ] of HTTP::Handler
+    )
 
+    routes()
+  end
+
+  def routes()
     # The routing occurs via the `get` macro which instantiates the controller class and assigns a route
     # to the routing mechanism.
     get "/", DemoController

docs/error_handling.md

@@ -21,8 +21,17 @@ end
 
 class Application < Grip::Application
   def initialize
-    super(environment: "development")
+    super(
+      environment: ENV["ENVIRONMENT"]? || "production"
+      handlers: [
+        Grip::Handlers::Exception.new,
+      ] of HTTP::Handler
+    )
 
+    routes()
+  end
+
+  def routes()
     exception Grip::Exceptions::Forbidden, ForbiddenController
   end
 end
@@ -64,8 +73,17 @@ end
 
 class Application < Grip::Application
   def initialize
-    super(environment: "development")
+    super(
+      environment: ENV["ENVIRONMENT"]? || "production"
+      handlers: [
+        Grip::Handlers::Exception.new,
+      ] of HTTP::Handler
+    )
+
+    routes()
+  end
 
+  def routes()
     exception NotImplementedError, FallbackController
   end
 end

docs/forward.md

@@ -13,7 +13,17 @@ end
 
 class Application < Grip::Application
   def initialize
-    super(environment: "development")
+    super(
+      environment: ENV["ENVIRONMENT"]? || "production"
+      handlers: [
+        Grip::Handlers::HTTP.new,
+      ] of HTTP::Handler
+    )
+
+    routes()
+  end
+
+  def routes()
 
     # Forward macro simply routes the matched requests to a certain Base controller
     # which contains a single call/1 function.

docs/getting_started.md

@@ -32,8 +32,17 @@ end
 
 class Application < Grip::Application
   def initialize
-    super(environment: "development")
+    super(
+      environment: ENV["ENVIRONMENT"]? || "production"
+      handlers: [
+        Grip::Handlers::HTTP.new,
+      ] of HTTP::Handler
+    )
 
+    routes()
+  end
+
+  def routes()
     get "/", DemoController
   end
 end

docs/intermediate_routing.md

@@ -19,8 +19,17 @@ end
 
 class Application < Grip::Application
   def initialize
-    super(environment: "development")
+    super(
+      environment: ENV["ENVIRONMENT"]? || "production"
+      handlers: [
+        Grip::Handlers::HTTP.new,
+      ] of HTTP::Handler
+    )
 
+    routes()
+  end
+
+  def routes()
     # The routing occurs via the `get` macro which instantiates the controller class and assigns a route
     # to the routing mechanism, the `as` keyword creates a Proc(Context, Context) and wraps it around
     # the index/1 function of the DemoController.

docs/pipe_middleware.md

@@ -21,8 +21,18 @@ end
 
 class Application < Grip::Application
   def initialize
-    super(environment: "development")
+    super(
+      environment: ENV["ENVIRONMENT"]? || "production"
+      handlers: [
+        Grip::Handlers::Pipeline.new,
+        Grip::Handlers::HTTP.new,
+      ] of HTTP::Handler
+    )
+
+    routes()
+  end
 
+  def routes()
     # Creating a pipeline with a single pipe to be routed through.
     pipeline :web, [
       DemoPipe.new

docs/raw_middleware.md

@@ -6,24 +6,19 @@ class DemoHandler
 
   def call(context : HTTP::Server::Context) : HTTP::Server::Context
     # Mutate the context and pass it on to the next handler.
+    call_next(context)
   end
 end
 
 class Application < Grip::Application
   def initialize
-    super(environment: "development")
-
-    # By default the router has 4 entries, if you insert a handler
-    # before the exception handler any exception that might occur in
-    # your newly inserted handler will not be handled and might crash the application.
-    #
-    # [
-    #   exception_handler,
-    #   pipeline_handler,
-    #   websocket_handler,
-    #   http_handler,
-    # ]
-    router.insert(1, DemoHandler.new)
+    super(
+      environment: ENV["ENVIRONMENT"]? || "production"
+      handlers: [
+        DemoHandler.new,
+        Grip::Handlers::HTTP.new,
+      ] of HTTP::Handler
+    )
   end
 end
 ```

docs/scope.md

@@ -10,8 +10,17 @@ end
 
 class Application < Grip::Application
   def initialize
-    super(environment: "development")
+    super(
+      environment: ENV["ENVIRONMENT"]? || "production"
+      handlers: [
+        Grip::Handlers::HTTP.new,
+      ] of HTTP::Handler
+    )
 
+    routes()
+  end
+
+  def routes()
     # The route gets built from the ground starting from the lowest GET /, to the top /api/v1.
     scope "/api/v1" do
       get "/", DemoController