tennpipes-base 3.6.6

data/lib/tennpipes-base/application/show_exceptions.rb

@@ -0,0 +1,50 @@
+module Tennpipes
+  ##
+  # This module extend Sinatra::ShowExceptions adding Tennpipes as "Framework".
+  #
+  # @private
+  class ShowExceptions < Sinatra::ShowExceptions
+    if Sinatra::VERSION <= '1.4.5'
+      def call(env)
+        @app.call(env)
+      rescue Exception => e
+        errors, env["rack.errors"] = env["rack.errors"], @@eats_errors
+
+        if prefers_plain_text?(env)
+          content_type = "text/plain"
+          exception_string = dump_exception(e)
+        else
+          content_type = "text/html"
+          exception_string = pretty(env, e)
+        end
+
+        env["rack.errors"] = errors
+
+        # Post 893a2c50 in rack/rack, the #pretty method above, implemented in
+        # Rack::ShowExceptions, returns a String instead of an array.
+        body = Array(exception_string)
+
+        [
+          500,
+         {"Content-Type" => content_type,
+          "Content-Length" => Rack::Utils.bytesize(body.join).to_s},
+         body
+        ]
+      end
+    end
+
+    private
+
+    def frame_class(frame)
+      if frame.filename =~ /lib\/sinatra.*\.rb|lib\/tennpipes.*\.rb/
+        "framework"
+      elsif (defined?(Gem) && frame.filename.include?(Gem.dir)) ||
+            frame.filename =~ /\/bin\/(\w+)$/ ||
+            frame.filename =~ /Ruby\/Gems/
+        "system"
+      else
+        "app"
+      end
+    end
+  end
+end

data/lib/tennpipes-base/caller.rb

@@ -0,0 +1,53 @@
+module Tennpipes
+
+  # List of callers in a Tennpipes application that should be ignored as part of a stack trace.
+  TENNPIPES_IGNORE_CALLERS = [
+    %r{lib/tennpipes-.*$},
+    %r{/tennpipes-.*/(lib|bin)},
+    %r{/bin/tennpipes$},
+    %r{/sinatra(/(base|main|show_?exceptions))?\.rb$},
+    %r{lib/tilt.*\.rb$},
+    %r{lib/rack.*\.rb$},
+    %r{lib/mongrel.*\.rb$},
+    %r{lib/shotgun.*\.rb$},
+    %r{bin/shotgun$},
+    %r{\(.*\)},
+    %r{shoulda/context\.rb$},
+    %r{mocha/integration},
+    %r{test/unit},
+    %r{rake_test_loader\.rb},
+    %r{custom_require\.rb$},
+    %r{active_support},
+    %r{/thor}
+  ] unless defined?(TENNPIPES_IGNORE_CALLERS)
+
+  ##
+  # Add rubinius (and hopefully other VM implementations) ignore patterns ...
+  #
+  TENNPIPES_IGNORE_CALLERS.concat(RUBY_IGNORE_CALLERS) if defined?(RUBY_IGNORE_CALLERS)
+
+  private
+  ##
+  # The filename for the file that is the direct caller (first caller).
+  #
+  # @return [String]
+  #   The file the caller method exists in.
+  #
+  def self.first_caller
+    caller_files.first
+  end
+
+  #
+  # Like +Kernel#caller+ but excluding certain magic entries and without
+  # line / method information; the resulting array contains filenames only.
+  #
+  # @return [Array<String>]
+  #   The files of the calling methods.
+  #
+  def self.caller_files
+    caller(1).
+      map    { |line| line.split(/:(?=\d|in )/)[0,2] }.
+      reject { |file,line| TENNPIPES_IGNORE_CALLERS.any? { |pattern| file =~ pattern } }.
+      map    { |file,line| file }
+  end
+end

data/lib/tennpipes-base/cli/adapter.rb

@@ -0,0 +1,33 @@
+module Tennpipes
+  module Cli
+    module Adapter
+      class << self
+        # Start for the given options a rackup handler
+        def start(options)
+          Tennpipes.run!(options.symbolize_keys)
+        end
+
+        # Method that stop (if exist) a running Tennpipes.application
+        def stop(options)
+          options.symbolize_keys!
+          if File.exist?(options[:pid])
+            pid = File.read(options[:pid]).to_i
+            puts "=> Sending INT to process with pid #{pid}"
+            begin
+              Process.kill(2, pid)
+            rescue Errno::ESRCH, RangeError => error
+              puts error.message
+              exit
+            rescue Errno::EPERM => error
+              puts error.message
+              abort
+            end
+          else
+            puts "=> #{options[:pid]} not found!"
+            abort
+          end
+        end
+      end
+    end
+  end
+end

