pakyow-core 1.0.0.rc5 → 1.0.0

data/lib/pakyow/behavior/running.rb

@@ -0,0 +1,127 @@
+# frozen_string_literal: true
+
+require "async/reactor"
+require "async/io/shared_endpoint"
+require "async/http/endpoint"
+
+require "pakyow/support/extension"
+
+require "pakyow/process_manager"
+require "pakyow/processes/proxy"
+require "pakyow/processes/server"
+
+module Pakyow
+  module Behavior
+    module Running
+      extend Support::Extension
+
+      apply_extension do
+        unfreezable :process_manager
+
+        class_state :processes, default: []
+
+        on "run" do
+          if config.server.proxy
+            # Find a port to run the environment on, start the proxy on the configured port.
+            #
+            port = Processes::Proxy.find_local_port
+            process :proxy, restartable: false do
+              Processes::Proxy.new(
+                host: config.server.host,
+                port: config.server.port,
+                proxy_port: port
+              ).run
+            end
+          else
+            # Run the environment on the configured port.
+            #
+            port = config.server.port
+          end
+
+          endpoint = Async::HTTP::Endpoint.parse(
+            "http://#{config.server.host}:#{port}"
+          )
+
+          bound_endpoint = Async::Reactor.run {
+            Async::IO::SharedEndpoint.bound(endpoint)
+          }.wait
+
+          process :server, count: config.server.count do
+            Pakyow.config.server.port = port
+
+            Processes::Server.new(
+              protocol: endpoint.protocol,
+              scheme: endpoint.scheme,
+              endpoint: bound_endpoint
+            ).run
+          end
+
+          unless config.server.proxy || ENV.key?("PW_RESPAWN")
+            Pakyow.logger << Processes::Server.running_text(
+              scheme: endpoint.scheme, host: config.server.host, port: port
+            )
+          end
+        end
+      end
+
+      class_methods do
+        def process(name, count: 1, restartable: true, &block)
+          @processes << {
+            name: name,
+            block: block,
+            count: count,
+            restartable: restartable
+          }
+        end
+
+        def run
+          performing :run do
+            @process_manager = @processes.each_with_object(ProcessManager.new) { |process, manager|
+              manager.add(process)
+            }
+
+            root_pid = Process.pid
+
+            at_exit do
+              if Process.pid == root_pid
+                shutdown
+              else
+                @apps.select { |app|
+                  app.respond_to?(:shutdown)
+                }.each(&:shutdown)
+              end
+            end
+          end
+
+          @process_manager.wait
+
+          if @respawn
+            # Replace the master process with a copy of itself.
+            #
+            exec "PW_RESPAWN=true #{$0} #{ARGV.join(" ")}"
+          end
+        rescue SignalException
+          exit
+        end
+
+        def shutdown
+          if $stdout.isatty
+            # Don't let ^C mess up our output.
+            #
+            puts
+          end
+
+          Pakyow.logger << "Goodbye"
+
+          performing :shutdown do
+            @process_manager.stop
+          end
+        end
+
+        def restart
+          @process_manager.restart
+        end
+      end
+    end
+  end
+end

data/lib/pakyow/behavior/silencing.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+require "pakyow/support/extension"
+
+module Pakyow
+  module Behavior
+    module Silencing
+      extend Support::Extension
+
+      apply_extension do
+        class_state :silencers, default: []
+      end
+
+      class_methods do
+        def silence(&block)
+          @silencers << block
+        end
+      end
+    end
+  end
+end

data/lib/pakyow/behavior/timezone.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+require "pakyow/support/extension"
+
+module Pakyow
+  module Behavior
+    # Sets up the timezone for the environment.
+    #
+    module Timezone
+      extend Support::Extension
+
+      apply_extension do
+        after "configure" do
+          ENV["TZ"] = config.timezone.to_s
+        end
+      end
+    end
+  end
+end

data/lib/pakyow/behavior/verification.rb

@@ -23,7 +23,7 @@ module Pakyow
         end
 
         original_values = values.deep_dup
-        result = Verifier.new(&block).call(values, context: self)
+        result = Pakyow::Verifier.new(&block).call(values, context: self)
 
         unless result.verified?
           error = InvalidData.new_with_message(:verification)

data/lib/pakyow/behavior/verifier.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+require "pakyow/support/extension"
+require "pakyow/support/message_verifier"
+
+module Pakyow
+  module Behavior
+    module Verifier
+      extend Support::Extension
+
+      class_methods do
+        attr_reader :verifier
+      end
+
+      apply_extension do
+        before :boot do
+          config.secrets.reject! { |secret|
+            secret.nil? || secret.empty?
+          }
+
+          if config.secrets.any?
+            @verifier = Support::MessageVerifier.new(config.secrets[0])
+          else
+            raise "Pakyow will not boot without a secret configured in `Pakyow.config.secrets`"
+          end
+        end
+      end
+    end
+  end
+end

data/lib/pakyow/behavior/watching.rb

