123456789_123456789_123456789_123456789_123456789_

Module: RDoc::TokenStream

Relationships & Source Files
Extension / Inclusion / Inheritance Descendants
Included In:
AnyMethod, GhostMethod, MetaMethod, Parser::Ruby
Defined in: lib/rdoc/token_stream.rb

Overview

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.

Class Method Summary

Instance Method Summary

Class Method Details

.to_html(token_stream)

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

[ GitHub ] 

  


# File 'lib/rdoc/token_stream.rb', line 16



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


  







Instance Method Details



  

    #add_token(token)  
  



  

    

Adds one token to the collected tokens


  



  [ GitHub ]


  

  


# File 'lib/rdoc/token_stream.rb', line 84



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


  








  

    #add_tokens(tokens)  
  



  

    

Adds tokens to the collected tokens


  



  [ GitHub ]


  

  


# File 'lib/rdoc/token_stream.rb', line 77



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


  








  

    #collect_tokens  
    Also known as: #start_collecting_tokens
  



  

    

Starts collecting tokens


  



  [ GitHub ]


  

  


# File 'lib/rdoc/token_stream.rb', line 91



def collect_tokens
  @token_stream = []
end


  








  

    #pop_token  
  



  

    

Remove the last token from the collected tokens


  



  [ GitHub ]


  

  


# File 'lib/rdoc/token_stream.rb', line 100



def pop_token
  @token_stream.pop
end


  








  

    #start_collecting_tokens  
  



  

    

Alias for #collect_tokens.


  



  [ GitHub ]


  

  


# File 'lib/rdoc/token_stream.rb', line 95



alias start_collecting_tokens collect_tokens


  








  

    #token_stream  
  



  

    

Current token stream


  



  [ GitHub ]


  

  


# File 'lib/rdoc/token_stream.rb', line 107



def token_stream
  @token_stream
end


  








  

    #tokens_to_s  
  



  

    

Returns a string representation of the token stream


  



  [ GitHub ]


  

  


# File 'lib/rdoc/token_stream.rb', line 114



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