data/lib/tennpipes-base/cli/base.rb

@@ -0,0 +1,105 @@
+require 'tennpipes-base/cli/launcher'
+
+module Tennpipes
+  module Cli
+    class Base < Launcher
+      desc "rake", "Execute rake tasks."
+      method_option :environment, :type => :string,  :aliases => "-e"
+      method_option :list,        :type => :string,  :aliases => "-T", :desc => "Display the tasks (matching optional PATTERN) with descriptions, then exit."
+      method_option :trace,       :type => :boolean, :aliases => "-t", :desc => "Turn on invoke/execute tracing, enable full backtrace."
+      def rake(*args)
+        prepare :rake
+        args << "-T" if options[:list]
+        args << options[:list]  unless options[:list].nil? || options[:list].to_s == "list"
+        args << "--trace" if options[:trace]
+        args << "--verbose" if options[:verbose]
+        ARGV.clear
+        ARGV.concat(args)
+        puts "=> Executing Rake #{ARGV.join(' ')} ..."
+        load File.expand_path('../rake.rb', __FILE__)
+        Rake.application.init
+        Rake.application.instance_variable_set(:@rakefile, __FILE__)
+        load File.expand_path('Rakefile')
+        Rake.application.top_level
+      end
+
+      desc "console", "Boots up the Tennpipes application irb console (alternatively use 'c')."
+      map "c" => :console
+      def console(*args)
+        prepare :console
+        require File.expand_path("../../version", __FILE__)
+        ARGV.clear
+        require 'irb'
+        begin
+          require "irb/completion"
+        rescue LoadError
+        end
+        require File.expand_path('config/boot.rb')
+        puts "=> Loading #{Tennpipes.env} console (Tennpipes v.#{Tennpipes.version})"
+        require File.expand_path('../console', __FILE__)
+        IRB.start
+      end
+
+      desc "generate", "Executes the Tennpipes generator with given options (alternatively use 'gen' or 'g')."
+      map ["gen", "g"] => :generate
+      def generate(*args)
+        begin
+          # We try to load the vendored tennpipes-init if exist
+          tennpipes_gen_path = File.expand_path('../../../../../tennpipes-init/lib', __FILE__)
+          $:.unshift(tennpipes_gen_path) if File.directory?(tennpipes_gen_path) && !$:.include?(tennpipes_gen_path)
+          require 'tennpipes-base/command'
+          require 'tennpipes-init/command'
+          ARGV.shift
+          ARGV << 'help' if ARGV.empty?
+          Tennpipes.bin_gen(*ARGV)
+        rescue
+          puts "<= You need tennpipes-init! Run: gem install tennpipes-init"
+        end
+      end
+
+      desc "version", "Show current Tennpipes version."
+      map ["-v", "--version"] => :version
+      def version
+        require 'tennpipes-base/version'
+        puts "Tennpipes v. #{Tennpipes.version}"
+      end
+
+      desc "runner", "Run a piece of code in the Tennpipes application environment (alternatively use 'run' or 'r')."
+      map ["run", "r"] => :runner
+      def runner(*args)
+        prepare :runner
+
+        code_or_file = args.shift
+        abort "Please specify code or file" if code_or_file.nil?
+
+        require File.expand_path('config/boot.rb')
+
+        if File.exist?(code_or_file)
+          eval(File.read(code_or_file), nil, code_or_file)
+        else
+          eval(code_or_file)
+        end
+      end
+
+      protected
+
+      def self.banner(task=nil, *args)
+        "tennpipes #{task.name}"
+      end
+
+      def capture(stream)
+        begin
+          stream = stream.to_s
+          eval "$#{stream} = StringIO.new"
+          yield
+          result = eval("$#{stream}").string
+        ensure
+          eval("$#{stream} = #{stream.upcase}")
+        end
+
+        result
+      end
+      alias :silence :capture
+    end
+  end
+end

data/lib/tennpipes-base/cli/console.rb

@@ -0,0 +1,20 @@
+# Reloads classes
+def reload!
+  Tennpipes.reload!
+end
+
+# Show applications
+def applications
+  puts "==== List of Mounted Applications ====\n\n"
+  Tennpipes.mounted_apps.each do |app|
+    puts " * %-10s mapped to      %s" % [app.name, app.uri_root]
+  end
+  puts
+  Tennpipes.mounted_apps.map { |app| "#{app.name} => #{app.uri_root}" }
+end
+
+# Load apps
+Tennpipes.mounted_apps.each do |app|
+  puts "=> Loading Application #{app.app_class}"
+  app.app_obj.setup_application!
+end

