bridgetown-core 0.14.1 → 0.15.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1c45c33f0989ba19297a2123d22d3d678c96e6a339beffc3ea3b70719ff12786
-  data.tar.gz: 36bccfc77d17a3294220f5e49789e30bf6c738c967ff03b6f9cea0801b2dce23
+  metadata.gz: 97ae06ce8eba440f7fbf028094f48c4779b08245c7e2edd2641deed2ccb271b0
+  data.tar.gz: b0680214291a6721bb43230bca4627608414fea6a6fc741b2431672dfd04a39d
 SHA512:
-  metadata.gz: b36d74cac58d2210185de187455f6ba3536feaccd34200b42dd08449c7c15745fb0ed468c2f551e31f3b7270ee286ea29396cfe0d4040a644d86b4750c3e3898
-  data.tar.gz: 7833b8a76ca6b2e36cd398e21a2b18d0f38163210f49e679552e637a4c90bbe68f7d76582966cbbcc036f5a901bb86a24910280f23f79a4b29092ae862a7a99f
+  metadata.gz: b742ce6a54a89c48beb0f12e27cb0bb8a67630ca0e749b30919ffc8a4be2054a9de38374bde59ba2f2f2db1a436a6704dc070f6eb418e85f650bb2f66d8c3dd0
+  data.tar.gz: 99a4bfe0ab8fb3dcf94e92423089048d9149722044b79ac698c95eda96872cfa84a25e5cc2e190d4f77f2215c80199aae01d9d7aa63669f6e21790c4279e50dc

data/Rakefile

@@ -1,9 +1,11 @@
+# frozen_string_literal: true
+
 require "bundler/gem_tasks"
 
 $LOAD_PATH.unshift File.expand_path("lib", __dir__)
 require "bridgetown-core/version"
 
-task :spec => :test
+task spec: :test
 require "rake/testtask"
 Rake::TestTask.new(:test) do |test|
   test.libs << "lib" << "test"

data/bin/bridgetown

@@ -6,31 +6,17 @@ STDOUT.sync = true
 $LOAD_PATH.unshift File.expand_path("../../bridgetown/lib", __dir__)
 
 require "bridgetown"
-require "mercenary"
 
 Bridgetown::PluginManager.require_from_bundler
 
-Bridgetown::Deprecator.process(ARGV)
+# Support NO_COLOR: https://no-color.org
+# TODO: need to change behavior of Colorator gem
+ENV["THOR_SHELL"] = "Basic" if ENV["NO_COLOR"]
 
-Mercenary.program(:bridgetown) do |p|
-  p.version "#{Bridgetown::VERSION.magenta} \"#{Bridgetown::CODE_NAME.yellow}\""
-  p.description "Bridgetown is a Webpack-aware, Ruby-powered static site generator for the modern Jamstack era"
-  p.syntax "bridgetown <subcommand> [options]"
+output_version = if ARGV[0] == "-v"
+                   puts "bridgetown #{Bridgetown::VERSION} \"#{Bridgetown::CODE_NAME}\""
+                   true
+                 end
 
-  Bridgetown::Command.subclasses.each { |c| c.init_with_program(p) }
-
-  p.action do |args, _|
-    if args.empty?
-      Bridgetown.logger.error "A subcommand is required."
-      puts p
-      abort
-    else
-      subcommand = args.first
-      unless p.has_command? subcommand
-        Bridgetown.logger.abort_with "fatal: 'bridgetown #{args.first}' could not" \
-          " be found. You may need to install the bridgetown-#{args.first} gem" \
-          " or a related gem to be able to use this subcommand."
-      end
-    end
-  end
-end
+require "bridgetown-core/commands/base"
+Bridgetown::Commands::Base.start unless output_version

data/bridgetown-core.gemspec

@@ -33,6 +33,7 @@ Gem::Specification.new do |s|
 
   s.add_runtime_dependency("activesupport",         "~> 6.0")
   s.add_runtime_dependency("addressable",           "~> 2.4")
+  s.add_runtime_dependency("awesome_print",         "~> 1.8")
   s.add_runtime_dependency("colorator",             "~> 1.0")
   s.add_runtime_dependency("faraday",               "~> 1.0")
   s.add_runtime_dependency("faraday_middleware",    "~> 1.0")
@@ -40,11 +41,12 @@ Gem::Specification.new do |s|
   s.add_runtime_dependency("kramdown",              "~> 2.1")
   s.add_runtime_dependency("kramdown-parser-gfm",   "~> 1.0")
   s.add_runtime_dependency("liquid",                "~> 4.0")
