archival 0.0.0 → 0.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b98cab63cfce4e643285b1da77a1536986cb6996bc06ebae39504ac0eff317c0
-  data.tar.gz: be5bcec316ce9f5c240ed03c7186af5b4872465ec8b86f52e2db09aea3916985
+  metadata.gz: 2cb0c34388e5643a954509fca99931fc9b60d2705ba12733ea890eed817a549e
+  data.tar.gz: 29c8b6c12cd039be464211cd658b76cde06d4e20a8f2dad5b8f1921c0d40e76b
 SHA512:
-  metadata.gz: 5eb2985aee73e4019e13fb833089ee33739657c0f4733f006de6e40c1be9af02e3f6539ded13aeb06b1bdf3a098b2dc65fe9b53b2c3f858845d6300a0c876921
-  data.tar.gz: b0f5f0f435bf4635096a913b26360d599fa674c4663d4912345543556c055785002c7d99e9e6fb51d54a1a11255fa94a487fa4cedce15c36bcd18eb2e3750b21
+  metadata.gz: 1a6015cc2dafc8335acd969a1616b1842e8fb5afa9a6d966920d5399792a9fc774313e67b2c8467767f408f32eddc33660f7389954a515af6dcd386392ee74ba
+  data.tar.gz: 3b076507b17cde33ef678c8ced6a84efa4e69c927017dc411b6c4a9475eff5344cbeafd11396c5185fa8e3638854ae40e91ef9756a8c02303d2781839e7f886c

data/.bundle/config

@@ -0,0 +1,2 @@
+---
+BUNDLE_BIN: "bin"

data/.rspec

@@ -0,0 +1,3 @@
+--format documentation
+--color
+--require spec_helper

data/.rubocop.yml