data/lib/tennpipes-base/cli/launcher.rb

@@ -0,0 +1,103 @@
+require 'thor'
+
+module Tennpipes
+  module Cli
+    class Launcher < Thor
+      include Thor::Actions
+
+      class_option :chdir, :type => :string, :aliases => "-c", :desc => "Change to dir before starting."
+      class_option :environment, :type => :string,  :aliases => "-e", :desc => "Tennpipes Environment."
+      class_option :help, :type => :boolean, :desc => "Show help usage"
+
+      desc "start", "Starts the Tennpipes application (alternatively use 's')."
+      map "s" => :start
+      method_option :server,    :type => :string,  :aliases => "-a", :desc => "Rack Handler (default: autodetect)"
+      method_option :host,      :type => :string,  :aliases => "-h", :desc => "Bind to HOST address (default: 127.0.0.1)"
+      method_option :port,      :type => :numeric, :aliases => "-p", :desc => "Use PORT (default: 3000)"
+      method_option :daemonize, :type => :boolean, :aliases => "-d", :desc => "Run daemonized in the background."
+      method_option :pid,       :type => :string,  :aliases => "-i", :desc => "File to store pid."
+      method_option :debug,     :type => :boolean,                   :desc => "Set debugging flags."
+      method_option :options,   :type => :array,  :aliases => "-O", :desc => "--options NAME=VALUE NAME2=VALUE2'. pass VALUE to the server as option NAME. If no VALUE, sets it to true. Run '#{$0} --server_options"
+      method_option :server_options,   :type => :boolean, :desc => "Tells the current server handler's options that can be used with --options"
+      def start(*args)
+        prepare :start
+        require File.expand_path("../adapter", __FILE__)
+        require File.expand_path('config/boot.rb')
+
+        if options[:server_options]
+          puts server_options(options)
+        else
+          Tennpipes::Cli::Adapter.start(args.last ? options.merge(:config => args.last).freeze : options)
+        end
+      end
+
+      desc "stop", "Stops the Tennpipes application (alternatively use 'st')."
+      map "st" => :stop
+      method_option :pid, :type => :string,  :aliases => "-p", :desc => "File to store pid", :default => 'tmp/pids/server.pid'
+      def stop
+        prepare :stop
+        require File.expand_path("../adapter", __FILE__)
+        Tennpipes::Cli::Adapter.stop(options)
+      end
+
+      private
+
+      # https://github.com/rack/rack/blob/master/lib/rack/server.rb\#L100
+      def server_options(options)
+        begin
+          info = []
+          server = Rack::Handler.get(options[:server]) || Rack::Handler.default(options)
+          if server && server.respond_to?(:valid_options)
+            info << ""
+            info << "Server-specific options for #{server.name}:"
+
+            has_options = false
+            server.valid_options.each do |name, description|
+              next if name.to_s.match(/^(Host|Port)[^a-zA-Z]/) # ignore handler's host and port options, we do our own.
+              info << "  -O %-21s %s" % [name, description]
+              has_options = true
+            end
+            return "" if !has_options
+          end
+          info.join("\n")
+        rescue NameError
+          return "Warning: Could not find handler specified (#{options[:server] || 'default'}) to determine handler-specific options"
+        end
+      end
+
+      protected
+
+      def prepare(task)
+        if options.help?
+          help(task.to_s)
+          exit
+        end
+        if options.environment
+          ENV["RACK_ENV"] = options.environment.to_s
+        else
+          ENV["RACK_ENV"] ||= 'development'
+        end
+        chdir(options.chdir)
+        unless File.exist?('config/boot.rb')
+          puts "=> Could not find boot file in: #{options.chdir}/config/boot.rb !!!"
+          abort
+        end
+      end
+
+      def chdir(dir)
+        return unless dir
+        begin
+          Dir.chdir(dir.to_s)
+        rescue Errno::ENOENT
+          puts "=> Specified Tennpipes root '#{dir}' does not appear to exist!"
+        rescue Errno::EACCES
+          puts "=> Specified Tennpipes root '#{dir}' cannot be accessed by the current user!"
+        end
+      end
+
+      def self.exit_on_failure?
+        true
+      end
+    end
+  end
+end

data/lib/tennpipes-base/cli/rake.rb

