lifer 0.14.0 → 0.15.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b4416a9edb890d8d98adc06d1baf7e58b695d85da827b48005d7285b6f5a1dbe
-  data.tar.gz: 0c45a40304601d473c946315ddea56860041339e029467f8bcecb603ca70a58a
+  metadata.gz: 77ae4b570449457ff719f5376089d578acd28e3cdd9e488c01b4948e94c7cc37
+  data.tar.gz: f016806b8615fd54792ea974eedba56988a5ec45cfdb3874370f9dade6b4e0b7
 SHA512:
-  metadata.gz: b8aa3c53f350191b59ff5105ac1130c62c4a2f690aca83794877b933e7d7bfa23e501d2c91bd90dfc4954a4db9edf57b5db8ea4c4bf75fe78aa3e3e3e7e20e0c
-  data.tar.gz: f9b729936ec8ef025d9bc6dc8b6deab6d4d63c1d281da50e99df5932cd1f245c581c911378a703f1ddb7e6a5167f21fa746a780ac9e9ad72f29721d93bf34215
+  metadata.gz: 75781a84cac83ab375a2e899ec0d9dc9dc1299308638a2afa546eb534570b8529713145dd64516d336fce7e28f6447084b31a689e5334ee8bc891c83d99608d1
+  data.tar.gz: f010be935ca56e945895ca9eb4441b30f944cd56a32b278c1cef2d0b854822b9d4cfed18f3745b4e4f191e6fa1d90ec79f2b9cd9c48949daea403d554ac97d4a

data/CHANGELOG.md

@@ -1,4 +1,30 @@
 ## Next
+## v0.15.1
+
+In this release:
+
+- Entry IDs and permalinks are no longer equivalent. This helps us build out
+  entries (or something with the same interface as entries) that aren't
+  represented by a file on disk.
+- The `node_modules` directory is now ignored at build time.
+
+## v0.15.0
+
+The theme for this release is improved error messaging
+
+- If the project root is equal to the `Lifer.gem_root`, we now exit before
+  attempting to build. This is just a quality-of-life improvement for
+  developers, to ensure that the project and Lifer development environment
+  are isolated from each other.
+- When building HTML from Liquid templates, we now use the `:strict2`
+  error mode and the error-raising `#render!` method for Liquid documents
+  now. This results in build failing early rather than Liquid builds succeeding
+  with entry contents that include strings like "Liquid error: blah blah."
+- When any entry fails to build for some reason, we now rescue the error,
+  inject an error message and entry context into STDOUT, and then re-raise
+  the original error. This should improve the experience of debugging template
+  bugs in projects.
+
 ## v0.14.0
 
 This release includes some really nice improvements and bug fixes:

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    lifer (0.14.0)
+    lifer (0.15.1)
       base64
       i18n (< 2)
       kramdown (~> 2.4)

data/lib/lifer/builder/html/from_any.rb

@@ -11,6 +11,14 @@ class Lifer::Builder
         # @return [String] The rendered entry.
         def build(entry:)
           new(entry: entry).build
+        rescue => error
+          Lifer::Message.error "builder.catchall_failure", context: {
+            entry_path: entry.path,
+            collection: entry.collection,
+            layout_file: entry.collection&.layout_file,
+            error_message: error.message
+          }.to_json
+          raise(error)
         end
       end
 

data/lib/lifer/builder/html/from_liquid/liquid_env.rb

@@ -16,7 +16,7 @@ class Lifer::Builder::HTML::FromLiquid
     # @return [Lifer::Environment]
     def self.global
       Liquid::Environment.build do |environment|
-        environment.error_mode = :strict
+        environment.error_mode = :strict2
 
         environment.file_system =
           Liquid::LocalFileSystem.new(Lifer.root, "%s.html.liquid")

data/lib/lifer/builder/html/from_liquid.rb

@@ -40,7 +40,7 @@ class Lifer::Builder::HTML
       )
       document = Liquid::Template
         .parse(layout_file_contents, **parse_options)
-        .render(document_context, **render_options)
+        .render!(document_context, **render_options)
 
       return document unless (relative_layout_path = frontmatter[:layout])
 