@@ -0,0 +1,42 @@
+AllCops:
+  NewCops: enable
+  SuggestExtensions: false
+  Exclude:
+    - bin/bundle
+
+Layout/LineLength:
+  Max: 80
+  Exclude:
+    - archival.gemspec
+    - bin/*
+    - spec/spec_helper.rb
+
+Layout/TrailingWhitespace:
+  Exclude:
+    # This file has a lot of templates and includes
+    # intentional trailing whitespace.
+    - spec/tags/layout_spec.rb
+
+Metrics/MethodLength:
+  Max: 35
+
+Metrics/AbcSize:
+   Enabled: false
+
+Metrics/BlockLength:
+  Max: 150
+
+Metrics/ClassLength:
+  Max: 150
+
+Lint/ImplicitStringConcatenation:
+  Exclude:
+    - spec/tags/layout_spec.rb
+
+# A nice idea, but some code is self-documenting and cops aren't human.
+Style/Documentation:
+  Enabled: false
+
+# In Layout we use class vars as a global cache.
+Style/ClassVars:
+  Enabled: false

data/.vscode/launch.json

@@ -0,0 +1,43 @@
+{
+    // Use IntelliSense to learn about possible attributes.
+    // Hover to view descriptions of existing attributes.
+    // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
+  "version": "0.2.0",
+  "configurations": [
+    {
+      "type": "ruby-debug",
+      "request": "launch",
+      "name": "Ruby",
+      "program": "${file}",
+      "programArgs": [],
+      "useBundler": false
+    },
+    {
+      "type": "ruby-debug",
+      "request": "launch",
+      "name": "RSpec All",
+      "program": "rspec",
+      "programArgs": [
+        "-I",
+        "${workspaceFolder}",
+      ],
+      "useBundler": false
+    },
+    {
+      "type": "ruby-debug",
+      "request": "launch",
+      "name": "RSpec LocalFile",
+      "program": "rspec",
+      "programArgs": ["${relativeFile}"],
+      "useBundler": true
+    },
+    {
+      "type": "ruby-debug",
+      "request": "launch",
+      "name": "RSpec Selected Line",
+      "program": "rspec",
+      "programArgs": ["${relativeFile}:${lineNumber}"],
+      "useBundler": true
+    }
+  ]
+}

data/CHANGELOG.md

@@ -0,0 +1,5 @@
+## [Unreleased]
+
+## [0.1.0] - 2021-10-28
+
+- Initial release

data/Gemfile

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in archival.gemspec
+gemspec
+
+gem 'rake', '~> 13.0'
+gem 'rspec', '~> 3.0'
+gem 'rubocop', '~> 1.22', require: false

data/LICENSE

@@ -0,0 +1,24 @@
+This is free and unencumbered software released into the public domain.
+
+Anyone is free to copy, modify, publish, use, compile, sell, or
+distribute this software, either in source code form or as a compiled
+binary, for any purpose, commercial or non-commercial, and by any
+means.
+
+In jurisdictions that recognize copyright laws, the author or authors
+of this software dedicate any and all copyright interest in the
+software to the public domain. We make this dedication for the benefit
+of the public at large and to the detriment of our heirs and
+successors. We intend this dedication to be an overt act of
+relinquishment in perpetuity of all present and future rights to this
+software under copyright law.
+
+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 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.
+
+For more information, please refer to <https://unlicense.org>

data/README.md

@@ -0,0 +1,58 @@
+# Archival
+
+https://archival.dev
+
+[![Rspec tests](https://github.com/jesseditson/archival/actions/workflows/rspec.yml/badge.svg)](https://github.com/jesseditson/archival/actions/workflows/rspec.yml)
+
+## Why?
+
+Websites have become a bit homogenous, and basic web skills have become fairly accessible. This project aims to make it very easy to build ultra-durable websites that will last a very long time with little to no maintenance, and that don't rely on trendy build tools.
+
+More musings about how this came about on my blog:
+
+https://jesseditson.com/the-simplest-cms-part-1
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'archival'
+```
+
+And then execute:
+
+    $ bundle install
+
+Or install it yourself as:
+
+    $ gem install archival
+
+## Usage
+
+First, install archival by running `gem install archival`.
+
+Then, create a new website:
+
+`archival create my-website`
+
+This sets up some basics. To see your local website, run `archival run`.
+
+When you push an archival website to github, it will automatically build itself to the `dist` folder. To see this locally, run `archival build`.
+
+For more information and documentation, check out the docs at https://archival.dev
+
+Archival uses as few domain specific languages as possible, but doesn't reinvent the wheel. Outside of web standards, here are the technologies used in Archival:
+
+- https://shopify.github.io/liquid/basics/introduction/
+- https://github.com/toml-lang/toml/wiki
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests.
+
+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 the created tag, 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/jesseditson/archival.

data/Rakefile

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
+require 'rubocop/rake_task'
+
+RSpec::Core::RakeTask.new(:spec)
+
+RuboCop::RakeTask.new
+
+task default: :spec
+task lint: :rubocop

data/action.yml

@@ -0,0 +1,14 @@
+name: 'Archival Build'
+description: 'Packages a website built with Archival'
+author: 'Jesse Ditson'
+branding:
+  color: green
+  icon: box
+runs:
+  using: 'composite'
+  steps:
+    - uses: ruby/setup-ruby@v1
+      with:
+        ruby-version: 3.0
+        bundler-cache: true
+    - run: bin/archival build

data/archival.gemspec

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+Gem::Specification.new do |s|
+  s.name = 'archival'
+  s.version     = '0.0.1'
+  s.summary     = 'An incredibly simple CMS for durable websites'
+  s.description = 'https://jesseditson.com/the-simplest-cms-part-1'
+  s.authors     = ['Jesse Ditson']
+  s.email       = 'jesse.ditson@gmail.com'
+  s.homepage    = 'https://archival.dev'
+  s.license = 'Unlicense'
+  s.required_ruby_version = '>= 2.5'
+
+  # Specify which files should be added to the gem when it is released.
+  # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
+  s.files = Dir.chdir(File.expand_path(__dir__)) do
+    `git ls-files -z`.split("\x0").reject do |f|
+      (f == __FILE__) || f.match(%r{\A(?:(?:test|spec|features)/|\.(?:git|travis|circleci)|appveyor)})
+    end
+  end
+  s.bindir        = 'exe'
+  s.executables   = 'archival'
+  s.require_paths = ['lib']
+
+  s.add_dependency 'liquid', '~> 5.1.0'
+  s.add_dependency 'listen', '~> 3.7.0'
+  s.add_dependency 'tomlrb', '~> 2.0.1'
+end

data/bin/archival

@@ -0,0 +1,31 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+#
+# This file was generated by Bundler.
+#
+# The application 'archival' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+require 'pathname'
+ENV['BUNDLE_GEMFILE'] ||= File.expand_path('../../Gemfile',
+                                           Pathname.new(__FILE__).realpath)
+
+bundle_binstub = File.expand_path('bundle',
+                                  __dir__)
+
+if File.file?(bundle_binstub)
+  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.
+Replace `bin/bundle` by running `bundle binstubs bundler --force`, then run this command again.")
+  end
+end
+
+require 'rubygems'
+require 'bundler/setup'
+
+load Gem.bin_path('archival', 'archival')

data/bin/bundle

@@ -0,0 +1,118 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+#
+# This file was generated by Bundler.
+#
+# The application 'bundle' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+require 'rubygems'
+
+m = Module.new do
+  module_function
+
+  def invoked_as_script?
+    File.expand_path($PROGRAM_NAME) == File.expand_path(__FILE__)
+  end
+
+  def env_var_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`
+
+    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
+      next unless a =~ /\A--bundler(?:[= ](#{Gem::Version::VERSION_PATTERN}))?\z/
+
+      bundler_version = Regexp.last_match(1)
+      update_index = i
+    end
+    bundler_version
+  end
+
+  def gemfile
+    gemfile = ENV['BUNDLE_GEMFILE']
+    return gemfile if gemfile && !gemfile.empty?
+
+    File.expand_path('../Gemfile', __dir__)
+  end
+
+  def lockfile
+    lockfile =
+      case File.basename(gemfile)
+      when 'gems.rb' then gemfile.sub(/\.rb$/, gemfile)
+      else "#{gemfile}.lock"
+      end
+    File.expand_path(lockfile)
+  end
+
+  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)
+  end
+
+  def bundler_requirement_for(version)
+    return "#{Gem::Requirement.default}.a" unless version
+
+    bundler_gem_version = Gem::Version.new(version)
+
+    requirement = bundler_gem_version.approximate_recommendation
+
+    return requirement unless Gem::Version.new(Gem::VERSION) < Gem::Version.new('2.7.0')
+
+    requirement += '.a' if bundler_gem_version.prerelease?
+
+    requirement
+  end
+
+  def load_bundler!
+    ENV['BUNDLE_GEMFILE'] ||= gemfile
+
+    activate_bundler
+  end
+
+  def activate_bundler
+    gem_error = activation_error_handling do
+      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
+    end
+
+    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
+
+  def activation_error_handling
+    yield
+    nil
+  rescue StandardError, LoadError => e
+    e
+  end
+end
+
+m.load_bundler!
+
+load Gem.bin_path('bundler', 'bundle') if m.invoked_as_script?

data/bin/htmldiff

@@ -0,0 +1,31 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+#
+# This file was generated by Bundler.
+#
+# The application 'htmldiff' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+require 'pathname'
+ENV['BUNDLE_GEMFILE'] ||= File.expand_path('../../Gemfile',
+                                           Pathname.new(__FILE__).realpath)
+
+bundle_binstub = File.expand_path('bundle',
+                                  __dir__)
+
+if File.file?(bundle_binstub)
+  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.
+Replace `bin/bundle` by running `bundle binstubs bundler --force`, then run this command again.")
+  end
+end
+
+require 'rubygems'
+require 'bundler/setup'
+
+load Gem.bin_path('diff-lcs', 'htmldiff')

data/bin/ldiff

@@ -0,0 +1,31 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+#
+# This file was generated by Bundler.
+#
+# The application 'ldiff' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+require 'pathname'
+ENV['BUNDLE_GEMFILE'] ||= File.expand_path('../../Gemfile',
+                                           Pathname.new(__FILE__).realpath)
+
+bundle_binstub = File.expand_path('bundle',
+                                  __dir__)
+
+if File.file?(bundle_binstub)
+  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.
+Replace `bin/bundle` by running `bundle binstubs bundler --force`, then run this command again.")
+  end
+end
+
+require 'rubygems'
+require 'bundler/setup'
+
+load Gem.bin_path('diff-lcs', 'ldiff')

data/bin/listen

@@ -0,0 +1,31 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+#
+# This file was generated by Bundler.
+#
+# The application 'listen' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+require 'pathname'
+ENV['BUNDLE_GEMFILE'] ||= File.expand_path('../../Gemfile',
+                                           Pathname.new(__FILE__).realpath)
+
+bundle_binstub = File.expand_path('bundle',
+                                  __dir__)
+
+if File.file?(bundle_binstub)
+  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.
+Replace `bin/bundle` by running `bundle binstubs bundler --force`, then run this command again.")
+  end
+end
+
+require 'rubygems'
+require 'bundler/setup'
+
+load Gem.bin_path('listen', 'listen')

data/bin/rake

@@ -0,0 +1,31 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+#
+# This file was generated by Bundler.
+#
+# The application 'rake' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+require 'pathname'
+ENV['BUNDLE_GEMFILE'] ||= File.expand_path('../../Gemfile',
+                                           Pathname.new(__FILE__).realpath)
+
+bundle_binstub = File.expand_path('bundle',
+                                  __dir__)
+
+if File.file?(bundle_binstub)
+  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.
+Replace `bin/bundle` by running `bundle binstubs bundler --force`, then run this command again.")
+  end
+end
+
+require 'rubygems'
+require 'bundler/setup'
+
+load Gem.bin_path('rake', 'rake')

data/bin/rspec

@@ -0,0 +1,31 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+#
+# This file was generated by Bundler.
+#
+# The application 'rspec' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+require 'pathname'
+ENV['BUNDLE_GEMFILE'] ||= File.expand_path('../../Gemfile',
+                                           Pathname.new(__FILE__).realpath)
+
+bundle_binstub = File.expand_path('bundle',
+                                  __dir__)
+
+if File.file?(bundle_binstub)
+  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.
+Replace `bin/bundle` by running `bundle binstubs bundler --force`, then run this command again.")
+  end
+end
+
+require 'rubygems'
+require 'bundler/setup'
+
+load Gem.bin_path('rspec-core', 'rspec')

data/bin/rubocop

@@ -0,0 +1,31 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+#
+# This file was generated by Bundler.
+#
+# The application 'rubocop' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+require 'pathname'
+ENV['BUNDLE_GEMFILE'] ||= File.expand_path('../../Gemfile',
+                                           Pathname.new(__FILE__).realpath)
+
+bundle_binstub = File.expand_path('bundle',
+                                  __dir__)
+
+if File.file?(bundle_binstub)
+  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.
+Replace `bin/bundle` by running `bundle binstubs bundler --force`, then run this command again.")
+  end
+end
+
+require 'rubygems'
+require 'bundler/setup'
+
+load Gem.bin_path('rubocop', 'rubocop')

data/bin/ruby-parse

@@ -0,0 +1,31 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+#
+# This file was generated by Bundler.
+#
+# The application 'ruby-parse' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+require 'pathname'
+ENV['BUNDLE_GEMFILE'] ||= File.expand_path('../../Gemfile',
+                                           Pathname.new(__FILE__).realpath)
+
+bundle_binstub = File.expand_path('bundle',
+                                  __dir__)
+
+if File.file?(bundle_binstub)
+  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.
+Replace `bin/bundle` by running `bundle binstubs bundler --force`, then run this command again.")
+  end
+end
+
+require 'rubygems'
+require 'bundler/setup'
+
+load Gem.bin_path('parser', 'ruby-parse')

data/bin/ruby-rewrite

@@ -0,0 +1,31 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+#
+# This file was generated by Bundler.
+#
+# The application 'ruby-rewrite' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+require 'pathname'
+ENV['BUNDLE_GEMFILE'] ||= File.expand_path('../../Gemfile',
+                                           Pathname.new(__FILE__).realpath)
+
+bundle_binstub = File.expand_path('bundle',
+                                  __dir__)
+
+if File.file?(bundle_binstub)
+  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.
+Replace `bin/bundle` by running `bundle binstubs bundler --force`, then run this command again.")
+  end
+end
+
+require 'rubygems'
+require 'bundler/setup'
+
+load Gem.bin_path('parser', 'ruby-rewrite')

data/bin/setup

@@ -0,0 +1,6 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install

data/exe/archival

@@ -0,0 +1,41 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require 'archival'
+
+VALID_COMMANDS = %w[
+  build
+  run
+].freeze
+
+command = ARGV[0]
+
+unless !command || VALID_COMMANDS.include?(command)
+  raise StandardError,
+        "Invalid command #{command}"
+end
+
+build_dir = Dir.pwd
+
+case command
+when 'build'
+  builder = Archival::Builder('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 ''
+  end
+else
+  # print help
+  puts 'archival [command]'
+  puts ''
+  puts 'Commands:'
+  puts '      build     Builds the current directory as an archival website.'
+  puts '      run       Runs the current directory in development mode, '
+  + 'recompiling when files change.'
+end

data/lib/archival/builder.rb

@@ -0,0 +1,127 @@
+# frozen_string_literal: true
+
+require 'liquid'
+require 'tomlrb'
+require 'tags/layout'
+
+Liquid::Template.error_mode = :strict
+Liquid::Template.register_tag('layout', Layout)
+
+module Archival
+  class Builder
+    attr_reader :page_templates
+
+    def initialize(config, *_args)
+      @config = Config.new(config)
+      refresh_config
+    end
+
+    def refresh_config
+      @file_system = Liquid::LocalFileSystem.new(
+        @config.root, '%s.liquid'
+      )
+      @variables = {}
+      @object_types = {}
+      @page_templates = {}
+
+      Liquid::Template.file_system = @file_system
+
+      objects_definition_file = File.join(@config.root,
+                                          'objects.toml')
+      if File.file? objects_definition_file
+        @object_types = read_toml(objects_definition_file)
+      end
+
+      update_pages
+      update_objects
+    end
+
+    def update_pages
+      do_update_pages(File.join(@config.root, @config.pages_dir))
+    end
+
+    def do_update_pages(dir, prefix = nil)
+      add_prefix = lambda { |entry|
+        prefix ? File.join(prefix, entry) : entry
+      }
+      Dir.foreach(dir) do |entry|
+        if File.directory? entry
+          unless [
+            '.', '..'
+          ].include?(entry)
+            update_pages(File.join(dir, entry),
+                         add_prefix(entry))
+          end
+        elsif File.file? File.join(dir, entry)
+          if entry.end_with?('.liquid') && !(entry.start_with? '_')
+            page_name = File.basename(entry,
+                                      '.liquid')
+            template_file = File.join(
+              @config.pages_dir,
+              add_prefix.call(page_name)
+            )
+            content = @file_system.read_template_file(template_file)
+            @page_templates[add_prefix.call(page_name)] =
+              Liquid::Template.parse(content)
+          end
+        end
+      end
+    end
+
+    def update_objects
+      do_update_objects(File.join(@config.root,
+                                  @config.objects_dir))
+    end
+
+    def do_update_objects(dir)
+      objects = {}
+      @object_types.each do |name, _definition|
+        objects[name] = []
+        obj_dir = File.join(dir, name)
+        if File.directory? obj_dir
+          Dir.foreach(obj_dir) do |file|
+            if file.end_with? '.toml'
+              object = read_toml(File.join(
+                                   obj_dir, file
+                                 ))
+              object[:name] =
+                File.basename(file, '.toml')
+              objects[name].push object
+            end
+          end
+        end
+        objects[name] = objects[name].sort do |a, b|
+          (a['order'] || a[:name]).to_s <=> (b['order'] || b[:name]).to_s
+        end
+      end
+      @variables['objects'] = objects
+    end
+
+    def read_toml(file_path)
+      Tomlrb.load_file(file_path)
+    end
+
+    def set_var(name, value)
+      @variables[name] = value
+    end
+
+    def render(page)
+      template = @page_templates[page]
+      template.render(@variables)
+    end
+
+    def write_all
+      Dir.mkdir(@config.build_dir) unless File.exist? @config.build_dir
+      @page_templates.each_key do |template|
+        out_dir = File.join(@config.build_dir,
+                            File.dirname(template))
+        Dir.mkdir(out_dir) unless File.exist? out_dir
+        out_path = File.join(@config.build_dir,
+                             "#{template}.html")
+        File.open(out_path, 'w+') do |file|
+          file.write(render(template))
+        end
+      end
+    end
+  end
+end

data/lib/archival/config.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module Archival
+  class Config
+    attr_reader :pages_dir, :objects_dir, :root, :build_dir
+
+    def initialize(config)
+      @pages_dir = config['pages'] || 'pages'
+      @objects_dir = config['objects'] || 'objects'
+      @root = config['root'] || Dir.pwd
+      @build_dir = config['build_dir'] || File.join(
+        @root, 'dist'
+      )
+    end
+  end
+end

data/lib/archival/listen.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+require 'listen'
+require 'pathname'
+
+module Archival
+  def self.child?(parent, child)
+    path = Pathname.new(child)
+    return true if path.fnmatch?(File.join(parent, '**'))
+
+    false
+  end
+
+  def self.process_change?(file, builder)
+    if child?(File.join(@config.root, @config.pages_dir), file)
+      # a page was modified, rebuild the pages.
+      builder.update_pages
+      return true
+    elsif child?(File.join(@config.root, @config.objects_dir), file)
+      # an object was modified, rebuild the objects.
+      builder.update_objects
+      return true
+    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)
+      end
+      builder.write_all if needs_update
+    end
+    listener.start
+    listener
+  end
+
+  module_function :listen
+end

data/lib/archival/rake_tasks.rb

@@ -0,0 +1,49 @@
+# frozen_string_literal: true
+
+require 'rake'
+require 'rake/tasklib'
+require 'archival'
+
+class RakeTasks
+  # Common tasks for archival.
+  #
+  # To include, just add
+  #
+  # require 'archival/rake_tasks'
+  #
+  # to your Rakefile.
+  include Rake::DSL if defined? Rake::DSL
+
+  class << self
+    # set when install'd.
+    attr_accessor :instance
+
+    def install_tasks
+      new.install
+    end
+  end
+
+  def install
+    build_dir = Dir.pwd
+
+    task 'build' do
+      builder = Archival::Builder.new('root' => build_dir)
+      builder.write_all
+    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
+    end
+
+    RakeTasks.instance = self
+  end
+end
+
+RakeTasks.install_tasks

data/lib/archival/version.rb

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

data/lib/archival.rb

@@ -1,3 +1,10 @@
+# frozen_string_literal: true
 
-class Archival
-end
+module Archival
+  # Main Archival module. See https://archival.dev for docs.
+end
+
+require 'archival/version'
+require 'archival/config'
+require 'archival/builder'
+require 'archival/listen'

data/lib/tags/layout.rb

@@ -0,0 +1,106 @@
+# frozen_string_literal: true
+
+require 'liquid'
+
+class Layout < Liquid::Tag
+  # Adds a `layout` tag to liquid. Usage:
+  #
+  # {% layout [layout-name], "key" => "value" %}
+  #
+  # This will wrap the entire current template in the specified layout, with
+  # the arguments provided as local variables.
+
+  prepend Liquid::Tag::Disableable
+  @@layout_cache = {}
+
+  SYNTAX = /(#{Liquid::QuotedFragment}+)/o.freeze
+
+  attr_reader :layout_name_expr, :attributes
+
+  def self.reset_cache
+    @@layout_cache = {}
+  end
+
+  def initialize(tag_name, markup, tokens)
+    super
+
+    @page_content = []
+    raise 'Invalid layout syntax' unless markup =~ SYNTAX
+
+    layout_name = Regexp.last_match(1)
+    @layout_name_expr = parse_expression(layout_name)
+    @attributes = {}
+
+    markup.scan(Liquid::TagAttributes) do |key, value|
+      @attributes[key] = parse_expression(value)
+    end
+  end
+
+  def layout_path
+    base_path = Dir.pwd
+    layout_dir = 'layout'
+    layout_path = File.join(base_path, layout_dir)
+    raise "Layout dir #{layout_path} not found" unless File.exist? layout_path
+
+    layout_path
+  end
+
+  def load_layout(layout_name)
+    return @@layout_cache[layout_name] if @@layout_cache[layout_name]
+
+    found_layout = nil
+    Dir.entries(layout_path).each do |f|
+      next unless File.file? File.join(
+        layout_path, f
+      )
+
+      next unless File.basename(f, '.*') == layout_name
+      raise "More than one layout named #{layout_name} found." if found_layout
+
+      found_layout = File.join(layout_path, f)
+    end
+    raise "No layouts named #{layout_name} found." if found_layout.nil?
+
+    layout = File.read(found_layout)
+    @@layout_cache[layout_name] =
+      Liquid::Template.parse(layout)
+    @@layout_cache[layout_name]
+  end
+
+  def parse(tokens)
+    t = tokens.shift
+    while t
+      @page_content.push t
+      t = tokens.shift
+    end
+  end
+
+  def render_to_output_buffer(context, output)
+    layout_name = context.evaluate(@layout_name_expr)
+    raise 'Bad layout name argument' unless layout_name
+
+    layout = load_layout(layout_name)
+
+    old_template_name = context.template_name
+    old_partial       = context.partial
+    begin
+      context.template_name = layout_name
+      context.partial       = true
+      context.stack do
+        @attributes.each do |key, value|
+          context[key] = context.evaluate(value)
+        end
+        rendered_page = Liquid::Template.parse(@page_content.join)
+                                        .render(context)
+        context['page_content'] = rendered_page
+        layout.render_to_output_buffer(context,
+                                       output)
+      end
+    ensure
+      context.template_name = old_template_name
+      context.partial       = old_partial
+    end
+
+    output
+  end
+end

data/package.json

@@ -0,0 +1,19 @@
+{
+  "name": "archival",
+  "version": "0.0.1",
+  "description": "An incredibly simple CMS for durable websites",
+  "bin": "build.rb",
+  "directories": {
+    "lib": "lib"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/jesseditson/archival.git"
+  },
+  "author": "Jesse Ditson <jesse.ditson@gmail.com>",
+  "license": "Unlicense",
+  "bugs": {
+    "url": "https://github.com/jesseditson/archival/issues"
+  },
+  "homepage": "https://github.com/jesseditson/archival#readme"
+}

metadata

@@ -1,23 +1,96 @@
 --- !ruby/object:Gem::Specification
 name: archival
 version: !ruby/object:Gem::Version
-  version: 0.0.0
+  version: 0.0.1
 platform: ruby
 authors:
 - Jesse Ditson
 autorequire:
-bindir: bin
+bindir: exe
 cert_chain: []
-date: 2021-10-29 00:00:00.000000000 Z
-dependencies: []
+date: 2021-11-05 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: liquid
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 5.1.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 5.1.0
+- !ruby/object:Gem::Dependency
+  name: listen
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 3.7.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 3.7.0
+- !ruby/object:Gem::Dependency
+  name: tomlrb
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.0.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.0.1
 description: https://jesseditson.com/the-simplest-cms-part-1
 email: jesse.ditson@gmail.com
-executables: []
+executables:
+- archival
 extensions: []
 extra_rdoc_files: []
 files:
+- ".bundle/config"
+- ".rspec"
+- ".rubocop.yml"
+- ".vscode/launch.json"
+- CHANGELOG.md
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- action.yml
+- archival.gemspec
+- bin/archival
+- bin/bundle
+- bin/htmldiff
+- bin/ldiff
+- bin/listen
+- bin/rake
+- bin/rspec
+- bin/rubocop
+- bin/ruby-parse
+- bin/ruby-rewrite
+- bin/setup
+- exe/archival
 - lib/archival.rb
-homepage: https://rubygems.org/gems/archival
+- lib/archival/builder.rb
+- lib/archival/config.rb
+- lib/archival/listen.rb
+- lib/archival/rake_tasks.rb
+- lib/archival/version.rb
+- lib/tags/layout.rb
+- package.json
+homepage: https://archival.dev
 licenses:
 - Unlicense
 metadata: {}
@@ -29,7 +102,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '0'
+      version: '2.5'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="