a_little_less 0.2.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 78b9df128c2de9afe5b00581080345c962ad84d0
+  data.tar.gz: ba48dffa35cbb68ba9ebf5ffadaf880ce22b370d
+SHA512:
+  metadata.gz: 0c7cf9afae7d2dfd02e740d30fb82e42326bc1b3472c150f99cdffe40b8f4a9126b6bf35b96978afe5a881b8fd1b0af03a39bf17587a3e9a6dc9ea6d3dd804b3
+  data.tar.gz: 8d5968c8c2fb959b41eef38c6a854c74ff7b8ac373c9d14dc6e9cfd22cf6f63f6aca8548bf6226a2647f40e774ca0434ca1187a13f4ca75ecba809ebb73e5f74

data/.gitignore

@@ -0,0 +1,9 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in a_little_less.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2017 Tom Lobato
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,39 @@
+# ALittleLess
+
+A web framework a little more simple.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'a_little_less'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install a_little_less
+
+## Usage
+
+See the [/sample_app](https://github.com/tomlobato/little_less/tree/master/sample_app).
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake test` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+
+To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/[USERNAME]/a_little_less.
+
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).
+

data/Rakefile

@@ -0,0 +1,10 @@
+require "bundler/gem_tasks"
+require "rake/testtask"
+
+Rake::TestTask.new(:test) do |t|
+  t.libs << "test"
+  t.libs << "lib"
+  t.test_files = FileList['test/**/*_test.rb']
+end
+
+task :default => :test

data/_config.yml

@@ -0,0 +1 @@
+theme: jekyll-theme-cayman

data/a_little_less.gemspec

@@ -0,0 +1,33 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'a_little_less/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "a_little_less"
+  spec.version       = ALittleLess::VERSION
+  spec.authors       = ["Tom Lobato"]
+
+  spec.summary       = 'Basic web framework in Ruby'
+  spec.description   = 'Basic web framework in Ruby.'
+  spec.homepage      = "https://tomlobato.github.io/a_little_less"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files -z`.split("\x0").reject do |f|
+    f.match(%r{^(test|spec|features)/})
+  end
+  spec.bindir        = "exe"
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.14"
+  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency "minitest", "~> 5.0"
+
+  spec.add_runtime_dependency 'rack', '~> 2.0'
+  spec.add_runtime_dependency 'i18n', '~> 0.7'
+  spec.add_runtime_dependency 'colorize', '~> 0.8'
+  spec.add_runtime_dependency 'activerecord', '~> 5.0.2'
+  spec.add_runtime_dependency 'bugsnag', '~> 5.0'
+end
+

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "a_little_less"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require "irb"
+IRB.start(__FILE__)

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/lib/a_little_less.rb

@@ -0,0 +1,147 @@
+require "a_little_less/version"
+
+APP_ROOT = File.expand_path '.'
+
+require 'logger'
+require 'ostruct'
+require 'yaml'
+require 'json'
+require 'i18n'
+require 'singleton'
+require 'colorize'
+require 'active_record'
+
+class AlittleLess; end
+
+require_relative 'vendor/rails_blank'
+require_relative 'vendor/rails_inclusion'
+require_relative 'a_little_less/global'
+require_relative 'a_little_less/router'
+require_relative 'a_little_less/util'
+require_relative 'a_little_less/core_ext'
+require_relative 'a_little_less/global_logger'
+require_relative 'a_little_less/env'
+require_relative 'a_little_less/rack_app'
+
+class AlittleLess
+    DB_CONF = "config/db.yml"
+    include AlittleLess::Util
+    include AlittleLess::Router
+
+    # Routing
+
+    @@controllers = {}
+    @@alias_name_map = {}
+    @@default_controller = nil
+
+    class << self
+        def controllers
+            @@controllers
+        end
+        def alias_name_map
+            @@alias_name_map
+        end
+        def inherited subclass
+            controllers[subclass.to_s.decamelize] = {
+                get: {
+                    # action_name string => action proc
+                },
+                head: {}, # head is the same as get, but doesn`t return body
+                post: {},
+                patch: {},
+                put: {},
+                delete: {}
+            }
+        end
+        def default_controller
+            @@default_controller = self.to_s.decamelize
+        end
+        def get_default_controller
+            @@default_controller
+        end
+        def alias_name name
+            name = name.to_s
+            main_name = self.to_s.decamelize
+            if name != main_name
+                alias_name_map[name] = main_name
+            end
+        end
+        def add_action verb, action, block
+            controllers[ self.to_s.decamelize ][ verb ][ action.to_s ] = block
+        end
+        def get     action, &block; add_action __method__, action, block; end
+        def post    action, &block; add_action __method__, action, block; end
+        def patch   action, &block; add_action __method__, action, block; end
+        def put     action, &block; add_action __method__, action, block; end
+        def delete  action, &block; add_action __method__, action, block; end
+        def head    action, &block; add_action __method__, action, block; end
+    end
+
+    # RackApp entry point
+
+    def initialize req
+        @req = req
+    end
+
+    def conversation!
+        if http_options? and http_origin_allowed?
+            set_options_response
+            add_default_cors_headers
+            return
+        end
+
+        if route = search_route
+            # logi "route found: #{route.klass} #{route.action_proc}"
+            action_please! route
+            add_default_cors_headers
+        else
+            # logi 'route not found'
+            not_found
+        end
+    end
+
+    private # the action always happens in private
+
+    def action_please! route
+        cont = route.klass.new @req
+        proc = route.action_proc
+
+        @params = @req.post_parts || @req.params
+        body = cont.instance_eval &proc
+
+        @req.resp.body = body if @req.resp.body.nil?
+    end
+
+    # General
+
+    def self.require_dir dir
+        Dir[APP_ROOT + "/#{ dir }/*.rb"].each do |file|
+            require file
+        end
+    end
+
+    def self.setup
+        I18n.config.available_locales = :en
+        require_dir "app/controllers"
+        require_dir "app/models" if setup_db
+        if File.exists? "lib"
+            require_dir "lib"
+            require_dir "lib/*"
+        end
+    end
+
+    # DB
+
+    def self.setup_db
+        if File.exists? DB_CONF
+            db_conf = YAML.load_file DB_CONF
+            ActiveRecord::Base.configurations["db"] = db_conf[AlittleLess.env.name]
+            true
+        end
+    end
+
+    setup
+
+end
+
+All = AlittleLess

data/lib/a_little_less/core_ext.rb

@@ -0,0 +1,102 @@
+
+class Exception
+    def log
+        loge to_s_long
+    end
+    def to_s_long
+        l = [message]
+        l += backtrace if backtrace
+        l.join "\n"
+    end
+end
+
+class String
+    def decamelize
+        scan(/[A-Z][a-z]*/).join("_").downcase
+    end
+    def camelize
+        split('_').map(&:capitalize).join
+    end
+    def light_parameterize
+        I18n.transliterate(self)
+          .downcase
+          .gsub(/[^a-z0-9]+/, '-')
+          .gsub(/-+/, '-')
+          .gsub(/^-|-$/, '')
+    rescue => e
+        logi "#{e.message} for '#{self}'"
+        logi e.backtrace.join("\n") if e.backtrace
+        self
+    end
+    def safe_utf8
+        self.tidy_bytes.split(//u).join.force_encoding 'UTF-8'
+    end
+    def urlparams_to_hash
+        hash = {}
+
+        return hash if blank?
+
+        split('&').each do |i| 
+            k, v = i.split('=')
+            if k and v
+                hash[ k ] = v
+            end
+        end
+
+        hash
+    end
+    def remove_extension
+        self.sub /\..*$/, ''
+    end
+end
+
+class Hash
+  def symbolize_keys
+    if self.is_a?(Hash) 
+        Hash[ self.map { |k,v| [k.respond_to?(:to_sym) ? k.to_sym : k, v.is_a?(Hash) ? v.symbolize_keys : v] } ]
+    else
+        self
+    end
+  end
+end
+
+class Dir
+    def self.ensure dir
+        unless File.exist? dir
+            FileUtils.mkdir_p dir
+        end
+    end
+end
+
+class Array
+    def all_present?
+        self.each do |i|
+            return false if i.blank?
+        end
+        true
+    end
+
+    def any_present?
+        self.each do |i|
+            return true if i.present?
+        end
+        false
+    end
+
+    def any_blank?
+        self.each do |i|
+            return true if i.blank?
+        end
+        false
+    end
+end
+
+class Pathname
+    def realpath_safe
+        realpath
+    rescue Errno::ENOENT => e
+        puts "Error following #{self}: #{e.message}"
+        puts e.backtrace.join("\n") if e.backtrace
+        nil
+    end
+end

data/lib/a_little_less/env.rb

@@ -0,0 +1,25 @@
+class AlittleLess::Env
+    DEFAULT_ENV = 'production'
+    def initialize env
+        @env = env.presence || DEFAULT_ENV
+    end
+    def prod?
+        @env == 'production'
+    end
+    def dev?
+        !prod?
+    end
+    def name
+        if prod?
+            "production"
+        else
+            "development"
+        end
+    end
+end
+
+class AlittleLess
+    def self.env
+        @all_env ||= Env.new ENV['ALL_ENV']
+    end
+end

data/lib/a_little_less/global.rb

@@ -0,0 +1,9 @@
+
+def run_safe
+    begin
+        yield
+    rescue => e
+        loge e
+    end
+end
+

data/lib/a_little_less/global_logger.rb

@@ -0,0 +1,69 @@
+class GlobalLogger
+	include Singleton
+	
+	SHOW_DIV = false
+
+	def initialize
+		@logger = build_logger
+	end
+
+	def log level, *args
+		@level = level
+		@caller = caller[1]
+		div if SHOW_DIV
+		args.each{|line| log_line line }
+		nil
+	end
+
+	private
+
+	def build_logger
+		logger = Logger.new log_file
+		logger.formatter = proc do |severity, datetime, progname, msg|
+			"#{ severity[0] } #{ datetime.strftime('%y%m%d %H:%M:%S.%L') } #{ msg }\n"
+		end
+		logger
+	end
+
+	def _log s
+		@logger.send @level, s
+	end
+
+	def div
+		_log "\033[#{1};31;#{40}m -----#{ @caller }---------------\033[0m" 
+	end
+
+	def log_line line
+		_log output(line)
+		_log "----" if SHOW_DIV
+	end
+
+	def output line
+		if line.is_a?(Numeric) || line.is_a?(String) || line.is_a?(Symbol)
+			line
+		elsif line.is_a? Exception
+			line.to_s_long
+		else
+			line.to_yaml
+		end
+	end
+
+	def log_file
+		fname = case ENV['ALL_ENV']
+		when 'PRODUCTION'
+			'production'
+		else
+			'development'
+		end
+		"log/#{ fname }.log"
+	end
+end
+
+def logd *args; GlobalLogger.instance.log :debug, 	*args; end
+def logi *args; GlobalLogger.instance.log :info,	*args; end
+def logw *args; GlobalLogger.instance.log :warn, 	*args; end
+def loge *args; GlobalLogger.instance.log :error, 	*args; end
+def logf *args; GlobalLogger.instance.log :fatal, 	*args; end
+def logu *args; GlobalLogger.instance.log :unknown, *args; end
+alias log logi 
+

data/lib/a_little_less/rack_app.rb

@@ -0,0 +1,214 @@
+class AlittleLess::RackApp
+    SLOW_GET_THRESOLD = 0.2
+
+    ID_CHARS = 'a'.upto('z').to_a +
+               'A'.upto('Z').to_a +
+               '0'.upto('9').to_a
+
+    def self.call env
+        new(env).call
+    end
+
+    def initialize env
+        @env = env
+    end
+
+    def call
+        req = build_req
+        req.id = rand_id
+        resp = req.resp
+
+        t0 = Time.now
+        run_safe { log_req req }
+
+        begin
+            AlittleLessApp.new(req).conversation!
+        rescue => e
+            loge e
+            Bugsnag.notify e
+            resp.status = 500
+        end
+
+        resp.headers['X-Runtime'] = Time.now - t0
+        run_safe { log_resp req }
+        handle_body req, resp
+
+        [
+            resp.status,
+            resp.headers,
+            resp.body
+        ]
+    end
+
+    private
+
+    def rand_id
+         4.times.map{ ID_CHARS.sample }.join
+    end
+
+    def handle_body req, resp
+        h = resp.headers
+
+        if resp.body.is_a?(Hash) or resp.body.is_a?(Array)
+            h['Content-Type'] = 'application/json'
+            resp.body = [resp.body.to_json]
+        end
+
+        if p = h['X-Sendfile'].presence and h['Content-Type'].blank?
+            if c = get_content_type(p)
+                h['Content-Type'] = c
+            end
+        end
+    end
+
+    def get_content_type path
+        return unless File.exists? path
+        require 'filemagic'
+        unless defined? @@file_magic
+            @@file_magic = FileMagic.open(:mime)
+        end
+        content_type = @@file_magic.file path
+        if content_type =~ /^\S+\/\S+; charset=\S+$/i
+            content_type
+        end
+    end
+
+    def debug?
+        #true
+    end
+
+    def log_req req
+        if debug?
+            logi "--ENV--\n#{ @env.to_yaml }\n--/ENV--"
+        end
+        logi [
+            "Q #{req.id}",
+            req.http_method.upcase,
+            req.uri
+        ].join(" ")
+    end
+
+    def log_resp req
+        resp = req.resp
+        status = resp.status.to_i
+        success = status >= 200 && status < 400
+
+        file = if success
+            if status >= 300
+                resp.headers['Location']
+            else
+                resp.headers['X-Sendfile'].to_s
+            end
+        end
+
+        status_str = resp.status.to_s
+        if success
+            status_str = status_str.send (status >= 300 ? :cyan : :green)
+        end
+
+        log_line = [
+            "A #{req.id}",
+            status_str,
+            log_runtime(resp.headers['X-Runtime'], req.http_method),
+            file
+        ].join(" ")
+
+        if success
+            logi log_line
+        else
+            loge log_line.red
+        end
+    end
+
+    def log_runtime xrt, met
+        rt = xrt.to_f
+        rts = '%.6f' % rt
+        color = :light_red if met == :get && rt > SLOW_GET_THRESOLD
+        color ? rts.colorize(color) : rts
+    end
+
+    def params
+        Rack::Utils
+            .parse_nested_query(@env['QUERY_STRING'])
+            .symbolize_keys
+    end
+
+    def clean_uri
+        uri = @env['REQUEST_URI']
+        uri.sub! /^(https?)?:\/\/[^\/]+/i, ''
+        Rack::Utils.unescape uri
+    end
+
+    def build_req
+        OpenStruct.new(
+            http_method: @env['REQUEST_METHOD'].downcase.to_sym,
+            uri: clean_uri,
+            params: params,
+            env: @env,
+            resp: build_resp,
+            post_parts: Rack::Multipart.parse_multipart(@env),
+            referer: @env['HTTP_REFERER'],
+            ua: @env['HTTP_USER_AGENT']
+            # body: @env['rack.input'].tmp # for file uploads non multipart
+        )
+    end
+
+    def build_resp
+        OpenStruct.new(
+            status: 200,
+            headers: {},
+            body: nil
+        )
+    end
+end
+
+class AlittleLess
+    def self.rack_app
+        RackApp
+    end
+end
+
+
+# Example @env:
+
+# REQUEST_URI: "/files/e/4/7/6/a/c/4/e476ac4e683ea737ddad1e53127819b983f1d5a5.jpg?fill=210x210&type=square210"
+# PATH_INFO: "/files/e/4/7/6/a/c/4/e476ac4e683ea737ddad1e53127819b983f1d5a5.jpg"
+# SCRIPT_NAME: ''
+# QUERY_STRING: fill=210x210&type=square210
+# REQUEST_METHOD: GET
+# SERVER_NAME: example.com
+# SERVER_PORT: '443'
+# SERVER_SOFTWARE: Apache
+# SERVER_PROTOCOL: HTTP/1.1
+# REMOTE_ADDR: 179.234.49.149
+# REMOTE_PORT: '56323'
+# HTTPS: 'on'
+# HTTP_USER_AGENT: Mozilla/5.0 (Linux; U; Android 4.3; pt-br; SM-G3502T Build/JLS36C)
+#   AppleWebKit/534.30 (KHTML, like Gecko) Version/4.0 Mobile Safari/534.30
+# HTTP_ACCEPT_ENCODING: gzip,deflate
+# HTTP_ACCEPT: "*/*"
+# HTTP_ACCEPT_LANGUAGE: pt-BR, en-US
+# HTTP_HOST: example.com
+# HTTP_ACCEPT_CHARSET: utf-8, iso-8859-1, utf-16, *;q=0.7
+# SSL_TLS_SNI: example.com
+# rack.version:
+# - 1
+# - 2
+# rack.input: !ruby/object:PhusionPassenger::Utils::TeeInput
+#   len: 0
+#   socket: !ruby/object:PhusionPassenger::Utils::UnseekableSocket
+#     socket: !ruby/object:UNIXSocket {}
+#     simulate_eof: true
+#   bytes_read: 0
+#   tmp: !ruby/object:StringIO {}
+# rack.errors: !ruby/object:IO {}
+# rack.multithread: false
+# rack.multiprocess: true
+# rack.run_once: false
+# rack.url_scheme: https
+# rack.hijack?: true
+# rack.hijack: !ruby/object:Proc {}
+# HTTP_VERSION: HTTP/1.1
+# rack.tempfiles: []
+
+

data/lib/a_little_less/router.rb

@@ -0,0 +1,66 @@
+module AlittleLess::Router
+    def search_route
+        nodes = @req.uri
+                    .sub(/\?.*/,'') # wipe query string
+                    .split('/')     # get path nodes
+        
+        # get 2 first nodes after /
+        controller_name, action_name = nodes[1,2]
+
+        # Below, we try to match url path nodes to controllers 
+        # and actions defined in @@controllers
+        #
+        # @@controllers estructure example, as defined by AlittleLess:
+        # 
+        # controllers["users"] = {
+        #   get: {
+        #       "index" => #<Proc,
+        #       "show" => #<Proc
+        #   },
+        #   post: {
+        #       "create" => #<Proc    
+        #   }
+        # }
+        # 
+        # Responding to:
+        # GET  /users/index
+        # GET  /users/show
+        # POST /users/create
+
+        # Resolve alias_name`s
+        if main_name = self.class.alias_name_map[controller_name]
+            controller_name = main_name
+        end
+
+        http_methods = self.class.controllers[controller_name]
+
+        # If no controllers found til here, lets check 
+        # if there exists a default controller
+        unless http_methods
+            if controller_name = self.class.get_default_controller
+                http_methods = self.class.controllers[controller_name]
+            end
+        end
+
+        return unless http_methods
+
+        actions = http_methods[method]
+        return unless actions
+
+        # Try to match the action
+        action_proc = actions[action_name] || actions['*']
+        return unless action_proc
+
+        OpenStruct.new(
+            klass: Object.const_get(controller_name.camelize), 
+            action_proc: action_proc
+        )
+    end
+
+    def method
+        @req.http_method
+            .to_s
+            .sub('head', 'get') # coalescing HEAD, as we only remove the body before responding
+            .to_sym
+    end
+end

data/lib/a_little_less/util.rb

@@ -0,0 +1,64 @@
+module AlittleLess::Util
+
+    # Response
+
+    def params
+        @req.params
+    end
+    
+    def send_file file
+        @req.resp.headers['X-Sendfile'] = file
+        nil
+    end
+
+    def status code
+        @req.resp.status = code
+        nil
+    end
+
+    def not_found
+        status 404
+    end
+
+    def with body
+        @req.resp.body = body
+        nil
+    end
+
+    def error_422 body
+        status 422
+        with body
+    end
+
+    def redir_301 url
+        @req.resp.headers['Location'] = url
+        @req.resp.status = 301
+    end
+
+    # HTTP CORS
+
+    def http_options?
+        @req.http_method == :options
+    end
+
+    def http_origin_allowed?
+        true
+    end
+
+    def add_default_cors_headers
+        @req.resp.headers.merge!(
+            'Access-Control-Allow-Origin'  => '*',
+            'Access-Control-Allow-Methods' => 'POST, GET, OPTIONS',
+            'Access-Control-Max-Age'       => '1728000'
+        )
+    end
+
+    def set_options_response
+        @req.resp.headers.merge!(
+            'Access-Control-Allow-Headers' => 'Accept, Cache-Control, Content-Type, X-Requested-With',
+            'Content-Type'                 => 'text/plain'
+        )
+        @req.resp.body = ''
+    end
+
+end

data/lib/a_little_less/version.rb

@@ -0,0 +1,3 @@
+module ALittleLess
+  VERSION = "0.2.1"
+end

data/lib/vendor/rails_blank.rb

@@ -0,0 +1,133 @@
+# encoding: utf-8
+
+# Rails 4.2.4
+
+class Object
+  # An object is blank if it's false, empty, or a whitespace string.
+  # For example, '', '   ', +nil+, [], and {} are all blank.
+  #
+  # This simplifies
+  #
+  #   address.nil? || address.empty?
+  #
+  # to
+  #
+  #   address.blank?
+  #
+  # @return [true, false]
+  def blank?
+    respond_to?(:empty?) ? !!empty? : !self
+  end
+
+  # An object is present if it's not blank.
+  #
+  # @return [true, false]
+  def present?
+    !blank?
+  end
+
+  # Returns the receiver if it's present otherwise returns +nil+.
+  # <tt>object.presence</tt> is equivalent to
+  #
+  #    object.present? ? object : nil
+  #
+  # For example, something like
+  #
+  #   state   = params[:state]   if params[:state].present?
+  #   country = params[:country] if params[:country].present?
+  #   region  = state || country || 'US'
+  #
+  # becomes
+  #
+  #   region = params[:state].presence || params[:country].presence || 'US'
+  #
+  # @return [Object]
+  def presence
+    self if present?
+  end
+end
+
+class NilClass
+  # +nil+ is blank:
+  #
+  #   nil.blank? # => true
+  #
+  # @return [true]
+  def blank?
+    true
+  end
+end
+
+class FalseClass
+  # +false+ is blank:
+  #
+  #   false.blank? # => true
+  #
+  # @return [true]
+  def blank?
+    true
+  end
+end
+
+class TrueClass
+  # +true+ is not blank:
+  #
+  #   true.blank? # => false
+  #
+  # @return [false]
+  def blank?
+    false
+  end
+end
+
+class Array
+  # An array is blank if it's empty:
+  #
+  #   [].blank?      # => true
+  #   [1,2,3].blank? # => false
+  #
+  # @return [true, false]
+  alias_method :blank?, :empty?
+end
+
+class Hash
+  # A hash is blank if it's empty:
+  #
+  #   {}.blank?                # => true
+  #   { key: 'value' }.blank?  # => false
+  #
+  # @return [true, false]
+  alias_method :blank?, :empty?
+end
+
+class String
+  BLANK_RE = /\A[[:space:]]*\z/
+
+  # A string is blank if it's empty or contains whitespaces only:
+  #
+  #   ''.blank?       # => true
+  #   '   '.blank?    # => true
+  #   "\t\n\r".blank? # => true
+  #   ' blah '.blank? # => false
+  #
+  # Unicode whitespace is supported:
+  #
+  #   "\u00a0".blank? # => true
+  #
+  # @return [true, false]
+  def blank?
+    BLANK_RE === self
+  end
+end
+
+class Numeric #:nodoc:
+  # No number is blank:
+  #
+  #   1.blank? # => false
+  #   0.blank? # => false
+  #
+  # @return [false]
+  def blank?
+    false
+  end
+end

data/lib/vendor/rails_inclusion.rb

@@ -0,0 +1,27 @@
+class Object
+  # Returns true if this object is included in the argument. Argument must be
+  # any object which responds to +#include?+. Usage:
+  #
+  #   characters = ["Konata", "Kagami", "Tsukasa"]
+  #   "Konata".in?(characters) # => true
+  #
+  # This will throw an ArgumentError if the argument doesn't respond
+  # to +#include?+.
+  def in?(another_object)
+    another_object.include?(self)
+  rescue NoMethodError
+    raise ArgumentError.new("The parameter passed to #in? must respond to #include?")
+  end
+
+  # Returns the receiver if it's included in the argument otherwise returns +nil+.
+  # Argument must be any object which responds to +#include?+. Usage:
+  #
+  #   params[:bucket_type].presence_in %w( project calendar )
+  #
+  # This will throw an ArgumentError if the argument doesn't respond to +#include?+.
+  #
+  # @return [Object]
+  def presence_in(another_object)
+    self.in?(another_object) ? self : nil
+  end
+end

data/sample_app/.gitignore

@@ -0,0 +1,2 @@
+/log
+/tmp

data/sample_app/.ruby-version

@@ -0,0 +1 @@
+2.3.1

data/sample_app/Gemfile

@@ -0,0 +1,13 @@
+
+source 'https://rubygems.org'
+
+# framework
+gem 'a_little_less'
+gem 'mysql2'
+
+# easy_img
+gem 'addressable'
+gem 'ruby-filemagic'
+gem 'mime-types'
+gem 'bugsnag'
+gem 'httparty'

data/sample_app/app/controllers/sample.rb

@@ -0,0 +1,21 @@
+
+class Files < AlittleLess
+    default_controller
+    get '*' do
+        # Helpers
+        # send_file path
+        # not_found
+        redir_301 '/policy.html'
+    end
+    post 'upload' do
+        if DoSome.thing
+            break error_422 success: false
+        else
+            {success: true}
+        end
+    end
+    get 'users' do
+        User.limit(10).map &:attributes
+    end
+end
+

data/sample_app/app/models/user.rb

@@ -0,0 +1,13 @@
+class User < ActiveRecord::Base
+    establish_connection :db
+
+    attr_accessor :authenticated
+
+    def self.check_auth key, auth
+        user = User.find_by_user_hash key
+        return unless user
+        user.authenticated = auth == user.auth
+        user
+    end
+
+end

data/sample_app/config.ru

@@ -0,0 +1,21 @@
+
+# Bugsnag
+
+require "bugsnag"
+
+Bugsnag.configure do |config|
+  config.api_key = "TODO: fill it with your api key"
+  config.project_root = '/var/www/yoursite'
+end
+
+use Bugsnag::Rack
+
+# Timeout
+
+#require "rack-timeout"
+#use Rack::Timeout, service_timeout: 10
+
+# Run
+
+class AlittleLessApp < AlittleLess; end
+run AlittleLessApp.rack_app

data/sample_app/config/db.yml

@@ -0,0 +1,6 @@
+production:
+    adapter: mysql2
+    database: db_name
+    username: user
+    password: pass
+    socket: /var/run/mysqld/mysqld.sock

data/sample_app/console

@@ -0,0 +1,4 @@
+#!/bin/bash
+
+irb -r alittle_less
+

data/sample_app/lib/my_lib/my_lib.rb

@@ -0,0 +1,3 @@
+class MyLib
+
+end

data/sample_app/lib/my_other_lib.rb

@@ -0,0 +1,3 @@
+class MyOtherLib
+
+end

metadata

@@ -0,0 +1,187 @@
+--- !ruby/object:Gem::Specification
+name: a_little_less
+version: !ruby/object:Gem::Version
+  version: 0.2.1
+platform: ruby
+authors:
+- Tom Lobato
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2017-08-10 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.14'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.14'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+- !ruby/object:Gem::Dependency
+  name: rack
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: i18n
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.7'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.7'
+- !ruby/object:Gem::Dependency
+  name: colorize
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.8'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.8'
+- !ruby/object:Gem::Dependency
+  name: activerecord
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 5.0.2
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 5.0.2
+- !ruby/object:Gem::Dependency
+  name: bugsnag
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+description: Basic web framework in Ruby.
+email: 
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- _config.yml
+- a_little_less.gemspec
+- bin/console
+- bin/setup
+- lib/a_little_less.rb
+- lib/a_little_less/core_ext.rb
+- lib/a_little_less/env.rb
+- lib/a_little_less/global.rb
+- lib/a_little_less/global_logger.rb
+- lib/a_little_less/rack_app.rb
+- lib/a_little_less/router.rb
+- lib/a_little_less/util.rb
+- lib/a_little_less/version.rb
+- lib/vendor/rails_blank.rb
+- lib/vendor/rails_inclusion.rb
+- sample_app/.gitignore
+- sample_app/.ruby-version
+- sample_app/Gemfile
+- sample_app/app/controllers/sample.rb
+- sample_app/app/models/user.rb
+- sample_app/config.ru
+- sample_app/config/db.yml
+- sample_app/console
+- sample_app/lib/my_lib/my_lib.rb
+- sample_app/lib/my_other_lib.rb
+- sample_app/public/.keep
+- sample_app/public/index.html
+homepage: https://tomlobato.github.io/a_little_less
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.5.1
+signing_key: 
+specification_version: 4
+summary: Basic web framework in Ruby
+test_files: []