SWAMPy

✎ CARVE FLESH

EDITING: token_stream.rb

# frozen_string_literal: true
##
# A TokenStream is a list of tokens, gathered during the parse of some entity
# (say a method). Entities populate these streams by being registered with the
# lexer. Any class can collect tokens by including TokenStream. From the
# outside, you use such an object by calling the start_collecting_tokens
# method, followed by calls to add_token and pop_token.

module RDoc::TokenStream

##
  # Converts +token_stream+ to HTML wrapping various tokens with
  # <tt><span></tt> elements. Some tokens types are wrapped in spans
  # with the given class names. Other token types are not wrapped in spans.

def self.to_html token_stream
    starting_title = false

token_stream.map do |t|
      next unless t

style = case t[:kind]
              when :on_const   then 'ruby-constant'
              when :on_kw      then 'ruby-keyword'
              when :on_ivar    then 'ruby-ivar'
              when :on_cvar    then 'ruby-identifier'
              when :on_gvar    then 'ruby-identifier'
              when '=' != t[:text] && :on_op
                               then 'ruby-operator'
              when :on_tlambda then 'ruby-operator'
              when :on_ident   then 'ruby-identifier'
              when :on_label   then 'ruby-value'
              when :on_backref, :on_dstring
                               then 'ruby-node'
              when :on_comment then 'ruby-comment'
              when :on_embdoc  then 'ruby-comment'
              when :on_regexp  then 'ruby-regexp'
              when :on_tstring then 'ruby-string'
              when :on_int, :on_float,
                   :on_rational, :on_imaginary,
                   :on_heredoc,
                   :on_symbol, :on_CHAR then 'ruby-value'
              when :on_heredoc_beg, :on_heredoc_end
                               then 'ruby-identifier'
              end

comment_with_nl = false
      if :on_comment == t[:kind] or :on_embdoc == t[:kind] or :on_heredoc_end == t[:kind]
        comment_with_nl = true if "\n" == t[:text][-1]
        text = t[:text].rstrip
      else
        text = t[:text]
      end

if :on_ident == t[:kind] && starting_title
        starting_title = false
        style = 'ruby-identifier ruby-title'
      end

if :on_kw == t[:kind] and 'def' == t[:text]
        starting_title = true
      end

text = CGI.escapeHTML text

if style then
        "<span class=\"#{style}\">#{text}</span>#{"\n" if comment_with_nl}"
      else
        text
      end
    end.join
  end

##
  # Adds +tokens+ to the collected tokens

def add_tokens(tokens)
    @token_stream.concat(tokens)
  end

##
  # Adds one +token+ to the collected tokens

def add_token(token)
    @token_stream.push(token)
  end

##
  # Starts collecting tokens

def collect_tokens
    @token_stream = []
  end

alias start_collecting_tokens collect_tokens

##
  # Remove the last token from the collected tokens

def pop_token
    @token_stream.pop
  end

##
  # Current token stream

def token_stream
    @token_stream
  end

##
  # Returns a string representation of the token stream

def tokens_to_s
    token_stream.compact.map { |token| token[:text] }.join ''
  end

end

CANCEL

Name	Type	Size	Modified	Actions
↩ ..	DIR	—	—
📁 context/	DIR	—	2026-01-17 03:50
📁 generator/	DIR	—	2026-01-17 03:50
📁 i18n/	DIR	—	2026-01-17 03:50
📁 markdown/	DIR	—	2026-01-17 03:50
📁 markup/	DIR	—	2026-01-17 03:50
📁 parser/	DIR	—	2026-01-17 03:50
📁 rd/	DIR	—	2026-01-17 03:50
📁 ri/	DIR	—	2026-01-17 03:50
📁 stats/	DIR	—	2026-01-17 03:50
📄 alias.rb	RB	2.1 KB	2025-03-26 04:20	EDIT
📄 anon_class.rb	RB	172 B	2025-03-26 04:20	EDIT
📄 any_method.rb	RB	8.2 KB	2025-03-26 04:20	EDIT
📄 attr.rb	RB	3.8 KB	2025-03-26 04:20	EDIT
📄 class_module.rb	RB	19.8 KB	2025-03-26 04:20	EDIT
📄 code_object.rb	RB	9.3 KB	2025-03-26 04:20	EDIT
📄 code_objects.rb	RB	151 B	2025-03-26 04:20	EDIT
📄 comment.rb	RB	5.7 KB	2025-03-26 04:20	EDIT
📄 constant.rb	RB	3.6 KB	2025-03-26 04:20	EDIT
📄 context.rb	RB	30.3 KB	2025-03-26 04:20	EDIT
📄 cross_reference.rb	RB	6.6 KB	2025-03-26 04:20	EDIT
📄 encoding.rb	RB	3.7 KB	2025-03-26 04:20	EDIT
📄 erb_partial.rb	RB	401 B	2025-03-26 04:20	EDIT
📄 erbio.rb	RB	1 KB	2025-03-26 04:20	EDIT
📄 extend.rb	RB	170 B	2025-03-26 04:20	EDIT
📄 generator.rb	RB	1.8 KB	2025-03-26 04:20	EDIT
📄 ghost_method.rb	RB	144 B	2025-03-26 04:20	EDIT
📄 i18n.rb	RB	174 B	2025-03-26 04:20	EDIT
📄 include.rb	RB	172 B	2025-03-26 04:20	EDIT
📄 known_classes.rb	RB	2.6 KB	2025-03-26 04:20	EDIT
📄 markdown.rb	RB	386.3 KB	2025-03-26 04:20	EDIT
📄 markup.rb	RB	28.1 KB	2025-03-26 04:20	EDIT
📄 meta_method.rb	RB	129 B	2025-03-26 04:20	EDIT
📄 method_attr.rb	RB	9 KB	2025-03-26 04:20	EDIT
📄 mixin.rb	RB	2.8 KB	2025-03-26 04:20	EDIT
📄 normal_class.rb	RB	2.1 KB	2025-03-26 04:20	EDIT
📄 normal_module.rb	RB	1.4 KB	2025-03-26 04:20	EDIT
📄 options.rb	RB	33.3 KB	2025-03-26 04:20	EDIT
📄 parser.rb	RB	7.1 KB	2025-03-26 04:20	EDIT
📄 rd.rb	RB	3.6 KB	2025-03-26 04:20	EDIT
📄 rdoc.rb	RB	13.3 KB	2025-03-26 04:20	EDIT
📄 require.rb	RB	965 B	2025-03-26 04:20	EDIT
📄 ri.rb	RB	345 B	2025-03-26 04:20	EDIT
📄 rubygems_hook.rb	RB	5.2 KB	2025-03-26 04:20	EDIT
📄 servlet.rb	RB	12.2 KB	2025-03-26 04:20	EDIT
📄 single_class.rb	RB	408 B	2025-03-26 04:20	EDIT
📄 stats.rb	RB	10.5 KB	2025-03-26 04:20	EDIT
📄 store.rb	RB	22.7 KB	2025-03-26 04:20	EDIT
📄 task.rb	RB	7.7 KB	2025-03-26 04:20	EDIT
📄 text.rb	RB	7.6 KB	2025-03-26 04:20	EDIT
📄 token_stream.rb	RB	3.2 KB	2025-03-26 04:20	EDIT
📄 tom_doc.rb	RB	6.5 KB	2025-03-26 04:20	EDIT
📄 top_level.rb	RB	5.5 KB	2025-03-26 04:20	EDIT
📄 version.rb	RB	77 B	2025-03-26 04:20	EDIT