Class: Ariadne::Yard::RegistryEntry

Inherits:
Object
  • Object
show all
Includes:
DocsHelper
Defined in:
lib/ariadne/yard/registry.rb

Overview

A wrapper around a YARD class reference that provides convenience methods for extracting component parameters, accessibility status, etc.

Instance Attribute Summary collapse

Instance Method Summary collapse

Methods included from DocsHelper

#link_to_accessibility, #link_to_component, #link_to_heading_practices, #link_to_octicons, #link_to_system_arguments_docs, #link_to_typography_docs, #one_of, #pretty_default_value, #pretty_value, #status_module_and_short_name

Constructor Details

#initialize(component, docs) ⇒ RegistryEntry

Returns a new instance of RegistryEntry.



18
19
20
21
# File 'lib/ariadne/yard/registry.rb', line 18

def initialize(component, docs)
  @component = component
  @docs = docs
end

Instance Attribute Details

#componentObject (readonly)

Returns the value of attribute component.



14
15
16
# File 'lib/ariadne/yard/registry.rb', line 14

def component
  @component
end

#docsObject (readonly)

Returns the value of attribute docs.



14
15
16
# File 'lib/ariadne/yard/registry.rb', line 14

def docs
  @docs
end

Instance Method Details

#a11y_reviewed?Boolean

Returns:

  • (Boolean)


89
90
91
# File 'lib/ariadne/yard/registry.rb', line 89

def a11y_reviewed?
  [:a11y_reviewed]
end

#component_idObject



73
74
75
# File 'lib/ariadne/yard/registry.rb', line 73

def component_id
  [:component_id]
end

#constructorObject



41
42
43
# File 'lib/ariadne/yard/registry.rb', line 41

def constructor
  docs.meths.find(&:constructor?)
end

#manifest_entryObject



93
94
95
# File 'lib/ariadne/yard/registry.rb', line 93

def manifest_entry
  @manifest_entry ||= ComponentManifest.ref_for(component)
end

#metadataObject



23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
# File 'lib/ariadne/yard/registry.rb', line 23

def 
  @metadata ||= begin
    status_module, short_name, class_name = status_module_and_short_name(component)
    status = component.status.to_s
    a11y_reviewed = component.audited_at.nil? ? "false" : "true"

    {
      title: class_name,
      class_name: class_name,
      component_id: short_name.underscore,
      status: status.capitalize,
      status_module: status_module,
      short_name: short_name,
      a11y_reviewed: a11y_reviewed,
    }
  end
end

#non_slot_methodsObject



53
54
55
# File 'lib/ariadne/yard/registry.rb', line 53

def non_slot_methods
  public_methods.reject { |mtd| slot_method?(mtd) }
end

#paramsObject



45
46
47
# File 'lib/ariadne/yard/registry.rb', line 45

def params
  constructor&.tags(:param) || []
end

#public_methodsObject



61
62
63
64
65
66
67
# File 'lib/ariadne/yard/registry.rb', line 61

def public_methods
  # Returns: only public methods that belong to this class (i.e. no inherited methods)
  # excluding the constructor
  @public_methods ||= docs.meths.reject do |mtd|
    mtd.tag(:private) || mtd.name == :initialize
  end
end

#short_nameObject



85
86
87
# File 'lib/ariadne/yard/registry.rb', line 85

def short_name
  [:short_name]
end

#slot_method?(mtd) ⇒ Boolean

Returns:

  • (Boolean)


57
58
59
# File 'lib/ariadne/yard/registry.rb', line 57

def slot_method?(mtd)
  mtd[:renders_one] || mtd[:renders_many]
end

#slot_methodsObject



49
50
51
# File 'lib/ariadne/yard/registry.rb', line 49

def slot_methods
  public_methods.select { |mtd| slot_method?(mtd) }
end

#statusObject



77
78
79
# File 'lib/ariadne/yard/registry.rb', line 77

def status
  [:status]
end

#status_moduleObject



81
82
83
# File 'lib/ariadne/yard/registry.rb', line 81

def status_module
  [:status_module]
end

#titleObject



69
70
71
# File 'lib/ariadne/yard/registry.rb', line 69

def title
  [:title]
end