Module: YARD::Templates::Helpers::BaseHelper
- Included in:
- CLI::Stats, Server::Commands::ListCommand, Template
- Defined in:
- lib/yard/templates/helpers/base_helper.rb
Overview
The base helper module included in all templates.
Instance Attribute Summary collapse
-
#object ⇒ Object
Returns the value of attribute object.
-
#serializer ⇒ Object
Returns the value of attribute serializer.
Managing Global Template State collapse
-
#globals ⇒ OpenStruct
An object that keeps track of global state throughout the entire template rendering process (including any sub-templates).
Running the Verifier collapse
-
#run_verifier(list) ⇒ Array<CodeObjects::Base>
Runs a list of objects against the Verifier object passed into the template and returns the subset of verified objects.
Escaping Text collapse
-
#h(text) ⇒ Object
Escapes text.
Linking Objects and URLs collapse
-
#link_file(filename, title = nil, anchor = nil) ⇒ String
Links to an extra file.
-
#link_include_file(file) ⇒ String
Include a file as a docstring in output.
-
#link_include_object(object) ⇒ String
Includes an object’s docstring into output.
-
#link_object(object, title = nil) ⇒ String
Links to an object with an optional title.
-
#link_url(url, title = nil, params = nil) ⇒ String
Links to a URL.
-
#linkify(*args) ⇒ Object
Links objects or URLs.
Formatting Object Attributes collapse
-
#format_object_title(object) ⇒ String
The page title name for a given object.
-
#format_object_type(object) ⇒ String
The human-readable formatted #type for the object.
-
#format_source(value) ⇒ String
Indents and formats source code.
-
#format_types(list, brackets = true) ⇒ String
Formats a list of return types for output and links each type.
Instance Attribute Details
#object ⇒ Object
Returns the value of attribute object.
4 5 6 |
# File 'lib/yard/templates/helpers/base_helper.rb', line 4 def object @object end |
#serializer ⇒ Object
Returns the value of attribute serializer.
4 5 6 |
# File 'lib/yard/templates/helpers/base_helper.rb', line 4 def serializer @serializer end |
Instance Method Details
#format_object_title(object) ⇒ String
Returns the page title name for a given object.
187 188 189 190 191 192 193 194 |
# File 'lib/yard/templates/helpers/base_helper.rb', line 187 def format_object_title(object) case object when YARD::CodeObjects::RootObject "Top Level Namespace" else format_object_type(object) + ": " + object.path end end |
#format_object_type(object) ⇒ String
Returns the human-readable formatted #type for the object.
173 174 175 176 177 178 179 180 |
# File 'lib/yard/templates/helpers/base_helper.rb', line 173 def format_object_type(object) case object when YARD::CodeObjects::ClassObject object.is_exception? ? "Exception" : "Class" else object.type.to_s.capitalize end end |
#format_source(value) ⇒ String
Indents and formats source code
200 201 202 203 204 |
# File 'lib/yard/templates/helpers/base_helper.rb', line 200 def format_source(value) sp = value.split("\n").last[/^(\s+)/, 1] num = sp ? sp.size : 0 value.gsub(/^\s{#{num}}/, '') end |
#format_types(list, brackets = true) ⇒ String
Formats a list of return types for output and links each type.
159 160 161 |
# File 'lib/yard/templates/helpers/base_helper.rb', line 159 def format_types(list, brackets = true) list.nil? || list.empty? ? "" : (brackets ? "(#{list.join(", ")})" : list.join(", ")) end |
#globals ⇒ OpenStruct
An object that keeps track of global state throughout the entire template rendering process (including any sub-templates).
13 |
# File 'lib/yard/templates/helpers/base_helper.rb', line 13 def globals; [:__globals] end |
#h(text) ⇒ Object
Escapes text. This is used a lot by the HtmlHelper and there should be some helper to “clean up” text for whatever, this is it.
31 32 33 |
# File 'lib/yard/templates/helpers/base_helper.rb', line 31 def h(text) text end |
#link_file(filename, title = nil, anchor = nil) ⇒ String
Links to an extra file
143 144 145 146 |
# File 'lib/yard/templates/helpers/base_helper.rb', line 143 def link_file(filename, title = nil, anchor = nil) return filename.filename if CodeObjects::ExtraFileObject === filename filename end |
#link_include_file(file) ⇒ String
Include a file as a docstring in output
104 105 106 |
# File 'lib/yard/templates/helpers/base_helper.rb', line 104 def link_include_file(file) File.read(file) end |
#link_include_object(object) ⇒ String
Includes an object’s docstring into output.
96 97 98 |
# File 'lib/yard/templates/helpers/base_helper.rb', line 96 def link_include_object(object) object.docstring end |
#link_object(object, title = nil) ⇒ String
Links to an object with an optional title
113 114 115 116 117 118 119 120 121 122 123 124 |
# File 'lib/yard/templates/helpers/base_helper.rb', line 113 def link_object(object, title = nil) return title if title case object when YARD::CodeObjects::Base, YARD::CodeObjects::Proxy object.path when String, Symbol P(object).path else object end end |
#link_url(url, title = nil, params = nil) ⇒ String
Links to a URL
132 133 134 |
# File 'lib/yard/templates/helpers/base_helper.rb', line 132 def link_url(url, title = nil, params = nil) url end |
#linkify(*args) ⇒ Object
Links objects or URLs. This method will delegate to the correct link_
method depending on the arguments passed in.
48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 |
# File 'lib/yard/templates/helpers/base_helper.rb', line 48 def linkify(*args) if args.first.is_a?(String) case args.first when %r{://}, /^mailto:/ link_url(args[0], args[1], {:target => '_parent'}.merge(args[2]||{})) when /^include:file:(\S+)/ file = $1 relpath = File.relative_path(Dir.pwd, File.(file)) if relpath =~ /^\.\./ log.warn "Cannot include file from path `#{file}'" "" elsif File.file?(file) link_include_file(file) else log.warn "Cannot find file at `#{file}' for inclusion" "" end when /^include:(\S+)/ path = $1 if obj = YARD::Registry.resolve(object.namespace, path) link_include_object(obj) else log.warn "Cannot find object at `#{path}' for inclusion" "" end when /^render:(\S+)/ path = $1 if obj = YARD::Registry.resolve(object, path) opts = .dup opts.delete(:serializer) obj.format(opts) else '' end when /^file:(\S+?)(?:#(\S+))?$/ link_file($1, args[1] ? args[1] : nil, $2) else link_object(*args) end else link_object(*args) end end |
#run_verifier(list) ⇒ Array<CodeObjects::Base>
Runs a list of objects against the Verifier object passed into the template and returns the subset of verified objects.
23 24 25 |
# File 'lib/yard/templates/helpers/base_helper.rb', line 23 def run_verifier(list) [:verifier] ? [:verifier].run(list) : list end |