+  s.add_runtime_dependency("liquid-component",      ">= 0.1")
   s.add_runtime_dependency("liquid-render-tag",     "~> 0.2")
   s.add_runtime_dependency("listen",                "~> 3.0")
-  s.add_runtime_dependency("mercenary",             "~> 0.4.0")
   s.add_runtime_dependency("pathutil",              "~> 0.9")
   s.add_runtime_dependency("rouge",                 "~> 3.0")
   s.add_runtime_dependency("safe_yaml",             "~> 1.0")
   s.add_runtime_dependency("terminal-table",        "~> 1.8")
+  s.add_runtime_dependency("thor",                  "~> 1.0")
 end

data/lib/bridgetown-core.rb

@@ -30,15 +30,18 @@ require "json"
 
 # 3rd party
 require "active_support/core_ext/hash/indifferent_access"
+require "active_support/core_ext/string/inflections"
 require "pathutil"
 require "addressable/uri"
 require "safe_yaml/load"
 require "liquid"
 require "liquid-render-tag"
+require "liquid-component"
 require "kramdown"
 require "colorator"
 require "i18n"
 require "faraday"
+require "thor"
 
 SafeYAML::OPTIONS[:suppress_warnings] = true
 
@@ -89,16 +92,15 @@ module Bridgetown
   autoload :Watcher,             "bridgetown-core/watcher"
 
   # extensions
+  require "bridgetown-core/commands/registrations"
   require "bridgetown-core/plugin"
   require "bridgetown-core/converter"
   require "bridgetown-core/generator"
-  require "bridgetown-core/command"
   require "bridgetown-core/liquid_extensions"
   require "bridgetown-core/filters"
 
   require "bridgetown-core/drops/drop"
   require "bridgetown-core/drops/document_drop"
-  require_all "bridgetown-core/commands"
   require_all "bridgetown-core/converters"
   require_all "bridgetown-core/converters/markdown"
   require_all "bridgetown-core/drops"
@@ -137,6 +139,11 @@ module Bridgetown
       end
     end
 
+    # Conveinence method to register a new Thor command
+    def register_command(&block)
+      Bridgetown::Commands::Registrations.register(&block)
+    end
+
     # Public: Set the TZ environment variable to use the timezone specified
     #
     # timezone - the IANA Time Zone

data/lib/bridgetown-core/commands/apply.rb

@@ -0,0 +1,73 @@
+# frozen_string_literal: true
+
+module Bridgetown
+  module Commands
+    class Apply < Thor::Group
+      include Thor::Actions
+      include Actions
+      extend Summarizable
+
+      Registrations.register do
+        register(Apply, "apply", "apply", Apply.summary)
+      end
+
+      def self.banner
+        "bridgetown apply PATH or URL"
+      end
+      summary "Applies an automation to the current site"
+
+      def self.source_root
+        Dir.pwd
+      end
+
+      def self.exit_on_failure?
+        true
+      end
+
+      def apply_automation
+        @source_paths = [Dir.pwd]
+
+        if options[:apply]
+          apply_after_new_command
+        else
+          apply_in_pwd
+        end
+      rescue SystemExit => e
+        Bridgetown.logger.error "Problem occurred while running automation:"
+        e.backtrace[0..3].each do |backtrace_line|
+          Bridgetown.logger.info backtrace_line if backtrace_line.include?(":in `apply'")
+        end
+        raise e
+      end
+
+      protected
+
+      def apply_after_new_command
+        # Coming from the new command, so set up proper bundler env
+        Bundler.with_clean_env do
+          self.destination_root = New.created_site_dir
+          inside(New.created_site_dir) do
+            apply_from_url options[:apply]
+          end
+        end
+      end
+
+      def apply_in_pwd
+        # Running standalone
+        automation_command = args.empty? ? "bridgetown.automation.rb" : args[0]
+
+        if args.empty? && !File.exist?("bridgetown.automation.rb")
+          raise ArgumentError, "You must specify a path or a URL," \
+                               " or add bridgetown.automation.rb to the" \
+                               " current folder."
+        end
+
+        Bundler.with_clean_env do
+          apply_from_url automation_command
+        end
+      rescue ArgumentError => e
+        Bridgetown.logger.warn "Oops!", e.message
+      end
+    end
+  end
+end