@@ -83,7 +83,7 @@ class Lifer::Builder::HTML
     def parse_options
       {
         environment: liquid_environment,
-        error_mode: :strict
+        error_mode: :strict2
       }
     end
 

data/lib/lifer/builder/json_feed.rb

@@ -117,7 +117,7 @@ class Lifer::Builder
     #   by the end of this procedure.
     def json_feed_entry(feed_object, lifer_entry, lifer_collection)
       feed_item_object = {
-        id: lifer_entry.permalink,
+        id: lifer_entry.identifier,
         url: lifer_entry.permalink,
         external_url: lifer_entry.frontmatter[:external_url],
         title: lifer_entry.title,

data/lib/lifer/builder/rss.rb

@@ -216,7 +216,7 @@ class Lifer::Builder::RSS < Lifer::Builder
       if (authors = lifer_entry.authors).any?
         rss_feed_item.author = authors.join(", ")
       end
-      rss_feed_item.id = lifer_entry.permalink
+      rss_feed_item.id = lifer_entry.identifier
       rss_feed_item.link = lifer_entry.permalink
       rss_feed_item.title = lifer_entry.title
       rss_feed_item.summary = lifer_entry.summary

data/lib/lifer/cli.rb

@@ -66,6 +66,11 @@ module Lifer
       parser.parse! args
 
       brain = Lifer.brain(**{root: @root, config_file: @config_file}.compact)
+      if brain.root == Lifer.gem_root
+        Lifer::Message.error("cli.pwd_is_gem_root", root: brain.root)
+        return
+      end
+
       brain.require_user_provided_ruby_files!
 
       case subcommand

data/lib/lifer/entry.rb

@@ -205,6 +205,12 @@ module Lifer
       @full_text ||= File.readlines(file).join if file
     end
 
+    # A unique identifier for the current entry. For all entry types (so far)
+    # it makes sense to use the permalink.
+    #
+    # @return [String] The permalink (using the defafult global host argument).
+    def identifier = permalink
+
     # The file extension to be used when at the entry's build time. For
     # example, a Markdown file should be built to HTML.
     #

data/lib/lifer/version.rb

@@ -1,3 +1,3 @@
 module Lifer
-  VERSION = "0.14.0"
+  VERSION = "0.15.1"
 end

data/lib/lifer.rb

@@ -13,6 +13,7 @@ module Lifer
   IGNORE_DIRECTORIES = [
     "assets",
     "bin",
+    "node_modules",
     "vendor"
   ]
 

data/locales/en.yml

@@ -1,5 +1,6 @@
 en:
   builder:
+    catchall_failure: "Something failed during the build! Context:\n%{context}."
     file_conflict_error: "Cannot build HTML file because `%{path}` already exists."
     prebuild_failure: >
       Lifer failed to complete building... A prebuild step failed to execute: %{exception}
@@ -21,6 +22,7 @@ en:
       dump_default_config: Print the default configuration file to STDOUT and exit.
       port: Specify a custom port for the dev server.
       root: Specify the path to the Lifer project root.
+    pwd_is_gem_root: "Cannot build project at gem root: %{root}."
     subcommands:
       build: Build the Lifer project as configured in your Lifer configuration file.
       help: Display help text for the Lifer commandline interface.

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: lifer
 version: !ruby/object:Gem::Version
-  version: 0.14.0
+  version: 0.15.1
 platform: ruby
 authors:
 - benjamin wil
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-06-17 00:00:00.000000000 Z
+date: 2026-08-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: base64
@@ -229,8 +229,8 @@ licenses:
 - MIT
 metadata:
   allowed_push_host: https://rubygems.org
-  homepage_uri: https://github.com/benjaminwil/lifer/blob/v0.14.0/README.md
-  source_code_uri: https://github.com/benjaminwil/lifer/tree/v0.14.0
+  homepage_uri: https://github.com/benjaminwil/lifer/blob/v0.15.1/README.md
+  source_code_uri: https://github.com/benjaminwil/lifer/tree/v0.15.1
   changelog_uri: https://github.com/benjaminwil/lifer/blob/main/CHANGELOG.md
 post_install_message:
 rdoc_options: []