Class: LeanCms::Loader

Inherits:
Object
  • Object
show all
Defined in:
lib/lean_cms/loader.rb

Overview

Loads page content structure from a YAML file into LeanCms::PageContent records. Idempotent — re-running against an unchanged YAML is a no-op; changes to field metadata (label, position, etc.) get applied without clobbering editor-supplied values.

Usage from a background job, runner, or one-off script:

result = LeanCms::Loader.new.load!
result.created  # => 28
result.skipped  # => 0

Usage from a rake task (with progress on stdout):

LeanCms::Loader.new(logger: Logger.new($stdout)).load!

See ‘lib/tasks/lean_cms.rake` for the thin Rake wrappers.

Defined Under Namespace

Classes: NoUsersFound, Result, StructureFileMissing

Constant Summary collapse

DEFAULT_YAML_PATH = 
"config/lean_cms_structure.yml".freeze

Instance Method Summary collapse

Constructor Details

#initialize(yaml_path: nil, system_user: nil, logger: nil) ⇒ Loader

Returns a new instance of Loader.



28
29
30
31
32
 
# File 'lib/lean_cms/loader.rb', line 28

def initialize(yaml_path: nil, system_user: nil, logger: nil)
  @yaml_path   = yaml_path || Rails.root.join(DEFAULT_YAML_PATH)
  @system_user = system_user
  @logger      = logger || ActiveSupport::Logger.new(IO::NULL)
end

Instance Method Details

#load! ⇒ Object

Raises:



34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
 
# File 'lib/lean_cms/loader.rb', line 34

def load!
  raise StructureFileMissing, "Structure file not found at #{@yaml_path}" unless File.exist?(@yaml_path)

  structure = YAML.load_file(@yaml_path)
  pages     = structure["pages"] || {}
  return empty_result if pages.empty?

  user = resolve_system_user
  raise NoUsersFound, "No users in database. Create at least one before loading structure." unless user

  @system_user = user
  @logger.info "Loading LeanCMS page content structure..."
  @logger.info "Using system user: #{user.email_address}"
  @logger.info "=" * 60

  @total = @created = @updated = @skipped = 0

  pages.each do |page_key, page_data|
    load_page(page_key, page_data)
  end

  @logger.info ""
  @logger.info "=" * 60
  @logger.info "Summary:"
  @logger.info "  Total fields: #{@total}"
  @logger.info "  Created: #{@created}"
  @logger.info "  Updated: #{@updated}"
  @logger.info "  Skipped: #{@skipped}"
  @logger.info "=" * 60

  Result.new(total_fields: @total, created: @created, updated: @updated, skipped: @skipped)
end