@@ -0,0 +1,73 @@
+# frozen_string_literal: true
+
+require "filewatcher"
+
+require "pakyow/support/extension"
+
+module Pakyow
+  module Behavior
+    module Watching
+      extend Support::Extension
+
+      apply_extension do
+        class_state :on_change_matchers, default: {}
+        class_state :watched_paths, default: []
+
+        unfreezable :filewatcher, :filewatcher_thread
+
+        after "run" do
+          @filewatcher = Filewatcher.new(
+            @watched_paths.map { |path|
+              File.expand_path(path)
+            }
+          )
+
+          @filewatcher_thread = Thread.new do
+            @filewatcher.watch(&method(:watch_callback))
+          end
+        end
+
+        on "shutdown" do
+          @filewatcher.stop
+          @filewatcher_thread.join
+        end
+      end
+
+      class_methods do
+        # Register a callback to be called when a file changes.
+        #
+        def on_change(matcher, &block)
+          (@on_change_matchers[matcher] ||= []) << block
+        end
+
+        # Register one or more path for changes.
+        #
+        def watch(*paths, &block)
+          @watched_paths.concat(paths).uniq!
+
+          if block
+            paths.each do |path|
+              on_change(File.expand_path(path), &block)
+            end
+          end
+        end
+
+        # @api private
+        def change_callbacks(path)
+          @on_change_matchers.each_with_object([]) { |(matcher, blocks), matched_blocks|
+            if matcher.match?(path)
+              matched_blocks.concat(blocks)
+            end
+          }
+        end
+
+        # @api private
+        def watch_callback(path, _event)
+          change_callbacks(path).each do |callback|
+            instance_exec(&callback)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/pakyow/config.rb

@@ -0,0 +1,168 @@
+# frozen_string_literal: true
+
+require "pakyow/support/extension"
+
+require "pakyow/logger/formatters/human"
+require "pakyow/logger/formatters/logfmt"
+
+module Pakyow
+  module Config
+    extend Support::Extension
+
+    apply_extension do
+      setting :default_env, :development
+      setting :freeze_on_boot, true
+      setting :exit_on_boot_failure, true
+      setting :timezone, :utc
+      setting :secrets, ["pakyow"]
+
+      setting :connection_class do
+        require "pakyow/connection"
+        Connection
+      end
+
+      setting :root do
+        File.expand_path(".")
+      end
+
+      setting :lib do
+        File.join(config.root, "lib")
+      end
+
+      setting :environment_path do
+        File.join(config.root, "config/environment")
+      end
+
+      setting :loader_path do
+        File.join(config.root, "config/loader")
+      end
+
+      defaults :test do
+        setting :exit_on_boot_failure, false
+      end
+
+      defaults :production do
+        setting :secrets, [ENV["SECRET"].to_s.strip]
+      end
+
+      configurable :server do
+        setting :host, "localhost"
+        setting :port, 3000
+        setting :count, 1
+        setting :proxy, true
+
+        defaults :production do
+          setting :proxy, false
+
+          setting :host do
+            ENV["HOST"] || "0.0.0.0"
+          end
+
+          setting :port do
+            ENV["PORT"] || 3000
+          end
+
+          setting :count do
+            ENV["WORKERS"] || 5
+          end
+        end
+      end
+
+      configurable :cli do
+        setting :repl do
+          require "irb"; IRB
+        end
+      end
+
+      configurable :logger do
+        setting :enabled, true
+        setting :sync, true
+
+        setting :level do
+          if config.logger.enabled
+            :debug
+          else
+            :off
+          end
+        end
+
+        setting :formatter do
+          Logger::Formatters::Human
+        end
+
+        setting :destinations do
+          if config.logger.enabled
+            { stdout: $stdout }
+          else
+            {}
+          end
+        end
+
+        defaults :test do
+          setting :enabled, false
+        end
+
+        defaults :production do
+          setting :level do
+            if config.logger.enabled
+              :info
+            else
+              :off
+            end
+          end
+
+          setting :formatter do
+            Logger::Formatters::Logfmt
+          end
+        end
+
+        defaults :ludicrous do
+          setting :enabled, false
+        end
+      end
+
+      configurable :normalizer do
+        setting :strict_path, true
+        setting :strict_www, false
+        setting :require_www, true
+      end
+
+      configurable :tasks do
+        setting :paths, ["./tasks", File.expand_path("../tasks", __FILE__)]
+        setting :prelaunch, []
+      end
+
+      configurable :redis do
+        configurable :connection do
+          setting :url do
+            ENV["REDIS_URL"] || "redis://127.0.0.1:6379"
+          end
+
+          setting :timeout, 5
+          setting :driver, nil
+          setting :id, nil
+          setting :tcp_keepalive, 5
+          setting :reconnect_attempts, 1
+          setting :inherit_socket, false
+        end
+
+        configurable :pool do
+          setting :size, 3
+          setting :timeout, 1
+        end
+
+        setting :key_prefix, "pw"
+      end
+
+      configurable :cookies do
+        setting :domain
+        setting :path, "/"
+        setting :max_age
+        setting :expires
+        setting :secure
+        setting :http_only
+        setting :same_site
+      end
+    end
+  end
+end