data/lib/bridgetown-core/commands/base.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+require_all "bridgetown-core/commands/concerns"
+require_all "bridgetown-core/commands"
+
+module Bridgetown
+  module Commands
+    class Base < Thor
+      def self.exit_on_failure?
+        true
+      end
+
+      Registrations.registrations.each do |block|
+        instance_exec(&block)
+      end
+
+      class << self
+        # Override single character commands if necessary
+        def find_command_possibilities(subcommand)
+          if subcommand == "c"
+            ["console"]
+          else
+            super
+          end
+        end
+      end
+
+      desc "help <command>", "Show detailed command usage information and exit"
+      def help(subcommand = nil)
+        if subcommand && respond_to?(subcommand)
+          klass = Kernel.const_get("Bridgetown::Commands::#{subcommand.capitalize}")
+          klass.start(["-h"])
+        else
+          puts "Bridgetown v#{Bridgetown::VERSION.magenta} \"#{Bridgetown::CODE_NAME.yellow}\"" \
+               " is a Webpack-aware, Ruby-powered static site generator for the modern Jamstack era"
+          puts ""
+          puts "Usage:"
+          puts "  bridgetown <command> [options]"
+          puts ""
+          super
+        end
+      end
+    end
+  end
+end

data/lib/bridgetown-core/commands/build.rb

@@ -2,106 +2,111 @@
 
 module Bridgetown
   module Commands
-    class Build < Command
-      class << self
-        # Create the Mercenary command for the Bridgetown CLI for this Command
-        def init_with_program(prog)
-          prog.command(:build) do |c|
-            c.syntax      "build [options]"
-            c.description "Build your site"
-            c.alias :b
+    class Build < Thor::Group
+      extend BuildOptions
+      extend Summarizable
+      include ConfigurationOverridable
 
-            add_build_options(c)
+      Registrations.register do
+        register(Build, "build", "build", Build.summary)
+      end
 
-            c.action do |_, options|
-              options["serving"] = false
-              process_with_graceful_fail(c, options, self)
-            end
-          end
-        end
+      def self.banner
+        "bridgetown build [options]"
+      end
+      summary "Build your site and save to destination folder"
 
-        # Build your bridgetown site
-        # Continuously watch if `watch` is set to true in the config.
-        def process(options)
-          # Adjust verbosity quickly
-          Bridgetown.logger.adjust_verbosity(options)
+      class_option :watch,
+                   type: :boolean,
+                   aliases: "-w",
+                   desc: "Watch for changes and rebuild"
 
-          Bridgetown.logger.info "Starting:", "Bridgetown v#{Bridgetown::VERSION.magenta}" \
-                                      " (codename \"#{Bridgetown::CODE_NAME.yellow}\")"
+      # Build your bridgetown site
+      # Continuously watch if `watch` is set to true in the config.
+      def build
+        Bridgetown.logger.adjust_verbosity(options)
 
-          options = configuration_from_options(options)
-          @site = Bridgetown::Site.new(options)
+        Bridgetown.logger.info "Starting:", "Bridgetown v#{Bridgetown::VERSION.magenta}" \
+                               " (codename \"#{Bridgetown::CODE_NAME.yellow}\")"
 
-          if options.fetch("skip_initial_build", false)
-            Bridgetown.logger.warn "Build Warning:", "Skipping the initial build." \
-                               " This may result in an out-of-date site."
-          else
-            build(options)
-          end
+        config_options = Serve.loaded_config || configuration_with_overrides(options)
+        config_options["serving"] = false unless config_options["serving"]
+        @site = Bridgetown::Site.new(config_options)
 
-          if options.fetch("detach", false)
-            Bridgetown.logger.info "Auto-regeneration:",
-                                   "disabled when running server detached."
-          elsif options.fetch("watch", false)
-            watch(options)
-          else
-            Bridgetown.logger.info "Auto-regeneration:", "disabled. Use --watch to enable."
-          end
+        if config_options.fetch("skip_initial_build", false)
+          Bridgetown.logger.warn "Build Warning:", "Skipping the initial build." \
+                                 " This may result in an out-of-date site."
+        else
+          build_site(config_options)
         end
 
