isola 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: d66e9eb2d33f8ab15d77fc1d71ed2c962d977b004c3eb340cd09c932a513a65e
+  data.tar.gz: b6d134d39802939a0728b9ab59300968286da39f36b9eb13e79ebac380192efd
+SHA512:
+  metadata.gz: ebeba2d27bb183e2a1ebe19b1dc899d3686bfb918d5d9cbebb6fa5cd1354c81ba85dfa950051fe192cfec00c7c132712b765b566385312dad15be79cf7f333cb
+  data.tar.gz: 568589f57d81020434011aa145c01c33452bb04b4f8fee604b0b9e5a89447ba4dc3172168746afb5827f77e526961dbbf559e70db883d45a945e0c5a2f888b8a

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Satoshi Kojima
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+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 OR COPYRIGHT HOLDERS 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.

data/README.md

@@ -0,0 +1,28 @@
+# isola
+
+Super simple static site generator using erb.
+
+## Installation
+
+```bash
+bundle add isola
+```
+
+If bundler is not being used to manage dependencies, install the gem by executing:
+
+```bash
+gem install isola
+```
+
+## Usage
+
+1. place markdown files in your directory
+2. `isola build`
+
+## Development Policy
+
+This project does not use Agentic Coding at all. AI assistance in code reviews is not avoided.
+
+## License
+
+See [LICENSE](LICENSE)

data/Rakefile

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+require "minitest/test_task"
+
+Minitest::TestTask.create
+
+require "standard/rake"
+
+task default: %i[test standard]

data/exe/isola

@@ -0,0 +1,23 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require "isola"
+require "thor"
+
+class IsolaCLI < Thor
+  package_name "Isola"
+  desc "build site", "build site on current directory"
+  def build
+    config =
+      if File.exist? "_config.yaml"
+        File.read("_config.yaml")
+      else
+        ""
+      end
+    site = Isola::Site.new(config)
+    site.collect_files
+    site.process
+  end
+end
+
+IsolaCLI.start(ARGV)

data/lib/isola/context.rb

@@ -0,0 +1,36 @@
+require "tilt"
+
+module Isola
+  class Context
+    attr_reader :site, :content, :layout
+    def initialize(page, site)
+      @page_source = page
+      @page_meta = Data.define(*page.meta.keys).new(**page.meta)
+      @site = site
+      @content = ""
+      @layout = {}
+    end
+
+    def page
+      @page_meta
+    end
+
+    def include name, params = {}
+      i = @site.include name
+      raise "include #{name} not found in #{@current.filepath}" unless i
+      i.render(self, @site, params)[0]
+    end
+
+    def render
+      @current = @page_source
+      @content, path = @page_source.render(self, @site)
+      while @current.meta[:layout]
+        layout = site.layout(@current.meta[:layout])
+        raise "#{@current.meta[:layout]} not found for #{@current.filepath}" unless layout
+        @current = layout
+        @content, _ = @current.render(self, @site)
+      end
+      [@content, path]
+    end
+  end
+end

data/lib/isola/file_handler.rb

