archival 0.0.2 → 0.0.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9c657b6a9eef44687dc75a8c85349309433c224fc7a0871890c4c50aa955745f
-  data.tar.gz: a857f9490e10cf5aa9e49e9df1d5adbb40908dd1731d00a81b41361fb4bbcc4c
+  metadata.gz: 71c5bb3b87870dd8146038f624251b7a9ef351a7d69f8da16c214c91ea740cfb
+  data.tar.gz: 6978ae618a2e5312178e5c0d1eb7174c13f3ef0512d0ef31d83f5012e0bd9712
 SHA512:
-  metadata.gz: 5bcf4e0b7678dc60aa1769a1afa586cbd3569a36b7d863c5fb83a7fe45e4249f6a176a411e17815c4ce41d0dc95d233f0fdaf7af640dfff81eba4851f54af387
-  data.tar.gz: 9738d2bc0bfbad7612c9ff5e225e5787691ef736824ff4a546e25bab3855c70af7cffeae2610eb486551dc8fb1f44f885223664a48e41d9bd4f0260eb45615dd
+  metadata.gz: df27c765403ac93aa5bd762ca7693b589aa86a0a80e31a93226fce2a0a756f2167417036cd76e4c96fda55071f3af92884628ac56f2c42bac8995a799432c32d
+  data.tar.gz: 4e785cf1c9bc97a152a737bbc03da981a65b8ea68e0b98fe6fc71196da82fbe928170c983f4dd11a857a9b51c4a1e854f268c42137c184ce15312e4dc9f5cc72

data/.rubocop.yml

@@ -1,14 +1,17 @@
+inherit_mode:
+    merge:
+      - Exclude
+
 AllCops:
   NewCops: enable
   SuggestExtensions: false
   Exclude:
