asciisourcerer 0.1.0 → 0.2.1

data/lib/sourcerer/util/pathifier.rb

@@ -0,0 +1,101 @@
+# frozen_string_literal: true
+
+require 'find'
+
+module Sourcerer
+  module Util
+    # Classify an input string as file/dir/glob/missing and yield matching paths lazily.
+    #
+    # Not required internally; callers must require this file explicitly.
+    module Pathifier
+      GLOB_METACHARACTERS = /[*?\[\]{}]/
+
+      # A small value object returned by +.match+.
+      Result = Struct.new(:type, :input, :enum, keyword_init: true)
+
+      # Classify +input+ and return a +Result+ with a lazy path enumerator.
+      #
+      # @param input           [String]  file path, directory path, or glob pattern
+      # @param recursive       [Boolean] if dir, traverse recursively (default: +true+)
+      # @param include_dirs    [Boolean] if dir traversal, also yield directory paths (default: +false+)
+      # @param follow_symlinks [Boolean] follow symlink directories during recursal (default: +false+)
+      # @return [Result]
+      def self.match input, recursive: true, include_dirs: false, follow_symlinks: false
+        type = classify(input)
+        Result.new(
+          type:  type,
+          input: input,
+          enum:  build_enum(
+            type, input, recursive: recursive, include_dirs: include_dirs,
+                                          follow_symlinks: follow_symlinks))
+      end
+
+      # Classify the input string without enumerating paths.
+      #
+      # @param input [String]
+      # @return [:file, :dir, :glob, :missing]
+      def self.classify input
+        if File.file?(input)
+          :file
+        elsif File.directory?(input)
+          :dir
+        elsif GLOB_METACHARACTERS.match?(input)
+          :glob
+        else
+          :missing
+        end
+      end
+      private_class_method :classify
+
+      def self.build_enum type, input, recursive:, include_dirs:, follow_symlinks:
+        case type
+        when :file
+          Enumerator.new do |y|
+            y << File.expand_path(input)
+          end
+        when :dir
+          build_dir_enum(
+            input, recursive: recursive, include_dirs: include_dirs,
+                                 follow_symlinks: follow_symlinks)
+        when :glob
+          Enumerator.new do |y|
+            Dir.glob(input) { |path| y << path }
+          end
+        else # :missing
+          Enumerator.new { |_y| nil }
+        end
+      end
+      private_class_method :build_enum
+
+      def self.build_dir_enum input, recursive:, include_dirs:, follow_symlinks:
+        abs = File.expand_path(input)
+        if recursive
+          Enumerator.new do |y|
+            Find.find(abs) do |path|
+              # Prune symlink directories unless follow_symlinks is set.
+              if File.symlink?(path) && File.directory?(path) && !follow_symlinks
+                Find.prune
+              elsif File.directory?(path)
+                y << path if include_dirs && path != abs
+              else
+                y << path
+              end
+            end
+          end
+        else
+          Enumerator.new do |y|
+            Dir.each_child(abs) do |name|
+              path = File.join(abs, name)
+              if File.directory?(path)
+                y << path if include_dirs
+              else
+                y << path
+              end
+            end
+          end
+        end
+      end
+      private_class_method :build_dir_enum
+    end
+  end
+end

data/lib/sourcerer/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Sourcerer
-  VERSION = '0.1.0'
+  VERSION = '0.2.1'
 end

data/lib/sourcerer.rb

@@ -17,8 +17,11 @@ require_relative 'sourcerer/yaml'
 # Requiring `sourcerer` also makes adjacent public constants (for example,
 # `Sourcerer::Builder`) available to downstream callers.
 module Sourcerer
+  autoload :AttributesFilter, 'sourcerer/attributes_filter'
   autoload :Jekyll, 'sourcerer/jekyll'
   autoload :MarkDownGrade, 'sourcerer/mark_down_grade'
+  autoload :SourceSkim, 'sourcerer/source_skim'
+  autoload :Sync, 'sourcerer/sync'
 
   DEPRECATED_FACADE_METHODS = {
     # DO NOT add new public methods to this surface

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: asciisourcerer
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.1
 platform: ruby
 authors:
 - DocOps Lab
-autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-02-28 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: asciidoctor
@@ -119,9 +118,11 @@ extra_rdoc_files: []
 files:
 - LICENSE
 - README.adoc
+- lib/asciidoctor/extensions/source-skim-tree-processor/extension.rb
 - lib/asciisourcerer.rb
 - lib/sourcerer.rb
 - lib/sourcerer/asciidoc.rb
+- lib/sourcerer/attributes_filter.rb
 - lib/sourcerer/builder.rb
 - lib/sourcerer/jekyll.rb
 - lib/sourcerer/jekyll/bootstrapper.rb
@@ -132,7 +133,15 @@ files:
 - lib/sourcerer/mark_down_grade.rb
 - lib/sourcerer/plaintext_converter.rb
 - lib/sourcerer/rendering.rb
+- lib/sourcerer/source_skim.rb
+- lib/sourcerer/source_skim/config.rb
+- lib/sourcerer/source_skim/skimmer.rb
+- lib/sourcerer/sync.rb
+- lib/sourcerer/sync/block_parser.rb
+- lib/sourcerer/sync/cast.rb
 - lib/sourcerer/templating.rb
+- lib/sourcerer/util/list_amend.rb
+- lib/sourcerer/util/pathifier.rb
 - lib/sourcerer/version.rb
 - lib/sourcerer/yaml.rb
 homepage: https://github.com/DocOps/asciisourcerer
@@ -141,7 +150,6 @@ licenses:
 metadata:
   allowed_push_host: https://rubygems.org
   rubygems_mfa_required: 'true'
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -156,8 +164,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.19
-signing_key:
+rubygems_version: 3.7.2
 specification_version: 4
 summary: APIs for specialized handling of AsciiDoc, YAML, and Liquid documents.
 test_files: []