@@ -0,0 +1,50 @@
+require File.expand_path('../../tasks', __FILE__)
+require 'rake'
+require 'rake/dsl_definition'
+require 'thor'
+require 'securerandom' unless defined?(SecureRandom)
+begin
+  require 'tennpipes-init'
+rescue LoadError
+end
+
+module TennpipesTasks
+  def self.init(init=false)
+    $LOAD_PATH.unshift(File.expand_path("lib"))
+    Tennpipes::Tasks.files.flatten.uniq.each { |rakefile| Rake.application.add_import(rakefile) rescue puts "<= Failed load #{ext}" }
+    load(File.expand_path('../rake_tasks.rb', __FILE__))
+    Rake.application.load_imports
+  end
+
+  def self.use(task)
+    tasks << task
+  end
+
+  def self.tasks
+    @tasks ||= []
+  end
+
+  def self.load?(task, constant_present)
+    if constant_present && !TennpipesTasks.tasks.include?(task)
+      warn <<-WARNING
+Loading #{task} tasks automatically.
+This functionality will be disabled in future versions. Please put
+
+  TennpipesTasks.use(#{task.inspect})
+  TennpipesTasks.init
+
+and remove
+
+  require File.expand_path('../config/boot.rb', __FILE__)
+
+in you Rakefile instead.
+      WARNING
+    end
+
+    constant_present || TennpipesTasks.tasks.include?(task)
+  end
+end
+
+def shell
+  @_shell ||= Thor::Base.shell.new
+end

data/lib/tennpipes-base/cli/rake_tasks.rb

@@ -0,0 +1,72 @@
+Dir["{lib/tasks/**,tasks/**,test,spec}/*.rake"].each do |file|
+  begin
+    load(file)
+  rescue LoadError => e
+    warn "#{file}: #{e.message}"
+  end
+end
+
+# Loads the Tennpipes applications mounted within the project.
+# Setting up the required environment for Tennpipes.
+task :environment do
+  require File.expand_path('config/boot.rb', Rake.application.original_dir)
+
+  Tennpipes.mounted_apps.each do |app|
+    app.app_obj.setup_application!
+  end
+end
+
+task :skeleton do
+  TENNPIPES_ROOT ||= Rake.application.original_dir
+  require 'tennpipes-base'
+  Tennpipes.send(:dependency_paths).reject!{ |path| path.include?('/models/') }
+  require File.expand_path('config/boot.rb', Rake.application.original_dir)
+end
+
+desc "Generate a secret key"
+task :secret do
+  shell.say SecureRandom.hex(32)
+end
+
+def list_app_routes(app, args)
+  app_routes = app.named_routes
+  app_routes.reject! { |r| r.identifier.to_s !~ /#{args.query}/ } if args.query.present?
+  app_routes.map! { |r| [r.verb, r.name, r.path] }
+  return if app_routes.empty?
+  shell.say "\nApplication: #{app.app_class}", :yellow
+  app_routes.unshift(["REQUEST", "URL", "PATH"])
+  max_col_1 = app_routes.max { |a, b| a[0].size <=> b[0].size }[0].size
+  max_col_2 = app_routes.max { |a, b| a[1].size <=> b[1].size }[1].size
+  app_routes.each_with_index do |row, i|
+    message = [row[1].ljust(max_col_2+2), row[0].center(max_col_1+2), row[2]]
+    shell.say("    " + message.join(" "), i==0 ? :bold : nil)
+  end
+end
+
+def env_migration_version
+  version = ENV["MIGRATION_VERSION"]
+  if version.nil? && ENV["VERSION"]
+    deprecated = true
+    warn "Environment variable VERSION is deprecated, use MIGRATION_VERSION"
+    version = ENV["VERSION"]
+  end
+  version ? Integer(version) : nil
+rescue ArgumentError
+  warn "Environment variable #{deprecated ? '' : 'MIGRATION_'}VERSION=#{version} should be non-existant or Integer"
+  nil
+end
+
+desc "Displays a listing of the named routes within a project, optionally only those matched by [query]"
+task :routes, [:query] => :environment do |t, args|
+  Tennpipes.mounted_apps.each do |app|
+    list_app_routes(app, args)
+  end
+end
+
+desc "Displays a listing of the named routes a given app [app]"
+namespace :routes do
+  task :app, [:app] => :environment do |t, args|
+    app = Tennpipes.mounted_apps.find { |app| app.app_class == args.app }
+    list_app_routes(app, args) if app
+  end
+end