Class: Jazzy::SourceDeclaration::Type
- Inherits:
-
Object
- Object
- Jazzy::SourceDeclaration::Type
- Defined in:
- lib/jazzy/source_declaration/type.rb
Overview
rubocop:disable Metrics/ClassLength
Constant Summary collapse
- MARKDOWN_KIND =
'document.markdown'.freeze
- TYPES =
{ # Markdown MARKDOWN_KIND => { jazzy: 'Guide', dash: 'Guide', }.freeze, 'Overview' => { jazzy: nil, dash: 'Section', }.freeze, # Objective-C 'sourcekitten.source.lang.objc.decl.unexposed' => { jazzy: 'Unexposed', dash: 'Unexposed', }.freeze, 'sourcekitten.source.lang.objc.decl.category' => { jazzy: 'Category', dash: 'Extension', }.freeze, 'sourcekitten.source.lang.objc.decl.class' => { jazzy: 'Class', dash: 'Class', }.freeze, 'sourcekitten.source.lang.objc.decl.constant' => { jazzy: 'Constant', dash: 'Constant', }.freeze, 'sourcekitten.source.lang.objc.decl.enum' => { jazzy: 'Enumeration', url: 'Enum', dash: 'Enum', }.freeze, 'sourcekitten.source.lang.objc.decl.enumcase' => { jazzy: 'Enumeration Case', dash: 'Case', }.freeze, 'sourcekitten.source.lang.objc.decl.initializer' => { jazzy: 'Initializer', dash: 'Initializer', }.freeze, 'sourcekitten.source.lang.objc.decl.method.class' => { jazzy: 'Class Method', dash: 'Method', }.freeze, 'sourcekitten.source.lang.objc.decl.method.instance' => { jazzy: 'Instance Method', dash: 'Method', }.freeze, 'sourcekitten.source.lang.objc.decl.property' => { jazzy: 'Property', dash: 'Property', }.freeze, 'sourcekitten.source.lang.objc.decl.protocol' => { jazzy: 'Protocol', dash: 'Protocol', }.freeze, 'sourcekitten.source.lang.objc.decl.typedef' => { jazzy: 'Type Definition', dash: 'Type', }.freeze, 'sourcekitten.source.lang.objc.mark' => { jazzy: 'Mark', dash: 'Mark', }.freeze, 'sourcekitten.source.lang.objc.decl.function' => { jazzy: 'Function', dash: 'Function', }.freeze, 'sourcekitten.source.lang.objc.decl.struct' => { jazzy: 'Structure', url: 'Struct', dash: 'Struct', }.freeze, 'sourcekitten.source.lang.objc.decl.field' => { jazzy: 'Field', dash: 'Field', }.freeze, 'sourcekitten.source.lang.objc.decl.ivar' => { jazzy: 'Instance Variable', dash: 'Ivar', }.freeze, 'sourcekitten.source.lang.objc.module.import' => { jazzy: 'Module', dash: 'Module', }.freeze, # Swift 'source.lang.swift.decl.function.accessor.address' => { jazzy: 'Addressor', dash: 'Function', }.freeze, 'source.lang.swift.decl.function.accessor.didset' => { jazzy: 'didSet Observer', dash: 'Function', }.freeze, 'source.lang.swift.decl.function.accessor.getter' => { jazzy: 'Getter', dash: 'Function', }.freeze, 'source.lang.swift.decl.function.accessor.mutableaddress' => { jazzy: 'Mutable Addressor', dash: 'Function', }.freeze, 'source.lang.swift.decl.function.accessor.setter' => { jazzy: 'Setter', dash: 'Function', }.freeze, 'source.lang.swift.decl.function.accessor.willset' => { jazzy: 'willSet Observer', dash: 'Function', }.freeze, 'source.lang.swift.decl.function.operator' => { jazzy: 'Operator', dash: 'Function', }.freeze, 'source.lang.swift.decl.function.operator.infix' => { jazzy: 'Infix Operator', dash: 'Function', }.freeze, 'source.lang.swift.decl.function.operator.postfix' => { jazzy: 'Postfix Operator', dash: 'Function', }.freeze, 'source.lang.swift.decl.function.operator.prefix' => { jazzy: 'Prefix Operator', dash: 'Function', }.freeze, 'source.lang.swift.decl.function.method.class' => { jazzy: 'Class Method', dash: 'Method', }.freeze, 'source.lang.swift.decl.var.class' => { jazzy: 'Class Variable', dash: 'Variable', }.freeze, 'source.lang.swift.decl.class' => { jazzy: 'Class', dash: 'Class', }.freeze, 'source.lang.swift.decl.function.constructor' => { jazzy: 'Initializer', dash: 'Constructor', }.freeze, 'source.lang.swift.decl.function.destructor' => { jazzy: 'Deinitializer', dash: 'Method', }.freeze, 'source.lang.swift.decl.var.global' => { jazzy: 'Global Variable', dash: 'Global', }.freeze, 'source.lang.swift.decl.enumcase' => { jazzy: 'Enumeration Case', dash: 'Case', }.freeze, 'source.lang.swift.decl.enumelement' => { jazzy: 'Enumeration Element', dash: 'Element', }.freeze, 'source.lang.swift.decl.enum' => { jazzy: 'Enumeration', url: 'Enum', dash: 'Enum', }.freeze, 'source.lang.swift.decl.extension' => { jazzy: 'Extension', dash: 'Extension', }.freeze, 'source.lang.swift.decl.extension.class' => { jazzy: 'Class Extension', dash: 'Extension', }.freeze, 'source.lang.swift.decl.extension.enum' => { jazzy: 'Enumeration Extension', dash: 'Extension', }.freeze, 'source.lang.swift.decl.extension.protocol' => { jazzy: 'Protocol Extension', dash: 'Extension', }.freeze, 'source.lang.swift.decl.extension.struct' => { jazzy: 'Structure Extension', dash: 'Extension', }.freeze, 'source.lang.swift.decl.function.free' => { jazzy: 'Function', dash: 'Function', }.freeze, 'source.lang.swift.decl.function.method.instance' => { jazzy: 'Instance Method', dash: 'Method', }.freeze, 'source.lang.swift.decl.var.instance' => { jazzy: 'Instance Variable', dash: 'Property', }.freeze, 'source.lang.swift.decl.var.local' => { jazzy: 'Local Variable', dash: 'Variable', }.freeze, 'source.lang.swift.decl.var.parameter' => { jazzy: 'Parameter', dash: 'Parameter', }.freeze, 'source.lang.swift.decl.protocol' => { jazzy: 'Protocol', dash: 'Protocol', }.freeze, 'source.lang.swift.decl.function.method.static' => { jazzy: 'Static Method', dash: 'Method', }.freeze, 'source.lang.swift.decl.var.static' => { jazzy: 'Static Variable', dash: 'Variable', }.freeze, 'source.lang.swift.decl.struct' => { jazzy: 'Structure', url: 'Struct', dash: 'Struct', }.freeze, 'source.lang.swift.decl.function.subscript' => { jazzy: 'Subscript', dash: 'Method', }.freeze, 'source.lang.swift.decl.typealias' => { jazzy: 'Type Alias', url: 'Typealias', dash: 'Alias', }.freeze, 'source.lang.swift.decl.generic_type_param' => { jazzy: 'Generic Type Parameter', dash: 'Parameter', }.freeze, 'source.lang.swift.decl.associatedtype' => { jazzy: 'Associated Type', dash: 'Alias', }.freeze, }.freeze
Instance Attribute Summary collapse
-
#kind ⇒ Object
readonly
Returns the value of attribute kind.
Class Method Summary collapse
Instance Method Summary collapse
- #==(other) ⇒ Object
- #dash_type ⇒ Object
- #declaration? ⇒ Boolean
- #equals ⇒ Object
- #extension? ⇒ Boolean
- #generic_type_param? ⇒ Boolean
- #hash ⇒ Object
-
#initialize(kind) ⇒ Type
constructor
A new instance of Type.
- #mark? ⇒ Boolean
- #markdown? ⇒ Boolean
- #name ⇒ Object
- #name_controlled_manually? ⇒ Boolean
- #objc_category? ⇒ Boolean
- #objc_class? ⇒ Boolean
- #objc_enum? ⇒ Boolean
- #objc_mark? ⇒ Boolean
- #objc_typedef? ⇒ Boolean
- #objc_unexposed? ⇒ Boolean
- #param? ⇒ Boolean
- #plural_name ⇒ Object
- #plural_url_name ⇒ Object
- #should_document? ⇒ Boolean
- #swift_enum_case? ⇒ Boolean
- #swift_enum_element? ⇒ Boolean
- #swift_extensible? ⇒ Boolean
- #swift_extension? ⇒ Boolean
-
#swift_mark? ⇒ Boolean
covers MARK: TODO: FIXME: comments.
- #swift_protocol? ⇒ Boolean
-
#task_mark?(name) ⇒ Boolean
mark that should start a new task section.
-
#url_name ⇒ Object
name to use for type subdirectory in URLs for back-compatibility.
Constructor Details
Instance Attribute Details
#kind ⇒ Object (readonly)
Returns the value of attribute kind.
11 12 13 |
# File 'lib/jazzy/source_declaration/type.rb', line 11 def kind @kind end |
Class Method Details
.all ⇒ Object
7 8 9 |
# File 'lib/jazzy/source_declaration/type.rb', line 7 def self.all TYPES.keys.map { |k| new(k) }.reject { |t| t.name.nil? } end |
.markdown ⇒ Object
134 135 136 |
# File 'lib/jazzy/source_declaration/type.rb', line 134 def self.markdown Type.new(MARKDOWN_KIND) end |
Instance Method Details
#==(other) ⇒ Object
147 148 149 |
# File 'lib/jazzy/source_declaration/type.rb', line 147 def ==(other) other && kind == other.kind end |
#dash_type ⇒ Object
18 19 20 |
# File 'lib/jazzy/source_declaration/type.rb', line 18 def dash_type @type && @type[:dash] end |
#declaration? ⇒ Boolean
92 93 94 95 |
# File 'lib/jazzy/source_declaration/type.rb', line 92 def declaration? kind.start_with?('source.lang.swift.decl', 'sourcekitten.source.lang.objc.decl') end |
#equals ⇒ Object
146 |
# File 'lib/jazzy/source_declaration/type.rb', line 146 alias equals == |
#extension? ⇒ Boolean
97 98 99 |
# File 'lib/jazzy/source_declaration/type.rb', line 97 def extension? swift_extension? || objc_category? end |
#generic_type_param? ⇒ Boolean
120 121 122 |
# File 'lib/jazzy/source_declaration/type.rb', line 120 def generic_type_param? kind == 'source.lang.swift.decl.generic_type_param' end |
#hash ⇒ Object
142 143 144 |
# File 'lib/jazzy/source_declaration/type.rb', line 142 def hash kind.hash end |
#mark? ⇒ Boolean
55 56 57 |
# File 'lib/jazzy/source_declaration/type.rb', line 55 def mark? objc_mark? || swift_mark? end |
#markdown? ⇒ Boolean
138 139 140 |
# File 'lib/jazzy/source_declaration/type.rb', line 138 def markdown? kind == MARKDOWN_KIND end |
#name ⇒ Object
22 23 24 |
# File 'lib/jazzy/source_declaration/type.rb', line 22 def name @type && @type[:jazzy] end |
#name_controlled_manually? ⇒ Boolean
31 32 33 34 35 36 |
# File 'lib/jazzy/source_declaration/type.rb', line 31 def name_controlled_manually? !kind.start_with?('source') # "'source'.lang..." for Swift # or "'source'kitten.source..." for Objective-C # but not "Overview" for navigation groups. end |
#objc_category? ⇒ Boolean
72 73 74 |
# File 'lib/jazzy/source_declaration/type.rb', line 72 def objc_category? kind == 'sourcekitten.source.lang.objc.decl.category' end |
#objc_class? ⇒ Boolean
76 77 78 |
# File 'lib/jazzy/source_declaration/type.rb', line 76 def objc_class? kind == 'sourcekitten.source.lang.objc.decl.class' end |
#objc_enum? ⇒ Boolean
64 65 66 |
# File 'lib/jazzy/source_declaration/type.rb', line 64 def objc_enum? kind == 'sourcekitten.source.lang.objc.decl.enum' end |
#objc_mark? ⇒ Boolean
46 47 48 |
# File 'lib/jazzy/source_declaration/type.rb', line 46 def objc_mark? kind == 'sourcekitten.source.lang.objc.mark' end |
#objc_typedef? ⇒ Boolean
68 69 70 |
# File 'lib/jazzy/source_declaration/type.rb', line 68 def objc_typedef? kind == 'sourcekitten.source.lang.objc.decl.typedef' end |
#objc_unexposed? ⇒ Boolean
124 125 126 |
# File 'lib/jazzy/source_declaration/type.rb', line 124 def objc_unexposed? kind == 'sourcekitten.source.lang.objc.decl.unexposed' end |
#param? ⇒ Boolean
113 114 115 116 117 118 |
# File 'lib/jazzy/source_declaration/type.rb', line 113 def param? # SourceKit strangely categorizes initializer parameters as local # variables, so both kinds represent a parameter in jazzy. kind == 'source.lang.swift.decl.var.parameter' || kind == 'source.lang.swift.decl.var.local' end |
#plural_name ⇒ Object
38 39 40 |
# File 'lib/jazzy/source_declaration/type.rb', line 38 def plural_name name.pluralize end |
#plural_url_name ⇒ Object
42 43 44 |
# File 'lib/jazzy/source_declaration/type.rb', line 42 def plural_url_name url_name.pluralize end |
#should_document? ⇒ Boolean
88 89 90 |
# File 'lib/jazzy/source_declaration/type.rb', line 88 def should_document? declaration? && !param? && !generic_type_param? end |
#swift_enum_case? ⇒ Boolean
80 81 82 |
# File 'lib/jazzy/source_declaration/type.rb', line 80 def swift_enum_case? kind == 'source.lang.swift.decl.enumcase' end |
#swift_enum_element? ⇒ Boolean
84 85 86 |
# File 'lib/jazzy/source_declaration/type.rb', line 84 def swift_enum_element? kind == 'source.lang.swift.decl.enumelement' end |
#swift_extensible? ⇒ Boolean
105 106 107 |
# File 'lib/jazzy/source_declaration/type.rb', line 105 def swift_extensible? kind =~ /^source\.lang\.swift\.decl\.(class|struct|protocol|enum)$/ end |
#swift_extension? ⇒ Boolean
101 102 103 |
# File 'lib/jazzy/source_declaration/type.rb', line 101 def swift_extension? kind =~ /^source\.lang\.swift\.decl\.extension.*/ end |
#swift_mark? ⇒ Boolean
covers MARK: TODO: FIXME: comments
51 52 53 |
# File 'lib/jazzy/source_declaration/type.rb', line 51 def swift_mark? kind == 'source.lang.swift.syntaxtype.comment.mark' end |
#swift_protocol? ⇒ Boolean
109 110 111 |
# File 'lib/jazzy/source_declaration/type.rb', line 109 def swift_protocol? kind == 'source.lang.swift.decl.protocol' end |
#task_mark?(name) ⇒ Boolean
mark that should start a new task section
60 61 62 |
# File 'lib/jazzy/source_declaration/type.rb', line 60 def task_mark?(name) objc_mark? || (swift_mark? && name.start_with?('MARK: ')) end |
#url_name ⇒ Object
name to use for type subdirectory in URLs for back-compatibility
27 28 29 |
# File 'lib/jazzy/source_declaration/type.rb', line 27 def url_name @type && (@type[:url] || @type[:jazzy]) end |