123456789_123456789_123456789_123456789_123456789_

Class: Prism::Result

Relationships & Source Files
Extension / Inclusion / Inheritance Descendants
Subclasses:
LexResult, ParseLexResult, ParseResult, LexCompat::Result
Inherits: Object
Defined in: lib/prism/parse_result.rb

Overview

This represents the result of a call to parse or parse_file. It contains the requested structure, any comments that were encounters, and any errors that were encountered.

Class Method Summary

Instance Attribute Summary

  • #comments readonly

    The list of comments that were encountered during parsing.

  • #data_loc readonly

    An optional location that represents the location of the __END__ marker and the rest of the content of the file.

  • #errors readonly

    The list of errors that were generated during parsing.

  • #failure? ⇒ Boolean readonly

    Returns true if there were errors during parsing and false if there were not.

  • #magic_comments readonly

    The list of magic comments that were encountered during parsing.

  • #source readonly

    A Source instance that represents the source code that was parsed.

  • #success? ⇒ Boolean readonly

    Returns true if there were no errors during parsing and false if there were.

  • #warnings readonly

    The list of warnings that were generated during parsing.

Instance Method Summary

Constructor Details

.new(comments, magic_comments, data_loc, errors, warnings, source) ⇒ Result

Create a new result object with the given values.

[ GitHub ] 

  


# File 'lib/prism/parse_result.rb', line 543



def initialize(comments, magic_comments, data_loc, errors, warnings, source)
  @comments = comments
  @magic_comments = magic_comments
  @data_loc = data_loc
  @errors = errors
  @warnings = warnings
  @source = source
end


  







Instance Attribute Details



  

    #comments   (readonly)
  



  

    

The list of comments that were encountered during parsing.


  



  [ GitHub ]


  

  


# File 'lib/prism/parse_result.rb', line 523



attr_reader :comments


  








  

    #data_loc   (readonly)
  



  

    

An optional location that represents the location of the __END__ marker and the rest of the content of the file. This content is loaded into the DATA constant when the file being parsed is the main file being executed.


  



  [ GitHub ]


  

  


# File 'lib/prism/parse_result.rb', line 531



attr_reader :data_loc


  








  

    #errors   (readonly)
  



  

    

The list of errors that were generated during parsing.


  



  [ GitHub ]


  

  


# File 'lib/prism/parse_result.rb', line 534



attr_reader :errors


  








  

    #failure?  ⇒ Boolean  (readonly)
  



  

    

Returns true if there were errors during parsing and false if there were not.


  





  


  [ GitHub ]


  

  


# File 'lib/prism/parse_result.rb', line 570



def failure?
  !success?
end


  








  

    #magic_comments   (readonly)
  



  

    

The list of magic comments that were encountered during parsing.


  



  [ GitHub ]


  

  


# File 'lib/prism/parse_result.rb', line 526



attr_reader :magic_comments


  








  

    #source   (readonly)
  



  

    

A Source instance that represents the source code that was parsed.


  



  [ GitHub ]


  

  


# File 'lib/prism/parse_result.rb', line 540



attr_reader :source


  








  

    #success?  ⇒ Boolean  (readonly)
  



  

    

Returns true if there were no errors during parsing and false if there were.


  





  


  [ GitHub ]


  

  


# File 'lib/prism/parse_result.rb', line 564



def success?
  errors.empty?
end


  








  

    #warnings   (readonly)
  



  

    

The list of warnings that were generated during parsing.


  



  [ GitHub ]


  

  


# File 'lib/prism/parse_result.rb', line 537



attr_reader :warnings


  







Instance Method Details



  

    #deconstruct_keys(keys)  
  



  

    

Implement the hash pattern matching interface for Result.


  



  [ GitHub ]


  

  


# File 'lib/prism/parse_result.rb', line 553



def deconstruct_keys(keys)
  { comments: comments, magic_comments: magic_comments, data_loc: data_loc, errors: errors, warnings: warnings }
end


  








  

    #encoding  
  



  

    

Returns the encoding of the source code that was parsed.


  



  [ GitHub ]


  

  


# File 'lib/prism/parse_result.rb', line 558



def encoding
  source.encoding
end