asgard 0.2.0 → 0.3.1

data/lib/asgard/kernel_methods.rb

@@ -0,0 +1,79 @@
+# frozen_string_literal: true
+
+require "pathname"
+
+module Kernel
+  def debug?   = $DEBUG
+  def verbose? = $VERBOSE
+  module_function :debug?, :verbose?
+
+  # Fetch an environment variable by symbol or string name.
+  # The name is converted to an uppercase string automatically.
+  # Raises KeyError when the variable is missing and no default is given.
+  def env(name, default = nil)
+    key = name.to_s.upcase
+    default.nil? ? ENV.fetch(key) : ENV.fetch(key, default)
+  end
+  module_function :env
+
+  def loki_up(name = ".loki")
+    dir = Pathname.new(Dir.pwd)
+    loop do
+      candidate = dir + name
+      return candidate if candidate.exist?
+      parent = dir.parent
+      break if parent == dir
+      dir = parent
+    end
+    nil
+  end
+  module_function :loki_up
+
+  def import(path)
+    path = path.to_s
+    raise ArgumentError, "import: path must end with .loki (got #{path.inspect})" unless path.end_with?(".loki")
+    unless File.absolute_path?(path)
+      caller_dir = File.dirname(caller_locations(1, 1).first.absolute_path)
+      path = File.expand_path(path, caller_dir)
+    end
+    paths = path =~ /[*?\[{]/ ? Dir.glob(path) : [path]
+    loaded = paths.map do |p|
+      if $LOADED_FEATURES.include?(p)
+        warn "import: skip #{p} (already loaded)" if debug?
+        next false
+      end
+      warn "import: #{p}" if verbose? || debug?
+      load p
+      $LOADED_FEATURES << p
+      true
+    end
+    loaded.any?
+  end
+  module_function :import
+
+  def import_up(name = ".loki")
+    if name =~ /[*?\[{]/
+      dir = Dir.pwd
+      loop do
+        matches = Dir.glob(File.join(dir, name))
+        unless matches.empty?
+          warn "import_up: #{name} → #{dir}" if verbose? || debug?
+          return matches.map { |p| import(p) }.any?
+        end
+        parent = File.dirname(dir)
+        break if parent == dir
+        dir = parent
+      end
+      warn "import_up: #{name} not found" if debug?
+      return false
+    end
+    path = loki_up(name)
+    unless path
+      warn "import_up: #{name} not found" if debug?
+      return false
+    end
+    warn "import_up: #{name} → #{path}" if verbose? || debug?
+    import path
+  end
+  module_function :import_up
+end

data/lib/asgard/shell.rb

@@ -1,5 +1,6 @@
 # frozen_string_literal: true
 
+require 'English'
 require "tempfile"
 
 module Asgard
@@ -12,12 +13,12 @@ module Asgard
       $stdout.puts script unless silent
 
       success = if script.include?("\n")
-        system("bash", "-c", script)
-      else
-        system(script)
-      end
+                  system("bash", "-c", script)
+                else
+                  system(script)
+                end
 
-      exit($?.exitstatus) unless success
+      exit($CHILD_STATUS.exitstatus) unless success
     end
 
     # Write +script+ to a tempfile and execute it with +interpreter+.
@@ -34,11 +35,11 @@ module Asgard
 
       $stdout.puts script unless silent
 
-    Tempfile.create(["asgard_", ext]) do |f|
+      Tempfile.create(["asgard_", ext]) do |f|
         f.write(script)
         f.flush
         system(interpreter.to_s, f.path)
-        exit($?.exitstatus) unless $?.success?
+        exit($CHILD_STATUS.exitstatus) unless $CHILD_STATUS.success?
       end
     end
   end

data/lib/asgard/tasks.rb

@@ -4,6 +4,13 @@
 # It is pre-defined by the gem so .loki files never need to declare a class.
 # Auxiliary *.loki files define modules which are imported into Tasks.
 class Tasks < Asgard::Base
+  header "\nasgard v#{Asgard::VERSION} The Mighty Thor and Loki working for you"
+
+  footer <<~FOOT
+    \nDocumentation ... https://madbomber.github.io/asgard
+    Github Repo ..... https://github.com/MadBomber/asgard\n
+  FOOT
+
   class_option :debug,
                type:    :boolean,
                default: false,
@@ -14,21 +21,9 @@ class Tasks < Asgard::Base
                default: false,
                desc:    "Enable verbose output ($VERBOSE = true)"
 
-  desc "--auto-load", "Load all *.loki files from the project root before running"
-  map "--auto-load" => :_auto_load
-  def _auto_load
-    # Consumed by run! before Thor dispatch — never called directly.
-  end
-
-  desc "--version", "Show asgard version"
-  map "--version" => :_version
-  def _version
-    puts Asgard::VERSION
-    exit
-  end
-
-  private
-
-  def debug?   = $DEBUG
-  def verbose? = $VERBOSE
+  class_option :version,
+               type:    :boolean,
+               default: false,
+               desc:    "Show asgard version and exit"
+  no_negate :version
 end

data/lib/asgard/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Asgard
-  VERSION = "0.2.0"
+  VERSION = "0.3.1"
 end

data/lib/asgard.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require_relative "asgard/version"
+require_relative "asgard/kernel_methods"
 require_relative "asgard/shell"
 require_relative "asgard/base"
 require_relative "asgard/tasks"
@@ -12,31 +13,18 @@ module Asgard
   # Search the current directory and its ancestors for a .loki task file.
   # Returns the path string, or nil if not found.
   def self.find_task_file
-    dir = Dir.pwd
-    loop do
-      candidate = File.join(dir, ".loki")
-      return candidate if File.exist?(candidate)
-      parent = File.dirname(dir)
-      break if parent == dir
-      dir = parent
-    end
-    nil
-  end
-
-  # Load all *.loki files from dir in alphabetical order.
-  # Each file typically reopens class Tasks to add tasks.
-  # The .loki entry point is excluded — it is loaded separately by run!.
-  def self.load_loki(dir)
-    Dir.glob(File.join(dir, "*.loki")).sort.each { |f| load f }
+    loki_up
   end
 
   # Main entry point invoked by the asgard executable.
   def self.run!(argv)
-    auto_load = argv.delete("--auto-load")
     abort "asgard: unknown command '#{argv.first}'" if argv.first&.start_with?("_")
+    if argv.include?("--version")
+      puts Asgard::VERSION
+      exit
+    end
     task_file = find_task_file or abort "asgard: no .loki file found in #{Dir.pwd}"
     before = Asgard::Base.subclasses.dup
-    load_loki(File.dirname(task_file)) if auto_load
     load task_file
     newly_defined = Asgard::Base.subclasses - before
     (newly_defined + [Tasks]).uniq.each(&:validate_deps!)

data/quality.loki

@@ -0,0 +1,75 @@
+# frozen_string_literal: true
+# Quality gate tasks — imported by .loki
+
+class Tasks
+  desc "Run the test suite"
+  def test
+    output = `bundle exec ruby -Ilib:test test/test_asgard.rb 2>&1`
+    @test_result = $?.success? ? :pass : :fail
+    if @test_result == :fail
+      lines  = output.lines
+      start  = lines.index { |l| l =~ /^\s+1\) / } || 0
+      finish = lines.rindex { |l| l =~ /\d+ runs,/ } || -1
+      print lines[start..finish].join
+    end
+  end
+
+  desc "Run all quality gates (tests, RuboCop, Flog) in parallel"
+  depends_on [:test, :rubocop, :flog_check]
+  def quality
+    results = { tests: @test_result, rubocop: @rubocop_result, flog: @flog_result }
+
+    if @flog_failures&.any?
+      puts "\nFlog failures (must be refactored):"
+      @flog_failures.each { |v| puts "  #{v}" }
+    end
+
+    puts "\n#{"=" * 60}"
+    puts "Quality Summary"
+    puts "=" * 60
+    results.each { |gate, status| puts "  [#{status == :pass ? "PASS" : "FAIL"}] #{gate}" }
+    puts "=" * 60
+
+    abort "\nQuality gate failed" if results.values.any?(:fail)
+    puts "\nAll quality gates passed."
+  end
+
+  desc "Check code style with RuboCop"
+  def rubocop
+    output = `RUBOCOP_CACHE_ROOT=tmp/rubocop_cache bundle exec rubocop 2>&1`
+    @rubocop_result = $?.success? ? :pass : :fail
+    if @rubocop_result == :fail
+      output.each_line { |l| print l if l =~ /:\d+:\d+: [CWEF]: / }
+    end
+  end
+
+  desc "Auto-correct RuboCop offenses"
+  def rubocop_fix
+    sh "RUBOCOP_CACHE_ROOT=tmp/rubocop_cache bundle exec rubocop -a"
+  end
+
+  desc "Check code complexity with Flog (warn >=20, fail >=50)"
+  def flog_check
+    require "flog"
+
+    method_warn = 20.0
+    method_fail = 50.0
+
+    flogger = Flog.new(all: true)
+    flogger.flog(*Dir.glob("lib/**/*.rb"))
+
+    warnings  = []
+    @flog_failures = []
+
+    flogger.each_by_score do |method_name, score|
+      next if method_name.end_with?("#none")
+      if score > method_fail
+        @flog_failures << "#{"%.1f" % score}: #{method_name}"
+      elsif score > method_warn
+        warnings << "#{"%.1f" % score}: #{method_name}"
+      end
+    end
+
+    @flog_result = @flog_failures.empty? ? :pass : :fail
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: asgard
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.1
 platform: ruby
 authors:
 - Dewayne VanHoozer
@@ -51,9 +51,10 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '3.0'
-description: A powerful Ruby-based task runner for any kind of project with task dependency
-  tracking and concurrent execution of designated tasks. Uses Thor for its rich CLI
-  options, var declarations, dotenv, sh/shebang helpers, and importable task files.
+description: |
+  A powerful Ruby-based task runner for any kind of project with task dependency tracking
+  and concurrent execution of designated tasks. Uses Thor for its rich CLI options, var
+  declarations, dotenv, sh/shebang helpers, and importable task files.
 email:
 - dewayne@vanhoozer.me
 executables:
@@ -64,12 +65,12 @@ files:
 - ".envrc"
 - ".github/workflows/deploy-github-pages.yml"
 - ".loki"
+- ".rubocop.yml"
 - CHANGELOG.md
 - CLAUDE.md
 - COMMITS.md
 - LICENSE.txt
 - README.md
-- Rakefile
 - bin/asgard
 - bin/console
 - bin/setup
@@ -89,17 +90,25 @@ files:
 - docs/task-files.md
 - docs/tasks.md
 - docs/variables.md
+- examples/.env
 - examples/.loki
 - examples/concurrent.loki
 - examples/db_subcommands.loki
+- examples/env_usage.loki
 - examples/kitchen_sink.loki
 - examples/server_subcommands.loki
+- examples/subdir/.loki
+- examples/subdir/import_demo.loki
+- examples/subdir/import_up_demo.loki
+- gem_tasks.loki
 - lib/asgard.rb
 - lib/asgard/base.rb
+- lib/asgard/kernel_methods.rb
 - lib/asgard/shell.rb
 - lib/asgard/tasks.rb
 - lib/asgard/version.rb
 - mkdocs.yml
+- quality.loki
 - sig/asgard.rbs
 homepage: https://github.com/madbomber/asgard
 licenses:
@@ -108,6 +117,7 @@ metadata:
   homepage_uri: https://github.com/madbomber/asgard
   source_code_uri: https://github.com/madbomber/asgard
   changelog_uri: https://github.com/madbomber/asgard/blob/master/CHANGELOG.md
+  rubygems_mfa_required: 'true'
 rdoc_options: []
 require_paths:
 - lib

data/Rakefile

@@ -1,22 +0,0 @@
-# frozen_string_literal: true
-
-require "bundler/gem_tasks"
-require "minitest/test_task"
-
-SIMPLECOV_PRELUDE = <<~RUBY.freeze
-  require "simplecov"
-  SimpleCov.start do
-    add_filter "/test/"
-    minimum_coverage 95
-  end
-RUBY
-
-Minitest::TestTask.create do |t|
-  t.test_prelude = SIMPLECOV_PRELUDE
-end
-
-task quality: :test do
-  sh "flog lib/"
-end
-
-task default: :test