lennarb 0.1.7 → 0.2.0

data/lib/lenna/middleware/default/error_handler.rb

@@ -1,243 +0,0 @@
-# frozen_string_literal: true
-
-# Released under the MIT License.
-# Copyright, 2023, by Aristóteles Coutinho.
-
-require 'cgi'
-
-module Lenna
-	module Middleware
-		module Default
-			# This middleware will handle errors.
-			#
-			# @private Since `v0.1.0`
-			#
-			module ErrorHandler
-				extend self
-
-				# This method will be called by the server.
-				#
-				# @parameter req             [Rack::Request] The request object
-				# @parameter res             [Rack::Response] The response object
-				# @parameter next_middleware [Proc] The next middleware in the stack
-				#
-				# @return                    [void]
-				#
-				def call(req, res, next_middleware)
-					next_middleware.call
-				rescue StandardError => e
-					env = req.env
-					log_error(env, e)
-
-					render_error_page(e, req, res)
-				end
-
-				private
-
-				# This method will render the error page.
-				#
-				# @parameter error [StandardError] The error object
-				# @parameter env   [Hash] The environment variables
-				# @parameter res   [Rack::Response] The response object
-				#
-				# @return          [void]
-				#
-				def render_error_page(error, req, res)
-					case req.headers['Content-Type']
-					in 'application/json' then render_json(error, res)
-					else render_html(error, res)
-					end
-				end
-
-				# This method will render the JSON error page.
-				#
-				# @parameter error [StandardError] The error object
-				# @parameter env   [Hash] The environment variables
-				# @parameter res   [Rack::Response] The response object
-				#
-				# @return          [void]
-				#
-				def render_json(error, res)
-					case ENV.fetch('RACK_ENV', 'development')
-					in 'development' | 'test' then res.json(
-						data: {
-							error: error.message,
-							status: 500
-						}
-					)
-					else res.json(data: { error: 'Internal Server Error', status: 500 })
-					end
-				end
-
-				# This method will render the HTML error page.
-				#
-				# @parameter error [StandardError] The error object
-				# @parameter env   [Hash] The environment variables
-				# @parameter res   [Rack::Response] The response object
-				#
-				# @return          [void]
-				#
-				def render_html(error, res)
-					res.html(error_page(error), status: 500)
-				end
-
-				# This method will log the error.
-				#
-				# @parameter env   [Hash] The environment variables
-				# @parameter error [StandardError] The error object
-				#
-				# @return          [void]
-				#
-				def log_error(env, error)
-					env['rack.errors'].puts error.message
-					env['rack.errors'].puts error.backtrace.join("\n")
-					env['rack.errors'].flush
-				end
-
-				# This method will render the error page.
-				#
-				def error_page(error)
-					style = <<-STYLE
-          <style>
-            body { font-family: 'Helvetica Neue', sans-serif; background-color: #F7F7F7; color: #333; margin: 0; padding: 0; }
-            .error-container { max-width: 600px; margin: 20px auto; padding: 20px; box-shadow: 0 4px 8px 0 rgba(0,0,0,0.1); background: white; border-radius: 4px; }
-            h1 { color: #c0392b }
-            h2 { padding: 0; margin: 0; font-size: 1.2em; }
-            .error-details, .backtrace { text-align: left; }
-            .error-details strong { color: #e74c3c; }
-            pre { background: #ecf0f1; padding: 15px; overflow: auto; border-left: 5px solid #e74c3c; font-size: 0.9em; }
-            .backtrace { margin-top: 20px; }
-            .backtrace pre { border-color: #3498db; }
-            svg { fill: #e74c3c; width: 50px; height: auto; }
-            .container { display: flex; justify-content: space-between; align-items: center; align-content: center;}
-          </style>
-					STYLE
-
-					# SVG logo
-					svg_logo = <<~SVG
-            <svg xmlns="http://www.w3.org/2000/svg" x="0px" y="0px" width="100" height="100" viewBox="0 0 100 100">
-      <path fill="#f1bc19" d="M77 12A1 1 0 1 0 77 14A1 1 0 1 0 77 12Z"></path><path fill="#e4e4f9" d="M50 13A37 37 0 1 0 50 87A37 37 0 1 0 50 13Z"></path><path fill="#f1bc19" d="M83 11A4 4 0 1 0 83 19A4 4 0 1 0 83 11Z"></path><path fill="#8889b9" d="M87 22A2 2 0 1 0 87 26A2 2 0 1 0 87 22Z"></path><path fill="#fbcd59" d="M81 74A2 2 0 1 0 81 78 2 2 0 1 0 81 74zM15 59A4 4 0 1 0 15 67 4 4 0 1 0 15 59z"></path><path fill="#8889b9" d="M25 85A2 2 0 1 0 25 89A2 2 0 1 0 25 85Z"></path><path fill="#fff" d="M18.5 49A2.5 2.5 0 1 0 18.5 54 2.5 2.5 0 1 0 18.5 49zM79.5 32A1.5 1.5 0 1 0 79.5 35 1.5 1.5 0 1 0 79.5 32z"></path><g><path fill="#fdfcee" d="M50 25.599999999999998A24.3 24.3 0 1 0 50 74.2A24.3 24.3 0 1 0 50 25.599999999999998Z"></path><path fill="#472b29" d="M50,74.8c-13.8,0-25-11.2-25-25c0-13.8,11.2-25,25-25c13.8,0,25,11.2,25,25C75,63.6,63.8,74.8,50,74.8z M50,26.3c-13,0-23.5,10.6-23.5,23.5S37,73.4,50,73.4s23.5-10.6,23.5-23.5S63,26.3,50,26.3z"></path></g><g><path fill="#ea5167" d="M49.9 29.6A20.4 20.4 0 1 0 49.9 70.4A20.4 20.4 0 1 0 49.9 29.6Z"></path></g><g><path fill="#ef7d99" d="M50.2,32.9c10.6,0,19.3,8.2,20.1,18.5c0-0.5,0.1-1,0.1-1.5c0-11-9-20-20.2-20c-11.1,0-20.2,9-20.2,20 c0,0.5,0,1,0.1,1.5C30.9,41,39.5,32.9,50.2,32.9z"></path></g><g><path fill="#472b29" d="M69.4,44.6c-0.2,0-0.4-0.1-0.5-0.4c-0.1-0.3-0.2-0.6-0.3-0.9c-0.4-1.1-0.9-2.2-1.5-3.2 c-0.1-0.2-0.1-0.5,0.2-0.7c0.2-0.1,0.5-0.1,0.7,0.2c0.6,1.1,1.1,2.2,1.5,3.3c0.1,0.3,0.2,0.6,0.3,0.9c0.1,0.3-0.1,0.5-0.3,0.6 C69.5,44.6,69.5,44.6,69.4,44.6z"></path></g><g><path fill="#472b29" d="M50,70.8c-11.5,0-20.9-9.3-20.9-20.8c0-11.5,9.4-20.8,20.9-20.8c6,0,11.7,2.6,15.6,7c0.3,0.3,0.6,0.7,0.9,1 c0.2,0.2,0.1,0.5-0.1,0.7c-0.2,0.2-0.5,0.1-0.7-0.1c-0.3-0.3-0.5-0.7-0.8-1c-3.8-4.2-9.2-6.7-14.9-6.7c-11,0-19.9,8.9-19.9,19.8 c0,10.9,8.9,19.8,19.9,19.8s19.9-8.9,19.9-19.8c0-1-0.1-2-0.2-3c0-0.3,0.1-0.5,0.4-0.6c0.3,0,0.5,0.1,0.6,0.4 c0.2,1,0.2,2.1,0.2,3.1C70.9,61.4,61.5,70.8,50,70.8z"></path></g><g><path fill="#fdfcee" d="M56,57.1c-0.3,0-0.6-0.1-0.9-0.4l-5.2-5.2l-5.2,5.2c-0.2,0.2-0.5,0.4-0.9,0.4s-0.6-0.1-0.9-0.4 c-0.5-0.5-0.5-1.2,0-1.7l5.2-5.2L43,44.6c-0.5-0.5-0.5-1.2,0-1.7c0.2-0.2,0.5-0.4,0.9-0.4s0.6,0.1,0.9,0.4l5.2,5.2l5.2-5.2 c0.2-0.2,0.5-0.4,0.9-0.4c0.3,0,0.6,0.1,0.9,0.4s0.4,0.5,0.4,0.9s-0.1,0.6-0.4,0.9l-5.2,5.2l5.2,5.2c0.2,0.2,0.4,0.5,0.4,0.9 c0,0.3-0.1,0.6-0.4,0.9S56.3,57.1,56,57.1z"></path><path fill="#472b29" d="M56,43.1c0.2,0,0.4,0.1,0.5,0.2c0.3,0.3,0.3,0.7,0,1l-5.5,5.5l5.5,5.5c0.3,0.3,0.3,0.7,0,1 c-0.1,0.1-0.3,0.2-0.5,0.2s-0.4-0.1-0.5-0.2l-5.5-5.5l-5.5,5.5c-0.1,0.1-0.3,0.2-0.5,0.2s-0.4-0.1-0.5-0.2c-0.3-0.3-0.3-0.7,0-1 l5.5-5.5l-5.5-5.5c-0.3-0.3-0.3-0.7,0-1c0.1-0.1,0.3-0.2,0.5-0.2s0.4,0.1,0.5,0.2l5.5,5.5l5.5-5.5C55.6,43.1,55.8,43.1,56,43.1 M56,42.1c-0.5,0-0.9,0.2-1.2,0.5l-4.8,4.8l-4.8-4.8c-0.3-0.3-0.8-0.5-1.2-0.5s-0.9,0.2-1.2,0.5c-0.3,0.3-0.5,0.8-0.5,1.2 s0.2,0.9,0.5,1.2l4.8,4.8l-4.8,4.8c-0.3,0.3-0.5,0.8-0.5,1.2s0.2,0.9,0.5,1.2c0.3,0.3,0.8,0.5,1.2,0.5s0.9-0.2,1.2-0.5l4.8-4.8 l4.8,4.8c0.3,0.3,0.8,0.5,1.2,0.5s0.9-0.2,1.2-0.5c0.3-0.3,0.5-0.8,0.5-1.2s-0.2-0.9-0.5-1.2l-4.8-4.8l4.8-4.8 c0.3-0.3,0.5-0.8,0.5-1.2s-0.2-0.9-0.5-1.2C56.9,42.2,56.4,42.1,56,42.1L56,42.1z"></path></g>
-      </svg>
-      #{'    '}
-					SVG
-
-					# HTML page
-					<<-HTML
-          <!DOCTYPE html>
-          <html lang="en">
-          <head>
-            <meta charset="UTF-8">
-            <meta name="viewport" content="width=device-width, initial-scale=1.0">
-          #{' '}
-            <title>System Error</title>
-            #{style}
-          </head>
-          <body>
-            <div class="error-container">
-              <div class="container">
-                <div class="item-left">
-                  <h1>Oops! An error has occurred.</h1>
-                </div>
-                <div class="item-right">#{svg_logo}</div>
-              </div>
-          #{'    '}
-              #{error_message_and_backtrace(error)}
-            </div>
-          </body>
-          </html>
-					HTML
-				end
-
-				# This method will render the error message and backtrace.
-				#
-				# @parameter error [StandardError] The error object
-				# @parameter env   [Hash] The environment variables
-				#
-				# @return          [String] The HTML string
-				#
-				def error_message_and_backtrace(error)
-					if ENV['RACK_ENV'] == 'development'
-						truncated_message =
-							error.message[0..500] + (error.message.length > 500 ? '...' : '')
-
-						file, line = error.backtrace.first.split(':')
-						line_number = Integer(line)
-						<<-DETAILS
-                <div class="error-details">
-                  <h2>Error Details:</h2>
-                  <p>
-                    <strong>Message:</strong> <span id="error-message">#{CGI.escapeHTML(truncated_message)}</span>
-                  </p>
-                  <div>
-                    <p><strong>Location:</strong> #{CGI.escapeHTML(file)}:#{line_number}</p>
-                    <pre>#{extract_source(file, line_number)}</pre>
-                  </div>
-
-                  <details>
-                    <summary>Details</summary>
-                    <p id="full-message" style="display: none;">
-                      <h3>Full Backtrace:</h3>
-                      <p><strong>Full Message:</strong> #{CGI.escapeHTML(error.message)}</p>
-                      <pre>#{error.backtrace.join("\n")}</pre>
-                    </p>
-                  </details>
-                </div>
-						DETAILS
-					else
-						"<p>We're sorry, but something went wrong. We've been notified " \
-							'about this issue and will take a look at it shortly.</p>'
-					end
-				end
-
-				# This method will extract the source code.
-				#
-				# @parameter file        [String] The file path
-				# @parameter line_number [Integer] The line number
-				#
-				# @return                [String] The HTML string
-				#
-				# ex.
-				#   extract_source('/path/to/file.rb', 10)
-				#   # => "<strong style='color: red;'>    7: </strong> =>
-				#         def foo\n<strong style='color: red;'>    8: </strong>
-				#         puts 'bar'\n<strong style='color: red;'>    9: </strong>
-				#         end\n<strong style='color: red;'>   10: </strong> foo\n<strong
-				#         style='color: red;'>   11: </strong> "
-				#
-				def extract_source(file, line_number)
-					lines = ::File.readlines(file)
-					start_line = [line_number - 3, 0].max
-					end_line = [line_number + 3, lines.size].min
-
-					line_ranger = lines[start_line...end_line]
-
-					format_lines(line_ranger, line_number).join
-				end
-
-				# This method will format the lines.
-				#
-				# ex.
-				#   format_lines(line_ranger, line_number)
-				#   # => ["<strong style='color: red;'>    7: </strong> =>\n",
-				#         "<strong style='color: red;'>    8: </strong> puts 'bar'\n",
-				#         "<strong style='color: red;'>    9: </strong> end\n",
-				#         "<strong style='color: red;'>   10: </strong> foo\n",
-				#         "<strong style='color: red;'>   11: </strong> "]
-				#
-				def format_lines(lines, highlight_line)
-					lines.map.with_index(highlight_line - 3 + 1) do |line, line_num|
-						line_number_text = "#{line_num.to_s.rjust(6)}: "
-						formatted_line = ::CGI.escapeHTML(line)
-
-						if line_num == highlight_line
-							"<strong style='color: red;'>#{line_number_text}</strong> " \
-								"#{formatted_line}"
-						else
-							"#{line_number_text}#{formatted_line}"
-						end
-					end
-				end
-			end
-		end
-	end
-end

data/lib/lenna/middleware/default/logging.rb

@@ -1,93 +0,0 @@
-# frozen_string_literal: true
-
-# Released under the MIT License.
-# Copyright, 2023, by Aristóteles Coutinho.
-
-require 'colorize'
-
-module Lenna
-	module Middleware
-		module Default
-			# The Logging module is responsible for logging the requests.
-			#
-			# @private
-			#
-			module Logging
-				extend self
-
-				# This method is used to log the request.
-				#
-				# @parameter req             [Rack::Request ] The request
-				# @parameter res             [Rack::Response] The response
-				# @parameter next_middleware [Proc]           The next middleware
-				#
-				def call(req, res, next_middleware)
-					start_time = ::Time.now
-					next_middleware.call
-					end_time = ::Time.now
-
-					http_method = colorize_http_method(req.request_method)
-					status_code = colorize_status_code(res.status.to_s)
-					duration = calculate_duration(start_time, end_time)
-
-					log_message = "[#{start_time}] \"#{http_method} #{req.path_info}\" " \
-																			"#{status_code} #{format('%.2f', duration)}ms"
-
-					::Kernel.puts(log_message)
-				end
-
-				private
-
-				# This method is used to colorize the request method.
-				#
-				# @parameter request_method [String] The request method
-				#
-				# @return                   [String] The colorized request method
-				#
-				# @private
-				#
-				def colorize_http_method(request_method)
-					case request_method
-					in 'GET' then 'GET'.green
-					in 'POST' then 'POST'.magenta
-					in 'PUT' then 'PUT'.yellow
-					in 'DELETE' then 'DELETE'.red
-					else request_method.blue
-					end
-				end
-
-				# This method is used to colorize the status code.
-				#
-				# @param status_code [String] The status code
-				#
-				# @return            [String] The colorized status code
-				#
-				# @private
-				#
-				def colorize_status_code(status_code)
-					case status_code
-					in '2' then status_code.green
-					in '3' then status_code.blue
-					in '4' then status_code.yellow
-					in '5' then status_code.red
-					else status_code
-					end
-				end
-
-				# This method is used to calculate the duration.
-				#
-				# @param start_time [Time] The start time
-				#
-				# @param end_time   [Time] The end time
-				# @return           [Float] The duration
-				#
-				# @api private
-				#
-				def calculate_duration(start_time, end_time)
-					millis_in_second = 1000.0
-					(end_time - start_time) * millis_in_second
-				end
-			end
-		end
-	end
-end

data/lib/lenna/middleware/default/reload.rb

@@ -1,97 +0,0 @@
-# frozen_string_literal: true
-
-# Released under the MIT License.
-# Copyright, 2023, by Aristóteles Coutinho.
-
-require 'console'
-
-# This middleware is used to reload files in development mode.
-#
-module Lenna
-	module Middleware
-		module Default
-			class Reload
-				attr_accessor :directories, :files_mtime
-
-				# Initializes a new instance of Middleware::Default::Reload.
-				#
-				# @parameter directories [Array] An array of directories to monitor.
-				#
-				# @return [Middleware::Default::Reload] A new instance of Middleware::Default::Reload.
-				def initialize(directories = [])
-					self.files_mtime = {}
-					self.directories = directories
-
-					monitor_directories(directories)
-				end
-
-				# Calls the middleware.
-				#
-				# @parameter req             [Rack::Request] The request.
-				# @parameter _res            [Rack::Response] The response.
-				# @parameter next_middleware [Proc] The next middleware.
-				#
-				# @return [void]
-				#
-				def call(_req, _res, next_middleware)
-					reload_if_needed
-
-					next_middleware.call
-				rescue ::StandardError => error
-					::Console.error(self, error)
-				end
-
-				private
-
-				# Reloads files if needed.
-				#
-				# @return [void]
-				#
-				def reload_if_needed
-					modified_files = check_for_modified_files
-
-					reload_files(modified_files) unless modified_files.empty?
-				end
-
-				# Monitors directories for changes.
-				#
-				# @parameter directories [Array] An array of directories to monitor.
-				#
-				# @return [void]
-				#
-				def monitor_directories(directories)
-					directories.each do |directory|
-						::Dir.glob(directory).each { |file| files_mtime[file] = ::File.mtime(file) }
-					end
-				end
-
-				# Checks for modified files.
-				#
-				# @return [Array] An array of modified files.
-				#
-				# @example
-				#   check_for_modified_files #=> ["/path/to/file.rb"]
-				#
-				def check_for_modified_files
-					@files_mtime.select do |file, last_mtime|
-						::File.mtime(file) > last_mtime
-					end.keys
-				end
-
-				# Reloads files.
-				#
-				# @parameter files [Array] An array of files(paths) to reload.
-				#
-				# @return [void]
-				#
-				def reload_files(files)
-					files.each do |file|
-						::Console.debug("Reloading #{file}")
-						::Kernel.load file
-						@files_mtime[file] = ::File.mtime(file)
-					end
-				end
-			end
-		end
-	end
-end

data/lib/lenna/router/builder.rb

@@ -1,124 +0,0 @@
-# frozen_string_literal: true
-
-# Released under the MIT License.
-# Copyright, 2023, by Aristóteles Coutinho.
-
-module Lenna
-	class Router
-		# The Route::Builder class is responsible for building the tree of routes.
-		#
-		# The tree of routes is built by adding routes to the tree. Each route is
-		# represented by a node in the tree and each node has a path and an
-		# endpoint. The path is the path of the route and the endpoint is then
-		# action to be executed when the route is matched.
-		#
-		# Those nodes are stored in a cache to avoid rebuilding the tree of routes
-		# for each request.
-		#
-		# The tree use `Trie` data structures to optimize the search for a route.
-		# The trie is a tree where each node is a character of the path.
-		# This way, the search for a route is O(n) where n is the length of the
-		# path.
-		#
-		# @private
-		#
-		class Builder
-			def initialize(root_node) = @root_node = root_node
-
-			# This method will add a route to the tree of routes.
-			#
-			# @parameter method  [String] the HTTP method
-			# @parameter path    [String] the path to be matched
-			# @parameter action  [Proc]   the action to be executed
-			# @parameter cache   [Cache]  the cache to be used
-			#
-			# @return            [void]
-			#
-			def call(method, path, action, cache)
-				path_key = cache.cache_key(method, path)
-
-				return if cache.exist?(path_key)
-
-				current_node = find_or_create_route_node(path)
-				setup_endpoint(current_node, method, action)
-
-				cache.add(path_key, current_node)
-			end
-
-			private
-
-			# This method will create routes that are missing.
-			# @parameter path [String] the path to be matched
-			#
-			# @return         [Node]   the node that matches the path
-			#
-			def find_or_create_route_node(path)
-				current_node = @root_node
-				split_path(path).each do |part|
-					current_node = find_or_create_node(current_node, part)
-				end
-				current_node
-			end
-
-			# This method will create the nodes that are missing.
-			#
-			# @parameter current_node [Node]  the current node
-			# @parameter part         [String] the part of the path
-			#
-			# @return                 [Node]  the node that matches the part of the path
-			#
-			#                     This way, the tree of routes is built.
-			# @example            Given the part ':id' and the tree bellow:
-			#                     root
-			#                     └── users
-			#                         └── :id
-			#                     The method will return the node :id.
-			#                     If the node :id does not exist, it will be created.
-			#                     The tree will be:
-			#                     root
-			#                     └── users
-			#                         └── :id
-			#
-			def find_or_create_node(current_node, part)
-				if part.start_with?(':')
-					# If it is a placeholder, then we just create or update
-					# the placeholder node with the placeholder name.
-					placeholder_name = part[1..].to_sym
-					current_node.children[:placeholder] ||= Node.new(
-						{},
-						nil,
-						placeholder_name
-					)
-				else
-					current_node.children[part] ||= Node.new
-				end
-				current_node.children[part.start_with?(':') ? :placeholder : part]
-			end
-
-			# This method will setup the endpoint of the current node.
-			#
-			# @parameter current_node [Node]  the current node
-			# @parameter method       [String] the HTTP method
-			# @parameter action       [Proc]   the action to be executed
-			#
-			# @return                 [void]
-			#
-			def setup_endpoint(current_node, method, action)
-				current_node.endpoint ||= {}
-				current_node.endpoint[method] = action
-			end
-
-			# This method will split the path into parts.
-			#
-			# @parameter path [String] the path to be split
-			#
-			# @return         [Array]  the splitted path
-			#
-			# TODO: Move this to a separate file and require it here.
-			# Maybe utils or something like that.
-			# Use Rack::Utils.split_path_info instead.
-			#
-			def split_path(path) = path.split('/').reject(&:empty?)
-		end
-	end
-end

data/lib/lenna/router/cache.rb

@@ -1,52 +0,0 @@
-# frozen_string_literal: true
-
-# Released under the MIT License.
-# Copyright, 2023, by Aristóteles Coutinho.
-
-module Lenna
-	class Router
-		# This class is used to cache the routes.
-		#
-		# @private
-		#
-		class Cache
-			def initialize = @cache = {}
-
-			# This method is used to generate a key for the cache.
-			#
-			# @parameter [String] method
-			# @parameter [String] path
-			#
-			# @return [String]
-			#
-			def cache_key(method, path) = "#{method} #{path}"
-
-			# This method is used to add a route to the cache.
-			#
-			# @parameter route_key [String] The key for the route.
-			# @parameter node      [Lenna::Route::Node] The node for the route.
-			#
-			# @return              [Lenna::Route::Node]
-			#
-			def add(route_key, node) = @cache[route_key] = node
-
-			# This method is used to get a route from the cache.
-			#
-			# @parameter route_key [String] The key for the route.
-			#
-			# @return              [Lenna::Route::Node]
-			#
-			def get(route_key) = @cache[route_key]
-
-			# This method is used to check if a route is in the cache.
-			#
-			# @api public
-			#
-			# @parameter route_key [String] The key for the route.
-			#
-			# @return              [Boolean]
-			#
-			def exist?(route_key) = @cache.key?(route_key)
-		end
-	end
-end

data/lib/lenna/router/namespace_stack.rb

@@ -1,77 +0,0 @@
-# frozen_string_literal: true
-
-# Released under the MIT License.
-# Copyright, 2023, by Aristóteles Coutinho.
-
-module Lenna
-	class Router
-		# This class is used to manage the namespaces.
-		#
-		# @private `Since v0.1.0`
-		#
-		class NamespaceStack
-			# @return [Array] The stack of namespaces
-			#
-			# @private
-			#
-			attr_reader :stack
-
-			# The initialize method is used to initialize the stack of namespaces.
-			#
-			# @private
-			#
-			# @attibute stack [Array] The stack of namespaces
-			#
-			# @return [void]
-			#
-			def initialize = @stack = ['']
-
-			# This method is used to push a prefix to the stack.
-			#
-			# @parameter prefix [String] The prefix to be pushed
-			#
-			# @return           [void]
-			#
-			# ex.
-			#
-			#  stack = NamespaceStack.new
-			#  stack.push('/users')
-			#  stack.current_prefix # => '/users'
-			#
-			# @see #resolve_prefix
-			#
-			def push(prefix)
-				@stack.push(resolve_prefix(prefix))
-			end
-
-			# This method is used to remove the last prefix from the stack.
-			#
-			# @return [String] The popped prefix
-			#
-			def pop
-				@stack.pop unless @stack.size == 1
-			end
-
-			# @return [String] The current prefix
-			#
-			def current_prefix = @stack.last
-
-			# The to_s method is used to return the current prefix.
-			#
-			# @return [String] The current prefix
-			#
-			def to_s = current_prefix
-
-			private
-
-			# The resolve_prefix method is used to resolve the prefix.
-			#
-			# @parameter prefix [String] The prefix to be resolved
-			# @return           [String] The resolved prefix
-			#
-			def resolve_prefix(prefix)
-				current_prefix + prefix
-			end
-		end
-	end
-end