isomorfeus-iodine 0.7.44

data/exe/iodine

@@ -0,0 +1,277 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+IODINE_PARSE_CLI = true
+require 'iodine'
+
+# Load Rack if available (assume it will be used).
+#
+# Remember, code costs memory. Duplicating the Rack::Builder module and functions can be avoided.
+begin
+  require 'rack'
+  module Iodine
+    module Base
+      module Rack
+        Builder = ::Rack::Builder
+      end
+    end
+  end
+rescue LoadError
+  module Iodine
+    module Base
+      module Rack
+        # The Rack::Builder code is used when Rack isn't available.
+        #
+        # The code was copied (with minor adjustments) from the Rack source code and is licensed under the MIT license.
+        # Copyright (C) 2007-2019 Leah Neukirchen <http://leahneukirchen.org/infopage.html>
+        #
+        # ====
+        #
+        # Rack::Builder implements a small DSL to iteratively construct Rack
+        # applications.
+        #
+        # Example:
+        #
+        #  require 'rack/lobster'
+        #  app = Rack::Builder.new do
+        #    use Rack::CommonLogger
+        #    use Rack::ShowExceptions
+        #    map "/lobster" do
+        #      use Rack::Lint
+        #      run Rack::Lobster.new
+        #    end
+        #  end
+        #
+        #  run app
+        #
+        # Or
+        #
+        #  app = Rack::Builder.app do
+        #    use Rack::CommonLogger
+        #    run lambda { |env| [200, {'Content-Type' => 'text/plain'}, ['OK']] }
+        #  end
+        #
+        #  run app
+        #
+        # +use+ adds middleware to the stack, +run+ dispatches to an application.
+        # You can use +map+ to construct a Rack::URLMap in a convenient way.
+        class Builder
+          # https://stackoverflow.com/questions/2223882/whats-the-difference-between-utf-8-and-utf-8-without-bom
+          UTF_8_BOM = '\xef\xbb\xbf'
+
+          def self.parse_file(config, opts = Hash.new)
+            if config =~ /\.ru$/
+              return self.load_file(config, opts)
+            else
+              require config
+              app = Object.const_get(::File.basename(config, '.rb').split('_').map(&:capitalize).join(''))
+              return app, {}
+            end
+          end
+
+          def self.load_file(path, options = Hash.new)
+            cfgfile = ::File.read(path)
+            cfgfile.slice!(/\A#{UTF_8_BOM}/) if cfgfile.encoding == Encoding::UTF_8
+
+            cfgfile.sub!(/^__END__\n.*\Z/m, '')
+            app = new_from_string cfgfile, path
+
+            return app, options
+          end
+
+          def self.new_from_string(builder_script, file = "(rackup)")
+            eval "Iodine::Base::Rack::Builder.new {\n" + builder_script + "\n}.to_app",
+              TOPLEVEL_BINDING, file, 0
+          end
+
+          def initialize(default_app = nil, &block)
+            @use, @map, @run, @warmup, @freeze_app = [], nil, default_app, nil, false
+            instance_eval(&block) if block_given?
+          end
+
+          def self.app(default_app = nil, &block)
+            self.new(default_app, &block).to_app
+          end
+
+          # Specifies middleware to use in a stack.
+          #
+          #   class Middleware
+          #     def initialize(app)
+          #       @app = app
+          #     end
+          #
+          #     def call(env)
+          #       env["rack.some_header"] = "setting an example"
+          #       @app.call(env)
+          #     end
+          #   end
+          #
+          #   use Middleware
+          #   run lambda { |env| [200, { "Content-Type" => "text/plain" }, ["OK"]] }
+          #
+          # All requests through to this application will first be processed by the middleware class.
+          # The +call+ method in this example sets an additional environment key which then can be
+          # referenced in the application if required.
+          def use(middleware, *args, &block)
+            if @map
+              mapping, @map = @map, nil
+              @use << proc { |app| generate_map(app, mapping) }
+            end
+            @use << proc { |app| middleware.new(app, *args, &block) }
+          end
+
+          # Takes an argument that is an object that responds to #call and returns a Rack response.
+          # The simplest form of this is a lambda object:
+          #
+          #   run lambda { |env| [200, { "Content-Type" => "text/plain" }, ["OK"]] }
+          #
+          # However this could also be a class:
+          #
+          #   class Heartbeat
+          #     def self.call(env)
+          #      [200, { "Content-Type" => "text/plain" }, ["OK"]]
+          #     end
+          #   end
+          #
+          #   run Heartbeat
+          def run(app)
+            @run = app
+          end
+
+          # Takes a lambda or block that is used to warm-up the application.
+          #
+          #   warmup do |app|
+          #     client = Rack::MockRequest.new(app)
+          #     client.get('/')
+          #   end
+          #
+          #   use SomeMiddleware
+          #   run MyApp
+          def warmup(prc = nil, &block)
+            @warmup = prc || block
+          end
+
+          # Creates a route within the application.
+          #
+          #   Rack::Builder.app do
+          #     map '/' do
+          #       run Heartbeat
+          #     end
+          #   end
+          #
+          # The +use+ method can also be used here to specify middleware to run under a specific path:
+          #
+          #   Rack::Builder.app do
+          #     map '/' do
+          #       use Middleware
+          #       run Heartbeat
+          #     end
+          #   end
+          #
+          # This example includes a piece of middleware which will run before requests hit +Heartbeat+.
+          #
+          def map(path, &block)
+            @map ||= {}
+            @map[path] = block
+          end
+
+          # Freeze the app (set using run) and all middleware instances when building the application
+          # in to_app.
+          def freeze_app
+            @freeze_app = true
+          end
+
+          def to_app
+            app = @map ? generate_map(@run, @map) : @run
+            fail "missing run or map statement" unless app
+            app.freeze if @freeze_app
+            app = @use.reverse.inject(app) { |a, e| e[a].tap { |x| x.freeze if @freeze_app } }
+            @warmup.call(app) if @warmup
+            app
+          end
+
+          def call(env)
+            to_app.call(env)
+          end
+
+          private
+
+          def generate_map(default_app, mapping)
+            mapped = default_app ? { '/' => default_app } : {}
+            mapping.each { |r, b| mapped[r] = self.class.new(default_app, &b).to_app }
+            URLMap.new(mapped)
+          end
+        end
+      end
+    end
+  end
+end
+
+module Iodine
+  # The Iodine::Base namespace is reserved for internal use and is NOT part of the public API.
+  module Base
+    # Command line interface. The Ruby CLI might be changed in future versions.
+    module CLI
+
+      def self.try_file filename
+        return nil unless File.exist? filename
+        return Iodine::Base::Rack::Builder.parse_file filename
+      end
+
+      def self.get_app_opts
+        app, opt = nil, nil
+        filename = Iodine::DEFAULT_SETTINGS[:filename_]
+        if filename
+          app, opt = try_file filename
+          app, opt = try_file "#{filename}.ru" unless opt
+          unless opt
+            puts "* Couldn't find #{filename}\n  testing for config.ru\n"
+            app, opt = try_file "config.ru"
+          end
+        else
+          app, opt = try_file "config.ru";
+        end
+
+        unless opt
+          puts "WARNING: Ruby application not found#{ filename ? " - missing both #{filename} and config.ru" : " - missing config.ru"}."
+          if Iodine::DEFAULT_SETTINGS[:public]
+            puts "         Running only static file service."
+            opt = Hash.new
+            app = Proc.new { [404, {}, "Not Found!"] }
+          else
+            puts "\nERROR: Couldn't run Ruby application, check command line arguments."
+            ARGV << "-?"
+            Iodine::Base::CLI.parse
+            exit(0);
+          end
+        end
+        return app, opt
+      end
+
+      def self.perform_warmup(app)
+        # load anything marked with `autoload`, since autoload is niether thread safe nor fork friendly.
+        Iodine.on_state(:on_start) do
+          Module.constants.each do |n|
+            begin
+              Object.const_get(n)
+            rescue StandardError => _e
+            end
+          end
+          Iodine::Base::Rack::Builder.new(app) do |r|
+            r.warmup do |a|
+              client = ::Rack::MockRequest.new(a)
+              client.get('/')
+            end
+          end
+        end
+      end
+
+      def self.call
+        app, opt = get_app_opts
+        perform_warmup(app) if Iodine::DEFAULT_SETTINGS[:warmup_]
+        Iodine::Rack.run(app, opt)
+      end
+    end
+  end
+end
+
+Iodine::Base::CLI.call

data/ext/iodine/extconf.rb

@@ -0,0 +1,109 @@
+require 'mkmf'
+
+# Test polling
+def iodine_test_polling_support
+  iodine_poll_test_kqueue = <<EOS
+\#define _GNU_SOURCE
+\#include <stdlib.h>
+\#include <sys/event.h>
+int main(void) {
+  int fd = kqueue();
+}
+EOS
+
+  iodine_poll_test_epoll = <<EOS
+\#define _GNU_SOURCE
+\#include <stdlib.h>
+\#include <stdio.h>
+\#include <sys/types.h>
+\#include <sys/stat.h>
+\#include <fcntl.h>
+\#include <sys/epoll.h>
+int main(void) {
+  int fd = epoll_create1(EPOLL_CLOEXEC);
+}
+EOS
+
+  iodine_poll_test_poll = <<EOS
+\#define _GNU_SOURCE
+\#include <stdlib.h>
+\#include <poll.h>
+int main(void) {
+  struct pollfd plist[18];
+  memset(plist, 0, sizeof(plist[0]) * 18);
+  poll(plist, 1, 1);
+}
+EOS
+
+  # Test for manual selection and then TRY_COMPILE with each polling engine
+  if Gem.win_platform?
+    puts "skipping polling tests, using WSAPOLL on Windows"
+    $defs << "-DFIO_ENGINE_WSAPOLL"
+  elsif ENV['FIO_POLL']
+    puts "skipping polling tests, enforcing manual selection of: poll"
+    $defs << "-DFIO_ENGINE_POLL"
+  elsif ENV['FIO_FORCE_POLL']
+    puts "skipping polling tests, enforcing manual selection of: poll"
+    $defs << "-DFIO_ENGINE_POLL"
+  elsif ENV['FIO_FORCE_EPOLL']
+    puts "skipping polling tests, enforcing manual selection of: epoll"
+    $defs << "-DFIO_ENGINE_EPOLL"
+  elsif ENV['FIO_FORCE_KQUEUE']
+    puts "* Skipping polling tests, enforcing manual selection of: kqueue"
+    $defs << "-DFIO_ENGINE_KQUEUE"
+  elsif try_compile(iodine_poll_test_epoll)
+    puts "detected `epoll`"
+    $defs << "-DFIO_ENGINE_EPOLL"
+  elsif try_compile(iodine_poll_test_kqueue)
+    puts "detected `kqueue`"
+    $defs << "-DFIO_ENGINE_KQUEUE"
+  elsif try_compile(iodine_poll_test_poll)
+    puts "detected `poll` - this is suboptimal fallback!"
+    $defs << "-DFIO_ENGINE_POLL"
+  else
+    puts "* WARNING: No supported polling engine! expecting compilation to fail."
+  end
+end
+
+iodine_test_polling_support()
+
+unless Gem.win_platform?
+  # Test for OpenSSL version equal to 1.0.0 or greater.
+  unless ENV['NO_SSL'] || ENV['NO_TLS'] || ENV["DISABLE_SSL"]
+    OPENSSL_TEST_CODE = <<EOS
+\#include <openssl/bio.h>
+\#include <openssl/err.h>
+\#include <openssl/ssl.h>
+\#if OPENSSL_VERSION_NUMBER < 0x10100000L
+\#error "OpenSSL version too small"
+\#endif
+int main(void) {
+  SSL_library_init();
+  SSL_CTX *ctx = SSL_CTX_new(TLS_method());
+  SSL *ssl = SSL_new(ctx);
+  BIO *bio = BIO_new_socket(3, 0);
+  BIO_up_ref(bio);
+  SSL_set0_rbio(ssl, bio);
+  SSL_set0_wbio(ssl, bio);
+}
+EOS
+
+    dir_config("openssl")
+    begin
+      require 'openssl'
+    rescue LoadError
+    else
+      if have_library('crypto') && have_library('ssl')
+        puts "detected OpenSSL library, testing for version and required functions."
+        if try_compile(OPENSSL_TEST_CODE)
+          $defs << "-DHAVE_OPENSSL"
+          puts "confirmed OpenSSL to be version 1.1.0 or above (#{OpenSSL::OPENSSL_LIBRARY_VERSION})...\n* compiling with HAVE_OPENSSL."
+        else
+          puts "FAILED: OpenSSL version not supported (#{OpenSSL::OPENSSL_LIBRARY_VERSION} is too old)."
+        end
+      end
+    end
+  end
+end
+
+create_makefile 'iodine/iodine'