-    - bin/bundle
+    - bin/*
 
 Layout/LineLength:
   Max: 80
   Exclude:
     - archival.gemspec
-    - bin/*
     - spec/spec_helper.rb
 
 Layout/TrailingWhitespace:
@@ -29,6 +32,18 @@ Metrics/BlockLength:
 Metrics/ClassLength:
   Max: 150
 
+Metrics/CyclomaticComplexity:
+  Max: 10
+  Exclude:
+    # This file does a lot of defaulting. It's easy to read.
+    - lib/archival/config.rb
+
+Metrics/PerceivedComplexity:
+  Max: 10
+  Exclude:
+    # This file does a lot of defaulting. It's easy to read.
+    - lib/archival/config.rb
+
 Lint/ImplicitStringConcatenation:
   Exclude:
     - spec/tags/layout_spec.rb

data/Rakefile

@@ -10,3 +10,4 @@ RuboCop::RakeTask.new
 
 task default: :spec
 task lint: :rubocop
+task 'lint:fix': 'rubocop:auto_correct'

data/archival.gemspec

@@ -2,7 +2,7 @@
 
 Gem::Specification.new do |s|
   s.name = 'archival'
-  s.version     = '0.0.2'
+  s.version     = '0.0.4'
   s.summary     = 'An incredibly simple CMS for durable websites'
   s.description = 'https://jesseditson.com/the-simplest-cms-part-1'
   s.authors     = ['Jesse Ditson']

data/bin/archival

@@ -8,16 +8,14 @@
 # this file is here to facilitate running it.
 #
 
-require 'pathname'
-ENV['BUNDLE_GEMFILE'] ||= File.expand_path('../../Gemfile',
-                                           Pathname.new(__FILE__).realpath)
+require "pathname"
+ENV["BUNDLE_GEMFILE"] ||= File.expand_path("../../Gemfile",
+  Pathname.new(__FILE__).realpath)
 
-bundle_binstub = File.expand_path('bundle',
-                                  __dir__)
+bundle_binstub = File.expand_path("../bundle", __FILE__)
 
 if File.file?(bundle_binstub)
-  if File.read(bundle_binstub,
-               300) =~ /This file was generated by Bundler/
+  if File.read(bundle_binstub, 300) =~ /This file was generated by Bundler/
     load(bundle_binstub)
   else
     abort("Your `bin/bundle` was not generated by Bundler, so this binstub cannot run.
@@ -25,7 +23,7 @@ Replace `bin/bundle` by running `bundle binstubs bundler --force`, then run this
   end
 end
 
-require 'rubygems'
-require 'bundler/setup'
+require "rubygems"
+require "bundler/setup"
 
-load Gem.bin_path('archival', 'archival')
+load Gem.bin_path("archival", "archival")

data/bin/bundle

@@ -8,46 +8,46 @@
 # this file is here to facilitate running it.
 #
 
-require 'rubygems'
+require "rubygems"
 
 m = Module.new do
   module_function
 
   def invoked_as_script?
-    File.expand_path($PROGRAM_NAME) == File.expand_path(__FILE__)
+    File.expand_path($0) == File.expand_path(__FILE__)
   end
 
   def env_var_version
-    ENV['BUNDLER_VERSION']
+    ENV["BUNDLER_VERSION"]
   end
 
   def cli_arg_version
     return unless invoked_as_script? # don't want to hijack other binstubs
-    return unless 'update'.start_with?(ARGV.first || ' ') # must be running `bundle update`
-
+    return unless "update".start_with?(ARGV.first || " ") # must be running `bundle update`
     bundler_version = nil
     update_index = nil
     ARGV.each_with_index do |a, i|
-      bundler_version = a if update_index && update_index.succ == i && a =~ Gem::Version::ANCHORED_VERSION_PATTERN
+      if update_index && update_index.succ == i && a =~ Gem::Version::ANCHORED_VERSION_PATTERN
+        bundler_version = a
+      end
       next unless a =~ /\A--bundler(?:[= ](#{Gem::Version::VERSION_PATTERN}))?\z/
-
-      bundler_version = Regexp.last_match(1)
+      bundler_version = $1
       update_index = i
     end
     bundler_version
   end
 
   def gemfile
-    gemfile = ENV['BUNDLE_GEMFILE']
+    gemfile = ENV["BUNDLE_GEMFILE"]
     return gemfile if gemfile && !gemfile.empty?
 
-    File.expand_path('../Gemfile', __dir__)
+    File.expand_path("../../Gemfile", __FILE__)
   end
 
   def lockfile
     lockfile =
       case File.basename(gemfile)
-      when 'gems.rb' then gemfile.sub(/\.rb$/, gemfile)
+      when "gems.rb" then gemfile.sub(/\.rb$/, gemfile)
       else "#{gemfile}.lock"
       end
     File.expand_path(lockfile)
@@ -55,17 +55,15 @@ m = Module.new do
 
   def lockfile_version
     return unless File.file?(lockfile)
-
     lockfile_contents = File.read(lockfile)
     return unless lockfile_contents =~ /\n\nBUNDLED WITH\n\s{2,}(#{Gem::Version::VERSION_PATTERN})\n/
-
     Regexp.last_match(1)
   end
 
   def bundler_requirement
     @bundler_requirement ||=
       env_var_version || cli_arg_version ||
-      bundler_requirement_for(lockfile_version)
+        bundler_requirement_for(lockfile_version)
   end
 
   def bundler_requirement_for(version)
@@ -75,32 +73,28 @@ m = Module.new do
 
     requirement = bundler_gem_version.approximate_recommendation
 
-    return requirement unless Gem::Version.new(Gem::VERSION) < Gem::Version.new('2.7.0')
+    return requirement unless Gem::Version.new(Gem::VERSION) < Gem::Version.new("2.7.0")
 
-    requirement += '.a' if bundler_gem_version.prerelease?
+    requirement += ".a" if bundler_gem_version.prerelease?
 
     requirement
   end
 
   def load_bundler!
-    ENV['BUNDLE_GEMFILE'] ||= gemfile
+    ENV["BUNDLE_GEMFILE"] ||= gemfile
 
     activate_bundler
   end
 
   def activate_bundler
     gem_error = activation_error_handling do
-      gem 'bundler', bundler_requirement
+      gem "bundler", bundler_requirement
     end
     return if gem_error.nil?
-
     require_error = activation_error_handling do
-      require 'bundler/version'
-    end
-    if require_error.nil? && Gem::Requirement.new(bundler_requirement).satisfied_by?(Gem::Version.new(Bundler::VERSION))
-      return
+      require "bundler/version"
     end
-
+    return if require_error.nil? && Gem::Requirement.new(bundler_requirement).satisfied_by?(Gem::Version.new(Bundler::VERSION))
     warn "Activating bundler (#{bundler_requirement}) failed:\n#{gem_error.message}\n\nTo install the version of bundler this project requires, run `gem install bundler -v '#{bundler_requirement}'`"
     exit 42
   end
@@ -115,4 +109,6 @@ end
 
 m.load_bundler!
 
-load Gem.bin_path('bundler', 'bundle') if m.invoked_as_script?
+if m.invoked_as_script?
+  load Gem.bin_path("bundler", "bundle")
+end

data/bin/htmldiff

@@ -8,16 +8,14 @@
 # this file is here to facilitate running it.
 #
 
-require 'pathname'
-ENV['BUNDLE_GEMFILE'] ||= File.expand_path('../../Gemfile',
-                                           Pathname.new(__FILE__).realpath)
+require "pathname"
+ENV["BUNDLE_GEMFILE"] ||= File.expand_path("../../Gemfile",
+  Pathname.new(__FILE__).realpath)
 
-bundle_binstub = File.expand_path('bundle',
-                                  __dir__)
+bundle_binstub = File.expand_path("../bundle", __FILE__)
 
 if File.file?(bundle_binstub)
-  if File.read(bundle_binstub,
-               300) =~ /This file was generated by Bundler/
+  if File.read(bundle_binstub, 300) =~ /This file was generated by Bundler/
     load(bundle_binstub)
   else
     abort("Your `bin/bundle` was not generated by Bundler, so this binstub cannot run.
@@ -25,7 +23,7 @@ Replace `bin/bundle` by running `bundle binstubs bundler --force`, then run this
   end
 end
 
-require 'rubygems'
-require 'bundler/setup'
+require "rubygems"
+require "bundler/setup"
 
-load Gem.bin_path('diff-lcs', 'htmldiff')
+load Gem.bin_path("diff-lcs", "htmldiff")

data/bin/ldiff

@@ -8,16 +8,14 @@
 # this file is here to facilitate running it.
 #
 
-require 'pathname'
-ENV['BUNDLE_GEMFILE'] ||= File.expand_path('../../Gemfile',
-                                           Pathname.new(__FILE__).realpath)
+require "pathname"
+ENV["BUNDLE_GEMFILE"] ||= File.expand_path("../../Gemfile",
+  Pathname.new(__FILE__).realpath)
 
-bundle_binstub = File.expand_path('bundle',
-                                  __dir__)
+bundle_binstub = File.expand_path("../bundle", __FILE__)
 
 if File.file?(bundle_binstub)
-  if File.read(bundle_binstub,
-               300) =~ /This file was generated by Bundler/
+  if File.read(bundle_binstub, 300) =~ /This file was generated by Bundler/
     load(bundle_binstub)
   else
     abort("Your `bin/bundle` was not generated by Bundler, so this binstub cannot run.
@@ -25,7 +23,7 @@ Replace `bin/bundle` by running `bundle binstubs bundler --force`, then run this
   end
 end
 
-require 'rubygems'
-require 'bundler/setup'
+require "rubygems"
+require "bundler/setup"
 
-load Gem.bin_path('diff-lcs', 'ldiff')
+load Gem.bin_path("diff-lcs", "ldiff")

data/bin/listen

@@ -8,16 +8,14 @@
 # this file is here to facilitate running it.
 #
 
-require 'pathname'
-ENV['BUNDLE_GEMFILE'] ||= File.expand_path('../../Gemfile',
-                                           Pathname.new(__FILE__).realpath)
+require "pathname"
+ENV["BUNDLE_GEMFILE"] ||= File.expand_path("../../Gemfile",
+  Pathname.new(__FILE__).realpath)
 
-bundle_binstub = File.expand_path('bundle',
-                                  __dir__)
+bundle_binstub = File.expand_path("../bundle", __FILE__)
 
 if File.file?(bundle_binstub)
-  if File.read(bundle_binstub,
-               300) =~ /This file was generated by Bundler/
+  if File.read(bundle_binstub, 300) =~ /This file was generated by Bundler/
     load(bundle_binstub)
   else
     abort("Your `bin/bundle` was not generated by Bundler, so this binstub cannot run.
@@ -25,7 +23,7 @@ Replace `bin/bundle` by running `bundle binstubs bundler --force`, then run this
   end
 end
 
-require 'rubygems'
-require 'bundler/setup'
+require "rubygems"
+require "bundler/setup"
 
-load Gem.bin_path('listen', 'listen')
+load Gem.bin_path("listen", "listen")

data/bin/rake

@@ -8,16 +8,14 @@
 # this file is here to facilitate running it.
 #
 
-require 'pathname'
-ENV['BUNDLE_GEMFILE'] ||= File.expand_path('../../Gemfile',
-                                           Pathname.new(__FILE__).realpath)
+require "pathname"
+ENV["BUNDLE_GEMFILE"] ||= File.expand_path("../../Gemfile",
+  Pathname.new(__FILE__).realpath)
 
-bundle_binstub = File.expand_path('bundle',
-                                  __dir__)
+bundle_binstub = File.expand_path("../bundle", __FILE__)
 
 if File.file?(bundle_binstub)
-  if File.read(bundle_binstub,
-               300) =~ /This file was generated by Bundler/
+  if File.read(bundle_binstub, 300) =~ /This file was generated by Bundler/
     load(bundle_binstub)
   else
     abort("Your `bin/bundle` was not generated by Bundler, so this binstub cannot run.
@@ -25,7 +23,7 @@ Replace `bin/bundle` by running `bundle binstubs bundler --force`, then run this
   end
 end
 
-require 'rubygems'
-require 'bundler/setup'
+require "rubygems"
+require "bundler/setup"
 
-load Gem.bin_path('rake', 'rake')
+load Gem.bin_path("rake", "rake")

data/bin/rspec

@@ -8,16 +8,14 @@
 # this file is here to facilitate running it.
 #
 
-require 'pathname'
-ENV['BUNDLE_GEMFILE'] ||= File.expand_path('../../Gemfile',
-                                           Pathname.new(__FILE__).realpath)
+require "pathname"
+ENV["BUNDLE_GEMFILE"] ||= File.expand_path("../../Gemfile",
+  Pathname.new(__FILE__).realpath)
 
-bundle_binstub = File.expand_path('bundle',
-                                  __dir__)
+bundle_binstub = File.expand_path("../bundle", __FILE__)
 
 if File.file?(bundle_binstub)
-  if File.read(bundle_binstub,
-               300) =~ /This file was generated by Bundler/
+  if File.read(bundle_binstub, 300) =~ /This file was generated by Bundler/
     load(bundle_binstub)
   else
     abort("Your `bin/bundle` was not generated by Bundler, so this binstub cannot run.
@@ -25,7 +23,7 @@ Replace `bin/bundle` by running `bundle binstubs bundler --force`, then run this
   end
 end
 
-require 'rubygems'
-require 'bundler/setup'
+require "rubygems"
+require "bundler/setup"
 
-load Gem.bin_path('rspec-core', 'rspec')
+load Gem.bin_path("rspec-core", "rspec")

data/bin/rubocop

@@ -8,16 +8,14 @@
 # this file is here to facilitate running it.
 #
 
-require 'pathname'
-ENV['BUNDLE_GEMFILE'] ||= File.expand_path('../../Gemfile',
-                                           Pathname.new(__FILE__).realpath)
+require "pathname"
+ENV["BUNDLE_GEMFILE"] ||= File.expand_path("../../Gemfile",
+  Pathname.new(__FILE__).realpath)
 
-bundle_binstub = File.expand_path('bundle',
-                                  __dir__)
+bundle_binstub = File.expand_path("../bundle", __FILE__)
 
 if File.file?(bundle_binstub)
-  if File.read(bundle_binstub,
-               300) =~ /This file was generated by Bundler/
+  if File.read(bundle_binstub, 300) =~ /This file was generated by Bundler/
     load(bundle_binstub)
   else
     abort("Your `bin/bundle` was not generated by Bundler, so this binstub cannot run.
@@ -25,7 +23,7 @@ Replace `bin/bundle` by running `bundle binstubs bundler --force`, then run this
   end
 end
 
-require 'rubygems'
-require 'bundler/setup'
+require "rubygems"
+require "bundler/setup"
 
-load Gem.bin_path('rubocop', 'rubocop')
+load Gem.bin_path("rubocop", "rubocop")

data/bin/ruby-parse

@@ -8,16 +8,14 @@
 # this file is here to facilitate running it.
 #
 
-require 'pathname'
-ENV['BUNDLE_GEMFILE'] ||= File.expand_path('../../Gemfile',
-                                           Pathname.new(__FILE__).realpath)
+require "pathname"
+ENV["BUNDLE_GEMFILE"] ||= File.expand_path("../../Gemfile",
+  Pathname.new(__FILE__).realpath)
 
-bundle_binstub = File.expand_path('bundle',
-                                  __dir__)
+bundle_binstub = File.expand_path("../bundle", __FILE__)
 
 if File.file?(bundle_binstub)
-  if File.read(bundle_binstub,
-               300) =~ /This file was generated by Bundler/
+  if File.read(bundle_binstub, 300) =~ /This file was generated by Bundler/
     load(bundle_binstub)
   else
     abort("Your `bin/bundle` was not generated by Bundler, so this binstub cannot run.
@@ -25,7 +23,7 @@ Replace `bin/bundle` by running `bundle binstubs bundler --force`, then run this
   end
 end
 
-require 'rubygems'
-require 'bundler/setup'
+require "rubygems"
+require "bundler/setup"
 
-load Gem.bin_path('parser', 'ruby-parse')
+load Gem.bin_path("parser", "ruby-parse")

data/bin/ruby-rewrite

@@ -8,16 +8,14 @@
 # this file is here to facilitate running it.
 #
 
-require 'pathname'
-ENV['BUNDLE_GEMFILE'] ||= File.expand_path('../../Gemfile',
-                                           Pathname.new(__FILE__).realpath)
+require "pathname"
+ENV["BUNDLE_GEMFILE"] ||= File.expand_path("../../Gemfile",
+  Pathname.new(__FILE__).realpath)
 
-bundle_binstub = File.expand_path('bundle',
-                                  __dir__)
+bundle_binstub = File.expand_path("../bundle", __FILE__)
 
 if File.file?(bundle_binstub)
-  if File.read(bundle_binstub,
-               300) =~ /This file was generated by Bundler/
+  if File.read(bundle_binstub, 300) =~ /This file was generated by Bundler/
     load(bundle_binstub)
   else
     abort("Your `bin/bundle` was not generated by Bundler, so this binstub cannot run.
@@ -25,7 +23,7 @@ Replace `bin/bundle` by running `bundle binstubs bundler --force`, then run this
   end
 end
 
-require 'rubygems'
-require 'bundler/setup'
+require "rubygems"
+require "bundler/setup"
 
-load Gem.bin_path('parser', 'ruby-rewrite')
+load Gem.bin_path("parser", "ruby-rewrite")

data/exe/archival

@@ -19,17 +19,13 @@ build_dir = Dir.pwd
 
 case command
 when 'build'
-  builder = Archival::Builder.new('root' => build_dir)
-  builder.write_all
-when 'run'
-  Archival.listen(build_dir)
-  begin
-    sleep
-  rescue Interrupt
-    # Don't print a stack when a user interrupts, as this is the right way to
-    # stop the development server.
-    puts ''
+  Archival::Logger.benchmark('built') do
+    config = Archival::Config.new('root' => build_dir)
+    builder = Archival::Builder.new(config)
+    builder.write_all
   end
+when 'run'
+  Archival.listen('root' => build_dir)
 else
   # print help
   puts 'archival [command]'

data/helper/js/archival-helper.js

@@ -0,0 +1,91 @@
+/**
+ * When running archival in development mode (archival run), this file is
+ * injected into all pages, and is responsible for reloading the page when the
+ * source has changed.
+ */
+
+(function () {
+  const remotePort = $PORT;
+  const CONNECTING_COLOR = "#bd270d";
+  const CONNECTED_COLOR = "#19bd0d";
+  const CHECK_INTERVAL = 500;
+  const DISCONNECTED_INTERVAL = 1000;
+  const connectionDot = document.createElement("div");
+  connectionDot.style = `position: absolute; z-index: 9999; bottom: 10px; right: 10px; background-color: ${CONNECTING_COLOR}; width: 15px; height: 15px; border-radius: 50%; opacity: 0.8;`;
+  connectionDot.setAttribute("title", "Archival Dev Server: Connecting");
+  connectionDot.addEventListener(
+    "mouseenter",
+    () => (connectionDot.style.opacity = 0.2)
+  );
+  connectionDot.addEventListener(
+    "mouseleave",
+    () => (connectionDot.style.opacity = 0.8)
+  );
+
+  let lastContact = -1;
+  let isConnecting = false;
+  let connection;
+
+  function connectionLoop() {
+    connection.send(`page:${window.location.pathname}`);
+    if (Date.now() - lastContact > DISCONNECTED_INTERVAL) {
+      setConnected(false);
+      connectSocket();
+    }
+    setTimeout(connectionLoop, CHECK_INTERVAL);
+  }
+
+  function setConnected(connected) {
+    connectionDot.style.backgroundColor = connected
+      ? CONNECTED_COLOR
+      : CONNECTING_COLOR;
+    connectionDot.setAttribute(
+      "title",
+      `Archival Dev Server: ${connected ? "Connected" : "Disconnected"}`
+    );
+  }
+
+  window.onload = () => {
+    connectSocket(true);
+  };
+
+  function connectSocket(init) {
+    if (isConnecting) {
+      return;
+    }
+    isConnecting = true;
+    console.log(
+      `${init ? "connecting" : "reconnecting"} to archival dev server...`
+    );
+    document.body.appendChild(connectionDot);
+    connection = new WebSocket(`ws://localhost:${remotePort}`);
+    connection.onerror = () => {
+      isConnecting = false;
+    };
+
+    connection.onopen = () => {
+      isConnecting = false;
+      connection.send("connected");
+      if (init) {
+        connectionLoop();
+      }
+    };
+    connection.onmessage = (event) => {
+      lastContact = Date.now();
+      switch (event.data) {
+        case "ready":
+          console.log("connected to archival dev server.");
+          break;
+        case "ok":
+          setConnected(true);
+          break;
+        case "refresh":
+          window.location.reload();
+          break;
+        default:
+          console.log(`receieved unexpected message ${event.data}`);
+          break;
+      }
+    };
+  }
+})();