-        # Build your Bridgetown site.
-        #
-        # options - A Hash of options passed to the command or loaded from config
-        #
-        # Returns nothing.
-        def build(options)
-          t = Time.now
-          display_folder_paths(options)
-          if options["unpublished"]
-            Bridgetown.logger.info "Unpublished mode:",
-                                   "enabled. Processing documents marked unpublished"
-          end
-          incremental = options["incremental"]
-          Bridgetown.logger.info "Incremental build:",
-                                 (incremental ? "enabled" : "disabled. Enable with --incremental")
-          Bridgetown.logger.info "Generating…"
-          process_site(@site)
-          Bridgetown.logger.info "Done! 🎉", "#{"Completed".green} in less than" \
-                                 " #{(Time.now - t).ceil(2)} seconds."
+        if config_options.fetch("detach", false)
+          Bridgetown.logger.info "Auto-regeneration:",
+                                 "disabled when running server detached."
+        elsif config_options.fetch("watch", false)
+          watch_site(config_options)
+        else
+          Bridgetown.logger.info "Auto-regeneration:", "disabled. Use --watch to enable."
         end
+      end
 
-        # Private: Watch for file changes and rebuild the site.
-        #
-        # options - A Hash of options passed to the command or loaded from config
-        #
-        # Returns nothing.
-        def watch(options)
-          # Warn Windows users that they might need to upgrade.
-          if Utils::Platforms.bash_on_windows?
-            Bridgetown.logger.warn "",
-                                   "Auto-regeneration may not work on some Windows versions."
-            Bridgetown.logger.warn "",
-                                   "Please see: https://github.com/Microsoft/BashOnWindows/issues/216"
-            Bridgetown.logger.warn "",
-                                   "If it does not work, please upgrade Bash on Windows or "\
-                                   "run Bridgetown with --no-watch."
-          end
+      protected
 
-          Bridgetown::Watcher.watch(@site, options)
+      # Build your Bridgetown site.
+      #
+      # options - A Hash of options passed to the command or loaded from config
+      #
+      # Returns nothing.
+      def build_site(config_options)
+        t = Time.now
+        display_folder_paths(config_options)
+        if config_options["unpublished"]
+          Bridgetown.logger.info "Unpublished mode:",
+                                 "enabled. Processing documents marked unpublished"
         end
+        incremental = config_options["incremental"]
+        Bridgetown.logger.info "Incremental build:",
+                               (incremental ? "enabled" : "disabled. Enable with --incremental")
+        Bridgetown.logger.info "Generating…"
+        @site.process
+        Bridgetown.logger.info "Done! 🎉", "#{"Completed".green} in less than" \
+                                " #{(Time.now - t).ceil(2)} seconds."
+      end
+
+      # Watch for file changes and rebuild the site.
+      #
+      # options - A Hash of options passed to the command or loaded from config
+      #
+      # Returns nothing.
+      def watch_site(config_options)
+        # Warn Windows users that they might need to upgrade.
+        if Utils::Platforms.bash_on_windows?
+          Bridgetown.logger.warn "",
+                                 "Auto-regeneration may not work on some Windows versions."
+          Bridgetown.logger.warn "",
+                                 "Please see: https://github.com/Microsoft/BashOnWindows/issues/216"
+          Bridgetown.logger.warn "",
+                                 "If it does not work, please upgrade Bash on Windows or "\
+                                 "run Bridgetown with --no-watch."
+        end
+
+        Bridgetown::Watcher.watch(@site, config_options)
+      end
 
-        # Private: display the source and destination folder paths
-        #
-        # options - A Hash of options passed to the command
-        #
-        # Returns nothing.
-        def display_folder_paths(options)
-          source = File.expand_path(options["source"])
-          destination = File.expand_path(options["destination"])
-          plugins_dir = File.expand_path(options["plugins_dir"])
-          Bridgetown.logger.info "Environment:", Bridgetown.environment.cyan
-          Bridgetown.logger.info "Source:", source
-          Bridgetown.logger.info "Destination:", destination
+      # Display the source and destination folder paths
+      #
+      # options - A Hash of options passed to the command
+      #
+      # Returns nothing.
+      def display_folder_paths(config_options)
+        source = File.expand_path(config_options["source"])
+        destination = File.expand_path(config_options["destination"])
+        Bridgetown.logger.info "Environment:", Bridgetown.environment.cyan
+        Bridgetown.logger.info "Source:", source
+        Bridgetown.logger.info "Destination:", destination
+        # TODO: work with arrays
+        if config_options["plugins_dir"].is_a?(String)
+          plugins_dir = File.expand_path(config_options["plugins_dir"])
           Bridgetown.logger.info "Custom Plugins:", plugins_dir if Dir.exist?(plugins_dir)
         end
       end