@@ -0,0 +1,70 @@
+module Isola
+  class FileHandler
+    attr_reader :pages, :layouts, :includes, :root_dir
+    DEFAULT_EXCLUDES = [
+      ".sass-cache", "gemfiles",
+      "Gemfile", "Gemfile.lock", "node_modules",
+      "vendor/bundle/", "vendor/cache/",
+      "vendor/gems/", "vendor/ruby/"
+    ]
+    def initialize(root_dir, excludes: [])
+      @excludes = DEFAULT_EXCLUDES.union(excludes)
+      @rejects = Regexp.union(%r{(?:^|/)[._]}, %r{~$})
+      @root_dir = File.absolute_path(root_dir)
+      @pages = {}
+      @layouts = {}
+      @includes = {}
+      collect(@root_dir)
+    end
+
+    private
+
+    def collect dir
+      Dir.each_child(dir) do |entry|
+        absolute_path = File.absolute_path(File.join(dir, entry))
+        path = absolute_path.delete_prefix("#{@root_dir}/")
+        path += "/" if File.directory? absolute_path
+        if process_path? path
+          if File.directory? absolute_path
+            collect(absolute_path)
+          elsif path.start_with?("_layouts/")
+            @layouts[remove_exts(path).delete_prefix("_layouts/")] = path
+          elsif path.start_with?("_includes/")
+            @includes[remove_exts(path).delete_prefix("_includes/")] = path
+          else
+            @pages[remove_exts(path)] = path
+          end
+        end
+      end
+    end
+
+    def process_path? path
+      p =
+        if /^(_includes|_layouts)\//.match?(path)
+          path.sub(/^(_includes|_layouts)\//, "")
+        else
+          path
+        end
+      !@rejects.match?(p) &&
+        !excluded?(path)
+    end
+
+    def excluded? relative_path
+      is_directory = File.directory?(File.join(@root_dir, relative_path))
+      @excludes.any? do |exclude|
+        case exclude
+        when String
+          File.fnmatch?(exclude, relative_path) ||
+            relative_path.start_with?(exclude) ||
+            (exclude == "#{relative_path}/" if is_directory)
+        when Regexp
+          exclude.match?(relative_path)
+        end
+      end
+    end
+
+    def remove_exts(filepath)
+      filepath.sub(%r{\.[^/]*\z}, "")
+    end
+  end
+end

data/lib/isola/site.rb

@@ -0,0 +1,79 @@
+require "yaml"
+require "fileutils"
+module Isola
+  class Site
+    attr_accessor :config
+    DEFAULT_CONFIG = {url: "http://example.com", title: "my awesome site", destination: "_site", default_language: "en"}.freeze
+    SUPPORTED_TILT_EXT = [".erb", ".md", ".markdown", ".mkd"]
+    EXT_MAP = {".md" => ".html", ".mkd" => ".html", ".markdown" => ".html", "" => ".html"}
+    def initialize(config)
+      @config = DEFAULT_CONFIG.merge(YAML.safe_load(config, symbolize_names: true) || {})
+      @config[:root_dir] ||= Dir.pwd
+      @config[:excludes] ||= []
+      @parsed_layouts = {}
+      @parsed_includes = {}
+    end
+
+    def title
+      @config[:title]
+    end
+
+    def url
+      @config[:url]
+    end
+
+    def lang
+      @config[:default_language]
+    end
+
+    def root_dir
+      @config[:root_dir]
+    end
+
+    def supported_ext? ext
+      SUPPORTED_TILT_EXT.include? ext
+    end
+
+    def result_ext_for ext
+      EXT_MAP[ext]
+    end
+
+    def collect_files
+      @file_handler = FileHandler.new(root_dir, excludes: @config[:excludes])
+    end
+
+    def process
+      @file_handler.pages.each do |name, path|
+        page = Source.new(path, read_in_site(path))
+        puts "processing #{path}..."
+        rendered, path = Context.new(page, self).render
+        dest_path = File.join(@file_handler.root_dir, @config[:destination], path)
+        FileUtils.mkdir_p(File.dirname(dest_path))
+        File.write(dest_path, rendered)
+      end
+    end
+
+    def layout name
+      find_source(name, @parsed_layouts, @file_handler.layouts)
+    end
+
+    def include name
+      find_source(name, @parsed_includes, @file_handler.includes)
+    end
+
+    private
+
+    def find_source(name, cache, store)
+      cache[name] ||=
+        begin
+          p = store[name]
+          return nil unless p
+          Source.new(p, read_in_site(p))
+        end
+    end
+
+    def read_in_site(p)
+      File.read(File.join(root_dir, p))
+    end
+  end
+end

data/lib/isola/source.rb

@@ -0,0 +1,32 @@
+require "yaml"
+
+module Isola
+  class Source
+    attr_reader :filepath, :meta, :content
+    def initialize filepath, text
+      @filepath = filepath
+      @meta, @content = if (m = text.match(/\A---\s*\n(.+?)^---\s*\n(.*)\z/m))
+        [YAML.safe_load(m[1], symbolize_names: true), m[2]]
+      else
+        [{}, text]
+      end
+    end
+
+    def render(context, site, params = {})
+      path = @filepath.dup
+      rendered = @content.dup
+      last_ext = ""
+      while !(ext = File.extname(path)).empty? && site.supported_ext?(ext)
+        rendered = Tilt.new(path) { rendered }.render(context, params)
+        path.delete_suffix! ext
+        last_ext = ext
+      end
+
+      if ext.empty?
+        [rendered, path + site.result_ext_for(last_ext)]
+      else
+        [rendered, path]
+      end
+    end
+  end
+end

data/lib/isola/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module Isola
+  VERSION = "0.1.0"
+end

data/lib/isola.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+require_relative "isola/version"
+require_relative "isola/site"
+require_relative "isola/file_handler"
+require_relative "isola/source"
+require_relative "isola/context"
+
+module Isola
+  class Error < StandardError; end
+end

data/sig/isola.rbs

@@ -0,0 +1,3 @@
+module Isola
+  VERSION: String
+end

metadata

@@ -0,0 +1,95 @@
+--- !ruby/object:Gem::Specification
+name: isola
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Satoshi Kojima
+bindir: exe
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: tilt
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '2.7'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '2.7'
+- !ruby/object:Gem::Dependency
+  name: kramdown
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.5'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.5'
+- !ruby/object:Gem::Dependency
+  name: thor
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.5'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.5'
+description: ''
+email:
+- skoji@skoji.jp
+executables:
+- isola
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- Rakefile
+- exe/isola
+- lib/isola.rb
+- lib/isola/context.rb
+- lib/isola/file_handler.rb
+- lib/isola/site.rb
+- lib/isola/source.rb
+- lib/isola/version.rb
+- sig/isola.rbs
+homepage: https://github.com/skoji/isola
+licenses: []
+metadata:
+  homepage_uri: https://github.com/skoji/isola
+  source_code_uri: https://github.com/skoji/isola
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 4.0.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.3
+specification_version: 4
+summary: very simple static site generator using ERB
+test_files: []