data/lib/archival/builder.rb

@@ -12,7 +12,7 @@ module Archival
     attr_reader :page_templates
 
     def initialize(config, *_args)
-      @config = Config.new(config)
+      @config = config
       refresh_config
     end
 
@@ -36,6 +36,11 @@ module Archival
       update_objects
     end
 
+    def full_rebuild
+      Layout.reset_cache
+      refresh_config
+    end
+
     def update_pages
       do_update_pages(File.join(@config.root, @config.pages_dir))
     end
@@ -61,6 +66,7 @@ module Archival
               add_prefix.call(page_name)
             )
             content = @file_system.read_template_file(template_file)
+            content += dev_mode_content if @config.dev_mode
             @page_templates[add_prefix.call(page_name)] =
               Liquid::Template.parse(content)
           end
@@ -122,6 +128,19 @@ module Archival
           file.write(render(template))
         end
       end
+      return if @config.dev_mode
+
+      # in production, also copy all assets to the dist folder.
+      @config.assets_dirs.each do |asset_dir|
+        FileUtils.copy_entry File.join(@config.root, asset_dir),
+                             File.join(@config.build_dir, asset_dir)
+      end
+    end
+
+    private
+
+    def dev_mode_content
+      "<script src=\"http://localhost:#{@config.helper_port}/js/archival-helper.js\" type=\"application/javascript\"></script>" # rubocop:disable Layout/LineLength
     end
   end
 end

