Module: Kiba::Extend::Fcar

Extended by:
Dry::Configurable
Defined in:
lib/kiba/extend/fcar.rb

Overview

Optional settings for creating sequenced FCAR processes in a project.

This code’s original use was in an abstract project, where it was used to determine whether a client project was using a given facilitated cleanup and remapping (FCAR) process or not, and thus automagically determine the correct source job for a given FCAR process in a given client project

Since:

  • 7.0.0

Class Method Summary collapse

Class Method Details

.base_source ⇒ Symbol

Returns job key of job whose output should be used as input for initial FCAR process.

Returns:

  • (Symbol) —

    job key of job whose output should be used as input for initial FCAR process

Since:

  • 7.0.0



25
 
# File 'lib/kiba/extend/fcar.rb', line 25

setting :base_source, reader: true, default: :your__jobkey

.chute ⇒ Array<String>, Hash{String => String}

Sample CHUTE for a reusable codebase on which multiple client projects can be based:

  • ObjectCounts

    The order of the overall CHUTE is NOT the order you must complete all the FCAR processes. For instance, your migration process may have you starting with the 2, not Itemandboxcount. Without an Itemandboxcount process set up, the source for AgencyMuseumNameCleanup will be the base_source. If/when you set up an Itemandboxcount process, its source will be base_source and AgencyMuseumNameCleanup’s source will become the output of the merge job for Itemandboxcount.

Within a group, you can leave out steps if they aren’t needed. For instance, if no site values are multi-value, you can skip SiteSplit. If multiple processs from a group are needed, they must be done in order.

Any hard-dependencies on order between processes and/or groups should be specified in the comments.

Returns:

  • (Array<String>, Hash{String => String}) —

    All FCAR processes defined for your project, in the order they are run. Use the Hash form if you wish to provide comments on the processes.

Since:

  • 7.0.0



52
53
54
55
56
57
58
59
60
 
# File 'lib/kiba/extend/fcar.rb', line 52

setting :chute,
reader: true,
default: [],
constructor: ->(default) do
  return {} if default.empty?
  return default if default.is_a?(Hash)

  default.map { |e| [e, ""] }.to_h
end

.final_merged ⇒ Object

Since:

  • 7.0.0



78
 
# File 'lib/kiba/extend/fcar.rb', line 78

def final_merged = processes[-1]&.merge_job || base_source

.pending_processes ⇒ Array<Module>

Returns FCAR processes intended for use in your project, for which there are not yet any files.

Returns:

  • (Array<Module>) —

    FCAR processes intended for use in your project, for which there are not yet any files

Since:

  • 7.0.0



21
 
# File 'lib/kiba/extend/fcar.rb', line 21

setting :pending_processes, reader: true, default: []

.previous_merged(mod) ⇒ Object

Since:

  • 7.0.0



70
71
72
73
74
75
76
 
# File 'lib/kiba/extend/fcar.rb', line 70

def previous_merged(mod)
  idx = processes.find_index(mod)
  fail(Kiba::Extend::UnknownFcarConfigError.new(mod)) unless idx
  return base_source if idx == 0

  processes[idx - 1].merge_job
end

.processes ⇒ Array<Module>

Returns FCAR processes used in client project.

Returns:

  • (Array<Module>) —

    FCAR processes used in client project

Since:

  • 7.0.0



63
64
65
66
67
68
 
# File 'lib/kiba/extend/fcar.rb', line 63

def processes
  chute.keys
    .map { |name| project_process(name) }
    .compact
    .select { |mod| active?(mod) && valid?(mod) }
end