data/lib/archival/config.rb

@@ -1,16 +1,30 @@
 # frozen_string_literal: true
 
+require 'tomlrb'
+
 module Archival
   class Config
-    attr_reader :pages_dir, :objects_dir, :root, :build_dir
+    attr_reader :pages_dir, :objects_dir, :assets_dirs, :root, :build_dir,
+                :helper_port, :dev_mode
 
-    def initialize(config)
-      @pages_dir = config['pages'] || 'pages'
-      @objects_dir = config['objects'] || 'objects'
+    def initialize(config = {})
       @root = config['root'] || Dir.pwd
-      @build_dir = config['build_dir'] || File.join(
+      manifest = load_manifest
+      @pages_dir = config['pages'] || manifest['pages'] || 'pages'
+      @objects_dir = config['objects'] || manifest['objects'] || 'objects'
+      @build_dir = config['build_dir'] || manifest['build_dir'] || File.join(
         @root, 'dist'
       )
+      @helper_port = config['helper_port'] || manifest['helper_port'] || 2701
+      @assets_dirs = config['assets_dirs'] || manifest['assets'] || []
+      @dev_mode = config[:dev_mode] || false
+    end
+
+    def load_manifest
+      manifest_file = File.join(@root, 'manifest.toml')
+      return Tomlrb.load_file(manifest_file) if File.file? manifest_file
+
+      {}
     end
   end
 end

data/lib/archival/helper_server.rb

@@ -0,0 +1,157 @@
+# frozen_string_literal: true
+
+require 'socket'
+require 'open-uri'
+
+module Archival
+  class HelperServer
+    attr_reader :page
+
+    def initialize(port, build_dir)
+      @port = port
+      @build_dir = build_dir
+      @helper_dir = File.expand_path(File.join(File.dirname(__FILE__),
+                                               '../../helper'))
+    end
+
+    def start
+      server = TCPServer.new @port
+      loop do
+        Thread.start(server.accept) do |client|
+          req = ''
+          method = nil
+          path = nil
+          while (line = client.gets) && (line != "\r\n")
+            unless method
+              req_info = line.split
+              method = req_info[0]
+              path = req_info[1]
+            end
+            req += line
+          end
+          client.close unless req
+          handle_request(client, req, method, path)
+        end
+      end
+    end
+
+    def refresh_client
+      ws_sendmessage('refresh')
+    end
+
+    private
+
+    MAGIC_GUID = '258EAFA5-E914-47DA-95CA-C5AB0DC85B11'
+
+    def handle_request(client, req, method, path)
+      if method == 'GET' && path.start_with?('/js/')
+        # For static paths, just serve the files they refer to.
+        http_response(client, type: 'application/javascript') do
+          serve_static(client, path)
+        end
+        client.close
+      elsif (matches = req.match(/^Sec-WebSocket-Key: (\S+)/))
+        websocket_key = matches[1]
+        # puts "Websocket handshake detected with key: #{websocket_key}"
+        connect_socket(client, websocket_key)
+      else
+        client.close
+      end
+    end
+
+    def connect_socket(client, websocket_key)
+      @socket = client
+      response_key = Digest::SHA1.base64digest([websocket_key,
+                                                MAGIC_GUID].join)
+      #   puts "Responding to handshake with key: #{response_key}"
+
+      @socket.write "HTTP/1.1 101 Switching Protocols\r\n"
+      @socket.write "Upgrade: websocket\r\n"
+      @socket.write "Connection: Upgrade\r\n"
+      @socket.write "Sec-WebSocket-Accept: #{response_key}\r\n"
+      @socket.write "\r\n"
+
+      #   puts 'Handshake completed.'
+      ws_loop
+    end
+
+    def ws_loop
+      loop do
+        msg = ws_getmessage
+        next unless msg
+
+        if msg == 'connected'
+          ws_sendmessage('ready')
+        elsif msg.start_with?('page:')
+          page_path = Pathname.new(msg.sub(/^page:/, ''))
+          @page = page_path.relative_path_from(@build_dir)
+          ws_sendmessage('ok')
+        end
+      end
+    end
+
+    def validate_ws_message
+      first_byte = @socket.getbyte
+      return unless first_byte
+
+      fin = first_byte & 0b10000000
+      opcode = first_byte & 0b00001111
+
+      # Our server only supports single-frame, text messages.
+      # Raise an exception if the client tries to send anything else.
+      raise "We don't support continuations" unless fin
+      raise 'We only support opcode 1' unless opcode == 1
+
+      second_byte = @socket.getbyte
+      is_masked = second_byte & 0b10000000
+      payload_size = second_byte & 0b01111111
+
+      raise 'frame masked incorrectly' unless is_masked
+      raise 'payload must be < 126 bytes in length' unless payload_size < 126
+
+      payload_size
+    end
+
+    def ws_getmessage
+      payload_size = validate_ws_message
+      return unless payload_size
+
+      #   warn "Payload size: #{payload_size} bytes"
+
+      mask = 4.times.map { @socket.getbyte }
+      #   warn "Got mask: #{mask.inspect}"
+
+      data = payload_size.times.map { @socket.getbyte }
+      #   warn "Got masked data: #{data.inspect}"
+
+      unmasked_data = data.each_with_index.map do |byte, i|
+        byte ^ mask[i % 4]
+      end
+      #   warn "Unmasked the data: #{unmasked_data.inspect}"
+
+      unmasked_data.to_s.pack('C*').force_encoding('utf-8')
+    end
+
+    def ws_sendmessage(message)
+      return unless @socket
+
+      output = [0b10000001, message.size, message]
+      @socket.write output.pack("CCA#{message.size}")
+    end
+
+    def serve_static(client, path)
+      buffer = File.open(File.join(@helper_dir, path)).read
+      buffer.sub! '$PORT', @port.to_s
+      client.print buffer
+    end
+
+    def http_response(client, config)
+      status = config[:status] ||= 200
+      type = config[:type] ||= 'text/html'
+      client.print "HTTP/1.1 #{status}\r\n"
+      client.print "Content-Type: #{type}\r\n"
+      client.print "\r\n"
+      yield
+    end
+  end
+end

data/lib/archival/listen.rb

@@ -4,40 +4,83 @@ require 'listen'
 require 'pathname'
 
 module Archival
-  def self.child?(parent, child)
-    path = Pathname.new(child)
-    return true if path.fnmatch?(File.join(parent, '**'))
-
-    false
+  def listen(config = {})
+    @config = Config.new(config.merge(dev_mode: true))
+    builder = Builder.new(@config)
+    Logger.benchmark('built') do
+      builder.write_all
+    end
+    ignore = %r{/dist/}
+    listener = Listen.to(@config.root,
+                         ignore: ignore) do |modified, added, removed|
+      updated_pages = []
+      updated_objects = []
+      updated_assets = []
+      (modified + added + removed).each do |file|
+        case change_type(file)
+        when :pages
+          updated_pages << file
+        when :objects
+          updated_objects << file
+        when :assets
+          updated_assets << file
+        end
+      end
+      @server.refresh_client if rebuild?(builder, updated_objects,
+                                         updated_pages, updated_assets)
+    end
+    listener.start
+    serve_helpers
   end
 
-  def self.process_change?(file, builder)
-    if child?(File.join(@config.root, @config.pages_dir), file)
+  module_function :listen
+
+  class << self
+    private
+
+    def child?(parent, child)
+      path = Pathname.new(child)
+      return true if path.fnmatch?(File.join(parent, '**'))
+
+      false
+    end
+
+    def change_type(file)
       # a page was modified, rebuild the pages.
-      builder.update_pages
-      return true
-    elsif child?(File.join(@config.root, @config.objects_dir), file)
+      return :pages if child?(File.join(@config.root, @config.pages_dir),
+                              file)
       # an object was modified, rebuild the objects.
-      builder.update_objects
-      return true
+      return :objects if child?(File.join(@config.root, @config.objects_dir),
+                                file)
+
+      # layout and other assets. For now, this is everything.
+      @config.assets_dirs.each do |dir|
+        return :assets if child?(File.join(@config.root, dir), file)
+      end
+      return :assets if child?(File.join(@config.root, 'layout'), file)
+      return :assets if ['manifest.toml',
+                         'objects.toml'].include? File.basename(file)
+
+      :none
     end
-    false
-  end
 
-  def listen(config)
-    @config = Config.new(config)
-    builder = Builder.new(config)
-    builder.write_all
-    listener = Listen.to(@config.root) do |modified, added, removed|
-      needs_update = false
-      (modified + added + removed).each do |file|
-        needs_update = true if process_change?(file, builder)
+    def rebuild?(builder, updated_objects, updated_pages, updated_assets)
+      if updated_pages.empty? && updated_objects.empty? && updated_assets.empty?
+        return false
+      end
+
+      Logger.benchmark('rebuilt') do
+        builder.update_objects if updated_objects.length
+        builder.update_pages if updated_pages.length
+        builder.full_rebuild if updated_assets.length
+        builder.write_all
       end
-      builder.write_all if needs_update
+      true
     end
-    listener.start
-    listener
-  end
 
-  module_function :listen
+    def serve_helpers
+      @server = HelperServer.new(@config.helper_port, @config.build_dir)
+      @server.start
+    end
+  end
 end

data/lib/archival/logger.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+require 'benchmark'
+
+module Archival
+  class Logger
+    def self.benchmark(message, &block)
+      Benchmark.bm do |bm|
+        bm.report(message, &block)
+      end
+    end
+  end
+end

data/lib/archival/rake_tasks.rb

@@ -27,19 +27,15 @@ class RakeTasks
     build_dir = Dir.pwd
 
     task 'build' do
-      builder = Archival::Builder.new('root' => build_dir)
-      builder.write_all
+      Archival::Logger.benchmark('built') do
+        config = Archival::Config.new('root' => build_dir)
+        builder = Archival::Builder.new(config)
+        builder.write_all
+      end
     end
 
     task 'run' do
-      Archival.listen(build_dir)
-      begin
-        sleep
-      rescue Interrupt
-        # Don't print a stack when a user interrupts, as this is the right way
-        # to stop the development server.
-        puts ''
-      end
+      Archival.listen('root' => build_dir)
     end
 
     RakeTasks.instance = self

data/lib/archival/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Archival
-  VERSION = '0.0.2'
+  VERSION = '0.0.4'
 end

data/lib/archival.rb

@@ -5,6 +5,8 @@ module Archival
 end
 
 require 'archival/version'
+require 'archival/logger'
 require 'archival/config'
+require 'archival/helper_server'
 require 'archival/builder'
 require 'archival/listen'

data/package.json

@@ -1,6 +1,6 @@
 {
   "name": "archival",
-  "version": "0.0.2",
+  "version": "0.0.4",
   "description": "An incredibly simple CMS for durable websites",
   "bin": "build.rb",
   "directories": {

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: archival
 version: !ruby/object:Gem::Version
-  version: 0.0.2
+  version: 0.0.4
 platform: ruby
 authors:
 - Jesse Ditson
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2021-11-05 00:00:00.000000000 Z
+date: 2021-11-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: liquid
@@ -82,10 +82,13 @@ files:
 - bin/ruby-rewrite
 - bin/setup
 - exe/archival
+- helper/js/archival-helper.js
 - lib/archival.rb
 - lib/archival/builder.rb
 - lib/archival/config.rb
+- lib/archival/helper_server.rb
 - lib/archival/listen.rb
+- lib/archival/logger.rb
 - lib/archival/rake_tasks.rb
 - lib/archival/version.rb
 - lib/tags/layout.rb