github
/
ruby
зеркало из https://github.com/github/ruby.git
1
0
Форкнуть 0
Код Задачи Пакеты Проекты Релизы Вики Активность
ruby/prism/config.yml

Ignoring revisions in .git-blame-ignore-revs. Click here to bypass and see the normal blame view.

4059 строки
106 KiB
YAML
Исходник Обычный вид История

[ruby/prism] Expose types on diagnostics https://github.com/ruby/prism/commit/a735c2262f
2024-03-06 21:18:55 +03:00
errors:
- ALIAS_ARGUMENT
[ruby/prism] Fix up error message for invalid numbered reference alias https://github.com/ruby/prism/commit/74bff9e834
2024-04-01 21:36:38 +03:00
- ALIAS_ARGUMENT_NUMBERED_REFERENCE
[ruby/prism] Expose types on diagnostics https://github.com/ruby/prism/commit/a735c2262f
2024-03-06 21:18:55 +03:00
- AMPAMPEQ_MULTI_ASSIGN
- ARGUMENT_AFTER_BLOCK
- ARGUMENT_AFTER_FORWARDING_ELLIPSES
- ARGUMENT_BARE_HASH
- ARGUMENT_BLOCK_FORWARDING
- ARGUMENT_BLOCK_MULTI
[ruby/prism] More specific error for conflicting forwarding parameters https://github.com/ruby/prism/commit/1c3b48fedb
2024-05-06 18:01:50 +03:00
- ARGUMENT_CONFLICT_AMPERSAND
- ARGUMENT_CONFLICT_STAR
- ARGUMENT_CONFLICT_STAR_STAR
[ruby/prism] Expose types on diagnostics https://github.com/ruby/prism/commit/a735c2262f
2024-03-06 21:18:55 +03:00
- ARGUMENT_FORMAL_CLASS
- ARGUMENT_FORMAL_CONSTANT
- ARGUMENT_FORMAL_GLOBAL
- ARGUMENT_FORMAL_IVAR
- ARGUMENT_FORWARDING_UNBOUND
[ruby/prism] More specific error for conflicting forwarding parameters https://github.com/ruby/prism/commit/1c3b48fedb
2024-05-06 18:01:50 +03:00
- ARGUMENT_NO_FORWARDING_AMPERSAND
[ruby/prism] Expose types on diagnostics https://github.com/ruby/prism/commit/a735c2262f
2024-03-06 21:18:55 +03:00
- ARGUMENT_NO_FORWARDING_ELLIPSES
- ARGUMENT_NO_FORWARDING_STAR
[ruby/prism] Fix a diagnostic incompatibility This PR fixes a diagnostic incompatibility when using no anonymous keyword rest parameter: ```ruby foo(**) ``` Note, although the actual update applies only to the `foo(**)` case, for reference, `foo(*)` and `foo(&) are also mentioned below. ## Ruby (Expected) ```console $ ruby -cve 'foo(*)' ruby 3.3.0 (2023-12-25 revision https://github.com/ruby/prism/commit/5124f9ac75) [x86_64-darwin22] -e:1: no anonymous rest parameter -e: compile error (SyntaxError) $ ruby -cve 'foo(**)' ruby 3.3.0 (2023-12-25 revision https://github.com/ruby/prism/commit/5124f9ac75) [x86_64-darwin22] -e:1: no anonymous keyword rest parameter -e: compile error (SyntaxError) $ ruby -cve 'foo(&)' ruby 3.3.0 (2023-12-25 revision https://github.com/ruby/prism/commit/5124f9ac75) [x86_64-darwin22] -e:1: no anonymous block parameter -e: compile error (SyntaxError) ``` ## Prism (Actual) Before: ```console $ bundle exec ruby -Ilib -rprism -wve 'p Prism.parse("foo(*)").errors' ruby 3.3.0 (2023-12-25 revision https://github.com/ruby/prism/commit/5124f9ac75) [x86_64-darwin22] [#<Prism::ParseError @type=:argument_no_forwarding_star @message="unexpected `*` when the parent method is not forwarding" @location=#<Prism::Location @start_offset=4 @length=1 start_line=1> @level=:fatal>] $ bundle exec ruby -Ilib -rprism -wve 'p Prism.parse("foo(**)").errors' ruby 3.3.0 (2023-12-25 revision https://github.com/ruby/prism/commit/5124f9ac75) [x86_64-darwin22] [#<Prism::ParseError @type=:expect_expression_after_splat_hash @message="expected an expression after `**` in a hash" @location=#<Prism::Location @start_offset=4 @length=2 start_line=1> @level=:fatal>] $ bundle exec ruby -Ilib -rprism -wve 'p Prism.parse("foo(&)").errors' ruby 3.3.0 (2023-12-25 revision https://github.com/ruby/prism/commit/5124f9ac75) [x86_64-darwin22] [#<Prism::ParseError @type=:argument_no_forwarding_amp @message="unexpected `&` when the parent method is not forwarding" @location=#<Prism::Location @start_offset=4 @length=1 start_line=1> @level=:fatal>] ``` After: ```console $ bundle exec ruby -Ilib -rprism -wve 'p Prism.parse("foo(*)").errors' ruby 3.3.0 (2023-12-25 revision https://github.com/ruby/prism/commit/5124f9ac75) [x86_64-darwin22] [#<Prism::ParseError @type=:argument_no_forwarding_star @message="unexpected `*` when the parent method is not forwarding" @location=#<Prism::Location @start_offset=4 @length=1 start_line=1> @level=:fatal>] $ bundle exec ruby -Ilib -rprism -wve 'p Prism.parse("foo(**)").errors' ruby 3.3.0 (2023-12-25 revision https://github.com/ruby/prism/commit/5124f9ac75) [x86_64-darwin22] [#<Prism::ParseError @type=:argument_no_forwarding_star_star @message="unexpected `**` when the parent method is not forwarding" @location=#<Prism::Location @start_offset=4 @length=2 start_line=1> @level=:fatal>] $ bundle exec ruby -Ilib -rprism -wve 'p Prism.parse("foo(&)").errors' ruby 3.3.0 (2023-12-25 revision https://github.com/ruby/prism/commit/5124f9ac75) [x86_64-darwin22] [#<Prism::ParseError @type=:argument_no_forwarding_amp @message="unexpected `&` when the parent method is not forwarding" @location=#<Prism::Location @start_offset=4 @length=1 start_line=1> @level=:fatal>] ``` https://github.com/ruby/prism/commit/633c9d9fd4
2024-03-19 07:06:19 +03:00
- ARGUMENT_NO_FORWARDING_STAR_STAR
[ruby/prism] Expose types on diagnostics https://github.com/ruby/prism/commit/a735c2262f
2024-03-06 21:18:55 +03:00
- ARGUMENT_SPLAT_AFTER_ASSOC_SPLAT
- ARGUMENT_SPLAT_AFTER_SPLAT
- ARGUMENT_TERM_PAREN
- ARGUMENT_UNEXPECTED_BLOCK
- ARRAY_ELEMENT
- ARRAY_EXPRESSION
- ARRAY_EXPRESSION_AFTER_STAR
- ARRAY_SEPARATOR
- ARRAY_TERM
- BEGIN_LONELY_ELSE
- BEGIN_TERM
- BEGIN_UPCASE_BRACE
- BEGIN_UPCASE_TERM
- BEGIN_UPCASE_TOPLEVEL
- BLOCK_PARAM_LOCAL_VARIABLE
- BLOCK_PARAM_PIPE_TERM
- BLOCK_TERM_BRACE
- BLOCK_TERM_END
[ruby/prism] Add initial implementation of `Regexp` validation. https://github.com/ruby/prism/commit/6bf1b8edf0
2024-02-16 05:27:46 +03:00
- CANNOT_PARSE_EXPRESSION
[ruby/prism] Expose types on diagnostics https://github.com/ruby/prism/commit/a735c2262f
2024-03-06 21:18:55 +03:00
- CANNOT_PARSE_STRING_PART
- CASE_EXPRESSION_AFTER_CASE
- CASE_EXPRESSION_AFTER_WHEN
- CASE_MATCH_MISSING_PREDICATE
- CASE_MISSING_CONDITIONS
- CASE_TERM
- CLASS_IN_METHOD
- CLASS_NAME
- CLASS_SUPERCLASS
- CLASS_TERM
- CLASS_UNEXPECTED_END
[ruby/prism] Match error messages for invalid instance/class variables https://github.com/ruby/prism/commit/82fd0599ed
2024-04-01 21:59:41 +03:00
- CLASS_VARIABLE_BARE
[ruby/prism] Expose types on diagnostics https://github.com/ruby/prism/commit/a735c2262f
2024-03-06 21:18:55 +03:00
- CONDITIONAL_ELSIF_PREDICATE
- CONDITIONAL_IF_PREDICATE
- CONDITIONAL_PREDICATE_TERM
- CONDITIONAL_TERM
- CONDITIONAL_TERM_ELSE
- CONDITIONAL_UNLESS_PREDICATE
- CONDITIONAL_UNTIL_PREDICATE
- CONDITIONAL_WHILE_PREDICATE
- CONSTANT_PATH_COLON_COLON_CONSTANT
- DEF_ENDLESS
- DEF_ENDLESS_SETTER
- DEF_NAME
- DEF_PARAMS_TERM
- DEF_PARAMS_TERM_PAREN
- DEF_RECEIVER
- DEF_RECEIVER_TERM
- DEF_TERM
- DEFINED_EXPRESSION
- EMBDOC_TERM
- EMBEXPR_END
- EMBVAR_INVALID
- END_UPCASE_BRACE
- END_UPCASE_TERM
- ESCAPE_INVALID_CONTROL
- ESCAPE_INVALID_CONTROL_REPEAT
- ESCAPE_INVALID_HEXADECIMAL
- ESCAPE_INVALID_META
- ESCAPE_INVALID_META_REPEAT
- ESCAPE_INVALID_UNICODE
- ESCAPE_INVALID_UNICODE_CM_FLAGS
[ruby/prism] Pass Unicode escapes on to onigmo When we encounter an invalid unicode escape within a regular expression, we now pass that error on to Onigmo as if it didn't exist in the parser (which matches the upstream parser's behavior). We do this because there are tests that specify that you are allowed to have invalid Unicode escapes if they are within the context of a regular expression comment for a regular expression in extended mode. That looks like: /# \u /x Note that this _only_ applies to Unicode escapes (as opposed to applying to hex or meta/control escapes as well). Importantly it also only applies if the regular expression is terminated. An unterminated regular expression will still get error handling done in the parser. That would look like: /# \u that would result in the same error handling we have today. https://github.com/ruby/prism/commit/fb98034806
2024-08-23 22:03:39 +03:00
- ESCAPE_INVALID_UNICODE_LIST
[ruby/prism] Expose types on diagnostics https://github.com/ruby/prism/commit/a735c2262f
2024-03-06 21:18:55 +03:00
- ESCAPE_INVALID_UNICODE_LITERAL
- ESCAPE_INVALID_UNICODE_LONG
[ruby/prism] Special error for too short unicode errors https://github.com/ruby/prism/commit/9f1f7d08bd
2024-08-15 19:24:49 +03:00
- ESCAPE_INVALID_UNICODE_SHORT
[ruby/prism] Expose types on diagnostics https://github.com/ruby/prism/commit/a735c2262f
2024-03-06 21:18:55 +03:00
- ESCAPE_INVALID_UNICODE_TERM
- EXPECT_ARGUMENT
- EXPECT_EOL_AFTER_STATEMENT
- EXPECT_EXPRESSION_AFTER_AMPAMPEQ
- EXPECT_EXPRESSION_AFTER_COMMA
- EXPECT_EXPRESSION_AFTER_EQUAL
- EXPECT_EXPRESSION_AFTER_LESS_LESS
- EXPECT_EXPRESSION_AFTER_LPAREN
- EXPECT_EXPRESSION_AFTER_OPERATOR
[ruby/prism] Add initial implementation of `Regexp` validation. https://github.com/ruby/prism/commit/6bf1b8edf0
2024-02-16 05:27:46 +03:00
- EXPECT_EXPRESSION_AFTER_PIPEPIPEEQ
- EXPECT_EXPRESSION_AFTER_QUESTION
[ruby/prism] Expose types on diagnostics https://github.com/ruby/prism/commit/a735c2262f
2024-03-06 21:18:55 +03:00
- EXPECT_EXPRESSION_AFTER_SPLAT
- EXPECT_EXPRESSION_AFTER_SPLAT_HASH
- EXPECT_EXPRESSION_AFTER_STAR
Sync Prism with latest main branch
2024-09-30 17:51:01 +03:00
- EXPECT_FOR_DELIMITER
[ruby/prism] Expose types on diagnostics https://github.com/ruby/prism/commit/a735c2262f
2024-03-06 21:18:55 +03:00
- EXPECT_IDENT_REQ_PARAMETER
[ruby/prism] Disallow implicit hash in array pattern https://github.com/ruby/prism/commit/bdd509c6ac
2024-05-07 20:02:25 +03:00
- EXPECT_IN_DELIMITER
[ruby/prism] Expose types on diagnostics https://github.com/ruby/prism/commit/a735c2262f
2024-03-06 21:18:55 +03:00
- EXPECT_LPAREN_REQ_PARAMETER
[ruby/prism] Better error message on invalid def https://github.com/ruby/prism/commit/d398e7d22c
2024-04-12 20:43:30 +03:00
- EXPECT_MESSAGE
[ruby/prism] Expose types on diagnostics https://github.com/ruby/prism/commit/a735c2262f
2024-03-06 21:18:55 +03:00
- EXPECT_RBRACKET
- EXPECT_RPAREN
- EXPECT_RPAREN_AFTER_MULTI
- EXPECT_RPAREN_REQ_PARAMETER
[ruby/prism] Require a delimiter for singleton classes https://github.com/ruby/prism/commit/fd58d6a9ea
2024-09-30 17:15:21 +03:00
- EXPECT_SINGLETON_CLASS_DELIMITER
[ruby/prism] Expose types on diagnostics https://github.com/ruby/prism/commit/a735c2262f
2024-03-06 21:18:55 +03:00
- EXPECT_STRING_CONTENT
- EXPECT_WHEN_DELIMITER
- EXPRESSION_BARE_HASH
[ruby/prism] Better error recovery for unwritable nodes https://github.com/ruby/prism/commit/4828e73263
2024-04-13 03:16:07 +03:00
- EXPRESSION_NOT_WRITABLE
- EXPRESSION_NOT_WRITABLE_ENCODING
- EXPRESSION_NOT_WRITABLE_FALSE
- EXPRESSION_NOT_WRITABLE_FILE
- EXPRESSION_NOT_WRITABLE_LINE
- EXPRESSION_NOT_WRITABLE_NIL
[ruby/prism] Add error for numbered parameter used in inner block https://github.com/ruby/prism/commit/c386ba6d48
2024-05-21 16:55:31 +03:00
- EXPRESSION_NOT_WRITABLE_NUMBERED
[ruby/prism] Better error recovery for unwritable nodes https://github.com/ruby/prism/commit/4828e73263
2024-04-13 03:16:07 +03:00
- EXPRESSION_NOT_WRITABLE_SELF
- EXPRESSION_NOT_WRITABLE_TRUE
[ruby/prism] Expose types on diagnostics https://github.com/ruby/prism/commit/a735c2262f
2024-03-06 21:18:55 +03:00
- FLOAT_PARSE
- FOR_COLLECTION
- FOR_IN
- FOR_INDEX
- FOR_TERM
[ruby/prism] Fix up error messages for empty global variable https://github.com/ruby/prism/commit/fa7559d40b
2024-04-01 22:03:41 +03:00
- GLOBAL_VARIABLE_BARE
[ruby/prism] Expose types on diagnostics https://github.com/ruby/prism/commit/a735c2262f
2024-03-06 21:18:55 +03:00
- HASH_EXPRESSION_AFTER_LABEL
- HASH_KEY
- HASH_ROCKET
- HASH_TERM
- HASH_VALUE
[PRISM] Error message for unterminated heredoc identifier
2024-05-02 00:49:41 +03:00
- HEREDOC_IDENTIFIER
[ruby/prism] Expose types on diagnostics https://github.com/ruby/prism/commit/a735c2262f
2024-03-06 21:18:55 +03:00
- HEREDOC_TERM
- INCOMPLETE_QUESTION_MARK
- INCOMPLETE_VARIABLE_CLASS
[ruby/prism] Support passing version 3.3.1 https://github.com/ruby/prism/commit/445a0f0d22
2024-05-02 01:54:05 +03:00
- INCOMPLETE_VARIABLE_CLASS_3_3
[ruby/prism] Expose types on diagnostics https://github.com/ruby/prism/commit/a735c2262f
2024-03-06 21:18:55 +03:00
- INCOMPLETE_VARIABLE_INSTANCE
[ruby/prism] Support passing version 3.3.1 https://github.com/ruby/prism/commit/445a0f0d22
2024-05-02 01:54:05 +03:00
- INCOMPLETE_VARIABLE_INSTANCE_3_3
[ruby/prism] Match error messages for invalid instance/class variables https://github.com/ruby/prism/commit/82fd0599ed
2024-04-01 21:59:41 +03:00
- INSTANCE_VARIABLE_BARE
[ruby/prism] Log errors for invalid jumps https://github.com/ruby/prism/commit/892d0f9310
2024-04-02 18:02:59 +03:00
- INVALID_BLOCK_EXIT
[ruby/prism] Add initial implementation of `Regexp` validation. https://github.com/ruby/prism/commit/6bf1b8edf0
2024-02-16 05:27:46 +03:00
- INVALID_CHARACTER
[ruby/prism] Expose types on diagnostics https://github.com/ruby/prism/commit/a735c2262f
2024-03-06 21:18:55 +03:00
- INVALID_ENCODING_MAGIC_COMMENT
[ruby/prism] Invalid escape character syntax for nested unicode escapes https://github.com/ruby/prism/commit/623a0bb995
2024-05-08 19:27:47 +03:00
- INVALID_ESCAPE_CHARACTER
[ruby/prism] Expose types on diagnostics https://github.com/ruby/prism/commit/a735c2262f
2024-03-06 21:18:55 +03:00
- INVALID_FLOAT_EXPONENT
[ruby/prism] Do not allow omitted hash keys with ! or ? https://github.com/ruby/prism/commit/06d358aa8d
2024-04-19 21:15:14 +03:00
- INVALID_LOCAL_VARIABLE_READ
- INVALID_LOCAL_VARIABLE_WRITE
[ruby/prism] Add initial implementation of `Regexp` validation. https://github.com/ruby/prism/commit/6bf1b8edf0
2024-02-16 05:27:46 +03:00
- INVALID_MULTIBYTE_CHAR
- INVALID_MULTIBYTE_CHARACTER
- INVALID_MULTIBYTE_ESCAPE
[ruby/prism] Expose types on diagnostics https://github.com/ruby/prism/commit/a735c2262f
2024-03-06 21:18:55 +03:00
- INVALID_NUMBER_BINARY
- INVALID_NUMBER_DECIMAL
[ruby/prism] Unexpected fractional component error messages https://github.com/ruby/prism/commit/e893bc2230
2024-05-06 18:21:28 +03:00
- INVALID_NUMBER_FRACTION
[ruby/prism] Expose types on diagnostics https://github.com/ruby/prism/commit/a735c2262f
2024-03-06 21:18:55 +03:00
- INVALID_NUMBER_HEXADECIMAL
- INVALID_NUMBER_OCTAL
[ruby/prism] CRuby error message for trailing underscore in number https://github.com/ruby/prism/commit/4e34f236d3
2024-05-01 22:40:27 +03:00
- INVALID_NUMBER_UNDERSCORE_INNER
- INVALID_NUMBER_UNDERSCORE_TRAILING
[ruby/prism] Expose types on diagnostics https://github.com/ruby/prism/commit/a735c2262f
2024-03-06 21:18:55 +03:00
- INVALID_PERCENT
[ruby/prism] Update error message for invalid % at EOF https://github.com/ruby/prism/commit/178d4f66fd
2024-05-16 17:38:16 +03:00
- INVALID_PERCENT_EOF
[ruby/prism] Add initial implementation of `Regexp` validation. https://github.com/ruby/prism/commit/6bf1b8edf0
2024-02-16 05:27:46 +03:00
- INVALID_PRINTABLE_CHARACTER
[ruby/prism] Correct errors for invalid retry https://github.com/ruby/prism/commit/96ca6e51fc
2024-04-02 18:11:06 +03:00
- INVALID_RETRY_AFTER_ELSE
- INVALID_RETRY_AFTER_ENSURE
- INVALID_RETRY_WITHOUT_RESCUE
[ruby/prism] Mark errors for invalid symbols https://github.com/ruby/prism/commit/661884c4a3
2024-05-01 19:35:28 +03:00
- INVALID_SYMBOL
[ruby/prism] Update fixtures to be all valid Ruby https://github.com/ruby/prism/commit/a0b978d25b
2024-04-02 19:19:39 +03:00
- INVALID_VARIABLE_GLOBAL
[ruby/prism] Support passing version 3.3.1 https://github.com/ruby/prism/commit/445a0f0d22
2024-05-02 01:54:05 +03:00
- INVALID_VARIABLE_GLOBAL_3_3
[ruby/prism] Update fixtures to be all valid Ruby https://github.com/ruby/prism/commit/a0b978d25b
2024-04-02 19:19:39 +03:00
- INVALID_YIELD
[ruby/prism] Expose types on diagnostics https://github.com/ruby/prism/commit/a735c2262f
2024-03-06 21:18:55 +03:00
- IT_NOT_ALLOWED_NUMBERED
- IT_NOT_ALLOWED_ORDINARY
- LAMBDA_OPEN
- LAMBDA_TERM_BRACE
- LAMBDA_TERM_END
- LIST_I_LOWER_ELEMENT
- LIST_I_LOWER_TERM
- LIST_I_UPPER_ELEMENT
- LIST_I_UPPER_TERM
- LIST_W_LOWER_ELEMENT
- LIST_W_LOWER_TERM
- LIST_W_UPPER_ELEMENT
- LIST_W_UPPER_TERM
- MALLOC_FAILED
- MIXED_ENCODING
- MODULE_IN_METHOD
- MODULE_NAME
- MODULE_TERM
- MULTI_ASSIGN_MULTI_SPLATS
- MULTI_ASSIGN_UNEXPECTED_REST
[ruby/prism] Support a max depth to protect against malicious payloads https://github.com/ruby/prism/commit/a474017bbe
2024-09-24 19:52:39 +03:00
- NESTING_TOO_DEEP
[ruby/prism] Expose types on diagnostics https://github.com/ruby/prism/commit/a735c2262f
2024-03-06 21:18:55 +03:00
- NO_LOCAL_VARIABLE
[ruby/prism] Reject non-assoc ranges with subsequent operators https://github.com/ruby/prism/commit/976a3cd0a5
2024-09-26 17:28:35 +03:00
- NON_ASSOCIATIVE_OPERATOR
[ruby/prism] Add initial implementation of `Regexp` validation. https://github.com/ruby/prism/commit/6bf1b8edf0
2024-02-16 05:27:46 +03:00
- NOT_EXPRESSION
[ruby/prism] Expose types on diagnostics https://github.com/ruby/prism/commit/a735c2262f
2024-03-06 21:18:55 +03:00
- NUMBER_LITERAL_UNDERSCORE
[ruby/prism] Add error for numbered parameter used in inner block https://github.com/ruby/prism/commit/c386ba6d48
2024-05-21 16:55:31 +03:00
- NUMBERED_PARAMETER_INNER_BLOCK
[ruby/prism] Expose types on diagnostics https://github.com/ruby/prism/commit/a735c2262f
2024-03-06 21:18:55 +03:00
- NUMBERED_PARAMETER_IT
- NUMBERED_PARAMETER_ORDINARY
[ruby/prism] Add error for numbered parameter used in inner block https://github.com/ruby/prism/commit/c386ba6d48
2024-05-21 16:55:31 +03:00
- NUMBERED_PARAMETER_OUTER_BLOCK
[ruby/prism] Expose types on diagnostics https://github.com/ruby/prism/commit/a735c2262f
2024-03-06 21:18:55 +03:00
- OPERATOR_MULTI_ASSIGN
- OPERATOR_WRITE_ARGUMENTS
- OPERATOR_WRITE_BLOCK
- PARAMETER_ASSOC_SPLAT_MULTI
- PARAMETER_BLOCK_MULTI
- PARAMETER_CIRCULAR
[ruby/prism] Enhance parameter forwarding error messages https://github.com/ruby/prism/commit/826657232e
2024-05-10 18:39:51 +03:00
- PARAMETER_FORWARDING_AFTER_REST
[ruby/prism] Expose types on diagnostics https://github.com/ruby/prism/commit/a735c2262f
2024-03-06 21:18:55 +03:00
- PARAMETER_METHOD_NAME
[PRISM] Fix error message for duplicate parameter name
2024-03-30 01:25:39 +03:00
- PARAMETER_NAME_DUPLICATED
[ruby/prism] Expose types on diagnostics https://github.com/ruby/prism/commit/a735c2262f
2024-03-06 21:18:55 +03:00
- PARAMETER_NO_DEFAULT
- PARAMETER_NO_DEFAULT_KW
- PARAMETER_NUMBERED_RESERVED
- PARAMETER_ORDER
- PARAMETER_SPLAT_MULTI
- PARAMETER_STAR
- PARAMETER_UNEXPECTED_FWD
[ruby/prism] Disallow **nil after keyword parameters https://github.com/ruby/prism/commit/5beeae076f
2024-05-03 19:36:54 +03:00
- PARAMETER_UNEXPECTED_NO_KW
[ruby/prism] Report onigmo errors for depth https://github.com/ruby/prism/commit/e0e8bba8be
2024-06-05 17:50:18 +03:00
- PARAMETER_WILD_LOOSE_COMMA
[ruby/prism] Fix up find and array patterns with multiple rests https://github.com/ruby/prism/commit/035890a839
2024-07-01 17:59:51 +03:00
- PATTERN_ARRAY_MULTIPLE_RESTS
[ruby/prism] Track captures in pattern matching for duplicates https://github.com/ruby/prism/commit/aa2182f064
2024-04-01 20:08:21 +03:00
- PATTERN_CAPTURE_DUPLICATE
[ruby/prism] Expose types on diagnostics https://github.com/ruby/prism/commit/a735c2262f
2024-03-06 21:18:55 +03:00
- PATTERN_EXPRESSION_AFTER_BRACKET
- PATTERN_EXPRESSION_AFTER_COMMA
[ruby/prism] Add initial implementation of `Regexp` validation. https://github.com/ruby/prism/commit/6bf1b8edf0
2024-02-16 05:27:46 +03:00
- PATTERN_EXPRESSION_AFTER_HROCKET
[ruby/prism] Expose types on diagnostics https://github.com/ruby/prism/commit/a735c2262f
2024-03-06 21:18:55 +03:00
- PATTERN_EXPRESSION_AFTER_IN
- PATTERN_EXPRESSION_AFTER_KEY
- PATTERN_EXPRESSION_AFTER_PAREN
- PATTERN_EXPRESSION_AFTER_PIN
- PATTERN_EXPRESSION_AFTER_PIPE
- PATTERN_EXPRESSION_AFTER_RANGE
- PATTERN_EXPRESSION_AFTER_REST
[ruby/prism] Fix up find and array patterns with multiple rests https://github.com/ruby/prism/commit/035890a839
2024-07-01 17:59:51 +03:00
- PATTERN_FIND_MISSING_INNER
[ruby/prism] Disallow implicit hash in array pattern https://github.com/ruby/prism/commit/bdd509c6ac
2024-05-07 20:02:25 +03:00
- PATTERN_HASH_IMPLICIT
[ruby/prism] Expose types on diagnostics https://github.com/ruby/prism/commit/a735c2262f
2024-03-06 21:18:55 +03:00
- PATTERN_HASH_KEY
[ruby/prism] Track duplicate hash keys for pattern matching https://github.com/ruby/prism/commit/71ea82f299
2024-04-01 20:33:16 +03:00
- PATTERN_HASH_KEY_DUPLICATE
[ruby/prism] Specific error message for symbol literal with interpolation in hash patterns https://github.com/ruby/prism/commit/31f0201bae
2024-05-07 19:15:44 +03:00
- PATTERN_HASH_KEY_INTERPOLATED
[ruby/prism] Expose types on diagnostics https://github.com/ruby/prism/commit/a735c2262f
2024-03-06 21:18:55 +03:00
- PATTERN_HASH_KEY_LABEL
[ruby/prism] Do not allow omitted hash keys with ! or ? https://github.com/ruby/prism/commit/06d358aa8d
2024-04-19 21:15:14 +03:00
- PATTERN_HASH_KEY_LOCALS
[ruby/prism] Expose types on diagnostics https://github.com/ruby/prism/commit/a735c2262f
2024-03-06 21:18:55 +03:00
- PATTERN_IDENT_AFTER_HROCKET
- PATTERN_LABEL_AFTER_COMMA
- PATTERN_REST
- PATTERN_TERM_BRACE
- PATTERN_TERM_BRACKET
- PATTERN_TERM_PAREN
- PIPEPIPEEQ_MULTI_ASSIGN
[ruby/prism] Add initial implementation of `Regexp` validation. https://github.com/ruby/prism/commit/6bf1b8edf0
2024-02-16 05:27:46 +03:00
- REGEXP_ENCODING_OPTION_MISMATCH
- REGEXP_INCOMPAT_CHAR_ENCODING
- REGEXP_INVALID_UNICODE_RANGE
- REGEXP_NON_ESCAPED_MBC
[ruby/prism] Report onigmo errors for depth https://github.com/ruby/prism/commit/e0e8bba8be
2024-06-05 17:50:18 +03:00
- REGEXP_PARSE_ERROR
[ruby/prism] Expose types on diagnostics https://github.com/ruby/prism/commit/a735c2262f
2024-03-06 21:18:55 +03:00
- REGEXP_TERM
[ruby/prism] Fix incorrect paring when using invalid regexp options Fixes https://github.com/ruby/prism/pull/2617. There was an issue with the lexer as follows. The following are valid regexp options: ```console $ bundle exec ruby -Ilib -rprism -ve 'p Prism.lex("/x/io").value.map {|token| token[0].type }' ruby 3.3.0 (2023-12-25 revision https://github.com/ruby/prism/commit/5124f9ac75) [x86_64-darwin22] [:REGEXP_BEGIN, :STRING_CONTENT, :REGEXP_END, :EOF] ``` The following are invalid regexp options. Unnecessary the `IDENTIFIER` token is appearing: ```console $ bundle exec ruby -Ilib -rprism -ve 'p Prism.lex("/x/az").value.map {|token| token[0].type }' ruby 3.3.0 (2023-12-25 revision https://github.com/ruby/prism/commit/5124f9ac75) [x86_64-darwin22] [:REGEXP_BEGIN, :STRING_CONTENT, :REGEXP_END, :IDENTIFIER, :EOF] ``` As a behavior of Ruby, when given `A` to `Z` and `a` to `z`, they act as invalid regexp options. e.g., ```console $ ruby -e '/regexp/az' -e:1: unknown regexp options - az /regexp/az -e: compile error (SyntaxError) ``` Thus, it should probably not be construed as `IDENTIFIER` token. Therefore, `pm_byte_table` has been adapted to accept those invalid regexp option values. Whether it is a valid regexp option or not is checked by `pm_regular_expression_flags_create`. For invalid regexp options, `PM_ERR_REGEXP_UNKNOWN_OPTIONS` is added to diagnostics. https://github.com/ruby/prism/commit/d2a6096fcf
2024-03-20 19:46:53 +03:00
- REGEXP_UNKNOWN_OPTIONS
[ruby/prism] Add initial implementation of `Regexp` validation. https://github.com/ruby/prism/commit/6bf1b8edf0
2024-02-16 05:27:46 +03:00
- REGEXP_UTF8_CHAR_NON_UTF8_REGEXP
[ruby/prism] Expose types on diagnostics https://github.com/ruby/prism/commit/a735c2262f
2024-03-06 21:18:55 +03:00
- RESCUE_EXPRESSION
- RESCUE_MODIFIER_VALUE
- RESCUE_TERM
- RESCUE_VARIABLE
- RETURN_INVALID
[ruby/prism] CLI -x flag https://github.com/ruby/prism/commit/2068e3c30a
2024-03-28 16:51:16 +03:00
- SCRIPT_NOT_FOUND
[ruby/prism] Expose types on diagnostics https://github.com/ruby/prism/commit/a735c2262f
2024-03-06 21:18:55 +03:00
- SINGLETON_FOR_LITERALS
- STATEMENT_ALIAS
- STATEMENT_POSTEXE_END
- STATEMENT_PREEXE_BEGIN
- STATEMENT_UNDEF
- STRING_CONCATENATION
- STRING_INTERPOLATED_TERM
- STRING_LITERAL_EOF
- STRING_LITERAL_TERM
- SYMBOL_INVALID
- SYMBOL_TERM_DYNAMIC
- SYMBOL_TERM_INTERPOLATED
- TERNARY_COLON
- TERNARY_EXPRESSION_FALSE
- TERNARY_EXPRESSION_TRUE
[ruby/prism] Prevent optional block parameter from accepting certain prefixed values This commit prevents the following unary operators from being accepted as the value prefix of a block's optional parameter: - `+` - `-` - `~` - `!` For example, `f { |a = +b| }` will now raise a syntax error. https://github.com/ruby/prism/commit/3024bee60c Co-authored-by: Kevin Newton <kddnewton@gmail.com>
2024-06-21 00:30:12 +03:00
- UNARY_DISALLOWED
[ruby/prism] Expose types on diagnostics https://github.com/ruby/prism/commit/a735c2262f
2024-03-06 21:18:55 +03:00
- UNARY_RECEIVER
[ruby/prism] Add initial implementation of `Regexp` validation. https://github.com/ruby/prism/commit/6bf1b8edf0
2024-02-16 05:27:46 +03:00
- UNDEF_ARGUMENT
[ruby/prism] Syntax error for block argument on yield https://github.com/ruby/prism/commit/9feeafbc67
2024-04-12 20:18:47 +03:00
- UNEXPECTED_BLOCK_ARGUMENT
[ruby/prism] Disallow keywords and blocks in index expressions https://github.com/ruby/prism/commit/e950dc1e83
2024-05-03 19:03:48 +03:00
- UNEXPECTED_INDEX_BLOCK
- UNEXPECTED_INDEX_KEYWORDS
[ruby/prism] Disallow label in parentheses https://github.com/ruby/prism/commit/b624e09cc6
2024-09-25 20:23:42 +03:00
- UNEXPECTED_LABEL
[ruby/prism] Disallow multi writes when not in statement level https://github.com/ruby/prism/commit/fe34a77df2
2024-06-10 20:11:41 +03:00
- UNEXPECTED_MULTI_WRITE
[ruby/prism] Ensure ranges are non-associative https://github.com/ruby/prism/commit/f59295938b
2024-06-14 22:09:25 +03:00
- UNEXPECTED_RANGE_OPERATOR
[ruby/prism] Disallow safe navigation in a call target node https://github.com/ruby/prism/commit/b1917adac7
2024-05-03 19:51:32 +03:00
- UNEXPECTED_SAFE_NAVIGATION
[ruby/prism] Expose types on diagnostics https://github.com/ruby/prism/commit/a735c2262f
2024-03-06 21:18:55 +03:00
- UNEXPECTED_TOKEN_CLOSE_CONTEXT
- UNEXPECTED_TOKEN_IGNORE
- UNTIL_TERM
- VOID_EXPRESSION
- WHILE_TERM
- WRITE_TARGET_IN_METHOD
- WRITE_TARGET_READONLY
- WRITE_TARGET_UNEXPECTED
- XSTRING_TERM
warnings:
[ruby/prism] Implement ambiguous binary operator warning https://github.com/ruby/prism/commit/6258c3695f
2024-05-20 16:54:14 +03:00
- AMBIGUOUS_BINARY_OPERATOR
[ruby/prism] Expose types on diagnostics https://github.com/ruby/prism/commit/a735c2262f
2024-03-06 21:18:55 +03:00
- AMBIGUOUS_FIRST_ARGUMENT_MINUS
- AMBIGUOUS_FIRST_ARGUMENT_PLUS
[ruby/prism] Warn `&` interpreted as argument prefix This PR makes `Prism` warn `&` interpreted as argument prefix. This carries a similar meaning to the following Ruby warning: ```console $ ruby -cwe "foo &bar" -e:1: warning: `&' interpreted as argument prefix Syntax OK ``` Previously, it did not issue a warning: ```console $ bundle exec ruby -rprism -ve "p Prism.parse('foo &bar').warnings" ruby 3.3.0 (2023-12-25 revision https://github.com/ruby/prism/commit/5124f9ac75) [x86_64-darwin22] [] ``` From now on, it will issue a warning similar to Ruby's: ```console $ bundle exec ruby -rprism -ve "p Prism.parse('foo &bar').warnings" ruby 3.3.0 (2023-12-25 revision https://github.com/ruby/prism/commit/5124f9ac75) [x86_64-darwin22] [#<Prism::ParseWarning @type=:ambiguous_prefix_amp @message="ambiguous `&` has been interpreted as an argument prefix" @location=#<Prism::Location @start_offset=4 @length=1 start_line=1> @level=:verbose>] ``` https://github.com/ruby/prism/commit/312f99cd1e
2024-03-13 04:46:10 +03:00
- AMBIGUOUS_PREFIX_AMPERSAND
[ruby/prism] Expose types on diagnostics https://github.com/ruby/prism/commit/a735c2262f
2024-03-06 21:18:55 +03:00
- AMBIGUOUS_PREFIX_STAR
[ruby/prism] Warn `**` interpreted as argument prefix This PR makes Prism warn `**` interpreted as argument prefix. This carries a similar meaning to the following Ruby warning: ```console $ ruby -cwe "foo **bar" -e:1: warning: `**' interpreted as argument prefix Syntax OK ``` Previously, it did not issue a warning: ```console $ bundle exec ruby -rprism -ve "p Prism.parse('foo **bar').warnings" ruby 3.3.0 (2023-12-25 revision https://github.com/ruby/prism/commit/5124f9ac75) [x86_64-darwin22] [] ``` From now on, it will issue a warning similar to Ruby's: ```console $ bundle exec ruby -rprism -ve "p Prism.parse('foo **bar').warnings" ruby 3.3.0 (2023-12-25 revision https://github.com/ruby/prism/commit/5124f9ac75) [x86_64-darwin22] [#<Prism::ParseWarning @type=:ambiguous_prefix_star_star @message="ambiguous `**` has been interpreted as an argument prefix" @location=#<Prism::Location @start_offset=4 @length=2 start_line=1> @level=:verbose>] ``` https://github.com/ruby/prism/commit/f6cb5c314c
2024-03-13 03:47:26 +03:00
- AMBIGUOUS_PREFIX_STAR_STAR
[ruby/prism] Expose types on diagnostics https://github.com/ruby/prism/commit/a735c2262f
2024-03-06 21:18:55 +03:00
- AMBIGUOUS_SLASH
[ruby/prism] Add warning for chained comparisons https://github.com/ruby/prism/commit/f9f3620d44
2024-03-12 21:46:21 +03:00
- COMPARISON_AFTER_COMPARISON
[ruby/prism] Expose types on diagnostics https://github.com/ruby/prism/commit/a735c2262f
2024-03-06 21:18:55 +03:00
- DOT_DOT_DOT_EOL
- EQUAL_IN_CONDITIONAL
[ruby/prism] Support passing version 3.3.1 https://github.com/ruby/prism/commit/445a0f0d22
2024-05-02 01:54:05 +03:00
- EQUAL_IN_CONDITIONAL_3_3
[ruby/prism] Expose types on diagnostics https://github.com/ruby/prism/commit/a735c2262f
2024-03-06 21:18:55 +03:00
- END_IN_METHOD
- DUPLICATED_HASH_KEY
- DUPLICATED_WHEN_CLAUSE
- FLOAT_OUT_OF_RANGE
[ruby/prism] Warn on frozen_string_literal after tokens https://github.com/ruby/prism/commit/edece87801
2024-03-18 19:20:44 +03:00
- IGNORED_FROZEN_STRING_LITERAL
[ruby/prism] Implement mismatched indentation warning https://github.com/ruby/prism/commit/5d5bf92be8
2024-07-19 18:08:06 +03:00
- INDENTATION_MISMATCH
[ruby/prism] Expose types on diagnostics https://github.com/ruby/prism/commit/a735c2262f
2024-03-06 21:18:55 +03:00
- INTEGER_IN_FLIP_FLOP
[ruby/prism] Warnings for incorrect character literal syntax https://github.com/ruby/prism/commit/909508296e
2024-03-12 21:01:30 +03:00
- INVALID_CHARACTER
[ruby/prism] Implement mismatched indentation warning https://github.com/ruby/prism/commit/5d5bf92be8
2024-07-19 18:08:06 +03:00
- INVALID_MAGIC_COMMENT_VALUE
[ruby/prism] Warn for maximum number variables https://github.com/ruby/prism/commit/2cdbf81c95
2024-03-13 21:22:31 +03:00
- INVALID_NUMBERED_REFERENCE
[ruby/prism] Expose types on diagnostics https://github.com/ruby/prism/commit/a735c2262f
2024-03-06 21:18:55 +03:00
- KEYWORD_EOL
[ruby/prism] Consolidate warnings for conditional predicates * Also add warnings for literals in predicates * Also create flip-flops in while/until https://github.com/ruby/prism/commit/a6b5c523c2
2024-03-12 18:42:07 +03:00
- LITERAL_IN_CONDITION_DEFAULT
- LITERAL_IN_CONDITION_VERBOSE
[ruby/prism] shareable_constant_value line warnings https://github.com/ruby/prism/commit/8c984b6922
2024-05-07 16:53:17 +03:00
- SHAREABLE_CONSTANT_VALUE_LINE
[ruby/prism] CLI -x flag https://github.com/ruby/prism/commit/2068e3c30a
2024-03-28 16:51:16 +03:00
- SHEBANG_CARRIAGE_RETURN
[ruby/prism] Add whitespace warnings https://github.com/ruby/prism/commit/01d137a0cb
2024-03-12 21:20:33 +03:00
- UNEXPECTED_CARRIAGE_RETURN
[ruby/prism] Create the warning for unreachable statements https://github.com/ruby/prism/commit/e17c86b886
2024-04-12 17:49:30 +03:00
- UNREACHABLE_STATEMENT
[ruby/prism] Warn on unused local variables https://github.com/ruby/prism/commit/de111935fb
2024-04-05 20:13:25 +03:00
- UNUSED_LOCAL_VARIABLE
[ruby/prism] Implement the void statement warning https://github.com/ruby/prism/commit/802ff71cd4
2024-04-11 22:54:40 +03:00
- VOID_STATEMENT
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
tokens:
- name: EOF
value: 1
comment: final token in the file
- name: MISSING
comment: "a token that was expected but not found"
- name: NOT_PROVIDED
comment: "a token that was not present but it is okay"
- name: AMPERSAND
comment: "&"
- name: AMPERSAND_AMPERSAND
comment: "&&"
- name: AMPERSAND_AMPERSAND_EQUAL
comment: "&&="
- name: AMPERSAND_DOT
comment: "&."
- name: AMPERSAND_EQUAL
comment: "&="
- name: BACKTICK
comment: "`"
- name: BACK_REFERENCE
comment: "a back reference"
- name: BANG
comment: "! or !@"
- name: BANG_EQUAL
comment: "!="
- name: BANG_TILDE
comment: "!~"
- name: BRACE_LEFT
comment: "{"
- name: BRACE_RIGHT
comment: "}"
- name: BRACKET_LEFT
comment: "["
- name: BRACKET_LEFT_ARRAY
comment: "[ for the beginning of an array"
- name: BRACKET_LEFT_RIGHT
comment: "[]"
- name: BRACKET_LEFT_RIGHT_EQUAL
comment: "[]="
- name: BRACKET_RIGHT
comment: "]"
- name: CARET
comment: "^"
- name: CARET_EQUAL
comment: "^="
- name: CHARACTER_LITERAL
comment: "a character literal"
- name: CLASS_VARIABLE
comment: "a class variable"
- name: COLON
comment: ":"
- name: COLON_COLON
comment: "::"
- name: COMMA
comment: ","
- name: COMMENT
comment: "a comment"
- name: CONSTANT
comment: "a constant"
- name: DOT
[ruby/prism] Last remaining missing C comments https://github.com/ruby/prism/commit/e327449db6
2023-10-31 20:26:31 +03:00
comment: "the . call operator"
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: DOT_DOT
[ruby/prism] Last remaining missing C comments https://github.com/ruby/prism/commit/e327449db6
2023-10-31 20:26:31 +03:00
comment: "the .. range operator"
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: DOT_DOT_DOT
[ruby/prism] Last remaining missing C comments https://github.com/ruby/prism/commit/e327449db6
2023-10-31 20:26:31 +03:00
comment: "the ... range operator or forwarding parameter"
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: EMBDOC_BEGIN
comment: "=begin"
- name: EMBDOC_END
comment: "=end"
- name: EMBDOC_LINE
comment: "a line inside of embedded documentation"
- name: EMBEXPR_BEGIN
comment: "#{"
- name: EMBEXPR_END
comment: "}"
- name: EMBVAR
comment: "#"
- name: EQUAL
comment: "="
- name: EQUAL_EQUAL
comment: "=="
- name: EQUAL_EQUAL_EQUAL
comment: "==="
- name: EQUAL_GREATER
comment: "=>"
- name: EQUAL_TILDE
comment: "=~"
- name: FLOAT
comment: "a floating point number"
- name: FLOAT_IMAGINARY
comment: "a floating pointer number with an imaginary suffix"
- name: FLOAT_RATIONAL
comment: "a floating pointer number with a rational suffix"
- name: FLOAT_RATIONAL_IMAGINARY
comment: "a floating pointer number with a rational and imaginary suffix"
- name: GLOBAL_VARIABLE
comment: "a global variable"
- name: GREATER
comment: ">"
- name: GREATER_EQUAL
comment: ">="
- name: GREATER_GREATER
comment: ">>"
- name: GREATER_GREATER_EQUAL
comment: ">>="
- name: HEREDOC_END
comment: "the end of a heredoc"
- name: HEREDOC_START
comment: "the start of a heredoc"
- name: IDENTIFIER
comment: "an identifier"
- name: IGNORED_NEWLINE
comment: "an ignored newline"
- name: INSTANCE_VARIABLE
comment: "an instance variable"
- name: INTEGER
comment: "an integer (any base)"
- name: INTEGER_IMAGINARY
comment: "an integer with an imaginary suffix"
- name: INTEGER_RATIONAL
comment: "an integer with a rational suffix"
- name: INTEGER_RATIONAL_IMAGINARY
comment: "an integer with a rational and imaginary suffix"
- name: KEYWORD_ALIAS
comment: "alias"
- name: KEYWORD_AND
comment: "and"
- name: KEYWORD_BEGIN
comment: "begin"
- name: KEYWORD_BEGIN_UPCASE
comment: "BEGIN"
- name: KEYWORD_BREAK
comment: "break"
- name: KEYWORD_CASE
comment: "case"
- name: KEYWORD_CLASS
comment: "class"
- name: KEYWORD_DEF
comment: "def"
- name: KEYWORD_DEFINED
comment: "defined?"
- name: KEYWORD_DO
comment: "do"
- name: KEYWORD_DO_LOOP
comment: "do keyword for a predicate in a while, until, or for loop"
- name: KEYWORD_ELSE
comment: "else"
- name: KEYWORD_ELSIF
comment: "elsif"
- name: KEYWORD_END
comment: "end"
- name: KEYWORD_END_UPCASE
comment: "END"
- name: KEYWORD_ENSURE
comment: "ensure"
- name: KEYWORD_FALSE
comment: "false"
- name: KEYWORD_FOR
comment: "for"
- name: KEYWORD_IF
comment: "if"
- name: KEYWORD_IF_MODIFIER
comment: "if in the modifier form"
- name: KEYWORD_IN
comment: "in"
- name: KEYWORD_MODULE
comment: "module"
- name: KEYWORD_NEXT
comment: "next"
- name: KEYWORD_NIL
comment: "nil"
- name: KEYWORD_NOT
comment: "not"
- name: KEYWORD_OR
comment: "or"
- name: KEYWORD_REDO
comment: "redo"
- name: KEYWORD_RESCUE
comment: "rescue"
- name: KEYWORD_RESCUE_MODIFIER
comment: "rescue in the modifier form"
- name: KEYWORD_RETRY
comment: "retry"
- name: KEYWORD_RETURN
comment: "return"
- name: KEYWORD_SELF
comment: "self"
- name: KEYWORD_SUPER
comment: "super"
- name: KEYWORD_THEN
comment: "then"
- name: KEYWORD_TRUE
comment: "true"
- name: KEYWORD_UNDEF
comment: "undef"
- name: KEYWORD_UNLESS
comment: "unless"
- name: KEYWORD_UNLESS_MODIFIER
comment: "unless in the modifier form"
- name: KEYWORD_UNTIL
comment: "until"
- name: KEYWORD_UNTIL_MODIFIER
comment: "until in the modifier form"
- name: KEYWORD_WHEN
comment: "when"
- name: KEYWORD_WHILE
comment: "while"
- name: KEYWORD_WHILE_MODIFIER
comment: "while in the modifier form"
- name: KEYWORD_YIELD
comment: "yield"
- name: KEYWORD___ENCODING__
comment: "__ENCODING__"
- name: KEYWORD___FILE__
comment: "__FILE__"
- name: KEYWORD___LINE__
comment: "__LINE__"
- name: LABEL
comment: "a label"
- name: LABEL_END
comment: "the end of a label"
- name: LAMBDA_BEGIN
comment: "{"
- name: LESS
comment: "<"
- name: LESS_EQUAL
comment: "<="
- name: LESS_EQUAL_GREATER
comment: "<=>"
- name: LESS_LESS
comment: "<<"
- name: LESS_LESS_EQUAL
comment: "<<="
[ruby/yarp] Introduce YP_TOKEN_METHOD_NAME https://github.com/ruby/yarp/commit/e855bf415c
2023-09-22 18:18:02 +03:00
- name: METHOD_NAME
comment: "a method name"
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: MINUS
comment: "-"
- name: MINUS_EQUAL
comment: "-="
- name: MINUS_GREATER
comment: "->"
- name: NEWLINE
comment: "a newline character outside of other tokens"
- name: NUMBERED_REFERENCE
comment: "a numbered reference to a capture group in the previous regular expression match"
- name: PARENTHESIS_LEFT
comment: "("
- name: PARENTHESIS_LEFT_PARENTHESES
comment: "( for a parentheses node"
- name: PARENTHESIS_RIGHT
comment: ")"
- name: PERCENT
comment: "%"
- name: PERCENT_EQUAL
comment: "%="
- name: PERCENT_LOWER_I
comment: "%i"
- name: PERCENT_LOWER_W
comment: "%w"
- name: PERCENT_LOWER_X
comment: "%x"
- name: PERCENT_UPPER_I
comment: "%I"
- name: PERCENT_UPPER_W
comment: "%W"
- name: PIPE
comment: "|"
- name: PIPE_EQUAL
comment: "|="
- name: PIPE_PIPE
comment: "||"
- name: PIPE_PIPE_EQUAL
comment: "||="
- name: PLUS
comment: "+"
- name: PLUS_EQUAL
comment: "+="
- name: QUESTION_MARK
comment: "?"
- name: REGEXP_BEGIN
comment: "the beginning of a regular expression"
- name: REGEXP_END
comment: "the end of a regular expression"
- name: SEMICOLON
comment: ";"
- name: SLASH
comment: "/"
- name: SLASH_EQUAL
comment: "/="
- name: STAR
comment: "*"
- name: STAR_EQUAL
comment: "*="
- name: STAR_STAR
comment: "**"
- name: STAR_STAR_EQUAL
comment: "**="
- name: STRING_BEGIN
comment: "the beginning of a string"
- name: STRING_CONTENT
comment: "the contents of a string"
- name: STRING_END
comment: "the end of a string"
- name: SYMBOL_BEGIN
comment: "the beginning of a symbol"
- name: TILDE
comment: "~ or ~@"
- name: UAMPERSAND
comment: "unary &"
- name: UCOLON_COLON
comment: "unary ::"
- name: UDOT_DOT
[ruby/prism] Last remaining missing C comments https://github.com/ruby/prism/commit/e327449db6
2023-10-31 20:26:31 +03:00
comment: "unary .. operator"
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: UDOT_DOT_DOT
[ruby/prism] Last remaining missing C comments https://github.com/ruby/prism/commit/e327449db6
2023-10-31 20:26:31 +03:00
comment: "unary ... operator"
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: UMINUS
comment: "-@"
- name: UMINUS_NUM
comment: "-@ for a number"
- name: UPLUS
comment: "+@"
- name: USTAR
comment: "unary *"
- name: USTAR_STAR
comment: "unary **"
- name: WORDS_SEP
comment: "a separator between words in a list"
- name: __END__
comment: "marker for the point in the file at which the parser should stop"
flags:
[ruby/prism] Add KeywordSplat flag to ArgumentsNode Method calls with keyword splat args compile differently than without since they merge the keyword arg hash with the keyword splat hash. We know this information at parse time, so can set a flag which the compiler can use. https://github.com/ruby/prism/commit/e5f8a9a3cd
2023-10-26 21:02:27 +03:00
- name: ArgumentsNodeFlags
values:
[ruby/prism] Add a flag for arguments that contain forwarding https://github.com/ruby/prism/commit/ebd2889bee
2024-09-11 19:29:13 +03:00
- name: CONTAINS_FORWARDING
comment: "if the arguments contain forwarding"
[ruby/prism] Disallow keywords and blocks in index expressions https://github.com/ruby/prism/commit/e950dc1e83
2024-05-03 19:03:48 +03:00
- name: CONTAINS_KEYWORDS
[ruby/prism] Add a flag for arguments that contain forwarding https://github.com/ruby/prism/commit/ebd2889bee
2024-09-11 19:29:13 +03:00
comment: "if the arguments contain keywords"
[PRISM] Rename flag to CONTAINS_KEYWORD_SPLAT We need to do this change first on ruby/ruby before merging to ruby/prism to avoid breaking ruby/ruby CI
2023-11-21 23:46:48 +03:00
- name: CONTAINS_KEYWORD_SPLAT
[ruby/prism] Add a flag for arguments that contain forwarding https://github.com/ruby/prism/commit/ebd2889bee
2024-09-11 19:29:13 +03:00
comment: "if the arguments contain a keyword splat"
[ruby/prism] Add `contains_splat` flag If we have a splat, add a flag for it named `contains_splat`. https://github.com/ruby/prism/commit/5be97a75c8
2024-08-27 23:40:48 +03:00
- name: CONTAINS_SPLAT
[ruby/prism] Add a flag for arguments that contain forwarding https://github.com/ruby/prism/commit/ebd2889bee
2024-09-11 19:29:13 +03:00
comment: "if the arguments contain a splat"
[ruby/prism] Multi-splat flag for arguments https://github.com/ruby/prism/commit/21cb9b78ae
2024-08-28 23:56:05 +03:00
- name: CONTAINS_MULTIPLE_SPLATS
[ruby/prism] Add a flag for arguments that contain forwarding https://github.com/ruby/prism/commit/ebd2889bee
2024-09-11 19:29:13 +03:00
comment: "if the arguments contain multiple splats"
[ruby/prism] Add comments on flags https://github.com/ruby/prism/commit/3abd09c803
2023-10-30 21:00:44 +03:00
comment: Flags for arguments nodes.
[ruby/prism] Add SPLAT flag on ArrayNode indicating if it contains splat element(s) This commit puts a SPLAT flag on any ArrayNodes which contain SplatNode elements https://github.com/ruby/prism/commit/2fc1e7f181
2023-11-21 23:17:09 +03:00
- name: ArrayNodeFlags
values:
- name: CONTAINS_SPLAT
comment: "if array contains splat nodes"
comment: Flags for array nodes.
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: CallNodeFlags
values:
- name: SAFE_NAVIGATION
comment: "&. operator"
- name: VARIABLE_CALL
comment: "a call that could have been a local variable"
[ruby/prism] Flag for attribute write on calls https://github.com/ruby/prism/commit/465731969c
2023-12-12 18:39:41 +03:00
- name: ATTRIBUTE_WRITE
comment: "a call that is an attribute write, so the value being written should be returned"
[ruby/prism] Ignore visibility flag https://github.com/ruby/prism/commit/55b049ddac
2024-01-02 22:54:45 +03:00
- name: IGNORE_VISIBILITY
comment: "a call that ignores method visibility"
[ruby/prism] Add comments on flags https://github.com/ruby/prism/commit/3abd09c803
2023-10-30 21:00:44 +03:00
comment: Flags for call nodes.
[ruby/prism] Provide flags for changing encodings https://github.com/ruby/prism/commit/e838eaff6f
2023-12-04 20:51:22 +03:00
- name: EncodingFlags
values:
- name: FORCED_UTF8_ENCODING
comment: "internal bytes forced the encoding to UTF-8"
- name: FORCED_BINARY_ENCODING
comment: "internal bytes forced the encoding to binary"
comment: Flags for nodes that have unescaped content.
[ruby/yarp] Provide a flag for the integer base https://github.com/ruby/yarp/commit/45dd046b83
2023-09-11 19:05:14 +03:00
- name: IntegerBaseFlags
values:
- name: BINARY
comment: "0b prefix"
- name: DECIMAL
comment: "0d or no prefix"
[ruby/prism] Update ordering of integer base flags https://github.com/ruby/prism/commit/d711950d5f
2023-12-07 18:39:21 +03:00
- name: OCTAL
comment: "0o or 0 prefix"
[ruby/yarp] Provide a flag for the integer base https://github.com/ruby/yarp/commit/45dd046b83
2023-09-11 19:05:14 +03:00
- name: HEXADECIMAL
comment: "0x prefix"
[ruby/prism] Add comments on flags https://github.com/ruby/prism/commit/3abd09c803
2023-10-30 21:00:44 +03:00
comment: Flags for integer nodes that correspond to the base of the integer.
[ruby/prism] Freeze internal parts, again https://github.com/ruby/prism/commit/50372fee5c
2024-03-25 22:32:54 +03:00
- name: InterpolatedStringNodeFlags
values:
- name: FROZEN
[ruby/prism] Improve description for InterpolatedStringNodeFlags https://github.com/ruby/prism/commit/caa576d63f
2024-03-28 17:12:45 +03:00
comment: "frozen by virtue of a `frozen_string_literal: true` comment or `--enable-frozen-string-literal`; only for adjacent string literals like `'a' 'b'`"
[ruby/prism] Freeze internal parts, again https://github.com/ruby/prism/commit/50372fee5c
2024-03-25 22:32:54 +03:00
- name: MUTABLE
[ruby/prism] Improve description for InterpolatedStringNodeFlags https://github.com/ruby/prism/commit/caa576d63f
2024-03-28 17:12:45 +03:00
comment: "mutable by virtue of a `frozen_string_literal: false` comment or `--disable-frozen-string-literal`; only for adjacent string literals like `'a' 'b'`"
[ruby/prism] Freeze internal parts, again https://github.com/ruby/prism/commit/50372fee5c
2024-03-25 22:32:54 +03:00
comment: Flags for interpolated string nodes that indicated mutability if they are also marked as literals.
[ruby/prism] Add `STATIC_KEYS` flag for `KeywordHashNode` https://github.com/ruby/prism/commit/aa83de39c1
2023-12-11 23:26:06 +03:00
- name: KeywordHashNodeFlags
values:
Revert "Revert all of commits after Prism 0.19.0 release" This reverts commit d242e8416e99eaee4465e2681210ae8b7ecd6d34.
2023-12-25 11:34:06 +03:00
- name: SYMBOL_KEYS
comment: "a keyword hash which only has `AssocNode` elements all with symbol keys, which means the elements can be treated as keyword arguments"
[ruby/prism] Add `STATIC_KEYS` flag for `KeywordHashNode` https://github.com/ruby/prism/commit/aa83de39c1
2023-12-11 23:26:06 +03:00
comment: Flags for keyword hash nodes.
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: LoopFlags
values:
- name: BEGIN_MODIFIER
comment: "a loop after a begin statement, so the body is executed first before the condition"
[ruby/prism] Add comments on flags https://github.com/ruby/prism/commit/3abd09c803
2023-10-30 21:00:44 +03:00
comment: Flags for while and until loop nodes.
[ruby/prism] Add a "repeated flag" to parameter nodes It's possible to repeat parameters in method definitions like so: ```ruby def foo(_a, _a) end ``` The compiler needs to know to adjust the local table size to account for these duplicate names. We'll use the repeated parameter flag to account for the extra stack space required https://github.com/ruby/prism/commit/b443cb1f60 Co-Authored-By: Kevin Newton <kddnewton@gmail.com> Co-Authored-By: Jemma Issroff <jemmaissroff@gmail.com>
2024-01-09 21:12:03 +03:00
- name: ParameterFlags
values:
- name: REPEATED_PARAMETER
comment: "a parameter name that has been repeated in the method signature"
comment: Flags for parameter nodes.
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: RangeFlags
values:
- name: EXCLUDE_END
comment: "... operator"
[ruby/prism] Add comments on flags https://github.com/ruby/prism/commit/3abd09c803
2023-10-30 21:00:44 +03:00
comment: Flags for range and flip-flop nodes.
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: RegularExpressionFlags
values:
- name: IGNORE_CASE
comment: "i - ignores the case of characters when matching"
- name: EXTENDED
comment: "x - ignores whitespace and allows comments in regular expressions"
[ruby/yarp] Fix order of Regexp flags https://github.com/ruby/yarp/commit/e421305ea2
2023-09-11 14:01:36 +03:00
- name: MULTI_LINE
comment: "m - allows $ to match the end of lines within strings"
[ruby/prism] Move common flags to top bits Moves the common flag bits to the top. This lets us eliminate the `COMMON` constant, and also allows us to group encoding flags on a nibble so we can more easily mask them. https://github.com/ruby/prism/commit/895508659e
2023-10-13 20:30:02 +03:00
- name: ONCE
comment: "o - only interpolates values into the regular expression once"
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: EUC_JP
comment: "e - forces the EUC-JP encoding"
- name: ASCII_8BIT
comment: "n - forces the ASCII-8BIT encoding"
- name: WINDOWS_31J
comment: "s - forces the Windows-31J encoding"
- name: UTF_8
comment: "u - forces the UTF-8 encoding"
[ruby/prism] Add necessary encoding flags for symbols and regex This doesn't actually fix the encodings for symbols and regex, unfortunately. But I wanted to get this change in because it is the last AST change we're going to make before 3.3 is released. So, if consumers want, they can start to check these flags to determine the encoding, even though it will be wrong. Then once we actually set them correctly, everything should work. https://github.com/ruby/prism/commit/9b35f7e891
2023-12-08 18:10:43 +03:00
- name: FORCED_UTF8_ENCODING
comment: "internal bytes forced the encoding to UTF-8"
- name: FORCED_BINARY_ENCODING
comment: "internal bytes forced the encoding to binary"
- name: FORCED_US_ASCII_ENCODING
comment: "internal bytes forced the encoding to US-ASCII"
[ruby/prism] Add comments on flags https://github.com/ruby/prism/commit/3abd09c803
2023-10-30 21:00:44 +03:00
comment: Flags for regular expression and match last line nodes.
[ruby/prism] Shareable constant nodes https://github.com/ruby/prism/commit/473cfed6d0
2024-03-15 04:37:16 +03:00
- name: ShareableConstantNodeFlags
values:
- name: LITERAL
comment: "constant writes that should be modified with shareable constant value literal"
- name: EXPERIMENTAL_EVERYTHING
comment: "constant writes that should be modified with shareable constant value experimental everything"
- name: EXPERIMENTAL_COPY
comment: "constant writes that should be modified with shareable constant value experimental copy"
comment: Flags for shareable constant nodes.
[ruby/yarp] Add a frozen string flag https://github.com/ruby/yarp/commit/09248a1f9e
2023-09-12 20:06:41 +03:00
- name: StringFlags
values:
[ruby/prism] Provide flags for changing encodings https://github.com/ruby/prism/commit/e838eaff6f
2023-12-04 20:51:22 +03:00
- name: FORCED_UTF8_ENCODING
comment: "internal bytes forced the encoding to UTF-8"
- name: FORCED_BINARY_ENCODING
comment: "internal bytes forced the encoding to binary"
[ruby/yarp] Add a frozen string flag https://github.com/ruby/yarp/commit/09248a1f9e
2023-09-12 20:06:41 +03:00
- name: FROZEN
[ruby/prism] Change `frozen_string_literal` to be a tri-state An explicit `false` is not equivalent to the comment being missing, because the default can be switched with a runtime flag: ```bash $ ruby --enable-frozen-string-literal -e 'p "foo".frozen?' true ``` https://github.com/ruby/prism/commit/4660f58775
2024-03-12 14:17:55 +03:00
comment: "frozen by virtue of a `frozen_string_literal: true` comment or `--enable-frozen-string-literal`"
- name: MUTABLE
comment: "mutable by virtue of a `frozen_string_literal: false` comment or `--disable-frozen-string-literal`"
[ruby/prism] Add comments on flags https://github.com/ruby/prism/commit/3abd09c803
2023-10-30 21:00:44 +03:00
comment: Flags for string nodes.
[ruby/prism] Add necessary encoding flags for symbols and regex This doesn't actually fix the encodings for symbols and regex, unfortunately. But I wanted to get this change in because it is the last AST change we're going to make before 3.3 is released. So, if consumers want, they can start to check these flags to determine the encoding, even though it will be wrong. Then once we actually set them correctly, everything should work. https://github.com/ruby/prism/commit/9b35f7e891
2023-12-08 18:10:43 +03:00
- name: SymbolFlags
values:
- name: FORCED_UTF8_ENCODING
comment: "internal bytes forced the encoding to UTF-8"
- name: FORCED_BINARY_ENCODING
comment: "internal bytes forced the encoding to binary"
- name: FORCED_US_ASCII_ENCODING
comment: "internal bytes forced the encoding to US-ASCII"
comment: Flags for symbol nodes.
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
nodes:
[ruby/yarp] Split AliasNode Into AliasGlobalVariableNode and AliasMethodNode. These have different enough semantics that we feel comfortable splitting them up. https://github.com/ruby/yarp/commit/c1f3e6d344
2023-09-11 18:52:01 +03:00
- name: AliasGlobalVariableNode
[ruby/yarp] Rename child_nodes to fields https://github.com/ruby/yarp/commit/715fce9264
2023-08-30 23:09:51 +03:00
fields:
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: new_name
type: node
[ruby/prism] Review config.yml: documentation, types and field names https://github.com/ruby/prism/commit/d43333539e
2024-07-25 23:49:42 +03:00
kind:
- GlobalVariableReadNode
- BackReferenceReadNode
- NumberedReferenceReadNode
[ruby/prism] Document the `AliasGlobalVariableNode` fields https://github.com/ruby/prism/commit/35bc711069
2024-01-04 06:08:59 +03:00
comment: |
[ruby/prism] Review config.yml: documentation, types and field names https://github.com/ruby/prism/commit/d43333539e
2024-07-25 23:49:42 +03:00
Represents the new name of the global variable that can be used after aliasing.
[ruby/prism] Document the `AliasGlobalVariableNode` fields https://github.com/ruby/prism/commit/35bc711069
2024-01-04 06:08:59 +03:00
alias $foo $bar
^^^^
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: old_name
type: node
[ruby/prism] Review config.yml: documentation, types and field names https://github.com/ruby/prism/commit/d43333539e
2024-07-25 23:49:42 +03:00
kind:
- GlobalVariableReadNode
- BackReferenceReadNode
- NumberedReferenceReadNode
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
- on error: SymbolNode # alias $a b
- on error: MissingNode # alias $a 42
[ruby/prism] Document the `AliasGlobalVariableNode` fields https://github.com/ruby/prism/commit/35bc711069
2024-01-04 06:08:59 +03:00
comment: |
[ruby/prism] Review config.yml: documentation, types and field names https://github.com/ruby/prism/commit/d43333539e
2024-07-25 23:49:42 +03:00
Represents the old name of the global variable that can be used before aliasing.
[ruby/prism] Document the `AliasGlobalVariableNode` fields https://github.com/ruby/prism/commit/35bc711069
2024-01-04 06:08:59 +03:00
alias $foo $bar
^^^^
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: keyword_loc
type: location
[ruby/prism] Document the `AliasGlobalVariableNode` fields https://github.com/ruby/prism/commit/35bc711069
2024-01-04 06:08:59 +03:00
comment: |
The location of the `alias` keyword.
alias $foo $bar
^^^^^
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
comment: |
[ruby/yarp] Split AliasNode Into AliasGlobalVariableNode and AliasMethodNode. These have different enough semantics that we feel comfortable splitting them up. https://github.com/ruby/yarp/commit/c1f3e6d344
2023-09-11 18:52:01 +03:00
Represents the use of the `alias` keyword to alias a global variable.
alias $foo $bar
^^^^^^^^^^^^^^^
- name: AliasMethodNode
fields:
- name: new_name
type: node
[ruby/prism] Review config.yml: documentation, types and field names https://github.com/ruby/prism/commit/d43333539e
2024-07-25 23:49:42 +03:00
kind:
- SymbolNode
- InterpolatedSymbolNode
[ruby/prism] Add fields documentation for AliasMethodNode and AlternationPatternNode https://github.com/ruby/prism/commit/6953daebde
2024-09-26 03:40:06 +03:00
comment: |
Represents the new name of the method that will be aliased.
alias foo bar
^^^
alias :foo :bar
^^^^
alias :"#{foo}" :"#{bar}"
^^^^^^^^^
[ruby/yarp] Split AliasNode Into AliasGlobalVariableNode and AliasMethodNode. These have different enough semantics that we feel comfortable splitting them up. https://github.com/ruby/yarp/commit/c1f3e6d344
2023-09-11 18:52:01 +03:00
- name: old_name
type: node
[ruby/prism] Review config.yml: documentation, types and field names https://github.com/ruby/prism/commit/d43333539e
2024-07-25 23:49:42 +03:00
kind:
- SymbolNode
- InterpolatedSymbolNode
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
- on error: GlobalVariableReadNode # alias a $b
- on error: MissingNode # alias a 42
[ruby/prism] Add fields documentation for AliasMethodNode and AlternationPatternNode https://github.com/ruby/prism/commit/6953daebde
2024-09-26 03:40:06 +03:00
comment: |
Represents the old name of the method that will be aliased.
alias foo bar
^^^
alias :foo :bar
^^^^
alias :"#{foo}" :"#{bar}"
^^^^^^^^^
[ruby/yarp] Split AliasNode Into AliasGlobalVariableNode and AliasMethodNode. These have different enough semantics that we feel comfortable splitting them up. https://github.com/ruby/yarp/commit/c1f3e6d344
2023-09-11 18:52:01 +03:00
- name: keyword_loc
type: location
comment: |
Represents the use of the `alias` keyword to alias a method.
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
alias foo bar
^^^^^^^^^^^^^
- name: AlternationPatternNode
[ruby/yarp] Rename child_nodes to fields https://github.com/ruby/yarp/commit/715fce9264
2023-08-30 23:09:51 +03:00
fields:
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: left
type: node
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
kind: pattern expression
[ruby/prism] Add fields documentation for AliasMethodNode and AlternationPatternNode https://github.com/ruby/prism/commit/6953daebde
2024-09-26 03:40:06 +03:00
comment: |
[ruby/prism] Fix incorrect reference to AlternationPatternNode as non-void expressions https://github.com/ruby/prism/commit/68de31919e
2024-09-26 18:18:35 +03:00
Represents the left side of the expression.
[ruby/prism] Add fields documentation for AliasMethodNode and AlternationPatternNode https://github.com/ruby/prism/commit/6953daebde
2024-09-26 03:40:06 +03:00
foo => bar | baz
^^^
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: right
type: node
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
kind: pattern expression
[ruby/prism] Add fields documentation for AliasMethodNode and AlternationPatternNode https://github.com/ruby/prism/commit/6953daebde
2024-09-26 03:40:06 +03:00
comment: |
[ruby/prism] Fix incorrect reference to AlternationPatternNode as non-void expressions https://github.com/ruby/prism/commit/68de31919e
2024-09-26 18:18:35 +03:00
Represents the right side of the expression.
[ruby/prism] Add fields documentation for AliasMethodNode and AlternationPatternNode https://github.com/ruby/prism/commit/6953daebde
2024-09-26 03:40:06 +03:00
foo => bar | baz
^^^
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: operator_loc
type: location
[ruby/prism] Add fields documentation for AliasMethodNode and AlternationPatternNode https://github.com/ruby/prism/commit/6953daebde
2024-09-26 03:40:06 +03:00
comment: |
Represents the alternation operator location.
foo => bar | baz
^
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
comment: |
Represents an alternation pattern in pattern matching.
foo => bar | baz
^^^^^^^^^
- name: AndNode
[ruby/yarp] Rename child_nodes to fields https://github.com/ruby/yarp/commit/715fce9264
2023-08-30 23:09:51 +03:00
fields:
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: left
type: node
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
kind: non-void expression
[ruby/prism] Document AndNode and OrNode https://github.com/ruby/prism/commit/a925856c2b
2024-01-14 11:58:30 +03:00
comment: |
[PRISM] Sync to latest
2024-01-19 19:22:40 +03:00
Represents the left side of the expression. It can be any [non-void expression](https://github.com/ruby/prism/blob/main/docs/parsing_rules.md#non-void-expression).
[ruby/prism] Document AndNode and OrNode https://github.com/ruby/prism/commit/a925856c2b
2024-01-14 11:58:30 +03:00
[ruby/prism] Wording in node field comments https://github.com/ruby/prism/commit/c9c913ee99
2024-01-17 20:42:44 +03:00
left and right
^^^^
1 && 2
^
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: right
type: node
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
kind: Node
[ruby/prism] Document AndNode and OrNode https://github.com/ruby/prism/commit/a925856c2b
2024-01-14 11:58:30 +03:00
comment: |
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
Represents the right side of the expression.
[ruby/prism] Document AndNode and OrNode https://github.com/ruby/prism/commit/a925856c2b
2024-01-14 11:58:30 +03:00
[ruby/prism] Wording in node field comments https://github.com/ruby/prism/commit/c9c913ee99
2024-01-17 20:42:44 +03:00
left && right
^^^^^
1 and 2
^
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: operator_loc
type: location
[ruby/prism] Document AndNode and OrNode https://github.com/ruby/prism/commit/a925856c2b
2024-01-14 11:58:30 +03:00
comment: |
[ruby/prism] Wording in node field comments https://github.com/ruby/prism/commit/c9c913ee99
2024-01-17 20:42:44 +03:00
The location of the `and` keyword or the `&&` operator.
[ruby/prism] Document AndNode and OrNode https://github.com/ruby/prism/commit/a925856c2b
2024-01-14 11:58:30 +03:00
[ruby/prism] Wording in node field comments https://github.com/ruby/prism/commit/c9c913ee99
2024-01-17 20:42:44 +03:00
left and right
^^^
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
comment: |
Represents the use of the `&&` operator or the `and` keyword.
left and right
^^^^^^^^^^^^^^
- name: ArgumentsNode
[ruby/prism] Expose flags on every node type https://github.com/ruby/prism/commit/9f12a56fd6
2024-07-02 22:43:01 +03:00
flags: ArgumentsNodeFlags
[ruby/yarp] Rename child_nodes to fields https://github.com/ruby/yarp/commit/715fce9264
2023-08-30 23:09:51 +03:00
fields:
[ruby/prism] Move flag position consistently to front https://github.com/ruby/prism/commit/6e69a81737
2023-12-06 23:32:53 +03:00
- name: arguments
type: node[]
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
kind: non-void expression
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
comment: |
Represents a set of arguments to a method or a keyword.
return foo, bar, baz
^^^^^^^^^^^^^
- name: ArrayNode
[ruby/prism] Expose flags on every node type https://github.com/ruby/prism/commit/9f12a56fd6
2024-07-02 22:43:01 +03:00
flags: ArrayNodeFlags
[ruby/yarp] Rename child_nodes to fields https://github.com/ruby/yarp/commit/715fce9264
2023-08-30 23:09:51 +03:00
fields:
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: elements
type: node[]
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
kind: non-void expression
[ruby/prism] Document `ArrayNode`, `SourceFileNode` fields https://github.com/ruby/prism/commit/0bdc566f67
2024-01-04 03:52:10 +03:00
comment: Represent the list of zero or more [non-void expressions](https://github.com/ruby/prism/blob/main/docs/parsing_rules.md#non-void-expression) within the array.
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: opening_loc
type: location?
[ruby/prism] Document `ArrayNode`, `SourceFileNode` fields https://github.com/ruby/prism/commit/0bdc566f67
2024-01-04 03:52:10 +03:00
comment: |
Represents the optional source location for the opening token.
[1,2,3] # "["
%w[foo bar baz] # "%w["
%I(apple orange banana) # "%I("
foo = 1, 2, 3 # nil
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: closing_loc
type: location?
[ruby/prism] Document `ArrayNode`, `SourceFileNode` fields https://github.com/ruby/prism/commit/0bdc566f67
2024-01-04 03:52:10 +03:00
comment: |
Represents the optional source location for the closing token.
[1,2,3] # "]"
%w[foo bar baz] # "]"
%I(apple orange banana) # ")"
foo = 1, 2, 3 # nil
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
comment: |
[PRISM] Sync to latest
2024-01-19 19:22:40 +03:00
Represents an array literal. This can be a regular array using brackets or a special array using % like %w or %i.
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
[1, 2, 3]
^^^^^^^^^
- name: ArrayPatternNode
[ruby/yarp] Rename child_nodes to fields https://github.com/ruby/yarp/commit/715fce9264
2023-08-30 23:09:51 +03:00
fields:
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: constant
type: node?
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
kind:
- ConstantReadNode
- ConstantPathNode
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: requireds
type: node[]
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
kind: pattern expression
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: rest
type: node?
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
kind: pattern expression
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: posts
type: node[]
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
kind: pattern expression
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: opening_loc
type: location?
- name: closing_loc
type: location?
comment: |
Represents an array pattern in pattern matching.
foo in 1, 2
^^^^^^^^^^^
foo in [1, 2]
^^^^^^^^^^^^^
foo in *1
^^^^^^^^^
foo in Bar[]
^^^^^^^^^^^^
foo in Bar[1, 2, 3]
^^^^^^^^^^^^^^^^^^^
- name: AssocNode
[ruby/yarp] Rename child_nodes to fields https://github.com/ruby/yarp/commit/715fce9264
2023-08-30 23:09:51 +03:00
fields:
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: key
type: node
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
kind: non-void expression
[ruby/prism] Add comments for AssocNode fields https://github.com/ruby/prism/commit/fb60072a1e
2024-01-07 12:56:22 +03:00
comment: |
[PRISM] Sync to latest
2024-01-19 19:22:40 +03:00
The key of the association. This can be any [non-void expression](https://github.com/ruby/prism/blob/main/docs/parsing_rules.md#non-void-expression).
[ruby/prism] Add comments for AssocNode fields https://github.com/ruby/prism/commit/fb60072a1e
2024-01-07 12:56:22 +03:00
{ a: b }
^
{ foo => bar }
^^^
{ def a; end => 1 }
^^^^^^^^^^
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: value
[ruby/prism] Add an implicit node for the target of a hash pattern This simplifies compiling it, since you can now compile the value as if it were always there. https://github.com/ruby/prism/commit/bcfc74aacb
2024-01-24 20:11:45 +03:00
type: node
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
kind: non-void expression
[ruby/prism] Add comments for AssocNode fields https://github.com/ruby/prism/commit/fb60072a1e
2024-01-07 12:56:22 +03:00
comment: |
[ruby/prism] Add an implicit node for the target of a hash pattern This simplifies compiling it, since you can now compile the value as if it were always there. https://github.com/ruby/prism/commit/bcfc74aacb
2024-01-24 20:11:45 +03:00
The value of the association, if present. This can be any [non-void expression](https://github.com/ruby/prism/blob/main/docs/parsing_rules.md#non-void-expression).
[ruby/prism] Add comments for AssocNode fields https://github.com/ruby/prism/commit/fb60072a1e
2024-01-07 12:56:22 +03:00
{ foo => bar }
^^^
{ x: 1 }
^
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: operator_loc
type: location?
[ruby/prism] Add comments for AssocNode fields https://github.com/ruby/prism/commit/fb60072a1e
2024-01-07 12:56:22 +03:00
comment: |
The location of the `=>` operator, if present.
{ foo => bar }
^^
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
comment: |
Represents a hash key/value pair.
{ a => b }
^^^^^^
- name: AssocSplatNode
[ruby/yarp] Rename child_nodes to fields https://github.com/ruby/yarp/commit/715fce9264
2023-08-30 23:09:51 +03:00
fields:
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: value
type: node?
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
kind: non-void expression
[ruby/prism] Add comments for AssocSplatNode fields https://github.com/ruby/prism/commit/a0fd874848
2024-01-07 13:07:55 +03:00
comment: |
[PRISM] Sync to latest
2024-01-19 19:22:40 +03:00
The value to be splatted, if present. Will be missing when keyword rest argument forwarding is used.
[ruby/prism] Add comments for AssocSplatNode fields https://github.com/ruby/prism/commit/a0fd874848
2024-01-07 13:07:55 +03:00
{ **foo }
^^^
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: operator_loc
type: location
[ruby/prism] Add comments for AssocSplatNode fields https://github.com/ruby/prism/commit/a0fd874848
2024-01-07 13:07:55 +03:00
comment: |
The location of the `**` operator.
{ **x }
^^
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
comment: |
Represents a splat in a hash literal.
{ **foo }
^^^^^
- name: BackReferenceReadNode
[ruby/prism] Put names on back reference read nodes https://github.com/ruby/prism/commit/10a6403293
2023-10-14 03:23:13 +03:00
fields:
- name: name
type: constant
[ruby/prism] Document BackReferencedReadNode fields https://github.com/ruby/prism/commit/99a5660623
2024-01-08 23:25:30 +03:00
comment: |
The name of the back-reference variable, including the leading `$`.
$& # name `:$&`
$+ # name `:$+`
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
comment: |
Represents reading a reference to a field in the previous match.
$'
^^
- name: BeginNode
[ruby/yarp] Rename child_nodes to fields https://github.com/ruby/yarp/commit/715fce9264
2023-08-30 23:09:51 +03:00
fields:
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: begin_keyword_loc
type: location?
- name: statements
type: node?
kind: StatementsNode
- name: rescue_clause
type: node?
kind: RescueNode
- name: else_clause
type: node?
kind: ElseNode
- name: ensure_clause
type: node?
kind: EnsureNode
- name: end_keyword_loc
type: location?
newline: false
comment: |
Represents a begin statement.
begin
foo
end
^^^^^
- name: BlockArgumentNode
[ruby/yarp] Rename child_nodes to fields https://github.com/ruby/yarp/commit/715fce9264
2023-08-30 23:09:51 +03:00
fields:
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: expression
type: node?
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
kind: non-void expression
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: operator_loc
type: location
comment: |
[ruby/prism] Review config.yml: documentation, types and field names https://github.com/ruby/prism/commit/d43333539e
2024-07-25 23:49:42 +03:00
Represents a block argument using `&`.
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
bar(&args)
^^^^^^^^^^
[ruby/yarp] Introduce a BlockLocalVariableNode This is a tradeoff that I think is worth it. Right now we have a location list that tracks the location of each of the block locals. Instead, I'd like to make that a node list that has a proper node in each spot in the list. In doing so, we eliminate the need to have a location list at all, making it simpler on all of the various consumers as we have one fewer field type. There should be minimal memory implications here since this syntax is exceedingly rare. https://github.com/ruby/yarp/commit/04d329ddf0
2023-09-05 19:34:16 +03:00
- name: BlockLocalVariableNode
[ruby/prism] Expose flags on every node type https://github.com/ruby/prism/commit/9f12a56fd6
2024-07-02 22:43:01 +03:00
flags: ParameterFlags
[ruby/yarp] Introduce a BlockLocalVariableNode This is a tradeoff that I think is worth it. Right now we have a location list that tracks the location of each of the block locals. Instead, I'd like to make that a node list that has a proper node in each spot in the list. In doing so, we eliminate the need to have a location list at all, making it simpler on all of the various consumers as we have one fewer field type. There should be minimal memory implications here since this syntax is exceedingly rare. https://github.com/ruby/yarp/commit/04d329ddf0
2023-09-05 19:34:16 +03:00
fields:
- name: name
type: constant
comment: |
Represents a block local variable.
a { |; b| }
^
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: BlockNode
[ruby/yarp] Rename child_nodes to fields https://github.com/ruby/yarp/commit/715fce9264
2023-08-30 23:09:51 +03:00
fields:
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: locals
type: constant[]
- name: parameters
type: node?
[ruby/prism] Review config.yml: documentation, types and field names https://github.com/ruby/prism/commit/d43333539e
2024-07-25 23:49:42 +03:00
kind:
- BlockParametersNode
- NumberedParametersNode
- ItParametersNode
[ruby/yarp] Rename statements to body where appropriate https://github.com/ruby/yarp/commit/0aa7d9d10c
2023-08-19 03:47:58 +03:00
- name: body
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
type: node?
[ruby/prism] Review config.yml: documentation, types and field names https://github.com/ruby/prism/commit/d43333539e
2024-07-25 23:49:42 +03:00
kind:
- StatementsNode
- BeginNode
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: opening_loc
type: location
- name: closing_loc
type: location
comment: |
Represents a block of ruby code.
[ruby/prism] Wording in node field comments https://github.com/ruby/prism/commit/c9c913ee99
2024-01-17 20:42:44 +03:00
[1, 2, 3].each { |i| puts x }
^^^^^^^^^^^^^^
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: BlockParameterNode
[ruby/prism] Expose flags on every node type https://github.com/ruby/prism/commit/9f12a56fd6
2024-07-02 22:43:01 +03:00
flags: ParameterFlags
[ruby/yarp] Rename child_nodes to fields https://github.com/ruby/yarp/commit/715fce9264
2023-08-30 23:09:51 +03:00
fields:
[ruby/yarp] Constant on block parameter node https://github.com/ruby/yarp/commit/2cd9a67150
2023-09-06 17:46:20 +03:00
- name: name
type: constant?
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: name_loc
type: location?
- name: operator_loc
type: location
comment: |
[ruby/prism] Review config.yml: documentation, types and field names https://github.com/ruby/prism/commit/d43333539e
2024-07-25 23:49:42 +03:00
Represents a block parameter of a method, block, or lambda definition.
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
def a(&b)
^^
end
- name: BlockParametersNode
[ruby/yarp] Rename child_nodes to fields https://github.com/ruby/yarp/commit/715fce9264
2023-08-30 23:09:51 +03:00
fields:
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: parameters
type: node?
kind: ParametersNode
- name: locals
[ruby/yarp] Introduce a BlockLocalVariableNode This is a tradeoff that I think is worth it. Right now we have a location list that tracks the location of each of the block locals. Instead, I'd like to make that a node list that has a proper node in each spot in the list. In doing so, we eliminate the need to have a location list at all, making it simpler on all of the various consumers as we have one fewer field type. There should be minimal memory implications here since this syntax is exceedingly rare. https://github.com/ruby/yarp/commit/04d329ddf0
2023-09-05 19:34:16 +03:00
type: node[]
[ruby/prism] wip: node unions https://github.com/ruby/prism/commit/99a71675d4
2023-12-21 07:41:52 +03:00
kind: BlockLocalVariableNode
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: opening_loc
type: location?
- name: closing_loc
type: location?
comment: |
Represents a block's parameters declaration.
-> (a, b = 1; local) { }
^^^^^^^^^^^^^^^^^
foo do |a, b = 1; local|
^^^^^^^^^^^^^^^^^
end
- name: BreakNode
[ruby/yarp] Rename child_nodes to fields https://github.com/ruby/yarp/commit/715fce9264
2023-08-30 23:09:51 +03:00
fields:
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: arguments
type: node?
kind: ArgumentsNode
[ruby/prism] Document BreakNode fields https://github.com/ruby/prism/commit/7a3ed22f14
2024-01-19 17:45:49 +03:00
comment: |
The arguments to the break statement, if present. These can be any [non-void expressions](https://github.com/ruby/prism/blob/main/docs/parsing_rules.md#non-void-expression).
break foo
^^^
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: keyword_loc
type: location
[ruby/prism] Document BreakNode fields https://github.com/ruby/prism/commit/7a3ed22f14
2024-01-19 17:45:49 +03:00
comment: |
The location of the `break` keyword.
break foo
^^^^^
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
comment: |
Represents the use of the `break` keyword.
break foo
^^^^^^^^^
[ruby/yarp] Flatten CallAndWriteNode, CallOrWriteNode, and CallOperatorWriteNode https://github.com/ruby/yarp/commit/8f26ffa0b2
2023-09-05 21:16:33 +03:00
- name: CallAndWriteNode
[ruby/prism] Expose flags on every node type https://github.com/ruby/prism/commit/9f12a56fd6
2024-07-02 22:43:01 +03:00
flags: CallNodeFlags
[ruby/yarp] Flatten CallAndWriteNode, CallOrWriteNode, and CallOperatorWriteNode https://github.com/ruby/yarp/commit/8f26ffa0b2
2023-09-05 21:16:33 +03:00
fields:
- name: receiver
type: node?
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
kind: non-void expression
[ruby/yarp] Flatten CallAndWriteNode, CallOrWriteNode, and CallOperatorWriteNode https://github.com/ruby/yarp/commit/8f26ffa0b2
2023-09-05 21:16:33 +03:00
- name: call_operator_loc
type: location?
- name: message_loc
type: location?
- name: read_name
Sync with prism CallNode#name changes * https://github.com/ruby/prism/pull/1533
2023-10-01 13:34:55 +03:00
type: constant
[ruby/yarp] Flatten CallAndWriteNode, CallOrWriteNode, and CallOperatorWriteNode https://github.com/ruby/yarp/commit/8f26ffa0b2
2023-09-05 21:16:33 +03:00
- name: write_name
Sync with prism CallNode#name changes * https://github.com/ruby/prism/pull/1533
2023-10-01 13:34:55 +03:00
type: constant
[ruby/yarp] Flatten CallAndWriteNode, CallOrWriteNode, and CallOperatorWriteNode https://github.com/ruby/yarp/commit/8f26ffa0b2
2023-09-05 21:16:33 +03:00
- name: operator_loc
type: location
- name: value
type: node
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
kind: non-void expression
[ruby/yarp] Flatten CallAndWriteNode, CallOrWriteNode, and CallOperatorWriteNode https://github.com/ruby/yarp/commit/8f26ffa0b2
2023-09-05 21:16:33 +03:00
comment: |
Represents the use of the `&&=` operator on a call.
foo.bar &&= value
^^^^^^^^^^^^^^^^^
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: CallNode
[ruby/prism] Expose flags on every node type https://github.com/ruby/prism/commit/9f12a56fd6
2024-07-02 22:43:01 +03:00
flags: CallNodeFlags
[ruby/yarp] Rename child_nodes to fields https://github.com/ruby/yarp/commit/715fce9264
2023-08-30 23:09:51 +03:00
fields:
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: receiver
type: node?
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
kind: non-void expression
[ruby/prism] Introduce field comments In an effort to further improve our documentation, this commit introduces the concept of templating comments onto fields. I hope to get more documentation above the nuances of specific fields this way going forward. With this, we template the comments into C and Ruby. I haven't done JS or Java yet, but we can touch those in the future, especially once their documentation is published. https://github.com/ruby/prism/commit/af300d5fb3
2024-01-02 23:26:21 +03:00
comment: |
[PRISM] Sync to latest
2024-01-19 19:22:40 +03:00
The object that the method is being called on. This can be either `nil` or any [non-void expression](https://github.com/ruby/prism/blob/main/docs/parsing_rules.md#non-void-expression).
[ruby/prism] Introduce field comments In an effort to further improve our documentation, this commit introduces the concept of templating comments onto fields. I hope to get more documentation above the nuances of specific fields this way going forward. With this, we template the comments into C and Ruby. I haven't done JS or Java yet, but we can touch those in the future, especially once their documentation is published. https://github.com/ruby/prism/commit/af300d5fb3
2024-01-02 23:26:21 +03:00
foo.bar
^^^
+foo
^^^
foo + bar
^^^
[ruby/yarp] Rename CallNode#operator_loc to CallNode#call_operator_loc https://github.com/ruby/yarp/commit/fbcd307a54
2023-09-05 20:58:48 +03:00
- name: call_operator_loc
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
type: location?
[ruby/prism] Move CallNode#name field between receiver and arguments * The same order as in source code. * CallOrWriteNode, CallOperatorWriteNode, CallAndWriteNode already have the correct order so it was also inconsistent with them. https://github.com/ruby/prism/commit/4434e4bc22
2023-11-20 19:43:26 +03:00
- name: name
type: constant
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: message_loc
type: location?
- name: opening_loc
type: location?
- name: arguments
type: node?
kind: ArgumentsNode
- name: closing_loc
type: location?
- name: block
type: node?
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
kind:
- BlockNode
- BlockArgumentNode
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
comment: |
Represents a method call, in all of the various forms that can take.
foo
^^^
foo()
^^^^^
+foo
^^^^
foo + bar
^^^^^^^^^
foo.bar
^^^^^^^
foo&.bar
^^^^^^^^
[ruby/yarp] Flatten CallAndWriteNode, CallOrWriteNode, and CallOperatorWriteNode https://github.com/ruby/yarp/commit/8f26ffa0b2
2023-09-05 21:16:33 +03:00
- name: CallOperatorWriteNode
[ruby/prism] Expose flags on every node type https://github.com/ruby/prism/commit/9f12a56fd6
2024-07-02 22:43:01 +03:00
flags: CallNodeFlags
[ruby/yarp] Rename child_nodes to fields https://github.com/ruby/yarp/commit/715fce9264
2023-08-30 23:09:51 +03:00
fields:
[ruby/yarp] Flatten CallAndWriteNode, CallOrWriteNode, and CallOperatorWriteNode https://github.com/ruby/yarp/commit/8f26ffa0b2
2023-09-05 21:16:33 +03:00
- name: receiver
type: node?
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
kind: non-void expression
[ruby/yarp] Flatten CallAndWriteNode, CallOrWriteNode, and CallOperatorWriteNode https://github.com/ruby/yarp/commit/8f26ffa0b2
2023-09-05 21:16:33 +03:00
- name: call_operator_loc
type: location?
- name: message_loc
type: location?
- name: read_name
Sync with prism CallNode#name changes * https://github.com/ruby/prism/pull/1533
2023-10-01 13:34:55 +03:00
type: constant
[ruby/yarp] Flatten CallAndWriteNode, CallOrWriteNode, and CallOperatorWriteNode https://github.com/ruby/yarp/commit/8f26ffa0b2
2023-09-05 21:16:33 +03:00
- name: write_name
Sync with prism CallNode#name changes * https://github.com/ruby/prism/pull/1533
2023-10-01 13:34:55 +03:00
type: constant
[ruby/prism] operator rename https://github.com/ruby/prism/commit/b5e47f5c42
2024-05-10 17:19:11 +03:00
- name: binary_operator
[ruby/yarp] Flatten CallAndWriteNode, CallOrWriteNode, and CallOperatorWriteNode https://github.com/ruby/yarp/commit/8f26ffa0b2
2023-09-05 21:16:33 +03:00
type: constant
[ruby/prism] operator rename https://github.com/ruby/prism/commit/b5e47f5c42
2024-05-10 17:19:11 +03:00
- name: binary_operator_loc
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
type: location
- name: value
type: node
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
kind: non-void expression
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
comment: |
[ruby/yarp] Flatten CallAndWriteNode, CallOrWriteNode, and CallOperatorWriteNode https://github.com/ruby/yarp/commit/8f26ffa0b2
2023-09-05 21:16:33 +03:00
Represents the use of an assignment operator on a call.
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
[ruby/yarp] Flatten CallAndWriteNode, CallOrWriteNode, and CallOperatorWriteNode https://github.com/ruby/yarp/commit/8f26ffa0b2
2023-09-05 21:16:33 +03:00
foo.bar += baz
^^^^^^^^^^^^^^
- name: CallOrWriteNode
[ruby/prism] Expose flags on every node type https://github.com/ruby/prism/commit/9f12a56fd6
2024-07-02 22:43:01 +03:00
flags: CallNodeFlags
[ruby/yarp] Rename child_nodes to fields https://github.com/ruby/yarp/commit/715fce9264
2023-08-30 23:09:51 +03:00
fields:
[ruby/yarp] Flatten CallAndWriteNode, CallOrWriteNode, and CallOperatorWriteNode https://github.com/ruby/yarp/commit/8f26ffa0b2
2023-09-05 21:16:33 +03:00
- name: receiver
type: node?
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
kind: non-void expression
[ruby/yarp] Flatten CallAndWriteNode, CallOrWriteNode, and CallOperatorWriteNode https://github.com/ruby/yarp/commit/8f26ffa0b2
2023-09-05 21:16:33 +03:00
- name: call_operator_loc
type: location?
- name: message_loc
type: location?
- name: read_name
Sync with prism CallNode#name changes * https://github.com/ruby/prism/pull/1533
2023-10-01 13:34:55 +03:00
type: constant
[ruby/yarp] Flatten CallAndWriteNode, CallOrWriteNode, and CallOperatorWriteNode https://github.com/ruby/yarp/commit/8f26ffa0b2
2023-09-05 21:16:33 +03:00
- name: write_name
Sync with prism CallNode#name changes * https://github.com/ruby/prism/pull/1533
2023-10-01 13:34:55 +03:00
type: constant
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: operator_loc
type: location
[ruby/yarp] Flatten CallAndWriteNode, CallOrWriteNode, and CallOperatorWriteNode https://github.com/ruby/yarp/commit/8f26ffa0b2
2023-09-05 21:16:33 +03:00
- name: value
type: node
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
kind: non-void expression
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
comment: |
Represents the use of the `||=` operator on a call.
foo.bar ||= value
^^^^^^^^^^^^^^^^^
[ruby/prism] Split up CallNode in target position In this commit we're splitting up the call nodes that were in target positions (that is, for loop indices, rescue error captures, and multi assign targets). Previously, we would simply leave the call nodes in place. This had the benefit of keeping the AST relatively simple, but had the downside of not being very explicit. If a static analysis tool wanted to only look at call nodes, it could easily be confused because the method would have 1 fewer argument than it would actually be called with. This also brings some consistency to the AST. All of the nodes in a target position are now *TargetNode nodes. These should all be treated the same, and the call nodes can now be treated the same. Finally, there is benefit to memory. Because being in a target position ensures we don't have some fields, we can strip down the number of fields on these nodes. So this commit introduces two new nodes: CallTargetNode and IndexTargetNode. For CallTargetNode we get to drop the opening_loc, closing_loc, arguments, and block. Those can never be present. We also get to mark their fields as non-null, so they will always be seen as present. The IndexTargetNode keeps around most of its fields but gets to drop both the name (because it will always be []=) and the message_loc (which was always super confusing because it included the arguments by virtue of being inside the []). Overall, this adds complexity to the AST at the expense of memory savings and explicitness. I believe this tradeoff is worth it in this case, especially because these are very much not common nodes in the first place. https://github.com/ruby/prism/commit/3ef71cdb45
2023-12-08 17:57:31 +03:00
- name: CallTargetNode
[ruby/prism] Expose flags on every node type https://github.com/ruby/prism/commit/9f12a56fd6
2024-07-02 22:43:01 +03:00
flags: CallNodeFlags
[ruby/prism] Split up CallNode in target position In this commit we're splitting up the call nodes that were in target positions (that is, for loop indices, rescue error captures, and multi assign targets). Previously, we would simply leave the call nodes in place. This had the benefit of keeping the AST relatively simple, but had the downside of not being very explicit. If a static analysis tool wanted to only look at call nodes, it could easily be confused because the method would have 1 fewer argument than it would actually be called with. This also brings some consistency to the AST. All of the nodes in a target position are now *TargetNode nodes. These should all be treated the same, and the call nodes can now be treated the same. Finally, there is benefit to memory. Because being in a target position ensures we don't have some fields, we can strip down the number of fields on these nodes. So this commit introduces two new nodes: CallTargetNode and IndexTargetNode. For CallTargetNode we get to drop the opening_loc, closing_loc, arguments, and block. Those can never be present. We also get to mark their fields as non-null, so they will always be seen as present. The IndexTargetNode keeps around most of its fields but gets to drop both the name (because it will always be []=) and the message_loc (which was always super confusing because it included the arguments by virtue of being inside the []). Overall, this adds complexity to the AST at the expense of memory savings and explicitness. I believe this tradeoff is worth it in this case, especially because these are very much not common nodes in the first place. https://github.com/ruby/prism/commit/3ef71cdb45
2023-12-08 17:57:31 +03:00
fields:
- name: receiver
type: node
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
kind: non-void expression
[ruby/prism] Split up CallNode in target position In this commit we're splitting up the call nodes that were in target positions (that is, for loop indices, rescue error captures, and multi assign targets). Previously, we would simply leave the call nodes in place. This had the benefit of keeping the AST relatively simple, but had the downside of not being very explicit. If a static analysis tool wanted to only look at call nodes, it could easily be confused because the method would have 1 fewer argument than it would actually be called with. This also brings some consistency to the AST. All of the nodes in a target position are now *TargetNode nodes. These should all be treated the same, and the call nodes can now be treated the same. Finally, there is benefit to memory. Because being in a target position ensures we don't have some fields, we can strip down the number of fields on these nodes. So this commit introduces two new nodes: CallTargetNode and IndexTargetNode. For CallTargetNode we get to drop the opening_loc, closing_loc, arguments, and block. Those can never be present. We also get to mark their fields as non-null, so they will always be seen as present. The IndexTargetNode keeps around most of its fields but gets to drop both the name (because it will always be []=) and the message_loc (which was always super confusing because it included the arguments by virtue of being inside the []). Overall, this adds complexity to the AST at the expense of memory savings and explicitness. I believe this tradeoff is worth it in this case, especially because these are very much not common nodes in the first place. https://github.com/ruby/prism/commit/3ef71cdb45
2023-12-08 17:57:31 +03:00
- name: call_operator_loc
type: location
- name: name
type: constant
- name: message_loc
type: location
comment: |
Represents assigning to a method call.
foo.bar, = 1
^^^^^^^
begin
rescue => foo.bar
^^^^^^^
end
for foo.bar in baz do end
^^^^^^^
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: CapturePatternNode
[ruby/yarp] Rename child_nodes to fields https://github.com/ruby/yarp/commit/715fce9264
2023-08-30 23:09:51 +03:00
fields:
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: value
type: node
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
kind: pattern expression
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: target
type: node
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
kind: LocalVariableTargetNode
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: operator_loc
type: location
comment: |
Represents assigning to a local variable in pattern matching.
foo => [bar => baz]
^^^^^^^^^^^^
[ruby/prism] Split up CaseNode and CaseMatchNode (https://github.com/ruby/prism/pull/1801) https://github.com/ruby/prism/commit/4c1391ea56
2023-11-21 05:38:03 +03:00
- name: CaseMatchNode
fields:
- name: predicate
type: node?
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
kind: non-void expression
[ruby/prism] Split up CaseNode and CaseMatchNode (https://github.com/ruby/prism/pull/1801) https://github.com/ruby/prism/commit/4c1391ea56
2023-11-21 05:38:03 +03:00
- name: conditions
type: node[]
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
kind: InNode
[PRISM] Field renaming Rename some fields that do not quite make sense. * CaseMatchNode#consequent -> CaseMatchNode#else_clause * CaseNode#consequent -> CaseNode#else_clause * IfNode#consequent -> IfNode#subsequent * RescueNode#consequent -> RescueNode#subsequent * UnlessNode#consequent -> UnlessNode#else_clause
2024-08-28 21:11:41 +03:00
- name: else_clause
[ruby/prism] Split up CaseNode and CaseMatchNode (https://github.com/ruby/prism/pull/1801) https://github.com/ruby/prism/commit/4c1391ea56
2023-11-21 05:38:03 +03:00
type: node?
kind: ElseNode
- name: case_keyword_loc
type: location
- name: end_keyword_loc
type: location
comment: |
Represents the use of a case statement for pattern matching.
case true
in false
end
^^^^^^^^^
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: CaseNode
[ruby/yarp] Rename child_nodes to fields https://github.com/ruby/yarp/commit/715fce9264
2023-08-30 23:09:51 +03:00
fields:
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: predicate
type: node?
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
kind: non-void expression
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: conditions
type: node[]
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
kind: WhenNode
[PRISM] Field renaming Rename some fields that do not quite make sense. * CaseMatchNode#consequent -> CaseMatchNode#else_clause * CaseNode#consequent -> CaseNode#else_clause * IfNode#consequent -> IfNode#subsequent * RescueNode#consequent -> RescueNode#subsequent * UnlessNode#consequent -> UnlessNode#else_clause
2024-08-28 21:11:41 +03:00
- name: else_clause
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
type: node?
kind: ElseNode
- name: case_keyword_loc
type: location
- name: end_keyword_loc
type: location
comment: |
Represents the use of a case statement.
[ruby/prism] Fix up Ruby docs https://github.com/ruby/prism/commit/8062849d0d
2023-10-30 20:01:35 +03:00
case true
when false
end
^^^^^^^^^^
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: ClassNode
[ruby/yarp] Rename child_nodes to fields https://github.com/ruby/yarp/commit/715fce9264
2023-08-30 23:09:51 +03:00
fields:
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: locals
type: constant[]
- name: class_keyword_loc
type: location
- name: constant_path
type: node
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
kind:
- ConstantReadNode
- ConstantPathNode
- on error: CallNode # class 0.X end
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: inheritance_operator_loc
type: location?
- name: superclass
type: node?
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
kind: non-void expression
[ruby/yarp] Rename statements to body where appropriate https://github.com/ruby/yarp/commit/0aa7d9d10c
2023-08-19 03:47:58 +03:00
- name: body
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
type: node?
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
kind:
- StatementsNode
- BeginNode
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: end_keyword_loc
type: location
[ruby/yarp] Add names to classes and modules This should hopefully make it easier to compile these nodes, and also for static analysis tools for having a quick label. https://github.com/ruby/yarp/commit/f086662144
2023-08-25 04:22:20 +03:00
- name: name
[ruby/yarp] Constants on classes and modules (https://github.com/ruby/yarp/pull/1409) https://github.com/ruby/yarp/commit/0a11ec579f
2023-09-06 19:19:38 +03:00
type: constant
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
comment: |
Represents a class declaration involving the `class` keyword.
class Foo end
^^^^^^^^^^^^^
[ruby/yarp] Split up AndWriteNode, OrWriteNode, OperatorWriteNode https://github.com/ruby/yarp/commit/6d3b3b5776
2023-08-25 17:49:00 +03:00
- name: ClassVariableAndWriteNode
[ruby/yarp] Rename child_nodes to fields https://github.com/ruby/yarp/commit/715fce9264
2023-08-30 23:09:51 +03:00
fields:
[ruby/yarp] Add class variables to the constant pool https://github.com/ruby/yarp/commit/be5cb60c83
2023-08-30 22:28:10 +03:00
- name: name
type: constant
[ruby/yarp] Split up AndWriteNode, OrWriteNode, OperatorWriteNode https://github.com/ruby/yarp/commit/6d3b3b5776
2023-08-25 17:49:00 +03:00
- name: name_loc
type: location
- name: operator_loc
type: location
- name: value
type: node
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
kind: non-void expression
[ruby/yarp] Split up AndWriteNode, OrWriteNode, OperatorWriteNode https://github.com/ruby/yarp/commit/6d3b3b5776
2023-08-25 17:49:00 +03:00
comment: |
Represents the use of the `&&=` operator for assignment to a class variable.
@@target &&= value
[ruby/prism] Fix up Ruby docs https://github.com/ruby/prism/commit/8062849d0d
2023-10-30 20:01:35 +03:00
^^^^^^^^^^^^^^^^^^
[ruby/yarp] Split up AndWriteNode, OrWriteNode, OperatorWriteNode https://github.com/ruby/yarp/commit/6d3b3b5776
2023-08-25 17:49:00 +03:00
- name: ClassVariableOperatorWriteNode
[ruby/yarp] Rename child_nodes to fields https://github.com/ruby/yarp/commit/715fce9264
2023-08-30 23:09:51 +03:00
fields:
[ruby/yarp] Add class variables to the constant pool https://github.com/ruby/yarp/commit/be5cb60c83
2023-08-30 22:28:10 +03:00
- name: name
type: constant
[ruby/yarp] Split up AndWriteNode, OrWriteNode, OperatorWriteNode https://github.com/ruby/yarp/commit/6d3b3b5776
2023-08-25 17:49:00 +03:00
- name: name_loc
type: location
[ruby/prism] operator rename https://github.com/ruby/prism/commit/b5e47f5c42
2024-05-10 17:19:11 +03:00
- name: binary_operator_loc
[ruby/yarp] Split up AndWriteNode, OrWriteNode, OperatorWriteNode https://github.com/ruby/yarp/commit/6d3b3b5776
2023-08-25 17:49:00 +03:00
type: location
- name: value
type: node
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
kind: non-void expression
[ruby/prism] operator rename https://github.com/ruby/prism/commit/b5e47f5c42
2024-05-10 17:19:11 +03:00
- name: binary_operator
[ruby/yarp] Split up AndWriteNode, OrWriteNode, OperatorWriteNode https://github.com/ruby/yarp/commit/6d3b3b5776
2023-08-25 17:49:00 +03:00
type: constant
comment: |
Represents assigning to a class variable using an operator that isn't `=`.
@@target += value
^^^^^^^^^^^^^^^^^
- name: ClassVariableOrWriteNode
[ruby/yarp] Rename child_nodes to fields https://github.com/ruby/yarp/commit/715fce9264
2023-08-30 23:09:51 +03:00
fields:
[ruby/yarp] Add class variables to the constant pool https://github.com/ruby/yarp/commit/be5cb60c83
2023-08-30 22:28:10 +03:00
- name: name
type: constant
[ruby/yarp] Split up AndWriteNode, OrWriteNode, OperatorWriteNode https://github.com/ruby/yarp/commit/6d3b3b5776
2023-08-25 17:49:00 +03:00
- name: name_loc
type: location
- name: operator_loc
type: location
- name: value
type: node
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
kind: non-void expression
[ruby/yarp] Split up AndWriteNode, OrWriteNode, OperatorWriteNode https://github.com/ruby/yarp/commit/6d3b3b5776
2023-08-25 17:49:00 +03:00
comment: |
Represents the use of the `||=` operator for assignment to a class variable.
@@target ||= value
^^^^^^^^^^^^^^^^^^
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: ClassVariableReadNode
[ruby/yarp] Fix up Rust config.yml reading https://github.com/ruby/yarp/commit/087f367847
2023-08-30 23:12:50 +03:00
fields:
[ruby/yarp] Add class variables to the constant pool https://github.com/ruby/yarp/commit/be5cb60c83
2023-08-30 22:28:10 +03:00
- name: name
type: constant
[ruby/prism] Document ClassVariableReadNode fields https://github.com/ruby/prism/commit/23ed81dd15
2024-01-08 23:03:47 +03:00
comment: |
[PRISM] Sync to latest
2024-01-19 19:22:40 +03:00
The name of the class variable, which is a `@@` followed by an [identifier](https://github.com/ruby/prism/blob/main/docs/parsing_rules.md#identifiers).
[ruby/prism] Document ClassVariableReadNode fields https://github.com/ruby/prism/commit/23ed81dd15
2024-01-08 23:03:47 +03:00
@@abc # name `:@@abc`
@@_test # name `:@@_test`
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
comment: |
Represents referencing a class variable.
@@foo
^^^^^
[ruby/yarp] Provide target node versions https://github.com/ruby/yarp/commit/a026564d38
2023-08-25 18:57:37 +03:00
- name: ClassVariableTargetNode
[ruby/yarp] Fix up Rust config.yml reading https://github.com/ruby/yarp/commit/087f367847
2023-08-30 23:12:50 +03:00
fields:
[ruby/yarp] Add class variables to the constant pool https://github.com/ruby/yarp/commit/be5cb60c83
2023-08-30 22:28:10 +03:00
- name: name
type: constant
[ruby/yarp] Provide target node versions https://github.com/ruby/yarp/commit/a026564d38
2023-08-25 18:57:37 +03:00
comment: |
Represents writing to a class variable in a context that doesn't have an explicit value.
@@foo, @@bar = baz
^^^^^ ^^^^^
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: ClassVariableWriteNode
[ruby/yarp] Rename child_nodes to fields https://github.com/ruby/yarp/commit/715fce9264
2023-08-30 23:09:51 +03:00
fields:
[ruby/yarp] Add class variables to the constant pool https://github.com/ruby/yarp/commit/be5cb60c83
2023-08-30 22:28:10 +03:00
- name: name
type: constant
[ruby/prism] Document `ClassVariableWriteNode` fields (https://github.com/ruby/prism/pull/2162) * Make ClassVariableWriteNode operator_loc non-nullable * Document ClassVariableWriteNode fields * Update config.yml --------- https://github.com/ruby/prism/commit/659b133888 Co-authored-by: Kevin Newton <kddnewton@gmail.com>
2024-03-11 22:45:54 +03:00
comment: |
The name of the class variable, which is a `@@` followed by an [identifier](https://github.com/ruby/prism/blob/main/docs/parsing_rules.md#identifiers).
@@abc = 123 # name `@@abc`
@@_test = :test # name `@@_test`
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: name_loc
type: location
[ruby/prism] Document `ClassVariableWriteNode` fields (https://github.com/ruby/prism/pull/2162) * Make ClassVariableWriteNode operator_loc non-nullable * Document ClassVariableWriteNode fields * Update config.yml --------- https://github.com/ruby/prism/commit/659b133888 Co-authored-by: Kevin Newton <kddnewton@gmail.com>
2024-03-11 22:45:54 +03:00
comment: |
The location of the variable name.
@@foo = :bar
^^^^^
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: value
[ruby/yarp] The value field of ClassVariableWriteNode is never null/nil https://github.com/ruby/yarp/commit/2ddd2eff94
2023-09-04 13:46:06 +03:00
type: node
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
kind: non-void expression
[ruby/prism] Document `ClassVariableWriteNode` fields (https://github.com/ruby/prism/pull/2162) * Make ClassVariableWriteNode operator_loc non-nullable * Document ClassVariableWriteNode fields * Update config.yml --------- https://github.com/ruby/prism/commit/659b133888 Co-authored-by: Kevin Newton <kddnewton@gmail.com>
2024-03-11 22:45:54 +03:00
comment: |
[PRISM] Sync latest config.yml documentation updates
2024-04-26 22:03:07 +03:00
The value to write to the class variable. This can be any [non-void expression](https://github.com/ruby/prism/blob/main/docs/parsing_rules.md#non-void-expression).
[ruby/prism] Document `ClassVariableWriteNode` fields (https://github.com/ruby/prism/pull/2162) * Make ClassVariableWriteNode operator_loc non-nullable * Document ClassVariableWriteNode fields * Update config.yml --------- https://github.com/ruby/prism/commit/659b133888 Co-authored-by: Kevin Newton <kddnewton@gmail.com>
2024-03-11 22:45:54 +03:00
@@foo = :bar
^^^^
@@_xyz = 123
^^^
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: operator_loc
[ruby/prism] Document `ClassVariableWriteNode` fields (https://github.com/ruby/prism/pull/2162) * Make ClassVariableWriteNode operator_loc non-nullable * Document ClassVariableWriteNode fields * Update config.yml --------- https://github.com/ruby/prism/commit/659b133888 Co-authored-by: Kevin Newton <kddnewton@gmail.com>
2024-03-11 22:45:54 +03:00
type: location
comment: |
The location of the `=` operator.
@@foo = :bar
^
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
comment: |
Represents writing to a class variable.
@@foo = 1
^^^^^^^^^
[ruby/yarp] Split up AndWriteNode, OrWriteNode, OperatorWriteNode https://github.com/ruby/yarp/commit/6d3b3b5776
2023-08-25 17:49:00 +03:00
- name: ConstantAndWriteNode
[ruby/yarp] Rename child_nodes to fields https://github.com/ruby/yarp/commit/715fce9264
2023-08-30 23:09:51 +03:00
fields:
[ruby/yarp] Add constants and constants https://github.com/ruby/yarp/commit/d7eaa89bc3
2023-09-05 20:53:37 +03:00
- name: name
type: constant
[ruby/yarp] Split up AndWriteNode, OrWriteNode, OperatorWriteNode https://github.com/ruby/yarp/commit/6d3b3b5776
2023-08-25 17:49:00 +03:00
- name: name_loc
type: location
- name: operator_loc
type: location
- name: value
type: node
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
kind: non-void expression
[ruby/yarp] Split up AndWriteNode, OrWriteNode, OperatorWriteNode https://github.com/ruby/yarp/commit/6d3b3b5776
2023-08-25 17:49:00 +03:00
comment: |
Represents the use of the `&&=` operator for assignment to a constant.
Target &&= value
^^^^^^^^^^^^^^^^
- name: ConstantOperatorWriteNode
[ruby/yarp] Rename child_nodes to fields https://github.com/ruby/yarp/commit/715fce9264
2023-08-30 23:09:51 +03:00
fields:
[ruby/yarp] Add constants and constants https://github.com/ruby/yarp/commit/d7eaa89bc3
2023-09-05 20:53:37 +03:00
- name: name
type: constant
[ruby/yarp] Split up AndWriteNode, OrWriteNode, OperatorWriteNode https://github.com/ruby/yarp/commit/6d3b3b5776
2023-08-25 17:49:00 +03:00
- name: name_loc
type: location
[ruby/prism] operator rename https://github.com/ruby/prism/commit/b5e47f5c42
2024-05-10 17:19:11 +03:00
- name: binary_operator_loc
[ruby/yarp] Split up AndWriteNode, OrWriteNode, OperatorWriteNode https://github.com/ruby/yarp/commit/6d3b3b5776
2023-08-25 17:49:00 +03:00
type: location
- name: value
type: node
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
kind: non-void expression
[ruby/prism] operator rename https://github.com/ruby/prism/commit/b5e47f5c42
2024-05-10 17:19:11 +03:00
- name: binary_operator
[ruby/yarp] Split up AndWriteNode, OrWriteNode, OperatorWriteNode https://github.com/ruby/yarp/commit/6d3b3b5776
2023-08-25 17:49:00 +03:00
type: constant
comment: |
Represents assigning to a constant using an operator that isn't `=`.
Target += value
^^^^^^^^^^^^^^^
- name: ConstantOrWriteNode
[ruby/yarp] Rename child_nodes to fields https://github.com/ruby/yarp/commit/715fce9264
2023-08-30 23:09:51 +03:00
fields:
[ruby/yarp] Add constants and constants https://github.com/ruby/yarp/commit/d7eaa89bc3
2023-09-05 20:53:37 +03:00
- name: name
type: constant
[ruby/yarp] Split up AndWriteNode, OrWriteNode, OperatorWriteNode https://github.com/ruby/yarp/commit/6d3b3b5776
2023-08-25 17:49:00 +03:00
- name: name_loc
type: location
- name: operator_loc
type: location
- name: value
type: node
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
kind: non-void expression
[ruby/yarp] Split up AndWriteNode, OrWriteNode, OperatorWriteNode https://github.com/ruby/yarp/commit/6d3b3b5776
2023-08-25 17:49:00 +03:00
comment: |
Represents the use of the `||=` operator for assignment to a constant.
Target ||= value
^^^^^^^^^^^^^^^^
- name: ConstantPathAndWriteNode
[ruby/yarp] Rename child_nodes to fields https://github.com/ruby/yarp/commit/715fce9264
2023-08-30 23:09:51 +03:00
fields:
[ruby/yarp] Split up AndWriteNode, OrWriteNode, OperatorWriteNode https://github.com/ruby/yarp/commit/6d3b3b5776
2023-08-25 17:49:00 +03:00
- name: target
type: node
kind: ConstantPathNode
- name: operator_loc
type: location
- name: value
type: node
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
kind: non-void expression
[ruby/yarp] Split up AndWriteNode, OrWriteNode, OperatorWriteNode https://github.com/ruby/yarp/commit/6d3b3b5776
2023-08-25 17:49:00 +03:00
comment: |
Represents the use of the `&&=` operator for assignment to a constant path.
Parent::Child &&= value
^^^^^^^^^^^^^^^^^^^^^^^
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: ConstantPathNode
[ruby/yarp] Rename child_nodes to fields https://github.com/ruby/yarp/commit/715fce9264
2023-08-30 23:09:51 +03:00
fields:
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: parent
type: node?
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
kind: non-void expression
[PRISM] Sync latest config.yml documentation updates
2024-04-26 22:03:07 +03:00
comment: |
The left-hand node of the path, if present. It can be `nil` or any [non-void expression](https://github.com/ruby/prism/blob/main/docs/parsing_rules.md#non-void-expression). It will be `nil` when the constant lookup is at the root of the module tree.
Foo::Bar
^^^
self::Test
^^^^
a.b::C
^^^
[ruby/prism] Change ConstantPathNode#child to ConstantPathNode#{name,name_loc} This has been requested for a long time, and I'm finally doing it now. Unfortunately this is a breaking change for all of the APIs. I've added in a Ruby method for `#child` that is deprecated so that existing usage doesn't break, but for everyone else this is going to be a bit of a pain. https://github.com/ruby/prism/commit/9cbe74464e
2024-05-03 16:35:32 +03:00
- name: name
type: constant?
comment: The name of the constant being accessed. This could be `nil` in the event of a syntax error.
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: delimiter_loc
type: location
[PRISM] Sync latest config.yml documentation updates
2024-04-26 22:03:07 +03:00
comment: |
The location of the `::` delimiter.
::Foo
^^
One::Two
^^
[ruby/prism] Change ConstantPathNode#child to ConstantPathNode#{name,name_loc} This has been requested for a long time, and I'm finally doing it now. Unfortunately this is a breaking change for all of the APIs. I've added in a Ruby method for `#child` that is deprecated so that existing usage doesn't break, but for everyone else this is going to be a bit of a pain. https://github.com/ruby/prism/commit/9cbe74464e
2024-05-03 16:35:32 +03:00
- name: name_loc
type: location
comment: |
The location of the name of the constant.
::Foo
^^^
One::Two
^^^
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
comment: |
Represents accessing a constant through a path of `::` operators.
Foo::Bar
^^^^^^^^
[ruby/yarp] Split up AndWriteNode, OrWriteNode, OperatorWriteNode https://github.com/ruby/yarp/commit/6d3b3b5776
2023-08-25 17:49:00 +03:00
- name: ConstantPathOperatorWriteNode
[ruby/yarp] Rename child_nodes to fields https://github.com/ruby/yarp/commit/715fce9264
2023-08-30 23:09:51 +03:00
fields:
[ruby/yarp] Split up AndWriteNode, OrWriteNode, OperatorWriteNode https://github.com/ruby/yarp/commit/6d3b3b5776
2023-08-25 17:49:00 +03:00
- name: target
type: node
kind: ConstantPathNode
[ruby/prism] operator rename https://github.com/ruby/prism/commit/b5e47f5c42
2024-05-10 17:19:11 +03:00
- name: binary_operator_loc
[ruby/yarp] Split up AndWriteNode, OrWriteNode, OperatorWriteNode https://github.com/ruby/yarp/commit/6d3b3b5776
2023-08-25 17:49:00 +03:00
type: location
- name: value
type: node
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
kind: non-void expression
[ruby/prism] operator rename https://github.com/ruby/prism/commit/b5e47f5c42
2024-05-10 17:19:11 +03:00
- name: binary_operator
[ruby/yarp] Split up AndWriteNode, OrWriteNode, OperatorWriteNode https://github.com/ruby/yarp/commit/6d3b3b5776
2023-08-25 17:49:00 +03:00
type: constant
comment: |
Represents assigning to a constant path using an operator that isn't `=`.
Parent::Child += value
^^^^^^^^^^^^^^^^^^^^^^
- name: ConstantPathOrWriteNode
[ruby/yarp] Rename child_nodes to fields https://github.com/ruby/yarp/commit/715fce9264
2023-08-30 23:09:51 +03:00
fields:
[ruby/yarp] Split up AndWriteNode, OrWriteNode, OperatorWriteNode https://github.com/ruby/yarp/commit/6d3b3b5776
2023-08-25 17:49:00 +03:00
- name: target
type: node
kind: ConstantPathNode
- name: operator_loc
type: location
- name: value
type: node
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
kind: non-void expression
[ruby/yarp] Split up AndWriteNode, OrWriteNode, OperatorWriteNode https://github.com/ruby/yarp/commit/6d3b3b5776
2023-08-25 17:49:00 +03:00
comment: |
Represents the use of the `||=` operator for assignment to a constant path.
Parent::Child ||= value
^^^^^^^^^^^^^^^^^^^^^^^
[ruby/yarp] Provide target node versions https://github.com/ruby/yarp/commit/a026564d38
2023-08-25 18:57:37 +03:00
- name: ConstantPathTargetNode
[ruby/yarp] Rename child_nodes to fields https://github.com/ruby/yarp/commit/715fce9264
2023-08-30 23:09:51 +03:00
fields:
[ruby/yarp] Provide target node versions https://github.com/ruby/yarp/commit/a026564d38
2023-08-25 18:57:37 +03:00
- name: parent
type: node?
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
kind: non-void expression
[ruby/prism] Change ConstantPathNode#child to ConstantPathNode#{name,name_loc} This has been requested for a long time, and I'm finally doing it now. Unfortunately this is a breaking change for all of the APIs. I've added in a Ruby method for `#child` that is deprecated so that existing usage doesn't break, but for everyone else this is going to be a bit of a pain. https://github.com/ruby/prism/commit/9cbe74464e
2024-05-03 16:35:32 +03:00
- name: name
type: constant?
[ruby/yarp] Provide target node versions https://github.com/ruby/yarp/commit/a026564d38
2023-08-25 18:57:37 +03:00
- name: delimiter_loc
type: location
[ruby/prism] Change ConstantPathNode#child to ConstantPathNode#{name,name_loc} This has been requested for a long time, and I'm finally doing it now. Unfortunately this is a breaking change for all of the APIs. I've added in a Ruby method for `#child` that is deprecated so that existing usage doesn't break, but for everyone else this is going to be a bit of a pain. https://github.com/ruby/prism/commit/9cbe74464e
2024-05-03 16:35:32 +03:00
- name: name_loc
type: location
[ruby/yarp] Provide target node versions https://github.com/ruby/yarp/commit/a026564d38
2023-08-25 18:57:37 +03:00
comment: |
Represents writing to a constant path in a context that doesn't have an explicit value.
Foo::Foo, Bar::Bar = baz
^^^^^^^^ ^^^^^^^^
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: ConstantPathWriteNode
[ruby/yarp] Rename child_nodes to fields https://github.com/ruby/yarp/commit/715fce9264
2023-08-30 23:09:51 +03:00
fields:
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: target
type: node
kind: ConstantPathNode
[PRISM] Sync latest config.yml documentation updates
2024-04-26 22:03:07 +03:00
comment: |
A node representing the constant path being written to.
Foo::Bar = 1
^^^^^^^^
::Foo = :abc
^^^^^
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: operator_loc
[ruby/yarp] Mark local variable targets in pattern matching https://github.com/ruby/yarp/commit/6c6700a001
2023-08-25 20:03:16 +03:00
type: location
[PRISM] Sync latest config.yml documentation updates
2024-04-26 22:03:07 +03:00
comment: |
The location of the `=` operator.
::ABC = 123
^
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: value
[ruby/yarp] Mark local variable targets in pattern matching https://github.com/ruby/yarp/commit/6c6700a001
2023-08-25 20:03:16 +03:00
type: node
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
kind: non-void expression
[PRISM] Sync latest config.yml documentation updates
2024-04-26 22:03:07 +03:00
comment: |
The value to write to the constant path. It can be any [non-void expression](https://github.com/ruby/prism/blob/main/docs/parsing_rules.md#non-void-expression).
FOO::BAR = :abc
^^^^
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
comment: |
Represents writing to a constant path.
::Foo = 1
^^^^^^^^^
Foo::Bar = 1
^^^^^^^^^^^^
::Foo::Bar = 1
^^^^^^^^^^^^^^
- name: ConstantReadNode
[ruby/yarp] Add constants and constants https://github.com/ruby/yarp/commit/d7eaa89bc3
2023-09-05 20:53:37 +03:00
fields:
- name: name
type: constant
[ruby/prism] Document ConstantReadNode fields https://github.com/ruby/prism/commit/a1623f6451
2024-01-09 00:07:01 +03:00
comment: |
[ruby/prism] Parsing rules document https://github.com/ruby/prism/commit/57a9575543
2024-01-19 19:12:12 +03:00
The name of the [constant](https://github.com/ruby/prism/blob/main/docs/parsing_rules.md#constants).
[ruby/prism] Document ConstantReadNode fields https://github.com/ruby/prism/commit/a1623f6451
2024-01-09 00:07:01 +03:00
X # name `:X`
SOME_CONSTANT # name `:SOME_CONSTANT`
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
comment: |
Represents referencing a constant.
Foo
^^^
[ruby/yarp] Provide target node versions https://github.com/ruby/yarp/commit/a026564d38
2023-08-25 18:57:37 +03:00
- name: ConstantTargetNode
[ruby/yarp] Add constants and constants https://github.com/ruby/yarp/commit/d7eaa89bc3
2023-09-05 20:53:37 +03:00
fields:
- name: name
type: constant
[ruby/yarp] Provide target node versions https://github.com/ruby/yarp/commit/a026564d38
2023-08-25 18:57:37 +03:00
comment: |
[PRISM] Sync to latest
2024-01-19 19:22:40 +03:00
Represents writing to a constant in a context that doesn't have an explicit value.
[ruby/yarp] Provide target node versions https://github.com/ruby/yarp/commit/a026564d38
2023-08-25 18:57:37 +03:00
Foo, Bar = baz
^^^ ^^^
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: ConstantWriteNode
[ruby/yarp] Rename child_nodes to fields https://github.com/ruby/yarp/commit/715fce9264
2023-08-30 23:09:51 +03:00
fields:
[ruby/yarp] Add constants and constants https://github.com/ruby/yarp/commit/d7eaa89bc3
2023-09-05 20:53:37 +03:00
- name: name
type: constant
[PRISM] Sync latest config.yml documentation updates
2024-04-26 22:03:07 +03:00
comment: |
The name of the [constant](https://github.com/ruby/prism/blob/main/docs/parsing_rules.md#constants).
Foo = :bar # name `:Foo`
XYZ = 1 # name `:XYZ`
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: name_loc
type: location
[PRISM] Sync latest config.yml documentation updates
2024-04-26 22:03:07 +03:00
comment: |
The location of the constant name.
FOO = 1
^^^
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: value
[ruby/yarp] Mark local variable targets in pattern matching https://github.com/ruby/yarp/commit/6c6700a001
2023-08-25 20:03:16 +03:00
type: node
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
kind: non-void expression
[PRISM] Sync latest config.yml documentation updates
2024-04-26 22:03:07 +03:00
comment: |
The value to write to the constant. It can be any [non-void expression](https://github.com/ruby/prism/blob/main/docs/parsing_rules.md#non-void-expression).
FOO = :bar
^^^^
MyClass = Class.new
^^^^^^^^^
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: operator_loc
[ruby/yarp] Mark local variable targets in pattern matching https://github.com/ruby/yarp/commit/6c6700a001
2023-08-25 20:03:16 +03:00
type: location
[PRISM] Sync latest config.yml documentation updates
2024-04-26 22:03:07 +03:00
comment: |
The location of the `=` operator.
FOO = :bar
^
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
comment: |
Represents writing to a constant.
Foo = 1
^^^^^^^
- name: DefNode
[ruby/yarp] Rename child_nodes to fields https://github.com/ruby/yarp/commit/715fce9264
2023-08-30 23:09:51 +03:00
fields:
[ruby/yarp] Constants and def nodes https://github.com/ruby/yarp/commit/6b2421ce1b
2023-09-06 18:27:00 +03:00
- name: name
type: constant
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: name_loc
type: location
- name: receiver
type: node?
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
kind: non-void expression
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: parameters
type: node?
kind: ParametersNode
[ruby/yarp] Rename statements to body where appropriate https://github.com/ruby/yarp/commit/0aa7d9d10c
2023-08-19 03:47:58 +03:00
- name: body
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
type: node?
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
kind:
- StatementsNode
- BeginNode
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: locals
type: constant[]
- name: def_keyword_loc
type: location
- name: operator_loc
type: location?
- name: lparen_loc
type: location?
- name: rparen_loc
type: location?
- name: equal_loc
type: location?
- name: end_keyword_loc
type: location?
comment: |
Represents a method definition.
def method
end
^^^^^^^^^^
- name: DefinedNode
[ruby/yarp] Rename child_nodes to fields https://github.com/ruby/yarp/commit/715fce9264
2023-08-30 23:09:51 +03:00
fields:
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: lparen_loc
type: location?
- name: value
type: node
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
kind: Node # More than non-void expression as defined?(return) is allowed, yet defined?(BEGIN{}) is SyntaxError
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: rparen_loc
type: location?
- name: keyword_loc
type: location
comment: |
Represents the use of the `defined?` keyword.
defined?(a)
^^^^^^^^^^^
- name: ElseNode
[ruby/yarp] Rename child_nodes to fields https://github.com/ruby/yarp/commit/715fce9264
2023-08-30 23:09:51 +03:00
fields:
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: else_keyword_loc
type: location
- name: statements
type: node?
kind: StatementsNode
- name: end_keyword_loc
type: location?
comment: |
Represents an `else` clause in a `case`, `if`, or `unless` statement.
if a then b else c end
^^^^^^^^^^
- name: EmbeddedStatementsNode
[ruby/yarp] Rename child_nodes to fields https://github.com/ruby/yarp/commit/715fce9264
2023-08-30 23:09:51 +03:00
fields:
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: opening_loc
type: location
- name: statements
type: node?
kind: StatementsNode
- name: closing_loc
type: location
comment: |
Represents an interpolated set of statements.
"foo #{bar}"
^^^^^^
- name: EmbeddedVariableNode
[ruby/yarp] Rename child_nodes to fields https://github.com/ruby/yarp/commit/715fce9264
2023-08-30 23:09:51 +03:00
fields:
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: operator_loc
type: location
- name: variable
type: node
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
kind:
- InstanceVariableReadNode
- ClassVariableReadNode
- GlobalVariableReadNode
- BackReferenceReadNode
- NumberedReferenceReadNode
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
comment: |
Represents an interpolated variable.
"foo #@bar"
^^^^^
- name: EnsureNode
[ruby/yarp] Rename child_nodes to fields https://github.com/ruby/yarp/commit/715fce9264
2023-08-30 23:09:51 +03:00
fields:
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: ensure_keyword_loc
type: location
- name: statements
type: node?
kind: StatementsNode
- name: end_keyword_loc
type: location
comment: |
Represents an `ensure` clause in a `begin` statement.
begin
foo
ensure
^^^^^^
bar
end
- name: FalseNode
comment: |
Represents the use of the literal `false` keyword.
false
^^^^^
- name: FindPatternNode
[ruby/yarp] Rename child_nodes to fields https://github.com/ruby/yarp/commit/715fce9264
2023-08-30 23:09:51 +03:00
fields:
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: constant
type: node?
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
kind:
- ConstantReadNode
- ConstantPathNode
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: left
type: node
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
kind: SplatNode
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: requireds
type: node[]
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
kind: pattern expression
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: right
type: node
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
kind:
- SplatNode
- on error: MissingNode
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: opening_loc
type: location?
- name: closing_loc
type: location?
comment: |
Represents a find pattern in pattern matching.
foo in *bar, baz, *qux
[ruby/prism] Fix up Ruby docs https://github.com/ruby/prism/commit/8062849d0d
2023-10-30 20:01:35 +03:00
^^^^^^^^^^^^^^^
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
foo in [*bar, baz, *qux]
[ruby/prism] Fix up Ruby docs https://github.com/ruby/prism/commit/8062849d0d
2023-10-30 20:01:35 +03:00
^^^^^^^^^^^^^^^^^
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
foo in Foo(*bar, baz, *qux)
[ruby/prism] Fix up Ruby docs https://github.com/ruby/prism/commit/8062849d0d
2023-10-30 20:01:35 +03:00
^^^^^^^^^^^^^^^^^^^^
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: FlipFlopNode
[ruby/prism] Expose flags on every node type https://github.com/ruby/prism/commit/9f12a56fd6
2024-07-02 22:43:01 +03:00
flags: RangeFlags
[ruby/yarp] Rename child_nodes to fields https://github.com/ruby/yarp/commit/715fce9264
2023-08-30 23:09:51 +03:00
fields:
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: left
type: node?
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
kind: non-void expression
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: right
type: node?
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
kind: non-void expression
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: operator_loc
type: location
comment: |
Represents the use of the `..` or `...` operators to create flip flops.
baz if foo .. bar
^^^^^^^^^^
- name: FloatNode
[ruby/prism] Parse float values https://github.com/ruby/prism/commit/9137226a52
2024-02-22 23:53:28 +03:00
fields:
- name: value
type: double
comment: The value of the floating point number as a Float.
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
comment: |
Represents a floating point number literal.
1.0
^^^
- name: ForNode
[ruby/yarp] Rename child_nodes to fields https://github.com/ruby/yarp/commit/715fce9264
2023-08-30 23:09:51 +03:00
fields:
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: index
type: node
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
kind:
- LocalVariableTargetNode
- InstanceVariableTargetNode
- ClassVariableTargetNode
- GlobalVariableTargetNode
- ConstantTargetNode
- ConstantPathTargetNode
- CallTargetNode
- IndexTargetNode
- MultiTargetNode
- on error: BackReferenceReadNode # for $& in a end
- on error: NumberedReferenceReadNode # for $1 in a end
- on error: MissingNode # for in 1..10; end
[ruby/prism] Document `ForNode` fields (https://github.com/ruby/prism/pull/2845) * Add document * fix * fix fmt * fix fmt * Revert "fix fmt" This reverts commit https://github.com/ruby/prism/commit/b23a05a94148. * add potition * fix fmt * reposition * fix indent * fix comment * fix indent https://github.com/ruby/prism/commit/0dd4c1bba1
2024-05-29 16:36:06 +03:00
comment: |
The index expression for `for` loops.
for i in a end
^
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: collection
type: node
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
kind: non-void expression
[ruby/prism] Document `ForNode` fields (https://github.com/ruby/prism/pull/2845) * Add document * fix * fix fmt * fix fmt * Revert "fix fmt" This reverts commit https://github.com/ruby/prism/commit/b23a05a94148. * add potition * fix fmt * reposition * fix indent * fix comment * fix indent https://github.com/ruby/prism/commit/0dd4c1bba1
2024-05-29 16:36:06 +03:00
comment: |
The collection to iterate over.
for i in a end
^
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: statements
type: node?
kind: StatementsNode
[ruby/prism] Document `ForNode` fields (https://github.com/ruby/prism/pull/2845) * Add document * fix * fix fmt * fix fmt * Revert "fix fmt" This reverts commit https://github.com/ruby/prism/commit/b23a05a94148. * add potition * fix fmt * reposition * fix indent * fix comment * fix indent https://github.com/ruby/prism/commit/0dd4c1bba1
2024-05-29 16:36:06 +03:00
comment: |
Represents the body of statements to execute for each iteration of the loop.
for i in a
foo(i)
^^^^^^
end
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: for_keyword_loc
type: location
[ruby/prism] Document `ForNode` fields (https://github.com/ruby/prism/pull/2845) * Add document * fix * fix fmt * fix fmt * Revert "fix fmt" This reverts commit https://github.com/ruby/prism/commit/b23a05a94148. * add potition * fix fmt * reposition * fix indent * fix comment * fix indent https://github.com/ruby/prism/commit/0dd4c1bba1
2024-05-29 16:36:06 +03:00
comment: |
The location of the `for` keyword.
for i in a end
^^^
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: in_keyword_loc
type: location
[ruby/prism] Document `ForNode` fields (https://github.com/ruby/prism/pull/2845) * Add document * fix * fix fmt * fix fmt * Revert "fix fmt" This reverts commit https://github.com/ruby/prism/commit/b23a05a94148. * add potition * fix fmt * reposition * fix indent * fix comment * fix indent https://github.com/ruby/prism/commit/0dd4c1bba1
2024-05-29 16:36:06 +03:00
comment: |
The location of the `in` keyword.
for i in a end
^^
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: do_keyword_loc
type: location?
[ruby/prism] Document `ForNode` fields (https://github.com/ruby/prism/pull/2845) * Add document * fix * fix fmt * fix fmt * Revert "fix fmt" This reverts commit https://github.com/ruby/prism/commit/b23a05a94148. * add potition * fix fmt * reposition * fix indent * fix comment * fix indent https://github.com/ruby/prism/commit/0dd4c1bba1
2024-05-29 16:36:06 +03:00
comment: |
The location of the `do` keyword, if present.
for i in a do end
^^
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: end_keyword_loc
type: location
[ruby/prism] Document `ForNode` fields (https://github.com/ruby/prism/pull/2845) * Add document * fix * fix fmt * fix fmt * Revert "fix fmt" This reverts commit https://github.com/ruby/prism/commit/b23a05a94148. * add potition * fix fmt * reposition * fix indent * fix comment * fix indent https://github.com/ruby/prism/commit/0dd4c1bba1
2024-05-29 16:36:06 +03:00
comment: |
The location of the `end` keyword.
for i in a end
^^^
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
comment: |
Represents the use of the `for` keyword.
for i in a end
^^^^^^^^^^^^^^
- name: ForwardingArgumentsNode
comment: |
Represents forwarding all arguments to this method to another method.
def foo(...)
bar(...)
[ruby/prism] Fix up Ruby docs https://github.com/ruby/prism/commit/8062849d0d
2023-10-30 20:01:35 +03:00
^^^
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
end
- name: ForwardingParameterNode
comment: |
Represents the use of the forwarding parameter in a method, block, or lambda declaration.
def foo(...)
^^^
end
- name: ForwardingSuperNode
[ruby/yarp] Rename child_nodes to fields https://github.com/ruby/yarp/commit/715fce9264
2023-08-30 23:09:51 +03:00
fields:
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: block
type: node?
kind: BlockNode
comment: |
Represents the use of the `super` keyword without parentheses or arguments.
super
^^^^^
[ruby/yarp] Split up AndWriteNode, OrWriteNode, OperatorWriteNode https://github.com/ruby/yarp/commit/6d3b3b5776
2023-08-25 17:49:00 +03:00
- name: GlobalVariableAndWriteNode
[ruby/yarp] Rename child_nodes to fields https://github.com/ruby/yarp/commit/715fce9264
2023-08-30 23:09:51 +03:00
fields:
[ruby/yarp] Add global variables to the constant pool https://github.com/ruby/yarp/commit/b48067b067
2023-09-01 16:40:08 +03:00
- name: name
type: constant
[ruby/yarp] Split up AndWriteNode, OrWriteNode, OperatorWriteNode https://github.com/ruby/yarp/commit/6d3b3b5776
2023-08-25 17:49:00 +03:00
- name: name_loc
type: location
- name: operator_loc
type: location
- name: value
type: node
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
kind: non-void expression
[ruby/yarp] Split up AndWriteNode, OrWriteNode, OperatorWriteNode https://github.com/ruby/yarp/commit/6d3b3b5776
2023-08-25 17:49:00 +03:00
comment: |
Represents the use of the `&&=` operator for assignment to a global variable.
$target &&= value
^^^^^^^^^^^^^^^^^
- name: GlobalVariableOperatorWriteNode
[ruby/yarp] Rename child_nodes to fields https://github.com/ruby/yarp/commit/715fce9264
2023-08-30 23:09:51 +03:00
fields:
[ruby/yarp] Add global variables to the constant pool https://github.com/ruby/yarp/commit/b48067b067
2023-09-01 16:40:08 +03:00
- name: name
type: constant
[ruby/yarp] Split up AndWriteNode, OrWriteNode, OperatorWriteNode https://github.com/ruby/yarp/commit/6d3b3b5776
2023-08-25 17:49:00 +03:00
- name: name_loc
type: location
[ruby/prism] operator rename https://github.com/ruby/prism/commit/b5e47f5c42
2024-05-10 17:19:11 +03:00
- name: binary_operator_loc
[ruby/yarp] Split up AndWriteNode, OrWriteNode, OperatorWriteNode https://github.com/ruby/yarp/commit/6d3b3b5776
2023-08-25 17:49:00 +03:00
type: location
- name: value
type: node
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
kind: non-void expression
[ruby/prism] operator rename https://github.com/ruby/prism/commit/b5e47f5c42
2024-05-10 17:19:11 +03:00
- name: binary_operator
[ruby/yarp] Split up AndWriteNode, OrWriteNode, OperatorWriteNode https://github.com/ruby/yarp/commit/6d3b3b5776
2023-08-25 17:49:00 +03:00
type: constant
comment: |
Represents assigning to a global variable using an operator that isn't `=`.
$target += value
^^^^^^^^^^^^^^^^
- name: GlobalVariableOrWriteNode
[ruby/yarp] Rename child_nodes to fields https://github.com/ruby/yarp/commit/715fce9264
2023-08-30 23:09:51 +03:00
fields:
[ruby/yarp] Add global variables to the constant pool https://github.com/ruby/yarp/commit/b48067b067
2023-09-01 16:40:08 +03:00
- name: name
type: constant
[ruby/yarp] Split up AndWriteNode, OrWriteNode, OperatorWriteNode https://github.com/ruby/yarp/commit/6d3b3b5776
2023-08-25 17:49:00 +03:00
- name: name_loc
type: location
- name: operator_loc
type: location
- name: value
type: node
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
kind: non-void expression
[ruby/yarp] Split up AndWriteNode, OrWriteNode, OperatorWriteNode https://github.com/ruby/yarp/commit/6d3b3b5776
2023-08-25 17:49:00 +03:00
comment: |
Represents the use of the `||=` operator for assignment to a global variable.
$target ||= value
^^^^^^^^^^^^^^^^^
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: GlobalVariableReadNode
[ruby/yarp] Add global variables to the constant pool https://github.com/ruby/yarp/commit/b48067b067
2023-09-01 16:40:08 +03:00
fields:
- name: name
type: constant
[ruby/prism] Document GlobalVariableReadNode fields https://github.com/ruby/prism/commit/5d092e6389
2024-01-08 23:20:56 +03:00
comment: |
[PRISM] Sync to latest
2024-01-19 19:22:40 +03:00
The name of the global variable, which is a `$` followed by an [identifier](https://github.com/ruby/prism/blob/main/docs/parsing_rules.md#identifier). Alternatively, it can be one of the special global variables designated by a symbol.
[ruby/prism] Document GlobalVariableReadNode fields https://github.com/ruby/prism/commit/5d092e6389
2024-01-08 23:20:56 +03:00
$foo # name `:$foo`
$_Test # name `:$_Test`
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
comment: |
Represents referencing a global variable.
$foo
^^^^
[ruby/yarp] Provide target node versions https://github.com/ruby/yarp/commit/a026564d38
2023-08-25 18:57:37 +03:00
- name: GlobalVariableTargetNode
[ruby/yarp] Add global variables to the constant pool https://github.com/ruby/yarp/commit/b48067b067
2023-09-01 16:40:08 +03:00
fields:
- name: name
type: constant
[ruby/yarp] Provide target node versions https://github.com/ruby/yarp/commit/a026564d38
2023-08-25 18:57:37 +03:00
comment: |
Represents writing to a global variable in a context that doesn't have an explicit value.
$foo, $bar = baz
^^^^ ^^^^
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: GlobalVariableWriteNode
[ruby/yarp] Rename child_nodes to fields https://github.com/ruby/yarp/commit/715fce9264
2023-08-30 23:09:51 +03:00
fields:
[ruby/yarp] Add global variables to the constant pool https://github.com/ruby/yarp/commit/b48067b067
2023-09-01 16:40:08 +03:00
- name: name
type: constant
[PRISM] Sync latest config.yml documentation updates
2024-04-26 22:03:07 +03:00
comment: |
The name of the global variable, which is a `$` followed by an [identifier](https://github.com/ruby/prism/blob/main/docs/parsing_rules.md#identifier). Alternatively, it can be one of the special global variables designated by a symbol.
$foo = :bar # name `:$foo`
$_Test = 123 # name `:$_Test`
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: name_loc
type: location
[PRISM] Sync latest config.yml documentation updates
2024-04-26 22:03:07 +03:00
comment: |
The location of the global variable's name.
$foo = :bar
^^^^
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: value
[ruby/yarp] Mark local variable targets in pattern matching https://github.com/ruby/yarp/commit/6c6700a001
2023-08-25 20:03:16 +03:00
type: node
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
kind: non-void expression
[PRISM] Sync latest config.yml documentation updates
2024-04-26 22:03:07 +03:00
comment: |
The value to write to the global variable. It can be any [non-void expression](https://github.com/ruby/prism/blob/main/docs/parsing_rules.md#non-void-expression).
$foo = :bar
^^^^
$-xyz = 123
^^^
[ruby/yarp] Make operator_loc the last field for GlobalVariableWriteNode * Consistent with ClassVariableWriteNode, ConstantWriteNode, InstanceVariableWriteNode, LocalVariableWriteNode. * Fixes desugaring of global variable with operators. https://github.com/ruby/yarp/commit/fb5a53fc0b
2023-08-30 23:43:40 +03:00
- name: operator_loc
type: location
[PRISM] Sync latest config.yml documentation updates
2024-04-26 22:03:07 +03:00
comment: |
The location of the `=` operator.
$foo = :bar
^
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
comment: |
Represents writing to a global variable.
$foo = 1
^^^^^^^^
- name: HashNode
[ruby/yarp] Rename child_nodes to fields https://github.com/ruby/yarp/commit/715fce9264
2023-08-30 23:09:51 +03:00
fields:
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: opening_loc
type: location
[ruby/prism] Add comments for HashNode fields https://github.com/ruby/prism/commit/649e209519
2024-01-07 12:26:21 +03:00
comment: |
The location of the opening brace.
{ a => b }
^
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: elements
type: node[]
[ruby/prism] Give a kind to all node[] fields which can have one more specific than "any Node" * Fixes https://github.com/ruby/prism/issues/2058 https://github.com/ruby/prism/commit/f3e3310b5e
2024-02-25 15:04:42 +03:00
kind:
- AssocNode
- AssocSplatNode
[ruby/prism] Add comments for HashNode fields https://github.com/ruby/prism/commit/649e209519
2024-01-07 12:26:21 +03:00
comment: |
The elements of the hash. These can be either `AssocNode`s or `AssocSplatNode`s.
{ a: b }
^^^^
{ **foo }
^^^^^
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: closing_loc
type: location
[ruby/prism] Add comments for HashNode fields https://github.com/ruby/prism/commit/649e209519
2024-01-07 12:26:21 +03:00
comment: |
The location of the closing brace.
{ a => b }
^
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
comment: |
Represents a hash literal.
{ a => b }
^^^^^^^^^^
- name: HashPatternNode
[ruby/yarp] Rename child_nodes to fields https://github.com/ruby/yarp/commit/715fce9264
2023-08-30 23:09:51 +03:00
fields:
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: constant
type: node?
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
kind:
- ConstantReadNode
- ConstantPathNode
[ruby/prism] Fix parsing lone assoc splat within hash patterns https://github.com/ruby/prism/commit/1da5e05672
2023-10-23 17:42:55 +03:00
- name: elements
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
type: node[]
[ruby/prism] Split private types https://github.com/ruby/prism/commit/0209d093ec
2024-01-08 21:31:37 +03:00
kind: AssocNode
[ruby/prism] Fix parsing lone assoc splat within hash patterns https://github.com/ruby/prism/commit/1da5e05672
2023-10-23 17:42:55 +03:00
- name: rest
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
type: node?
[ruby/prism] Split private types https://github.com/ruby/prism/commit/0209d093ec
2024-01-08 21:31:37 +03:00
kind:
- AssocSplatNode
- NoKeywordsParameterNode
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: opening_loc
type: location?
- name: closing_loc
type: location?
comment: |
Represents a hash pattern in pattern matching.
foo => { a: 1, b: 2 }
^^^^^^^^^^^^^^
foo => { a: 1, b: 2, **c }
^^^^^^^^^^^^^^^^^^^
- name: IfNode
[ruby/yarp] Rename child_nodes to fields https://github.com/ruby/yarp/commit/715fce9264
2023-08-30 23:09:51 +03:00
fields:
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: if_keyword_loc
type: location?
[ruby/prism] Document `IfNode` fields - Adds documentation for the fields of the `IfNode`. Also updates the overall description to mention ternary expressions. - Part of #2123 https://github.com/ruby/prism/commit/fd17c0733d
2024-01-15 02:40:32 +03:00
comment: |
The location of the `if` keyword if present.
bar if foo
^^
The `if_keyword_loc` field will be `nil` when the `IfNode` represents a ternary expression.
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: predicate
type: node
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
kind: non-void expression
[ruby/prism] Document `IfNode` fields - Adds documentation for the fields of the `IfNode`. Also updates the overall description to mention ternary expressions. - Part of #2123 https://github.com/ruby/prism/commit/fd17c0733d
2024-01-15 02:40:32 +03:00
comment: |
The node for the condition the `IfNode` is testing.
if foo
^^^
bar
end
bar if foo
^^^
foo ? bar : baz
^^^
[ruby/prism] Track the then keyword for conditionals https://github.com/ruby/prism/commit/fef0019a25
2023-11-16 01:55:16 +03:00
- name: then_keyword_loc
type: location?
[ruby/prism] Document `IfNode` fields - Adds documentation for the fields of the `IfNode`. Also updates the overall description to mention ternary expressions. - Part of #2123 https://github.com/ruby/prism/commit/fd17c0733d
2024-01-15 02:40:32 +03:00
comment: |
The location of the `then` keyword (if present) or the `?` in a ternary expression, `nil` otherwise.
if foo then bar end
^^^^
a ? b : c
^
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: statements
type: node?
kind: StatementsNode
[ruby/prism] Document `IfNode` fields - Adds documentation for the fields of the `IfNode`. Also updates the overall description to mention ternary expressions. - Part of #2123 https://github.com/ruby/prism/commit/fd17c0733d
2024-01-15 02:40:32 +03:00
comment: |
Represents the body of statements that will be executed when the predicate is evaluated as truthy. Will be `nil` when no body is provided.
if foo
bar
^^^
baz
^^^
end
[PRISM] Field renaming Rename some fields that do not quite make sense. * CaseMatchNode#consequent -> CaseMatchNode#else_clause * CaseNode#consequent -> CaseNode#else_clause * IfNode#consequent -> IfNode#subsequent * RescueNode#consequent -> RescueNode#subsequent * UnlessNode#consequent -> UnlessNode#else_clause
2024-08-28 21:11:41 +03:00
- name: subsequent
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
type: node?
[ruby/prism] Review config.yml: documentation, types and field names https://github.com/ruby/prism/commit/d43333539e
2024-07-25 23:49:42 +03:00
kind:
- ElseNode
- IfNode
[ruby/prism] Document `IfNode` fields - Adds documentation for the fields of the `IfNode`. Also updates the overall description to mention ternary expressions. - Part of #2123 https://github.com/ruby/prism/commit/fd17c0733d
2024-01-15 02:40:32 +03:00
comment: |
Represents an `ElseNode` or an `IfNode` when there is an `else` or an `elsif` in the `if` statement.
if foo
bar
elsif baz
^^^^^^^^^
qux
^^^
end
^^^
if foo then bar else baz end
^^^^^^^^^^^^
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: end_keyword_loc
type: location?
[ruby/prism] Document `IfNode` fields - Adds documentation for the fields of the `IfNode`. Also updates the overall description to mention ternary expressions. - Part of #2123 https://github.com/ruby/prism/commit/fd17c0733d
2024-01-15 02:40:32 +03:00
comment: |
The location of the `end` keyword if present, `nil` otherwise.
if foo
bar
end
^^^
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
newline: predicate
comment: |
[ruby/prism] Document `IfNode` fields - Adds documentation for the fields of the `IfNode`. Also updates the overall description to mention ternary expressions. - Part of #2123 https://github.com/ruby/prism/commit/fd17c0733d
2024-01-15 02:40:32 +03:00
Represents the use of the `if` keyword, either in the block form or the modifier form, or a ternary expression.
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
bar if foo
^^^^^^^^^^
if foo then bar end
^^^^^^^^^^^^^^^^^^^
[ruby/prism] Document `IfNode` fields - Adds documentation for the fields of the `IfNode`. Also updates the overall description to mention ternary expressions. - Part of #2123 https://github.com/ruby/prism/commit/fd17c0733d
2024-01-15 02:40:32 +03:00
foo ? bar : baz
^^^^^^^^^^^^^^^
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: ImaginaryNode
[ruby/yarp] Rename child_nodes to fields https://github.com/ruby/yarp/commit/715fce9264
2023-08-30 23:09:51 +03:00
fields:
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: numeric
type: node
[ruby/prism] wip: node unions https://github.com/ruby/prism/commit/99a71675d4
2023-12-21 07:41:52 +03:00
kind:
- FloatNode
- IntegerNode
- RationalNode
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
comment: |
Represents an imaginary number literal.
1.0i
^^^^
[ruby/yarp] Add implicit nodes for ommitted hash values https://github.com/ruby/yarp/commit/22130b3491
2023-09-13 16:39:20 +03:00
- name: ImplicitNode
fields:
- name: value
type: node
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
kind:
- LocalVariableReadNode
- CallNode
- ConstantReadNode
- LocalVariableTargetNode
[ruby/yarp] Add implicit nodes for ommitted hash values https://github.com/ruby/yarp/commit/22130b3491
2023-09-13 16:39:20 +03:00
comment: |
[PRISM] Sync to latest
2024-01-19 19:22:40 +03:00
Represents a node that is implicitly being added to the tree but doesn't correspond directly to a node in the source.
[ruby/yarp] Add implicit nodes for ommitted hash values https://github.com/ruby/yarp/commit/22130b3491
2023-09-13 16:39:20 +03:00
{ foo: }
^^^^
{ Foo: }
^^^^
[ruby/prism] Add an implicit node for the target of a hash pattern This simplifies compiling it, since you can now compile the value as if it were always there. https://github.com/ruby/prism/commit/bcfc74aacb
2024-01-24 20:11:45 +03:00
foo in { bar: }
^^^^
[ruby/prism] Implicit rest nodes Fundamentally, `foo { |bar,| }` is different from `foo { |bar, *| }` because of arity checks. This PR introduces a new node to handle that, `ImplicitRestNode`, which goes in the `rest` slot of parameter nodes instead of `RestParameterNode` instances. This is also used in a couple of other places, namely: * pattern matching: `foo in [bar,]` * multi target: `for foo, in bar do end` * multi write: `foo, = bar` Now the only splat nodes with a `NULL` value are when you're forwarding, as in: `def foo(*) = bar(*)`. https://github.com/ruby/prism/commit/dba2a3b652
2023-11-28 23:49:04 +03:00
- name: ImplicitRestNode
comment: |
Represents using a trailing comma to indicate an implicit rest parameter.
foo { |bar,| }
^
foo in [bar,]
^
for foo, in bar do end
^
foo, = bar
^
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: InNode
[ruby/yarp] Rename child_nodes to fields https://github.com/ruby/yarp/commit/715fce9264
2023-08-30 23:09:51 +03:00
fields:
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: pattern
type: node
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
kind: pattern expression
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: statements
type: node?
kind: StatementsNode
- name: in_loc
type: location
- name: then_loc
type: location?
comment: |
Represents the use of the `in` keyword in a case statement.
case a; in b then c end
^^^^^^^^^^^
[ruby/prism] Index{Operator,And,Or}WriteNode Right now, our Call{Operator,And,Or}WriteNode nodes represent two different concepts: ```ruby foo.bar += 1 foo[bar] += 1 ``` These two statements are different in what they can support. The former can never have arguments (or an opening_loc or closing_loc). The former can also never have a block. Also, the former is a variable method name. The latter is always going to be []/[]=, it can have any number of arguments including blocks (`foo[&bar] ||= 1`), and will always have an opening_loc and closing_loc. Furthermore, these statements end of having to take different paths through the various compilers because with the latter you have to consider the arguments and the block, whereas the former can perform some additional peephole optimizations since there are fewer values on the stack. For these reasons, I'm introducing Index{Operator,And,Or}WriteNode. These nodes never have a read_name or write_name on them because they are always []/[]=. They also support blocks, which the previous write nodes didn't. As a benefit of introducing these nodes, I've removed the opening_loc, closing_loc, and arguments from the older write nodes because they will always be null. For the serialized format, both of these nodes end up being smaller, and for in-memory we're storing fewer things in general, so we have savings all around. I don't love that we are introducing another node that is a call node since we generally want consumers to only have to handle a single call, but these nodes are so specific that they would have to be handled separately anyway since in fact call 2 methods. https://github.com/ruby/prism/commit/70155db9cd
2023-10-17 18:15:56 +03:00
- name: IndexAndWriteNode
[ruby/prism] Expose flags on every node type https://github.com/ruby/prism/commit/9f12a56fd6
2024-07-02 22:43:01 +03:00
flags: CallNodeFlags
[ruby/prism] Index{Operator,And,Or}WriteNode Right now, our Call{Operator,And,Or}WriteNode nodes represent two different concepts: ```ruby foo.bar += 1 foo[bar] += 1 ``` These two statements are different in what they can support. The former can never have arguments (or an opening_loc or closing_loc). The former can also never have a block. Also, the former is a variable method name. The latter is always going to be []/[]=, it can have any number of arguments including blocks (`foo[&bar] ||= 1`), and will always have an opening_loc and closing_loc. Furthermore, these statements end of having to take different paths through the various compilers because with the latter you have to consider the arguments and the block, whereas the former can perform some additional peephole optimizations since there are fewer values on the stack. For these reasons, I'm introducing Index{Operator,And,Or}WriteNode. These nodes never have a read_name or write_name on them because they are always []/[]=. They also support blocks, which the previous write nodes didn't. As a benefit of introducing these nodes, I've removed the opening_loc, closing_loc, and arguments from the older write nodes because they will always be null. For the serialized format, both of these nodes end up being smaller, and for in-memory we're storing fewer things in general, so we have savings all around. I don't love that we are introducing another node that is a call node since we generally want consumers to only have to handle a single call, but these nodes are so specific that they would have to be handled separately anyway since in fact call 2 methods. https://github.com/ruby/prism/commit/70155db9cd
2023-10-17 18:15:56 +03:00
fields:
- name: receiver
type: node?
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
kind: non-void expression
[ruby/prism] Index{Operator,And,Or}WriteNode Right now, our Call{Operator,And,Or}WriteNode nodes represent two different concepts: ```ruby foo.bar += 1 foo[bar] += 1 ``` These two statements are different in what they can support. The former can never have arguments (or an opening_loc or closing_loc). The former can also never have a block. Also, the former is a variable method name. The latter is always going to be []/[]=, it can have any number of arguments including blocks (`foo[&bar] ||= 1`), and will always have an opening_loc and closing_loc. Furthermore, these statements end of having to take different paths through the various compilers because with the latter you have to consider the arguments and the block, whereas the former can perform some additional peephole optimizations since there are fewer values on the stack. For these reasons, I'm introducing Index{Operator,And,Or}WriteNode. These nodes never have a read_name or write_name on them because they are always []/[]=. They also support blocks, which the previous write nodes didn't. As a benefit of introducing these nodes, I've removed the opening_loc, closing_loc, and arguments from the older write nodes because they will always be null. For the serialized format, both of these nodes end up being smaller, and for in-memory we're storing fewer things in general, so we have savings all around. I don't love that we are introducing another node that is a call node since we generally want consumers to only have to handle a single call, but these nodes are so specific that they would have to be handled separately anyway since in fact call 2 methods. https://github.com/ruby/prism/commit/70155db9cd
2023-10-17 18:15:56 +03:00
- name: call_operator_loc
type: location?
- name: opening_loc
type: location
- name: arguments
type: node?
kind: ArgumentsNode
- name: closing_loc
type: location
- name: block
type: node?
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
kind: BlockArgumentNode # foo[&b] &&= value, only valid on Ruby < 3.4
[ruby/prism] Index{Operator,And,Or}WriteNode Right now, our Call{Operator,And,Or}WriteNode nodes represent two different concepts: ```ruby foo.bar += 1 foo[bar] += 1 ``` These two statements are different in what they can support. The former can never have arguments (or an opening_loc or closing_loc). The former can also never have a block. Also, the former is a variable method name. The latter is always going to be []/[]=, it can have any number of arguments including blocks (`foo[&bar] ||= 1`), and will always have an opening_loc and closing_loc. Furthermore, these statements end of having to take different paths through the various compilers because with the latter you have to consider the arguments and the block, whereas the former can perform some additional peephole optimizations since there are fewer values on the stack. For these reasons, I'm introducing Index{Operator,And,Or}WriteNode. These nodes never have a read_name or write_name on them because they are always []/[]=. They also support blocks, which the previous write nodes didn't. As a benefit of introducing these nodes, I've removed the opening_loc, closing_loc, and arguments from the older write nodes because they will always be null. For the serialized format, both of these nodes end up being smaller, and for in-memory we're storing fewer things in general, so we have savings all around. I don't love that we are introducing another node that is a call node since we generally want consumers to only have to handle a single call, but these nodes are so specific that they would have to be handled separately anyway since in fact call 2 methods. https://github.com/ruby/prism/commit/70155db9cd
2023-10-17 18:15:56 +03:00
- name: operator_loc
type: location
- name: value
type: node
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
kind: non-void expression
[ruby/prism] Index{Operator,And,Or}WriteNode Right now, our Call{Operator,And,Or}WriteNode nodes represent two different concepts: ```ruby foo.bar += 1 foo[bar] += 1 ``` These two statements are different in what they can support. The former can never have arguments (or an opening_loc or closing_loc). The former can also never have a block. Also, the former is a variable method name. The latter is always going to be []/[]=, it can have any number of arguments including blocks (`foo[&bar] ||= 1`), and will always have an opening_loc and closing_loc. Furthermore, these statements end of having to take different paths through the various compilers because with the latter you have to consider the arguments and the block, whereas the former can perform some additional peephole optimizations since there are fewer values on the stack. For these reasons, I'm introducing Index{Operator,And,Or}WriteNode. These nodes never have a read_name or write_name on them because they are always []/[]=. They also support blocks, which the previous write nodes didn't. As a benefit of introducing these nodes, I've removed the opening_loc, closing_loc, and arguments from the older write nodes because they will always be null. For the serialized format, both of these nodes end up being smaller, and for in-memory we're storing fewer things in general, so we have savings all around. I don't love that we are introducing another node that is a call node since we generally want consumers to only have to handle a single call, but these nodes are so specific that they would have to be handled separately anyway since in fact call 2 methods. https://github.com/ruby/prism/commit/70155db9cd
2023-10-17 18:15:56 +03:00
comment: |
Represents the use of the `&&=` operator on a call to the `[]` method.
foo.bar[baz] &&= value
^^^^^^^^^^^^^^^^^^^^^^
- name: IndexOperatorWriteNode
[ruby/prism] Expose flags on every node type https://github.com/ruby/prism/commit/9f12a56fd6
2024-07-02 22:43:01 +03:00
flags: CallNodeFlags
[ruby/prism] Index{Operator,And,Or}WriteNode Right now, our Call{Operator,And,Or}WriteNode nodes represent two different concepts: ```ruby foo.bar += 1 foo[bar] += 1 ``` These two statements are different in what they can support. The former can never have arguments (or an opening_loc or closing_loc). The former can also never have a block. Also, the former is a variable method name. The latter is always going to be []/[]=, it can have any number of arguments including blocks (`foo[&bar] ||= 1`), and will always have an opening_loc and closing_loc. Furthermore, these statements end of having to take different paths through the various compilers because with the latter you have to consider the arguments and the block, whereas the former can perform some additional peephole optimizations since there are fewer values on the stack. For these reasons, I'm introducing Index{Operator,And,Or}WriteNode. These nodes never have a read_name or write_name on them because they are always []/[]=. They also support blocks, which the previous write nodes didn't. As a benefit of introducing these nodes, I've removed the opening_loc, closing_loc, and arguments from the older write nodes because they will always be null. For the serialized format, both of these nodes end up being smaller, and for in-memory we're storing fewer things in general, so we have savings all around. I don't love that we are introducing another node that is a call node since we generally want consumers to only have to handle a single call, but these nodes are so specific that they would have to be handled separately anyway since in fact call 2 methods. https://github.com/ruby/prism/commit/70155db9cd
2023-10-17 18:15:56 +03:00
fields:
- name: receiver
type: node?
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
kind: non-void expression
[ruby/prism] Index{Operator,And,Or}WriteNode Right now, our Call{Operator,And,Or}WriteNode nodes represent two different concepts: ```ruby foo.bar += 1 foo[bar] += 1 ``` These two statements are different in what they can support. The former can never have arguments (or an opening_loc or closing_loc). The former can also never have a block. Also, the former is a variable method name. The latter is always going to be []/[]=, it can have any number of arguments including blocks (`foo[&bar] ||= 1`), and will always have an opening_loc and closing_loc. Furthermore, these statements end of having to take different paths through the various compilers because with the latter you have to consider the arguments and the block, whereas the former can perform some additional peephole optimizations since there are fewer values on the stack. For these reasons, I'm introducing Index{Operator,And,Or}WriteNode. These nodes never have a read_name or write_name on them because they are always []/[]=. They also support blocks, which the previous write nodes didn't. As a benefit of introducing these nodes, I've removed the opening_loc, closing_loc, and arguments from the older write nodes because they will always be null. For the serialized format, both of these nodes end up being smaller, and for in-memory we're storing fewer things in general, so we have savings all around. I don't love that we are introducing another node that is a call node since we generally want consumers to only have to handle a single call, but these nodes are so specific that they would have to be handled separately anyway since in fact call 2 methods. https://github.com/ruby/prism/commit/70155db9cd
2023-10-17 18:15:56 +03:00
- name: call_operator_loc
type: location?
- name: opening_loc
type: location
- name: arguments
type: node?
kind: ArgumentsNode
- name: closing_loc
type: location
- name: block
type: node?
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
kind: BlockArgumentNode # foo[&b] += value, only valid on Ruby < 3.4
[ruby/prism] operator rename https://github.com/ruby/prism/commit/b5e47f5c42
2024-05-10 17:19:11 +03:00
- name: binary_operator
[ruby/prism] Index{Operator,And,Or}WriteNode Right now, our Call{Operator,And,Or}WriteNode nodes represent two different concepts: ```ruby foo.bar += 1 foo[bar] += 1 ``` These two statements are different in what they can support. The former can never have arguments (or an opening_loc or closing_loc). The former can also never have a block. Also, the former is a variable method name. The latter is always going to be []/[]=, it can have any number of arguments including blocks (`foo[&bar] ||= 1`), and will always have an opening_loc and closing_loc. Furthermore, these statements end of having to take different paths through the various compilers because with the latter you have to consider the arguments and the block, whereas the former can perform some additional peephole optimizations since there are fewer values on the stack. For these reasons, I'm introducing Index{Operator,And,Or}WriteNode. These nodes never have a read_name or write_name on them because they are always []/[]=. They also support blocks, which the previous write nodes didn't. As a benefit of introducing these nodes, I've removed the opening_loc, closing_loc, and arguments from the older write nodes because they will always be null. For the serialized format, both of these nodes end up being smaller, and for in-memory we're storing fewer things in general, so we have savings all around. I don't love that we are introducing another node that is a call node since we generally want consumers to only have to handle a single call, but these nodes are so specific that they would have to be handled separately anyway since in fact call 2 methods. https://github.com/ruby/prism/commit/70155db9cd
2023-10-17 18:15:56 +03:00
type: constant
[ruby/prism] operator rename https://github.com/ruby/prism/commit/b5e47f5c42
2024-05-10 17:19:11 +03:00
- name: binary_operator_loc
[ruby/prism] Index{Operator,And,Or}WriteNode Right now, our Call{Operator,And,Or}WriteNode nodes represent two different concepts: ```ruby foo.bar += 1 foo[bar] += 1 ``` These two statements are different in what they can support. The former can never have arguments (or an opening_loc or closing_loc). The former can also never have a block. Also, the former is a variable method name. The latter is always going to be []/[]=, it can have any number of arguments including blocks (`foo[&bar] ||= 1`), and will always have an opening_loc and closing_loc. Furthermore, these statements end of having to take different paths through the various compilers because with the latter you have to consider the arguments and the block, whereas the former can perform some additional peephole optimizations since there are fewer values on the stack. For these reasons, I'm introducing Index{Operator,And,Or}WriteNode. These nodes never have a read_name or write_name on them because they are always []/[]=. They also support blocks, which the previous write nodes didn't. As a benefit of introducing these nodes, I've removed the opening_loc, closing_loc, and arguments from the older write nodes because they will always be null. For the serialized format, both of these nodes end up being smaller, and for in-memory we're storing fewer things in general, so we have savings all around. I don't love that we are introducing another node that is a call node since we generally want consumers to only have to handle a single call, but these nodes are so specific that they would have to be handled separately anyway since in fact call 2 methods. https://github.com/ruby/prism/commit/70155db9cd
2023-10-17 18:15:56 +03:00
type: location
- name: value
type: node
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
kind: non-void expression
[ruby/prism] Index{Operator,And,Or}WriteNode Right now, our Call{Operator,And,Or}WriteNode nodes represent two different concepts: ```ruby foo.bar += 1 foo[bar] += 1 ``` These two statements are different in what they can support. The former can never have arguments (or an opening_loc or closing_loc). The former can also never have a block. Also, the former is a variable method name. The latter is always going to be []/[]=, it can have any number of arguments including blocks (`foo[&bar] ||= 1`), and will always have an opening_loc and closing_loc. Furthermore, these statements end of having to take different paths through the various compilers because with the latter you have to consider the arguments and the block, whereas the former can perform some additional peephole optimizations since there are fewer values on the stack. For these reasons, I'm introducing Index{Operator,And,Or}WriteNode. These nodes never have a read_name or write_name on them because they are always []/[]=. They also support blocks, which the previous write nodes didn't. As a benefit of introducing these nodes, I've removed the opening_loc, closing_loc, and arguments from the older write nodes because they will always be null. For the serialized format, both of these nodes end up being smaller, and for in-memory we're storing fewer things in general, so we have savings all around. I don't love that we are introducing another node that is a call node since we generally want consumers to only have to handle a single call, but these nodes are so specific that they would have to be handled separately anyway since in fact call 2 methods. https://github.com/ruby/prism/commit/70155db9cd
2023-10-17 18:15:56 +03:00
comment: |
Represents the use of an assignment operator on a call to `[]`.
foo.bar[baz] += value
^^^^^^^^^^^^^^^^^^^^^
- name: IndexOrWriteNode
[ruby/prism] Expose flags on every node type https://github.com/ruby/prism/commit/9f12a56fd6
2024-07-02 22:43:01 +03:00
flags: CallNodeFlags
[ruby/prism] Index{Operator,And,Or}WriteNode Right now, our Call{Operator,And,Or}WriteNode nodes represent two different concepts: ```ruby foo.bar += 1 foo[bar] += 1 ``` These two statements are different in what they can support. The former can never have arguments (or an opening_loc or closing_loc). The former can also never have a block. Also, the former is a variable method name. The latter is always going to be []/[]=, it can have any number of arguments including blocks (`foo[&bar] ||= 1`), and will always have an opening_loc and closing_loc. Furthermore, these statements end of having to take different paths through the various compilers because with the latter you have to consider the arguments and the block, whereas the former can perform some additional peephole optimizations since there are fewer values on the stack. For these reasons, I'm introducing Index{Operator,And,Or}WriteNode. These nodes never have a read_name or write_name on them because they are always []/[]=. They also support blocks, which the previous write nodes didn't. As a benefit of introducing these nodes, I've removed the opening_loc, closing_loc, and arguments from the older write nodes because they will always be null. For the serialized format, both of these nodes end up being smaller, and for in-memory we're storing fewer things in general, so we have savings all around. I don't love that we are introducing another node that is a call node since we generally want consumers to only have to handle a single call, but these nodes are so specific that they would have to be handled separately anyway since in fact call 2 methods. https://github.com/ruby/prism/commit/70155db9cd
2023-10-17 18:15:56 +03:00
fields:
- name: receiver
type: node?
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
kind: non-void expression
[ruby/prism] Index{Operator,And,Or}WriteNode Right now, our Call{Operator,And,Or}WriteNode nodes represent two different concepts: ```ruby foo.bar += 1 foo[bar] += 1 ``` These two statements are different in what they can support. The former can never have arguments (or an opening_loc or closing_loc). The former can also never have a block. Also, the former is a variable method name. The latter is always going to be []/[]=, it can have any number of arguments including blocks (`foo[&bar] ||= 1`), and will always have an opening_loc and closing_loc. Furthermore, these statements end of having to take different paths through the various compilers because with the latter you have to consider the arguments and the block, whereas the former can perform some additional peephole optimizations since there are fewer values on the stack. For these reasons, I'm introducing Index{Operator,And,Or}WriteNode. These nodes never have a read_name or write_name on them because they are always []/[]=. They also support blocks, which the previous write nodes didn't. As a benefit of introducing these nodes, I've removed the opening_loc, closing_loc, and arguments from the older write nodes because they will always be null. For the serialized format, both of these nodes end up being smaller, and for in-memory we're storing fewer things in general, so we have savings all around. I don't love that we are introducing another node that is a call node since we generally want consumers to only have to handle a single call, but these nodes are so specific that they would have to be handled separately anyway since in fact call 2 methods. https://github.com/ruby/prism/commit/70155db9cd
2023-10-17 18:15:56 +03:00
- name: call_operator_loc
type: location?
- name: opening_loc
type: location
- name: arguments
type: node?
kind: ArgumentsNode
- name: closing_loc
type: location
- name: block
type: node?
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
kind: BlockArgumentNode # foo[&b] ||= value, only valid on Ruby < 3.4
[ruby/prism] Index{Operator,And,Or}WriteNode Right now, our Call{Operator,And,Or}WriteNode nodes represent two different concepts: ```ruby foo.bar += 1 foo[bar] += 1 ``` These two statements are different in what they can support. The former can never have arguments (or an opening_loc or closing_loc). The former can also never have a block. Also, the former is a variable method name. The latter is always going to be []/[]=, it can have any number of arguments including blocks (`foo[&bar] ||= 1`), and will always have an opening_loc and closing_loc. Furthermore, these statements end of having to take different paths through the various compilers because with the latter you have to consider the arguments and the block, whereas the former can perform some additional peephole optimizations since there are fewer values on the stack. For these reasons, I'm introducing Index{Operator,And,Or}WriteNode. These nodes never have a read_name or write_name on them because they are always []/[]=. They also support blocks, which the previous write nodes didn't. As a benefit of introducing these nodes, I've removed the opening_loc, closing_loc, and arguments from the older write nodes because they will always be null. For the serialized format, both of these nodes end up being smaller, and for in-memory we're storing fewer things in general, so we have savings all around. I don't love that we are introducing another node that is a call node since we generally want consumers to only have to handle a single call, but these nodes are so specific that they would have to be handled separately anyway since in fact call 2 methods. https://github.com/ruby/prism/commit/70155db9cd
2023-10-17 18:15:56 +03:00
- name: operator_loc
type: location
- name: value
type: node
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
kind: non-void expression
[ruby/prism] Index{Operator,And,Or}WriteNode Right now, our Call{Operator,And,Or}WriteNode nodes represent two different concepts: ```ruby foo.bar += 1 foo[bar] += 1 ``` These two statements are different in what they can support. The former can never have arguments (or an opening_loc or closing_loc). The former can also never have a block. Also, the former is a variable method name. The latter is always going to be []/[]=, it can have any number of arguments including blocks (`foo[&bar] ||= 1`), and will always have an opening_loc and closing_loc. Furthermore, these statements end of having to take different paths through the various compilers because with the latter you have to consider the arguments and the block, whereas the former can perform some additional peephole optimizations since there are fewer values on the stack. For these reasons, I'm introducing Index{Operator,And,Or}WriteNode. These nodes never have a read_name or write_name on them because they are always []/[]=. They also support blocks, which the previous write nodes didn't. As a benefit of introducing these nodes, I've removed the opening_loc, closing_loc, and arguments from the older write nodes because they will always be null. For the serialized format, both of these nodes end up being smaller, and for in-memory we're storing fewer things in general, so we have savings all around. I don't love that we are introducing another node that is a call node since we generally want consumers to only have to handle a single call, but these nodes are so specific that they would have to be handled separately anyway since in fact call 2 methods. https://github.com/ruby/prism/commit/70155db9cd
2023-10-17 18:15:56 +03:00
comment: |
Represents the use of the `||=` operator on a call to `[]`.
foo.bar[baz] ||= value
^^^^^^^^^^^^^^^^^^^^^^
[ruby/prism] Split up CallNode in target position In this commit we're splitting up the call nodes that were in target positions (that is, for loop indices, rescue error captures, and multi assign targets). Previously, we would simply leave the call nodes in place. This had the benefit of keeping the AST relatively simple, but had the downside of not being very explicit. If a static analysis tool wanted to only look at call nodes, it could easily be confused because the method would have 1 fewer argument than it would actually be called with. This also brings some consistency to the AST. All of the nodes in a target position are now *TargetNode nodes. These should all be treated the same, and the call nodes can now be treated the same. Finally, there is benefit to memory. Because being in a target position ensures we don't have some fields, we can strip down the number of fields on these nodes. So this commit introduces two new nodes: CallTargetNode and IndexTargetNode. For CallTargetNode we get to drop the opening_loc, closing_loc, arguments, and block. Those can never be present. We also get to mark their fields as non-null, so they will always be seen as present. The IndexTargetNode keeps around most of its fields but gets to drop both the name (because it will always be []=) and the message_loc (which was always super confusing because it included the arguments by virtue of being inside the []). Overall, this adds complexity to the AST at the expense of memory savings and explicitness. I believe this tradeoff is worth it in this case, especially because these are very much not common nodes in the first place. https://github.com/ruby/prism/commit/3ef71cdb45
2023-12-08 17:57:31 +03:00
- name: IndexTargetNode
[ruby/prism] Expose flags on every node type https://github.com/ruby/prism/commit/9f12a56fd6
2024-07-02 22:43:01 +03:00
flags: CallNodeFlags
[ruby/prism] Split up CallNode in target position In this commit we're splitting up the call nodes that were in target positions (that is, for loop indices, rescue error captures, and multi assign targets). Previously, we would simply leave the call nodes in place. This had the benefit of keeping the AST relatively simple, but had the downside of not being very explicit. If a static analysis tool wanted to only look at call nodes, it could easily be confused because the method would have 1 fewer argument than it would actually be called with. This also brings some consistency to the AST. All of the nodes in a target position are now *TargetNode nodes. These should all be treated the same, and the call nodes can now be treated the same. Finally, there is benefit to memory. Because being in a target position ensures we don't have some fields, we can strip down the number of fields on these nodes. So this commit introduces two new nodes: CallTargetNode and IndexTargetNode. For CallTargetNode we get to drop the opening_loc, closing_loc, arguments, and block. Those can never be present. We also get to mark their fields as non-null, so they will always be seen as present. The IndexTargetNode keeps around most of its fields but gets to drop both the name (because it will always be []=) and the message_loc (which was always super confusing because it included the arguments by virtue of being inside the []). Overall, this adds complexity to the AST at the expense of memory savings and explicitness. I believe this tradeoff is worth it in this case, especially because these are very much not common nodes in the first place. https://github.com/ruby/prism/commit/3ef71cdb45
2023-12-08 17:57:31 +03:00
fields:
- name: receiver
type: node
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
kind: non-void expression
[ruby/prism] Split up CallNode in target position In this commit we're splitting up the call nodes that were in target positions (that is, for loop indices, rescue error captures, and multi assign targets). Previously, we would simply leave the call nodes in place. This had the benefit of keeping the AST relatively simple, but had the downside of not being very explicit. If a static analysis tool wanted to only look at call nodes, it could easily be confused because the method would have 1 fewer argument than it would actually be called with. This also brings some consistency to the AST. All of the nodes in a target position are now *TargetNode nodes. These should all be treated the same, and the call nodes can now be treated the same. Finally, there is benefit to memory. Because being in a target position ensures we don't have some fields, we can strip down the number of fields on these nodes. So this commit introduces two new nodes: CallTargetNode and IndexTargetNode. For CallTargetNode we get to drop the opening_loc, closing_loc, arguments, and block. Those can never be present. We also get to mark their fields as non-null, so they will always be seen as present. The IndexTargetNode keeps around most of its fields but gets to drop both the name (because it will always be []=) and the message_loc (which was always super confusing because it included the arguments by virtue of being inside the []). Overall, this adds complexity to the AST at the expense of memory savings and explicitness. I believe this tradeoff is worth it in this case, especially because these are very much not common nodes in the first place. https://github.com/ruby/prism/commit/3ef71cdb45
2023-12-08 17:57:31 +03:00
- name: opening_loc
type: location
- name: arguments
type: node?
kind: ArgumentsNode
- name: closing_loc
type: location
- name: block
type: node?
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
kind: BlockArgumentNode # foo[&b], = 1, only valid on Ruby < 3.4
[ruby/prism] Split up CallNode in target position In this commit we're splitting up the call nodes that were in target positions (that is, for loop indices, rescue error captures, and multi assign targets). Previously, we would simply leave the call nodes in place. This had the benefit of keeping the AST relatively simple, but had the downside of not being very explicit. If a static analysis tool wanted to only look at call nodes, it could easily be confused because the method would have 1 fewer argument than it would actually be called with. This also brings some consistency to the AST. All of the nodes in a target position are now *TargetNode nodes. These should all be treated the same, and the call nodes can now be treated the same. Finally, there is benefit to memory. Because being in a target position ensures we don't have some fields, we can strip down the number of fields on these nodes. So this commit introduces two new nodes: CallTargetNode and IndexTargetNode. For CallTargetNode we get to drop the opening_loc, closing_loc, arguments, and block. Those can never be present. We also get to mark their fields as non-null, so they will always be seen as present. The IndexTargetNode keeps around most of its fields but gets to drop both the name (because it will always be []=) and the message_loc (which was always super confusing because it included the arguments by virtue of being inside the []). Overall, this adds complexity to the AST at the expense of memory savings and explicitness. I believe this tradeoff is worth it in this case, especially because these are very much not common nodes in the first place. https://github.com/ruby/prism/commit/3ef71cdb45
2023-12-08 17:57:31 +03:00
comment: |
Represents assigning to an index.
foo[bar], = 1
^^^^^^^^
begin
rescue => foo[bar]
^^^^^^^^
end
for foo[bar] in baz do end
^^^^^^^^
[ruby/yarp] Split up AndWriteNode, OrWriteNode, OperatorWriteNode https://github.com/ruby/yarp/commit/6d3b3b5776
2023-08-25 17:49:00 +03:00
- name: InstanceVariableAndWriteNode
[ruby/yarp] Rename child_nodes to fields https://github.com/ruby/yarp/commit/715fce9264
2023-08-30 23:09:51 +03:00
fields:
[ruby/yarp] Add instance variable names to the constant pool https://github.com/ruby/yarp/commit/f049932c44
2023-08-29 16:17:34 +03:00
- name: name
type: constant
[ruby/yarp] Split up AndWriteNode, OrWriteNode, OperatorWriteNode https://github.com/ruby/yarp/commit/6d3b3b5776
2023-08-25 17:49:00 +03:00
- name: name_loc
type: location
- name: operator_loc
type: location
- name: value
type: node
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
kind: non-void expression
[ruby/yarp] Split up AndWriteNode, OrWriteNode, OperatorWriteNode https://github.com/ruby/yarp/commit/6d3b3b5776
2023-08-25 17:49:00 +03:00
comment: |
Represents the use of the `&&=` operator for assignment to an instance variable.
@target &&= value
^^^^^^^^^^^^^^^^^
- name: InstanceVariableOperatorWriteNode
[ruby/yarp] Rename child_nodes to fields https://github.com/ruby/yarp/commit/715fce9264
2023-08-30 23:09:51 +03:00
fields:
[ruby/yarp] Add instance variable names to the constant pool https://github.com/ruby/yarp/commit/f049932c44
2023-08-29 16:17:34 +03:00
- name: name
type: constant
[ruby/yarp] Split up AndWriteNode, OrWriteNode, OperatorWriteNode https://github.com/ruby/yarp/commit/6d3b3b5776
2023-08-25 17:49:00 +03:00
- name: name_loc
type: location
[ruby/prism] operator rename https://github.com/ruby/prism/commit/b5e47f5c42
2024-05-10 17:19:11 +03:00
- name: binary_operator_loc
[ruby/yarp] Split up AndWriteNode, OrWriteNode, OperatorWriteNode https://github.com/ruby/yarp/commit/6d3b3b5776
2023-08-25 17:49:00 +03:00
type: location
- name: value
type: node
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
kind: non-void expression
[ruby/prism] operator rename https://github.com/ruby/prism/commit/b5e47f5c42
2024-05-10 17:19:11 +03:00
- name: binary_operator
[ruby/yarp] Split up AndWriteNode, OrWriteNode, OperatorWriteNode https://github.com/ruby/yarp/commit/6d3b3b5776
2023-08-25 17:49:00 +03:00
type: constant
comment: |
Represents assigning to an instance variable using an operator that isn't `=`.
@target += value
^^^^^^^^^^^^^^^^
- name: InstanceVariableOrWriteNode
[ruby/yarp] Rename child_nodes to fields https://github.com/ruby/yarp/commit/715fce9264
2023-08-30 23:09:51 +03:00
fields:
[ruby/yarp] Add instance variable names to the constant pool https://github.com/ruby/yarp/commit/f049932c44
2023-08-29 16:17:34 +03:00
- name: name
type: constant
[ruby/yarp] Split up AndWriteNode, OrWriteNode, OperatorWriteNode https://github.com/ruby/yarp/commit/6d3b3b5776
2023-08-25 17:49:00 +03:00
- name: name_loc
type: location
- name: operator_loc
type: location
- name: value
type: node
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
kind: non-void expression
[ruby/yarp] Split up AndWriteNode, OrWriteNode, OperatorWriteNode https://github.com/ruby/yarp/commit/6d3b3b5776
2023-08-25 17:49:00 +03:00
comment: |
Represents the use of the `||=` operator for assignment to an instance variable.
@target ||= value
^^^^^^^^^^^^^^^^^
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: InstanceVariableReadNode
[ruby/yarp] Rename child_nodes to fields https://github.com/ruby/yarp/commit/715fce9264
2023-08-30 23:09:51 +03:00
fields:
[ruby/yarp] Add instance variable names to the constant pool https://github.com/ruby/yarp/commit/f049932c44
2023-08-29 16:17:34 +03:00
- name: name
type: constant
[ruby/prism] Document InstanceVariableReadNode fields https://github.com/ruby/prism/commit/c0747103b0
2024-01-08 22:55:07 +03:00
comment: |
[PRISM] Sync to latest
2024-01-19 19:22:40 +03:00
The name of the instance variable, which is a `@` followed by an [identifier](https://github.com/ruby/prism/blob/main/docs/parsing_rules.md#identifiers).
[ruby/prism] Document InstanceVariableReadNode fields https://github.com/ruby/prism/commit/c0747103b0
2024-01-08 22:55:07 +03:00
@x # name `:@x`
@_test # name `:@_test`
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
comment: |
Represents referencing an instance variable.
@foo
^^^^
[ruby/yarp] Provide target node versions https://github.com/ruby/yarp/commit/a026564d38
2023-08-25 18:57:37 +03:00
- name: InstanceVariableTargetNode
[ruby/yarp] Rename child_nodes to fields https://github.com/ruby/yarp/commit/715fce9264
2023-08-30 23:09:51 +03:00
fields:
[ruby/yarp] Add instance variable names to the constant pool https://github.com/ruby/yarp/commit/f049932c44
2023-08-29 16:17:34 +03:00
- name: name
type: constant
[ruby/yarp] Provide target node versions https://github.com/ruby/yarp/commit/a026564d38
2023-08-25 18:57:37 +03:00
comment: |
Represents writing to an instance variable in a context that doesn't have an explicit value.
@foo, @bar = baz
^^^^ ^^^^
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: InstanceVariableWriteNode
[ruby/yarp] Rename child_nodes to fields https://github.com/ruby/yarp/commit/715fce9264
2023-08-30 23:09:51 +03:00
fields:
[ruby/yarp] Add instance variable names to the constant pool https://github.com/ruby/yarp/commit/f049932c44
2023-08-29 16:17:34 +03:00
- name: name
type: constant
[ruby/prism] Document `InstanceVariableWriteNode` fields (https://github.com/ruby/prism/pull/2161) * Document InstanceVariableWriteNode fields * Reference lexing docs in name field documentation * Update config.yml --------- https://github.com/ruby/prism/commit/015b3a857e Co-authored-by: Kevin Newton <kddnewton@gmail.com>
2024-03-11 22:46:25 +03:00
comment: |
The name of the instance variable, which is a `@` followed by an [identifier](https://github.com/ruby/prism/blob/main/docs/parsing_rules.md#identifiers).
@x = :y # name `:@x`
@_foo = "bar" # name `@_foo`
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: name_loc
type: location
[ruby/prism] Document `InstanceVariableWriteNode` fields (https://github.com/ruby/prism/pull/2161) * Document InstanceVariableWriteNode fields * Reference lexing docs in name field documentation * Update config.yml --------- https://github.com/ruby/prism/commit/015b3a857e Co-authored-by: Kevin Newton <kddnewton@gmail.com>
2024-03-11 22:46:25 +03:00
comment: |
The location of the variable name.
@_x = 1
^^^
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: value
[ruby/yarp] Mark local variable targets in pattern matching https://github.com/ruby/yarp/commit/6c6700a001
2023-08-25 20:03:16 +03:00
type: node
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
kind: non-void expression
[ruby/prism] Document `InstanceVariableWriteNode` fields (https://github.com/ruby/prism/pull/2161) * Document InstanceVariableWriteNode fields * Reference lexing docs in name field documentation * Update config.yml --------- https://github.com/ruby/prism/commit/015b3a857e Co-authored-by: Kevin Newton <kddnewton@gmail.com>
2024-03-11 22:46:25 +03:00
comment: |
[PRISM] Sync latest config.yml documentation updates
2024-04-26 22:03:07 +03:00
The value to write to the instance variable. It can be any [non-void expression](https://github.com/ruby/prism/blob/main/docs/parsing_rules.md#non-void-expression).
[ruby/prism] Document `InstanceVariableWriteNode` fields (https://github.com/ruby/prism/pull/2161) * Document InstanceVariableWriteNode fields * Reference lexing docs in name field documentation * Update config.yml --------- https://github.com/ruby/prism/commit/015b3a857e Co-authored-by: Kevin Newton <kddnewton@gmail.com>
2024-03-11 22:46:25 +03:00
@foo = :bar
^^^^
@_x = 1234
^^^^
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: operator_loc
[ruby/yarp] Mark local variable targets in pattern matching https://github.com/ruby/yarp/commit/6c6700a001
2023-08-25 20:03:16 +03:00
type: location
[ruby/prism] Document `InstanceVariableWriteNode` fields (https://github.com/ruby/prism/pull/2161) * Document InstanceVariableWriteNode fields * Reference lexing docs in name field documentation * Update config.yml --------- https://github.com/ruby/prism/commit/015b3a857e Co-authored-by: Kevin Newton <kddnewton@gmail.com>
2024-03-11 22:46:25 +03:00
comment: |
The location of the `=` operator.
@x = y
^
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
comment: |
Represents writing to an instance variable.
@foo = 1
^^^^^^^^
- name: IntegerNode
[ruby/prism] Expose flags on every node type https://github.com/ruby/prism/commit/9f12a56fd6
2024-07-02 22:43:01 +03:00
flags: IntegerBaseFlags
[ruby/yarp] Provide a flag for the integer base https://github.com/ruby/yarp/commit/45dd046b83
2023-09-11 19:05:14 +03:00
fields:
[ruby/prism] Add an IntegerField for parsing integer values https://github.com/ruby/prism/commit/120d8c0479
2024-02-22 18:55:29 +03:00
- name: value
type: integer
comment: The value of the integer literal as a number.
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
comment: |
Represents an integer number literal.
1
^
[ruby/yarp] Introduce MatchLastLineNode and InterpolatedMatchLastLineNode These are replacements for regular expressions when they are used alone as the predicate of a conditional. That's because they are significantly different from a regular expression because they are not evaluated for truthyness, but instead evaluated as a match against the last line read by an IO object. https://github.com/ruby/yarp/commit/0f1c7780e8
2023-09-11 19:32:25 +03:00
- name: InterpolatedMatchLastLineNode
[ruby/prism] Expose flags on every node type https://github.com/ruby/prism/commit/9f12a56fd6
2024-07-02 22:43:01 +03:00
flags: RegularExpressionFlags
[ruby/yarp] Introduce MatchLastLineNode and InterpolatedMatchLastLineNode These are replacements for regular expressions when they are used alone as the predicate of a conditional. That's because they are significantly different from a regular expression because they are not evaluated for truthyness, but instead evaluated as a match against the last line read by an IO object. https://github.com/ruby/yarp/commit/0f1c7780e8
2023-09-11 19:32:25 +03:00
fields:
- name: opening_loc
type: location
- name: parts
type: node[]
[ruby/prism] Give a kind to all node[] fields which can have one more specific than "any Node" * Fixes https://github.com/ruby/prism/issues/2058 https://github.com/ruby/prism/commit/f3e3310b5e
2024-02-25 15:04:42 +03:00
kind:
- StringNode
- EmbeddedStatementsNode
- EmbeddedVariableNode
[ruby/yarp] Introduce MatchLastLineNode and InterpolatedMatchLastLineNode These are replacements for regular expressions when they are used alone as the predicate of a conditional. That's because they are significantly different from a regular expression because they are not evaluated for truthyness, but instead evaluated as a match against the last line read by an IO object. https://github.com/ruby/yarp/commit/0f1c7780e8
2023-09-11 19:32:25 +03:00
- name: closing_loc
type: location
newline: parts
comment: |
[PRISM] Sync to latest
2024-01-19 19:22:40 +03:00
Represents a regular expression literal that contains interpolation that is being used in the predicate of a conditional to implicitly match against the last line read by an IO object.
[ruby/yarp] Introduce MatchLastLineNode and InterpolatedMatchLastLineNode These are replacements for regular expressions when they are used alone as the predicate of a conditional. That's because they are significantly different from a regular expression because they are not evaluated for truthyness, but instead evaluated as a match against the last line read by an IO object. https://github.com/ruby/yarp/commit/0f1c7780e8
2023-09-11 19:32:25 +03:00
if /foo #{bar} baz/ then end
^^^^^^^^^^^^^^^^
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: InterpolatedRegularExpressionNode
[ruby/prism] Expose flags on every node type https://github.com/ruby/prism/commit/9f12a56fd6
2024-07-02 22:43:01 +03:00
flags: RegularExpressionFlags
[ruby/yarp] Rename child_nodes to fields https://github.com/ruby/yarp/commit/715fce9264
2023-08-30 23:09:51 +03:00
fields:
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: opening_loc
type: location
- name: parts
type: node[]
[ruby/prism] Give a kind to all node[] fields which can have one more specific than "any Node" * Fixes https://github.com/ruby/prism/issues/2058 https://github.com/ruby/prism/commit/f3e3310b5e
2024-02-25 15:04:42 +03:00
kind:
- StringNode
- EmbeddedStatementsNode
- EmbeddedVariableNode
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: closing_loc
type: location
newline: parts
comment: |
Represents a regular expression literal that contains interpolation.
/foo #{bar} baz/
^^^^^^^^^^^^^^^^
- name: InterpolatedStringNode
[ruby/prism] Expose flags on every node type https://github.com/ruby/prism/commit/9f12a56fd6
2024-07-02 22:43:01 +03:00
flags: InterpolatedStringNodeFlags
[ruby/yarp] Rename child_nodes to fields https://github.com/ruby/yarp/commit/715fce9264
2023-08-30 23:09:51 +03:00
fields:
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: opening_loc
type: location?
- name: parts
type: node[]
[ruby/prism] Give a kind to all node[] fields which can have one more specific than "any Node" * Fixes https://github.com/ruby/prism/issues/2058 https://github.com/ruby/prism/commit/f3e3310b5e
2024-02-25 15:04:42 +03:00
kind:
- StringNode
- EmbeddedStatementsNode
- EmbeddedVariableNode
- InterpolatedStringNode # `"a" "#{b}"`
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: closing_loc
type: location?
newline: parts
comment: |
Represents a string literal that contains interpolation.
"foo #{bar} baz"
^^^^^^^^^^^^^^^^
- name: InterpolatedSymbolNode
[ruby/yarp] Rename child_nodes to fields https://github.com/ruby/yarp/commit/715fce9264
2023-08-30 23:09:51 +03:00
fields:
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: opening_loc
type: location?
- name: parts
type: node[]
[ruby/prism] Give a kind to all node[] fields which can have one more specific than "any Node" * Fixes https://github.com/ruby/prism/issues/2058 https://github.com/ruby/prism/commit/f3e3310b5e
2024-02-25 15:04:42 +03:00
kind:
- StringNode
- EmbeddedStatementsNode
- EmbeddedVariableNode
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: closing_loc
type: location?
newline: parts
comment: |
Represents a symbol literal that contains interpolation.
:"foo #{bar} baz"
^^^^^^^^^^^^^^^^^
- name: InterpolatedXStringNode
[ruby/yarp] Rename child_nodes to fields https://github.com/ruby/yarp/commit/715fce9264
2023-08-30 23:09:51 +03:00
fields:
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: opening_loc
type: location
- name: parts
type: node[]
[ruby/prism] Give a kind to all node[] fields which can have one more specific than "any Node" * Fixes https://github.com/ruby/prism/issues/2058 https://github.com/ruby/prism/commit/f3e3310b5e
2024-02-25 15:04:42 +03:00
kind:
- StringNode
- EmbeddedStatementsNode
- EmbeddedVariableNode
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: closing_loc
type: location
newline: parts
comment: |
Represents an xstring literal that contains interpolation.
`foo #{bar} baz`
^^^^^^^^^^^^^^^^
[ruby/prism] Fix support for 'it' implicit local variable https://github.com/ruby/prism/commit/53bbcfe513
2024-05-22 21:31:38 +03:00
- name: ItLocalVariableReadNode
comment: |
Represents reading from the implicit `it` local variable.
-> { it }
^^
[ruby/prism] Support ItParametersNode So that compilers know they need to add to add an anonymous variable to the local table. https://github.com/ruby/prism/commit/7f1aadd057
2024-02-21 22:11:50 +03:00
- name: ItParametersNode
comment: |
Represents an implicit set of parameters through the use of the `it` keyword within a block or lambda.
-> { it + it }
^^^^^^^^^^^^^^
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: KeywordHashNode
[ruby/prism] Expose flags on every node type https://github.com/ruby/prism/commit/9f12a56fd6
2024-07-02 22:43:01 +03:00
flags: KeywordHashNodeFlags
[ruby/yarp] Rename child_nodes to fields https://github.com/ruby/yarp/commit/715fce9264
2023-08-30 23:09:51 +03:00
fields:
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: elements
type: node[]
[ruby/prism] Give a kind to all node[] fields which can have one more specific than "any Node" * Fixes https://github.com/ruby/prism/issues/2058 https://github.com/ruby/prism/commit/f3e3310b5e
2024-02-25 15:04:42 +03:00
kind:
- AssocNode
- AssocSplatNode
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
comment: |
Represents a hash literal without opening and closing braces.
foo(a: b)
^^^^
- name: KeywordRestParameterNode
[ruby/prism] Expose flags on every node type https://github.com/ruby/prism/commit/9f12a56fd6
2024-07-02 22:43:01 +03:00
flags: ParameterFlags
[ruby/yarp] Rename child_nodes to fields https://github.com/ruby/yarp/commit/715fce9264
2023-08-30 23:09:51 +03:00
fields:
[ruby/yarp] Constants on keyword rest parameters https://github.com/ruby/yarp/commit/5e1a8fbc54
2023-09-06 18:14:38 +03:00
- name: name
type: constant?
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: name_loc
type: location?
[ruby/yarp] Constants on keyword rest parameters https://github.com/ruby/yarp/commit/5e1a8fbc54
2023-09-06 18:14:38 +03:00
- name: operator_loc
type: location
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
comment: |
Represents a keyword rest parameter to a method, block, or lambda definition.
def a(**b)
^^^
end
- name: LambdaNode
[ruby/yarp] Rename child_nodes to fields https://github.com/ruby/yarp/commit/715fce9264
2023-08-30 23:09:51 +03:00
fields:
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: locals
type: constant[]
[ruby/yarp] Track block opening and closing locations https://github.com/ruby/yarp/commit/7984e4ddc7
2023-08-22 04:12:52 +03:00
- name: operator_loc
type: location
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: opening_loc
type: location
[ruby/yarp] Track block opening and closing locations https://github.com/ruby/yarp/commit/7984e4ddc7
2023-08-22 04:12:52 +03:00
- name: closing_loc
type: location
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: parameters
type: node?
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
kind:
- BlockParametersNode
- NumberedParametersNode
- ItParametersNode
[ruby/yarp] Rename statements to body where appropriate https://github.com/ruby/yarp/commit/0aa7d9d10c
2023-08-19 03:47:58 +03:00
- name: body
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
type: node?
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
kind:
- StatementsNode
- BeginNode
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
comment: |
Represents using a lambda literal (not the lambda method call).
->(value) { value * 2 }
^^^^^^^^^^^^^^^^^^^^^^^
[ruby/yarp] Split up AndWriteNode, OrWriteNode, OperatorWriteNode https://github.com/ruby/yarp/commit/6d3b3b5776
2023-08-25 17:49:00 +03:00
- name: LocalVariableAndWriteNode
[ruby/yarp] Rename child_nodes to fields https://github.com/ruby/yarp/commit/715fce9264
2023-08-30 23:09:51 +03:00
fields:
[ruby/yarp] Split up AndWriteNode, OrWriteNode, OperatorWriteNode https://github.com/ruby/yarp/commit/6d3b3b5776
2023-08-25 17:49:00 +03:00
- name: name_loc
type: location
- name: operator_loc
type: location
- name: value
type: node
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
kind: non-void expression
[ruby/yarp] Rename constant pool fields to name or operator * `constant_id` and `operator_id` are confusing. * See https://github.com/ruby/yarp/issues/1296 https://github.com/ruby/yarp/commit/09d0a144df
2023-08-27 18:56:53 +03:00
- name: name
[ruby/yarp] Split up AndWriteNode, OrWriteNode, OperatorWriteNode https://github.com/ruby/yarp/commit/6d3b3b5776
2023-08-25 17:49:00 +03:00
type: constant
- name: depth
type: uint32
comment: |
Represents the use of the `&&=` operator for assignment to a local variable.
target &&= value
^^^^^^^^^^^^^^^^
- name: LocalVariableOperatorWriteNode
[ruby/yarp] Rename child_nodes to fields https://github.com/ruby/yarp/commit/715fce9264
2023-08-30 23:09:51 +03:00
fields:
[ruby/yarp] Split up AndWriteNode, OrWriteNode, OperatorWriteNode https://github.com/ruby/yarp/commit/6d3b3b5776
2023-08-25 17:49:00 +03:00
- name: name_loc
type: location
[ruby/prism] operator rename https://github.com/ruby/prism/commit/b5e47f5c42
2024-05-10 17:19:11 +03:00
- name: binary_operator_loc
[ruby/yarp] Split up AndWriteNode, OrWriteNode, OperatorWriteNode https://github.com/ruby/yarp/commit/6d3b3b5776
2023-08-25 17:49:00 +03:00
type: location
- name: value
type: node
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
kind: non-void expression
[ruby/yarp] Rename constant pool fields to name or operator * `constant_id` and `operator_id` are confusing. * See https://github.com/ruby/yarp/issues/1296 https://github.com/ruby/yarp/commit/09d0a144df
2023-08-27 18:56:53 +03:00
- name: name
[ruby/yarp] Split up AndWriteNode, OrWriteNode, OperatorWriteNode https://github.com/ruby/yarp/commit/6d3b3b5776
2023-08-25 17:49:00 +03:00
type: constant
[ruby/prism] operator rename https://github.com/ruby/prism/commit/b5e47f5c42
2024-05-10 17:19:11 +03:00
- name: binary_operator
[ruby/yarp] Split up AndWriteNode, OrWriteNode, OperatorWriteNode https://github.com/ruby/yarp/commit/6d3b3b5776
2023-08-25 17:49:00 +03:00
type: constant
- name: depth
type: uint32
comment: |
Represents assigning to a local variable using an operator that isn't `=`.
target += value
^^^^^^^^^^^^^^^
- name: LocalVariableOrWriteNode
[ruby/yarp] Rename child_nodes to fields https://github.com/ruby/yarp/commit/715fce9264
2023-08-30 23:09:51 +03:00
fields:
[ruby/yarp] Split up AndWriteNode, OrWriteNode, OperatorWriteNode https://github.com/ruby/yarp/commit/6d3b3b5776
2023-08-25 17:49:00 +03:00
- name: name_loc
type: location
- name: operator_loc
type: location
- name: value
type: node
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
kind: non-void expression
[ruby/yarp] Rename constant pool fields to name or operator * `constant_id` and `operator_id` are confusing. * See https://github.com/ruby/yarp/issues/1296 https://github.com/ruby/yarp/commit/09d0a144df
2023-08-27 18:56:53 +03:00
- name: name
[ruby/yarp] Split up AndWriteNode, OrWriteNode, OperatorWriteNode https://github.com/ruby/yarp/commit/6d3b3b5776
2023-08-25 17:49:00 +03:00
type: constant
- name: depth
type: uint32
comment: |
Represents the use of the `||=` operator for assignment to a local variable.
target ||= value
^^^^^^^^^^^^^^^^
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: LocalVariableReadNode
[ruby/yarp] Rename child_nodes to fields https://github.com/ruby/yarp/commit/715fce9264
2023-08-30 23:09:51 +03:00
fields:
[ruby/yarp] Rename constant pool fields to name or operator * `constant_id` and `operator_id` are confusing. * See https://github.com/ruby/yarp/issues/1296 https://github.com/ruby/yarp/commit/09d0a144df
2023-08-27 18:56:53 +03:00
- name: name
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
type: constant
[ruby/prism] Document LocalVariableReadNode fields https://github.com/ruby/prism/commit/5e9afd3729
2024-01-08 23:51:21 +03:00
comment: |
[PRISM] Sync to latest
2024-01-19 19:22:40 +03:00
The name of the local variable, which is an [identifier](https://github.com/ruby/prism/blob/main/docs/parsing_rules.md#identifiers).
[ruby/prism] Document LocalVariableReadNode fields https://github.com/ruby/prism/commit/5e9afd3729
2024-01-08 23:51:21 +03:00
x # name `:x`
_Test # name `:_Test`
[ruby/prism] Parsing rules document https://github.com/ruby/prism/commit/57a9575543
2024-01-19 19:12:12 +03:00
[PRISM] Sync to latest
2024-01-19 19:22:40 +03:00
Note that this can also be an underscore followed by a number for the default block parameters.
* remove trailing spaces. [ci skip]
2024-01-19 19:12:34 +03:00
[ruby/prism] Parsing rules document https://github.com/ruby/prism/commit/57a9575543
2024-01-19 19:12:12 +03:00
_1 # name `:_1`
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: depth
type: uint32
[ruby/prism] Document LocalVariableReadNode fields https://github.com/ruby/prism/commit/5e9afd3729
2024-01-08 23:51:21 +03:00
comment: |
[PRISM] Sync to latest
2024-01-19 19:22:40 +03:00
The number of visible scopes that should be searched to find the origin of this local variable.
[ruby/prism] Document LocalVariableReadNode fields https://github.com/ruby/prism/commit/5e9afd3729
2024-01-08 23:51:21 +03:00
foo = 1; foo # depth 0
bar = 2; tap { bar } # depth 1
[PRISM] Sync to latest
2024-01-19 19:22:40 +03:00
The specific rules for calculating the depth may differ from individual Ruby implementations, as they are not specified by the language. For more information, see [the Prism documentation](https://github.com/ruby/prism/blob/main/docs/local_variable_depth.md).
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
comment: |
[PRISM] Sync to latest
2024-01-19 19:22:40 +03:00
Represents reading a local variable. Note that this requires that a local variable of the same name has already been written to in the same scope, otherwise it is parsed as a method call.
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
foo
^^^
[ruby/yarp] Provide target node versions https://github.com/ruby/yarp/commit/a026564d38
2023-08-25 18:57:37 +03:00
- name: LocalVariableTargetNode
[ruby/yarp] Rename child_nodes to fields https://github.com/ruby/yarp/commit/715fce9264
2023-08-30 23:09:51 +03:00
fields:
[ruby/yarp] Rename constant pool fields to name or operator * `constant_id` and `operator_id` are confusing. * See https://github.com/ruby/yarp/issues/1296 https://github.com/ruby/yarp/commit/09d0a144df
2023-08-27 18:56:53 +03:00
- name: name
[ruby/yarp] Provide target node versions https://github.com/ruby/yarp/commit/a026564d38
2023-08-25 18:57:37 +03:00
type: constant
- name: depth
type: uint32
comment: |
Represents writing to a local variable in a context that doesn't have an explicit value.
foo, bar = baz
^^^ ^^^
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: LocalVariableWriteNode
[ruby/yarp] Rename child_nodes to fields https://github.com/ruby/yarp/commit/715fce9264
2023-08-30 23:09:51 +03:00
fields:
[ruby/yarp] Rename constant pool fields to name or operator * `constant_id` and `operator_id` are confusing. * See https://github.com/ruby/yarp/issues/1296 https://github.com/ruby/yarp/commit/09d0a144df
2023-08-27 18:56:53 +03:00
- name: name
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
type: constant
[PRISM] Sync latest config.yml documentation updates
2024-04-26 22:03:07 +03:00
comment: |
The name of the local variable, which is an [identifier](https://github.com/ruby/prism/blob/main/docs/parsing_rules.md#identifiers).
foo = :bar # name `:foo`
abc = 123 # name `:abc`
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: depth
type: uint32
[PRISM] Sync latest config.yml documentation updates
2024-04-26 22:03:07 +03:00
comment: |
The number of semantic scopes we have to traverse to find the declaration of this variable.
foo = 1 # depth 0
tap { foo = 1 } # depth 1
The specific rules for calculating the depth may differ from individual Ruby implementations, as they are not specified by the language. For more information, see [the Prism documentation](https://github.com/ruby/prism/blob/main/docs/local_variable_depth.md).
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: name_loc
type: location
[PRISM] Sync latest config.yml documentation updates
2024-04-26 22:03:07 +03:00
comment: |
The location of the variable name.
foo = :bar
^^^
[ruby/yarp] Move name_loc before value for LocalVariableWriteNode * Consistent with ClassVariableWriteNode, ConstantWriteNode, InstanceVariableWriteNode, GlobalVariableWriteNode. * Fixes desugaring of local variable with operators. https://github.com/ruby/yarp/commit/9a66737775
2023-08-30 23:48:17 +03:00
- name: value
type: node
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
kind: non-void expression
[PRISM] Sync latest config.yml documentation updates
2024-04-26 22:03:07 +03:00
comment: |
The value to write to the local variable. It can be any [non-void expression](https://github.com/ruby/prism/blob/main/docs/parsing_rules.md#non-void-expression).
foo = :bar
^^^^
abc = 1234
^^^^
Note that since the name of a local variable is known before the value is parsed, it is valid for a local variable to appear within the value of its own write.
foo = foo
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: operator_loc
[ruby/yarp] Mark local variable targets in pattern matching https://github.com/ruby/yarp/commit/6c6700a001
2023-08-25 20:03:16 +03:00
type: location
[PRISM] Sync latest config.yml documentation updates
2024-04-26 22:03:07 +03:00
comment: |
The location of the `=` operator.
x = :y
^
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
comment: |
Represents writing to a local variable.
foo = 1
^^^^^^^
[ruby/yarp] Introduce MatchLastLineNode and InterpolatedMatchLastLineNode These are replacements for regular expressions when they are used alone as the predicate of a conditional. That's because they are significantly different from a regular expression because they are not evaluated for truthyness, but instead evaluated as a match against the last line read by an IO object. https://github.com/ruby/yarp/commit/0f1c7780e8
2023-09-11 19:32:25 +03:00
- name: MatchLastLineNode
[ruby/prism] Expose flags on every node type https://github.com/ruby/prism/commit/9f12a56fd6
2024-07-02 22:43:01 +03:00
flags: RegularExpressionFlags
[ruby/yarp] Introduce MatchLastLineNode and InterpolatedMatchLastLineNode These are replacements for regular expressions when they are used alone as the predicate of a conditional. That's because they are significantly different from a regular expression because they are not evaluated for truthyness, but instead evaluated as a match against the last line read by an IO object. https://github.com/ruby/yarp/commit/0f1c7780e8
2023-09-11 19:32:25 +03:00
fields:
- name: opening_loc
type: location
- name: content_loc
type: location
- name: closing_loc
type: location
- name: unescaped
type: string
comment: |
[PRISM] Sync to latest
2024-01-19 19:22:40 +03:00
Represents a regular expression literal used in the predicate of a conditional to implicitly match against the last line read by an IO object.
[ruby/yarp] Introduce MatchLastLineNode and InterpolatedMatchLastLineNode These are replacements for regular expressions when they are used alone as the predicate of a conditional. That's because they are significantly different from a regular expression because they are not evaluated for truthyness, but instead evaluated as a match against the last line read by an IO object. https://github.com/ruby/yarp/commit/0f1c7780e8
2023-09-11 19:32:25 +03:00
if /foo/i then end
^^^^^^
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: MatchPredicateNode
[ruby/yarp] Rename child_nodes to fields https://github.com/ruby/yarp/commit/715fce9264
2023-08-30 23:09:51 +03:00
fields:
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: value
type: node
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
kind: non-void expression
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: pattern
type: node
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
kind: pattern expression
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: operator_loc
type: location
comment: |
Represents the use of the modifier `in` operator.
foo in bar
^^^^^^^^^^
- name: MatchRequiredNode
[ruby/yarp] Rename child_nodes to fields https://github.com/ruby/yarp/commit/715fce9264
2023-08-30 23:09:51 +03:00
fields:
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: value
type: node
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
kind: non-void expression
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: pattern
type: node
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
kind: pattern expression
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: operator_loc
type: location
comment: |
Represents the use of the `=>` operator.
foo => bar
^^^^^^^^^^
[ruby/yarp] Introduce MatchWriteNode This rarely used node holds information about the local variables that need to get written in the case a regular expression is used on the left-hand side of a =~ operator and it has named capture groups. Note that we already "handled" these nodes by adding locals to the AST, but we didn't actually expose this information, making it difficult to compile. The general idea behind this node is that it maintains the ability for consumers to find all of the call nodes in the tree easily so it's not flattening down. However, it should be okay because you hopefully don't need any information in the call node to determine what to compile because the locals list is on the top level. https://github.com/ruby/yarp/commit/e136e7f9a8
2023-09-14 16:01:20 +03:00
- name: MatchWriteNode
fields:
- name: call
type: node
kind: CallNode
[ruby/prism] Replace match write locals with match write targets https://github.com/ruby/prism/commit/eec1862967
2023-11-10 06:59:35 +03:00
- name: targets
type: node[]
[ruby/prism] Give a kind to all node[] fields which can have one more specific than "any Node" * Fixes https://github.com/ruby/prism/issues/2058 https://github.com/ruby/prism/commit/f3e3310b5e
2024-02-25 15:04:42 +03:00
kind: LocalVariableTargetNode
[ruby/yarp] Introduce MatchWriteNode This rarely used node holds information about the local variables that need to get written in the case a regular expression is used on the left-hand side of a =~ operator and it has named capture groups. Note that we already "handled" these nodes by adding locals to the AST, but we didn't actually expose this information, making it difficult to compile. The general idea behind this node is that it maintains the ability for consumers to find all of the call nodes in the tree easily so it's not flattening down. However, it should be okay because you hopefully don't need any information in the call node to determine what to compile because the locals list is on the top level. https://github.com/ruby/yarp/commit/e136e7f9a8
2023-09-14 16:01:20 +03:00
comment: |
[PRISM] Sync to latest
2024-01-19 19:22:40 +03:00
Represents writing local variables using a regular expression match with named capture groups.
[ruby/yarp] Introduce MatchWriteNode This rarely used node holds information about the local variables that need to get written in the case a regular expression is used on the left-hand side of a =~ operator and it has named capture groups. Note that we already "handled" these nodes by adding locals to the AST, but we didn't actually expose this information, making it difficult to compile. The general idea behind this node is that it maintains the ability for consumers to find all of the call nodes in the tree easily so it's not flattening down. However, it should be okay because you hopefully don't need any information in the call node to determine what to compile because the locals list is on the top level. https://github.com/ruby/yarp/commit/e136e7f9a8
2023-09-14 16:01:20 +03:00
/(?<foo>bar)/ =~ baz
^^^^^^^^^^^^^^^^^^^^
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: MissingNode
comment: |
[PRISM] Sync to latest
2024-01-19 19:22:40 +03:00
Represents a node that is missing from the source and results in a syntax error.
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: ModuleNode
[ruby/yarp] Rename child_nodes to fields https://github.com/ruby/yarp/commit/715fce9264
2023-08-30 23:09:51 +03:00
fields:
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: locals
type: constant[]
- name: module_keyword_loc
type: location
- name: constant_path
type: node
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
kind:
- ConstantReadNode
- ConstantPathNode
- on error: MissingNode # module Parent module end
[ruby/yarp] Rename statements to body where appropriate https://github.com/ruby/yarp/commit/0aa7d9d10c
2023-08-19 03:47:58 +03:00
- name: body
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
type: node?
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
kind:
- StatementsNode
- BeginNode
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: end_keyword_loc
type: location
[ruby/yarp] Add names to classes and modules This should hopefully make it easier to compile these nodes, and also for static analysis tools for having a quick label. https://github.com/ruby/yarp/commit/f086662144
2023-08-25 04:22:20 +03:00
- name: name
[ruby/yarp] Constants on classes and modules (https://github.com/ruby/yarp/pull/1409) https://github.com/ruby/yarp/commit/0a11ec579f
2023-09-06 19:19:38 +03:00
type: constant
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
comment: |
Represents a module declaration involving the `module` keyword.
module Foo end
^^^^^^^^^^^^^^
[ruby/yarp] Multi target nodes https://github.com/ruby/yarp/commit/fa53fe88e4
2023-09-07 20:00:45 +03:00
- name: MultiTargetNode
[ruby/yarp] Rename child_nodes to fields https://github.com/ruby/yarp/commit/715fce9264
2023-08-30 23:09:51 +03:00
fields:
[ruby/prism] Rename to lefts/rights https://github.com/ruby/prism/commit/e6deed05a5
2023-10-26 21:56:21 +03:00
- name: lefts
[ruby/prism] Split up multi target/write targets https://github.com/ruby/prism/commit/dda7a0da52
2023-10-23 19:06:21 +03:00
type: node[]
[ruby/prism] Give a kind to all node[] fields which can have one more specific than "any Node" * Fixes https://github.com/ruby/prism/issues/2058 https://github.com/ruby/prism/commit/f3e3310b5e
2024-02-25 15:04:42 +03:00
kind:
- LocalVariableTargetNode
- InstanceVariableTargetNode
- ClassVariableTargetNode
- GlobalVariableTargetNode
- ConstantTargetNode
- ConstantPathTargetNode
- CallTargetNode
- IndexTargetNode
- MultiTargetNode
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
- RequiredParameterNode # def m((a,b)); end
- on error: BackReferenceReadNode # a, (b, $&) = z
- on error: NumberedReferenceReadNode # a, (b, $1) = z
[ruby/prism] Document MultiTargetNode https://github.com/ruby/prism/commit/b817cd25c5
2024-06-15 13:21:58 +03:00
comment: |
Represents the targets expressions before a splat node.
a, (b, c, *) = 1, 2, 3, 4, 5
^^^^
The splat node can be absent, in that case all target expressions are in the left field.
a, (b, c) = 1, 2, 3, 4, 5
^^^^
[ruby/prism] Split up multi target/write targets https://github.com/ruby/prism/commit/dda7a0da52
2023-10-23 19:06:21 +03:00
- name: rest
type: node?
[ruby/prism] Document MultiTargetNode https://github.com/ruby/prism/commit/b817cd25c5
2024-06-15 13:21:58 +03:00
kind:
- ImplicitRestNode
- SplatNode
comment: |
Represents a splat node in the target expression.
a, (b, *c) = 1, 2, 3, 4
^^
The variable can be empty, this results in a `SplatNode` with a `nil` expression field.
a, (b, *) = 1, 2, 3, 4
^
[ruby/prism] Update config.yml https://github.com/ruby/prism/commit/369b2c1304
2024-09-04 16:03:19 +03:00
If the `*` is omitted, this field will contain an `ImplicitRestNode`
[ruby/prism] Document MultiTargetNode https://github.com/ruby/prism/commit/b817cd25c5
2024-06-15 13:21:58 +03:00
a, (b,) = 1, 2, 3, 4
^
[ruby/prism] Rename to lefts/rights https://github.com/ruby/prism/commit/e6deed05a5
2023-10-26 21:56:21 +03:00
- name: rights
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
type: node[]
[ruby/prism] Give a kind to all node[] fields which can have one more specific than "any Node" * Fixes https://github.com/ruby/prism/issues/2058 https://github.com/ruby/prism/commit/f3e3310b5e
2024-02-25 15:04:42 +03:00
kind:
- LocalVariableTargetNode
- InstanceVariableTargetNode
- ClassVariableTargetNode
- GlobalVariableTargetNode
- ConstantTargetNode
- ConstantPathTargetNode
- CallTargetNode
- IndexTargetNode
- MultiTargetNode
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
- RequiredParameterNode # def m((*,b)); end
- on error: BackReferenceReadNode # a, (*, $&) = z
- on error: NumberedReferenceReadNode # a, (*, $1) = z
[ruby/prism] Document MultiTargetNode https://github.com/ruby/prism/commit/b817cd25c5
2024-06-15 13:21:58 +03:00
comment: |
Represents the targets expressions after a splat node.
a, (*, b, c) = 1, 2, 3, 4, 5
^^^^
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: lparen_loc
type: location?
[ruby/prism] Document MultiTargetNode https://github.com/ruby/prism/commit/b817cd25c5
2024-06-15 13:21:58 +03:00
comment: |
The location of the opening parenthesis.
a, (b, c) = 1, 2, 3
^
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: rparen_loc
type: location?
[ruby/prism] Document MultiTargetNode https://github.com/ruby/prism/commit/b817cd25c5
2024-06-15 13:21:58 +03:00
comment: |
The location of the closing parenthesis.
a, (b, c) = 1, 2, 3
^
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
comment: |
Represents a multi-target expression.
[ruby/prism] Add KeywordSplat flag to ArgumentsNode Method calls with keyword splat args compile differently than without since they merge the keyword arg hash with the keyword splat hash. We know this information at parse time, so can set a flag which the compiler can use. https://github.com/ruby/prism/commit/e5f8a9a3cd
2023-10-26 21:02:27 +03:00
a, (b, c) = 1, 2, 3
^^^^^^
[ruby/prism] Document MultiTargetNode https://github.com/ruby/prism/commit/b817cd25c5
2024-06-15 13:21:58 +03:00
This can be a part of `MultiWriteNode` as above, or the target of a `for` loop
for a, b in [[1, 2], [3, 4]]
^^^^
[ruby/yarp] Multi target nodes https://github.com/ruby/yarp/commit/fa53fe88e4
2023-09-07 20:00:45 +03:00
- name: MultiWriteNode
fields:
[ruby/prism] Rename to lefts/rights https://github.com/ruby/prism/commit/e6deed05a5
2023-10-26 21:56:21 +03:00
- name: lefts
[ruby/prism] Split up multi target/write targets https://github.com/ruby/prism/commit/dda7a0da52
2023-10-23 19:06:21 +03:00
type: node[]
[ruby/prism] Give a kind to all node[] fields which can have one more specific than "any Node" * Fixes https://github.com/ruby/prism/issues/2058 https://github.com/ruby/prism/commit/f3e3310b5e
2024-02-25 15:04:42 +03:00
kind:
- LocalVariableTargetNode
- InstanceVariableTargetNode
- ClassVariableTargetNode
- GlobalVariableTargetNode
- ConstantTargetNode
- ConstantPathTargetNode
- CallTargetNode
- IndexTargetNode
- MultiTargetNode
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
- on error: BackReferenceReadNode # $&, = z
- on error: NumberedReferenceReadNode # $1, = z
[ruby/prism] Document MultiWriteNode fields https://github.com/ruby/prism/commit/b6a97a43c2
2024-06-15 15:54:43 +03:00
comment: |
Represents the targets expressions before a splat node.
a, b, * = 1, 2, 3, 4, 5
^^^^
The splat node can be absent, in that case all target expressions are in the left field.
a, b, c = 1, 2, 3, 4, 5
^^^^^^^
[ruby/prism] Split up multi target/write targets https://github.com/ruby/prism/commit/dda7a0da52
2023-10-23 19:06:21 +03:00
- name: rest
type: node?
[ruby/prism] Document MultiWriteNode fields https://github.com/ruby/prism/commit/b6a97a43c2
2024-06-15 15:54:43 +03:00
kind:
- ImplicitRestNode
- SplatNode
comment: |
Represents a splat node in the target expression.
a, b, *c = 1, 2, 3, 4
^^
The variable can be empty, this results in a `SplatNode` with a `nil` expression field.
a, b, * = 1, 2, 3, 4
^
[ruby/prism] Update config.yml https://github.com/ruby/prism/commit/8a3fa9f46e
2024-09-04 16:03:22 +03:00
If the `*` is omitted, this field will contain an `ImplicitRestNode`
[ruby/prism] Document MultiWriteNode fields https://github.com/ruby/prism/commit/b6a97a43c2
2024-06-15 15:54:43 +03:00
a, b, = 1, 2, 3, 4
^
[ruby/prism] Rename to lefts/rights https://github.com/ruby/prism/commit/e6deed05a5
2023-10-26 21:56:21 +03:00
- name: rights
[ruby/yarp] Flatten multitarget into multiwrite https://github.com/ruby/yarp/commit/1021dac372
2023-09-07 21:20:18 +03:00
type: node[]
[ruby/prism] Give a kind to all node[] fields which can have one more specific than "any Node" * Fixes https://github.com/ruby/prism/issues/2058 https://github.com/ruby/prism/commit/f3e3310b5e
2024-02-25 15:04:42 +03:00
kind:
- LocalVariableTargetNode
- InstanceVariableTargetNode
- ClassVariableTargetNode
- GlobalVariableTargetNode
- ConstantTargetNode
- ConstantPathTargetNode
- CallTargetNode
- IndexTargetNode
- MultiTargetNode
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
- on error: BackReferenceReadNode # *, $& = z
- on error: NumberedReferenceReadNode # *, $1 = z
[ruby/prism] Document MultiWriteNode fields https://github.com/ruby/prism/commit/b6a97a43c2
2024-06-15 15:54:43 +03:00
comment: |
Represents the targets expressions after a splat node.
a, *, b, c = 1, 2, 3, 4, 5
^^^^
[ruby/yarp] Flatten multitarget into multiwrite https://github.com/ruby/yarp/commit/1021dac372
2023-09-07 21:20:18 +03:00
- name: lparen_loc
type: location?
[ruby/prism] Document MultiWriteNode fields https://github.com/ruby/prism/commit/b6a97a43c2
2024-06-15 15:54:43 +03:00
comment: |
The location of the opening parenthesis.
(a, b, c) = 1, 2, 3
^
[ruby/yarp] Flatten multitarget into multiwrite https://github.com/ruby/yarp/commit/1021dac372
2023-09-07 21:20:18 +03:00
- name: rparen_loc
type: location?
[ruby/prism] Document MultiWriteNode fields https://github.com/ruby/prism/commit/b6a97a43c2
2024-06-15 15:54:43 +03:00
comment: |
The location of the closing parenthesis.
(a, b, c) = 1, 2, 3
^
[ruby/yarp] Multi target nodes https://github.com/ruby/yarp/commit/fa53fe88e4
2023-09-07 20:00:45 +03:00
- name: operator_loc
type: location
[ruby/prism] Document MultiWriteNode fields https://github.com/ruby/prism/commit/b6a97a43c2
2024-06-15 15:54:43 +03:00
comment: |
The location of the operator.
a, b, c = 1, 2, 3
^
[ruby/yarp] Multi target nodes https://github.com/ruby/yarp/commit/fa53fe88e4
2023-09-07 20:00:45 +03:00
- name: value
type: node
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
kind: non-void expression
[ruby/prism] Document MultiWriteNode fields https://github.com/ruby/prism/commit/b6a97a43c2
2024-06-15 15:54:43 +03:00
comment: |
The value to write to the targets. It can be any [non-void expression](https://github.com/ruby/prism/blob/main/docs/parsing_rules.md#non-void-expression).
a, b, c = 1, 2, 3
^^^^^^^
[ruby/yarp] Multi target nodes https://github.com/ruby/yarp/commit/fa53fe88e4
2023-09-07 20:00:45 +03:00
comment: |
Represents a write to a multi-target expression.
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
a, b, c = 1, 2, 3
^^^^^^^^^^^^^^^^^
- name: NextNode
[ruby/yarp] Rename child_nodes to fields https://github.com/ruby/yarp/commit/715fce9264
2023-08-30 23:09:51 +03:00
fields:
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: arguments
type: node?
kind: ArgumentsNode
- name: keyword_loc
type: location
comment: |
Represents the use of the `next` keyword.
next 1
^^^^^^
- name: NilNode
comment: |
Represents the use of the `nil` keyword.
nil
^^^
- name: NoKeywordsParameterNode
[ruby/yarp] Rename child_nodes to fields https://github.com/ruby/yarp/commit/715fce9264
2023-08-30 23:09:51 +03:00
fields:
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: operator_loc
type: location
- name: keyword_loc
type: location
comment: |
Represents the use of `**nil` inside method arguments.
def a(**nil)
^^^^^
end
[ruby/prism] Change numbered parameters Previously numbered parameters were a field on blocks and lambdas that indicated the maximum number of numbered parameters in either the block or lambda, respectively. However they also had a parameters field that would always be nil in these cases. This changes it so that we introduce a NumberedParametersNode that goes in place of parameters, which has a single uint8_t maximum field on it. That field contains the maximum numbered parameter in either the block or lambda. As a part of the PR, I'm introducing a new UInt8Field type that can be used on nodes, which is just to make it a little more explicit what the maximum values can be (the maximum is actually 9, since it only goes up to _9). Plus we can do a couple of nice things in serialization like just read a single byte. https://github.com/ruby/prism/commit/2d87303903
2023-12-01 04:47:08 +03:00
- name: NumberedParametersNode
fields:
- name: maximum
type: uint8
comment: |
[PRISM] Sync to latest
2024-01-19 19:22:40 +03:00
Represents an implicit set of parameters through the use of numbered parameters within a block or lambda.
[ruby/prism] Change numbered parameters Previously numbered parameters were a field on blocks and lambdas that indicated the maximum number of numbered parameters in either the block or lambda, respectively. However they also had a parameters field that would always be nil in these cases. This changes it so that we introduce a NumberedParametersNode that goes in place of parameters, which has a single uint8_t maximum field on it. That field contains the maximum numbered parameter in either the block or lambda. As a part of the PR, I'm introducing a new UInt8Field type that can be used on nodes, which is just to make it a little more explicit what the maximum values can be (the maximum is actually 9, since it only goes up to _9). Plus we can do a couple of nice things in serialization like just read a single byte. https://github.com/ruby/prism/commit/2d87303903
2023-12-01 04:47:08 +03:00
-> { _1 + _2 }
^^^^^^^^^^^^^^
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: NumberedReferenceReadNode
[ruby/yarp] Add a value to numbered references https://github.com/ruby/yarp/commit/5d9b048971
2023-08-31 00:21:50 +03:00
fields:
- name: number
type: uint32
[ruby/prism] Document NumberedReferenceReadNode fields https://github.com/ruby/prism/commit/c3148b4519
2024-01-08 23:34:11 +03:00
comment: |
[ruby/prism] Warn for maximum number variables https://github.com/ruby/prism/commit/2cdbf81c95
2024-03-13 21:22:31 +03:00
The (1-indexed, from the left) number of the capture group. Numbered references that are too large result in this value being `0`.
[ruby/prism] Document NumberedReferenceReadNode fields https://github.com/ruby/prism/commit/c3148b4519
2024-01-08 23:34:11 +03:00
$1 # number `1`
$5432 # number `5432`
[ruby/prism] Warn for maximum number variables https://github.com/ruby/prism/commit/2cdbf81c95
2024-03-13 21:22:31 +03:00
$4294967296 # number `0`
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
comment: |
Represents reading a numbered reference to a capture in the previous match.
$1
^^
[ruby/prism] Split KeywordParameterNode into Optional and Required Prior to this commit, KeywordParameterNode included both optional and required keywords. With this commit, it is split in two, with `OptionalKeywordParameterNode`s no longer having a value field. https://github.com/ruby/prism/commit/89084d9af4
2023-10-31 23:00:28 +03:00
- name: OptionalKeywordParameterNode
[ruby/prism] Expose flags on every node type https://github.com/ruby/prism/commit/9f12a56fd6
2024-07-02 22:43:01 +03:00
flags: ParameterFlags
[ruby/prism] Split KeywordParameterNode into Optional and Required Prior to this commit, KeywordParameterNode included both optional and required keywords. With this commit, it is split in two, with `OptionalKeywordParameterNode`s no longer having a value field. https://github.com/ruby/prism/commit/89084d9af4
2023-10-31 23:00:28 +03:00
fields:
- name: name
type: constant
- name: name_loc
type: location
[ruby/prism] Flip incorrect names of OptionalKeywordParameterNode and RequiredKeywordParameterNode https://github.com/ruby/prism/commit/c31f61e898
2023-11-01 15:36:15 +03:00
- name: value
type: node
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
kind: non-void expression
[ruby/prism] Split KeywordParameterNode into Optional and Required Prior to this commit, KeywordParameterNode included both optional and required keywords. With this commit, it is split in two, with `OptionalKeywordParameterNode`s no longer having a value field. https://github.com/ruby/prism/commit/89084d9af4
2023-10-31 23:00:28 +03:00
comment: |
Represents an optional keyword parameter to a method, block, or lambda definition.
[ruby/prism] Flip incorrect names of OptionalKeywordParameterNode and RequiredKeywordParameterNode https://github.com/ruby/prism/commit/c31f61e898
2023-11-01 15:36:15 +03:00
def a(b: 1)
^^^^
[ruby/prism] Split KeywordParameterNode into Optional and Required Prior to this commit, KeywordParameterNode included both optional and required keywords. With this commit, it is split in two, with `OptionalKeywordParameterNode`s no longer having a value field. https://github.com/ruby/prism/commit/89084d9af4
2023-10-31 23:00:28 +03:00
end
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: OptionalParameterNode
[ruby/prism] Expose flags on every node type https://github.com/ruby/prism/commit/9f12a56fd6
2024-07-02 22:43:01 +03:00
flags: ParameterFlags
[ruby/yarp] Rename child_nodes to fields https://github.com/ruby/yarp/commit/715fce9264
2023-08-30 23:09:51 +03:00
fields:
[ruby/yarp] Rename constant pool fields to name or operator * `constant_id` and `operator_id` are confusing. * See https://github.com/ruby/yarp/issues/1296 https://github.com/ruby/yarp/commit/09d0a144df
2023-08-27 18:56:53 +03:00
- name: name
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
type: constant
- name: name_loc
type: location
- name: operator_loc
type: location
- name: value
type: node
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
kind: non-void expression
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
comment: |
Represents an optional parameter to a method, block, or lambda definition.
def a(b = 1)
^^^^^
end
- name: OrNode
[ruby/yarp] Rename child_nodes to fields https://github.com/ruby/yarp/commit/715fce9264
2023-08-30 23:09:51 +03:00
fields:
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: left
type: node
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
kind: non-void expression
[ruby/prism] Document AndNode and OrNode https://github.com/ruby/prism/commit/a925856c2b
2024-01-14 11:58:30 +03:00
comment: |
[PRISM] Sync to latest
2024-01-19 19:22:40 +03:00
Represents the left side of the expression. It can be any [non-void expression](https://github.com/ruby/prism/blob/main/docs/parsing_rules.md#non-void-expression).
[ruby/prism] Document AndNode and OrNode https://github.com/ruby/prism/commit/a925856c2b
2024-01-14 11:58:30 +03:00
[ruby/prism] Wording in node field comments https://github.com/ruby/prism/commit/c9c913ee99
2024-01-17 20:42:44 +03:00
left or right
^^^^
1 || 2
^
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: right
type: node
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
kind: Node
[ruby/prism] Document AndNode and OrNode https://github.com/ruby/prism/commit/a925856c2b
2024-01-14 11:58:30 +03:00
comment: |
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
Represents the right side of the expression.
[ruby/prism] Document AndNode and OrNode https://github.com/ruby/prism/commit/a925856c2b
2024-01-14 11:58:30 +03:00
[ruby/prism] Wording in node field comments https://github.com/ruby/prism/commit/c9c913ee99
2024-01-17 20:42:44 +03:00
left || right
^^^^^
1 or 2
^
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: operator_loc
type: location
[ruby/prism] Document AndNode and OrNode https://github.com/ruby/prism/commit/a925856c2b
2024-01-14 11:58:30 +03:00
comment: |
[ruby/prism] Wording in node field comments https://github.com/ruby/prism/commit/c9c913ee99
2024-01-17 20:42:44 +03:00
The location of the `or` keyword or the `||` operator.
[ruby/prism] Document AndNode and OrNode https://github.com/ruby/prism/commit/a925856c2b
2024-01-14 11:58:30 +03:00
[ruby/prism] Wording in node field comments https://github.com/ruby/prism/commit/c9c913ee99
2024-01-17 20:42:44 +03:00
left or right
^^
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
comment: |
Represents the use of the `||` operator or the `or` keyword.
left or right
^^^^^^^^^^^^^
- name: ParametersNode
[ruby/yarp] Rename child_nodes to fields https://github.com/ruby/yarp/commit/715fce9264
2023-08-30 23:09:51 +03:00
fields:
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: requireds
type: node[]
[ruby/prism] wip: node unions https://github.com/ruby/prism/commit/99a71675d4
2023-12-21 07:41:52 +03:00
kind:
- RequiredParameterNode
- MultiTargetNode
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: optionals
type: node[]
[ruby/prism] wip: node unions https://github.com/ruby/prism/commit/99a71675d4
2023-12-21 07:41:52 +03:00
kind: OptionalParameterNode
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: rest
type: node?
[ruby/prism] wip: node unions https://github.com/ruby/prism/commit/99a71675d4
2023-12-21 07:41:52 +03:00
kind:
- RestParameterNode
- ImplicitRestNode # Only in block parameters
[ruby/yarp] Move the post required parameters after the rest parameter * See https://github.com/ruby/yarp/issues/1436 https://github.com/ruby/yarp/commit/6f4e9ff940
2023-09-12 13:36:12 +03:00
- name: posts
type: node[]
[ruby/prism] wip: node unions https://github.com/ruby/prism/commit/99a71675d4
2023-12-21 07:41:52 +03:00
kind:
- RequiredParameterNode
- MultiTargetNode
# On parsing error of `f(**kwargs, ...)` or `f(**nil, ...)`, the keyword_rest value is moved here:
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
- on error: KeywordRestParameterNode
- on error: NoKeywordsParameterNode
[ruby/prism] Enhance parameter forwarding error messages https://github.com/ruby/prism/commit/826657232e
2024-05-10 18:39:51 +03:00
# On parsing error of `f(..., ...)`, the first forwarding parameter is moved here:
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
- on error: ForwardingParameterNode
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: keywords
type: node[]
[ruby/prism] wip: node unions https://github.com/ruby/prism/commit/99a71675d4
2023-12-21 07:41:52 +03:00
kind:
- RequiredKeywordParameterNode
- OptionalKeywordParameterNode
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: keyword_rest
type: node?
[ruby/prism] wip: node unions https://github.com/ruby/prism/commit/99a71675d4
2023-12-21 07:41:52 +03:00
kind:
- KeywordRestParameterNode
- ForwardingParameterNode
- NoKeywordsParameterNode
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: block
type: node?
kind: BlockParameterNode
comment: |
Represents the list of parameters on a method, block, or lambda definition.
def a(b, c, d)
^^^^^^^
end
- name: ParenthesesNode
[ruby/yarp] Rename child_nodes to fields https://github.com/ruby/yarp/commit/715fce9264
2023-08-30 23:09:51 +03:00
fields:
[ruby/yarp] Rename statements to body where appropriate https://github.com/ruby/yarp/commit/0aa7d9d10c
2023-08-19 03:47:58 +03:00
- name: body
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
type: node?
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
kind: non-void expression # Usually a StatementsNode but not always e.g. `1 in (..10)`
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: opening_loc
type: location
- name: closing_loc
type: location
newline: false
comment: |
Represents a parenthesized expression
(10 + 34)
^^^^^^^^^
- name: PinnedExpressionNode
[ruby/yarp] Rename child_nodes to fields https://github.com/ruby/yarp/commit/715fce9264
2023-08-30 23:09:51 +03:00
fields:
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: expression
type: node
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
kind: non-void expression
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: operator_loc
type: location
- name: lparen_loc
type: location
- name: rparen_loc
type: location
comment: |
[PRISM] Sync to latest
2024-01-19 19:22:40 +03:00
Represents the use of the `^` operator for pinning an expression in a pattern matching expression.
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
foo in ^(bar)
^^^^^^
- name: PinnedVariableNode
[ruby/yarp] Rename child_nodes to fields https://github.com/ruby/yarp/commit/715fce9264
2023-08-30 23:09:51 +03:00
fields:
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: variable
type: node
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
kind:
- LocalVariableReadNode
- InstanceVariableReadNode
- ClassVariableReadNode
- GlobalVariableReadNode # foo in ^$a
- BackReferenceReadNode # foo in ^$&
- NumberedReferenceReadNode # foo in ^$1
- ItLocalVariableReadNode # proc { 1 in ^it }
- on error: MissingNode # foo in ^Bar
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: operator_loc
type: location
comment: |
[PRISM] Sync to latest
2024-01-19 19:22:40 +03:00
Represents the use of the `^` operator for pinning a variable in a pattern matching expression.
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
foo in ^bar
^^^^
- name: PostExecutionNode
[ruby/yarp] Rename child_nodes to fields https://github.com/ruby/yarp/commit/715fce9264
2023-08-30 23:09:51 +03:00
fields:
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: statements
type: node?
kind: StatementsNode
- name: keyword_loc
type: location
- name: opening_loc
type: location
- name: closing_loc
type: location
comment: |
Represents the use of the `END` keyword.
END { foo }
^^^^^^^^^^^
- name: PreExecutionNode
[ruby/yarp] Rename child_nodes to fields https://github.com/ruby/yarp/commit/715fce9264
2023-08-30 23:09:51 +03:00
fields:
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: statements
type: node?
kind: StatementsNode
- name: keyword_loc
type: location
- name: opening_loc
type: location
- name: closing_loc
type: location
comment: |
Represents the use of the `BEGIN` keyword.
BEGIN { foo }
^^^^^^^^^^^^^
- name: ProgramNode
[ruby/yarp] Rename child_nodes to fields https://github.com/ruby/yarp/commit/715fce9264
2023-08-30 23:09:51 +03:00
fields:
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: locals
type: constant[]
- name: statements
type: node
kind: StatementsNode
comment: The top level node of any parse tree.
- name: RangeNode
[ruby/prism] Expose flags on every node type https://github.com/ruby/prism/commit/9f12a56fd6
2024-07-02 22:43:01 +03:00
flags: RangeFlags
[ruby/yarp] Rename child_nodes to fields https://github.com/ruby/yarp/commit/715fce9264
2023-08-30 23:09:51 +03:00
fields:
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: left
type: node?
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
kind: non-void expression
[ruby/prism] Add comments documenting RangeNode fields https://github.com/ruby/prism/commit/e6aef6499b
2024-01-07 15:54:43 +03:00
comment: |
[PRISM] Sync to latest
2024-01-19 19:22:40 +03:00
The left-hand side of the range, if present. It can be either `nil` or any [non-void expression](https://github.com/ruby/prism/blob/main/docs/parsing_rules.md#non-void-expression).
[ruby/prism] Fix spacing in documentation comment https://github.com/ruby/prism/commit/8408961e76 Co-authored-by: Kevin Newton <kddnewton@gmail.com>
2024-01-08 17:52:58 +03:00
[ruby/prism] Add comments documenting RangeNode fields https://github.com/ruby/prism/commit/e6aef6499b
2024-01-07 15:54:43 +03:00
1...
^
hello...goodbye
^^^^^
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: right
type: node?
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
kind: non-void expression
[ruby/prism] Add missing comment key https://github.com/ruby/prism/commit/723480a107
2024-01-08 18:01:01 +03:00
comment: |
[PRISM] Sync to latest
2024-01-19 19:22:40 +03:00
The right-hand side of the range, if present. It can be either `nil` or any [non-void expression](https://github.com/ruby/prism/blob/main/docs/parsing_rules.md#non-void-expression).
[ruby/prism] Add comments documenting RangeNode fields https://github.com/ruby/prism/commit/e6aef6499b
2024-01-07 15:54:43 +03:00
..5
^
1...foo
^^^
[PRISM] Sync to latest
2024-01-19 19:22:40 +03:00
If neither right-hand or left-hand side was included, this will be a MissingNode.
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: operator_loc
type: location
[ruby/prism] Add comments documenting RangeNode fields https://github.com/ruby/prism/commit/e6aef6499b
2024-01-07 15:54:43 +03:00
comment: |
The location of the `..` or `...` operator.
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
comment: |
Represents the use of the `..` or `...` operators.
1..2
^^^^
c if a =~ /left/ ... b =~ /right/
^^^^^^^^^^^^^^^^^^^^^^^^^^^^
- name: RationalNode
[ruby/prism] Expose flags on every node type https://github.com/ruby/prism/commit/9f12a56fd6
2024-07-02 22:43:01 +03:00
flags: IntegerBaseFlags
[ruby/yarp] Rename child_nodes to fields https://github.com/ruby/yarp/commit/715fce9264
2023-08-30 23:09:51 +03:00
fields:
[ruby/prism] Reconfigure rationals This eliminates the subnode on RationalNode and replaces it with two integer fields, which represent the ratio for the rational. It also reduces those two integers if they both fit into 32 bits. Importantly, this PR does not implement bignum reduction. That's something I'd like to consider for the future, but it's simple enough for now to leave them unreduced, which makes it more useful than it used to be. https://github.com/ruby/prism/commit/86e06c7068
2024-05-08 22:32:24 +03:00
- name: numerator
type: integer
comment: |
The numerator of the rational number.
1.5r # numerator 3
- name: denominator
type: integer
comment: |
The denominator of the rational number.
1.5r # denominator 2
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
comment: |
Represents a rational number literal.
1.0r
^^^^
- name: RedoNode
comment: |
Represents the use of the `redo` keyword.
redo
^^^^
- name: RegularExpressionNode
[ruby/prism] Expose flags on every node type https://github.com/ruby/prism/commit/9f12a56fd6
2024-07-02 22:43:01 +03:00
flags: RegularExpressionFlags
[ruby/yarp] Rename child_nodes to fields https://github.com/ruby/yarp/commit/715fce9264
2023-08-30 23:09:51 +03:00
fields:
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: opening_loc
type: location
- name: content_loc
type: location
- name: closing_loc
type: location
- name: unescaped
type: string
comment: |
Represents a regular expression literal with no interpolation.
/foo/i
^^^^^^
[ruby/prism] Split KeywordParameterNode into Optional and Required Prior to this commit, KeywordParameterNode included both optional and required keywords. With this commit, it is split in two, with `OptionalKeywordParameterNode`s no longer having a value field. https://github.com/ruby/prism/commit/89084d9af4
2023-10-31 23:00:28 +03:00
- name: RequiredKeywordParameterNode
[ruby/prism] Expose flags on every node type https://github.com/ruby/prism/commit/9f12a56fd6
2024-07-02 22:43:01 +03:00
flags: ParameterFlags
[ruby/prism] Split KeywordParameterNode into Optional and Required Prior to this commit, KeywordParameterNode included both optional and required keywords. With this commit, it is split in two, with `OptionalKeywordParameterNode`s no longer having a value field. https://github.com/ruby/prism/commit/89084d9af4
2023-10-31 23:00:28 +03:00
fields:
- name: name
type: constant
- name: name_loc
type: location
comment: |
Represents a required keyword parameter to a method, block, or lambda definition.
[ruby/prism] Flip incorrect names of OptionalKeywordParameterNode and RequiredKeywordParameterNode https://github.com/ruby/prism/commit/c31f61e898
2023-11-01 15:36:15 +03:00
def a(b: )
^^
[ruby/prism] Split KeywordParameterNode into Optional and Required Prior to this commit, KeywordParameterNode included both optional and required keywords. With this commit, it is split in two, with `OptionalKeywordParameterNode`s no longer having a value field. https://github.com/ruby/prism/commit/89084d9af4
2023-10-31 23:00:28 +03:00
end
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: RequiredParameterNode
[ruby/prism] Expose flags on every node type https://github.com/ruby/prism/commit/9f12a56fd6
2024-07-02 22:43:01 +03:00
flags: ParameterFlags
[ruby/yarp] Rename child_nodes to fields https://github.com/ruby/yarp/commit/715fce9264
2023-08-30 23:09:51 +03:00
fields:
[ruby/yarp] Rename constant pool fields to name or operator * `constant_id` and `operator_id` are confusing. * See https://github.com/ruby/yarp/issues/1296 https://github.com/ruby/yarp/commit/09d0a144df
2023-08-27 18:56:53 +03:00
- name: name
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
type: constant
comment: |
Represents a required parameter to a method, block, or lambda definition.
def a(b)
^
end
- name: RescueModifierNode
[ruby/yarp] Rename child_nodes to fields https://github.com/ruby/yarp/commit/715fce9264
2023-08-30 23:09:51 +03:00
fields:
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: expression
type: node
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
kind: Node
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: keyword_loc
type: location
- name: rescue_expression
type: node
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
kind: Node
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
newline: expression
comment: |
Represents an expression modified with a rescue.
[ruby/prism] Fix rescue modifier comment https://github.com/ruby/prism/commit/e13f2e4590
2023-11-01 20:02:04 +03:00
foo rescue nil
^^^^^^^^^^^^^^
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: RescueNode
[ruby/yarp] Rename child_nodes to fields https://github.com/ruby/yarp/commit/715fce9264
2023-08-30 23:09:51 +03:00
fields:
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: keyword_loc
type: location
- name: exceptions
type: node[]
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
kind: non-void expression
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: operator_loc
type: location?
- name: reference
type: node?
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
kind:
- LocalVariableTargetNode
- InstanceVariableTargetNode
- ClassVariableTargetNode
- GlobalVariableTargetNode
- ConstantTargetNode
- ConstantPathTargetNode
- CallTargetNode
- IndexTargetNode
- on error: BackReferenceReadNode # => begin; rescue => $&; end
- on error: NumberedReferenceReadNode # => begin; rescue => $1; end
- on error: MissingNode # begin; rescue =>; end
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: statements
type: node?
kind: StatementsNode
[PRISM] Field renaming Rename some fields that do not quite make sense. * CaseMatchNode#consequent -> CaseMatchNode#else_clause * CaseNode#consequent -> CaseNode#else_clause * IfNode#consequent -> IfNode#subsequent * RescueNode#consequent -> RescueNode#subsequent * UnlessNode#consequent -> UnlessNode#else_clause
2024-08-28 21:11:41 +03:00
- name: subsequent
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
type: node?
kind: RescueNode
comment: |
Represents a rescue statement.
begin
rescue Foo, *splat, Bar => ex
foo
[ruby/prism] Fix up Ruby docs https://github.com/ruby/prism/commit/8062849d0d
2023-10-30 20:01:35 +03:00
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
end
[PRISM] Sync to latest
2024-01-19 19:22:40 +03:00
`Foo, *splat, Bar` are in the `exceptions` field. `ex` is in the `exception` field.
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: RestParameterNode
[ruby/prism] Expose flags on every node type https://github.com/ruby/prism/commit/9f12a56fd6
2024-07-02 22:43:01 +03:00
flags: ParameterFlags
[ruby/yarp] Rename child_nodes to fields https://github.com/ruby/yarp/commit/715fce9264
2023-08-30 23:09:51 +03:00
fields:
[ruby/yarp] Constants on rest parameter nodes https://github.com/ruby/yarp/commit/a6fdb8aae9
2023-09-06 18:22:27 +03:00
- name: name
type: constant?
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: name_loc
type: location?
[ruby/yarp] Constants on rest parameter nodes https://github.com/ruby/yarp/commit/a6fdb8aae9
2023-09-06 18:22:27 +03:00
- name: operator_loc
type: location
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
comment: |
Represents a rest parameter to a method, block, or lambda definition.
def a(*b)
^^
end
- name: RetryNode
comment: |
Represents the use of the `retry` keyword.
retry
^^^^^
- name: ReturnNode
[ruby/yarp] Rename child_nodes to fields https://github.com/ruby/yarp/commit/715fce9264
2023-08-30 23:09:51 +03:00
fields:
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: keyword_loc
type: location
- name: arguments
type: node?
kind: ArgumentsNode
comment: |
Represents the use of the `return` keyword.
return 1
^^^^^^^^
- name: SelfNode
comment: |
Represents the `self` keyword.
self
^^^^
[ruby/prism] Shareable constant nodes https://github.com/ruby/prism/commit/473cfed6d0
2024-03-15 04:37:16 +03:00
- name: ShareableConstantNode
[ruby/prism] Expose flags on every node type https://github.com/ruby/prism/commit/9f12a56fd6
2024-07-02 22:43:01 +03:00
flags: ShareableConstantNodeFlags
[ruby/prism] Shareable constant nodes https://github.com/ruby/prism/commit/473cfed6d0
2024-03-15 04:37:16 +03:00
fields:
- name: write
type: node
kind:
- ConstantWriteNode
- ConstantAndWriteNode
- ConstantOrWriteNode
- ConstantOperatorWriteNode
- ConstantPathWriteNode
- ConstantPathAndWriteNode
- ConstantPathOrWriteNode
- ConstantPathOperatorWriteNode
comment: The constant write that should be modified with the shareability state.
comment: |
This node wraps a constant write to indicate that when the value is written, it should have its shareability state modified.
# shareable_constant_value: literal
C = { a: 1 }
^^^^^^^^^^^^
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: SingletonClassNode
[ruby/yarp] Rename child_nodes to fields https://github.com/ruby/yarp/commit/715fce9264
2023-08-30 23:09:51 +03:00
fields:
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: locals
type: constant[]
- name: class_keyword_loc
type: location
- name: operator_loc
type: location
- name: expression
type: node
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
kind: non-void expression
[ruby/yarp] Rename statements to body where appropriate https://github.com/ruby/yarp/commit/0aa7d9d10c
2023-08-19 03:47:58 +03:00
- name: body
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
type: node?
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
kind:
- StatementsNode
- BeginNode
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: end_keyword_loc
type: location
comment: |
Represents a singleton class declaration involving the `class` keyword.
class << self end
^^^^^^^^^^^^^^^^^
- name: SourceEncodingNode
comment: |
Represents the use of the `__ENCODING__` keyword.
__ENCODING__
^^^^^^^^^^^^
- name: SourceFileNode
[ruby/prism] Expose flags on every node type https://github.com/ruby/prism/commit/9f12a56fd6
2024-07-02 22:43:01 +03:00
flags: StringFlags
[ruby/yarp] Rename child_nodes to fields https://github.com/ruby/yarp/commit/715fce9264
2023-08-30 23:09:51 +03:00
fields:
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: filepath
type: string
[ruby/prism] Document `ArrayNode`, `SourceFileNode` fields https://github.com/ruby/prism/commit/0bdc566f67
2024-01-04 03:52:10 +03:00
comment: Represents the file path being parsed. This corresponds directly to the `filepath` option given to the various `Prism::parse*` APIs.
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
comment: |
Represents the use of the `__FILE__` keyword.
__FILE__
^^^^^^^^
- name: SourceLineNode
comment: |
Represents the use of the `__LINE__` keyword.
__LINE__
^^^^^^^^
- name: SplatNode
[ruby/yarp] Rename child_nodes to fields https://github.com/ruby/yarp/commit/715fce9264
2023-08-30 23:09:51 +03:00
fields:
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: operator_loc
type: location
- name: expression
type: node?
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
kind: non-void expression
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
comment: |
Represents the use of the splat operator.
[*a]
^^
- name: StatementsNode
[ruby/yarp] Rename child_nodes to fields https://github.com/ruby/yarp/commit/715fce9264
2023-08-30 23:09:51 +03:00
fields:
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: body
type: node[]
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
kind: Node
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
comment: |
Represents a set of statements contained within some scope.
foo; bar; baz
^^^^^^^^^^^^^
- name: StringNode
[ruby/prism] Expose flags on every node type https://github.com/ruby/prism/commit/9f12a56fd6
2024-07-02 22:43:01 +03:00
flags: StringFlags
[ruby/yarp] Rename child_nodes to fields https://github.com/ruby/yarp/commit/715fce9264
2023-08-30 23:09:51 +03:00
fields:
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: opening_loc
type: location?
- name: content_loc
type: location
- name: closing_loc
type: location?
- name: unescaped
type: string
comment: |
[PRISM] Sync to latest
2024-01-19 19:22:40 +03:00
Represents a string literal, a string contained within a `%w` list, or plain string content within an interpolated string.
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
"foo"
^^^^^
%w[foo]
^^^
"foo #{bar} baz"
^^^^ ^^^^
- name: SuperNode
[ruby/yarp] Rename child_nodes to fields https://github.com/ruby/yarp/commit/715fce9264
2023-08-30 23:09:51 +03:00
fields:
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: keyword_loc
type: location
- name: lparen_loc
type: location?
- name: arguments
type: node?
kind: ArgumentsNode
- name: rparen_loc
type: location?
- name: block
type: node?
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
kind:
- BlockNode
- BlockArgumentNode
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
comment: |
Represents the use of the `super` keyword with parentheses or arguments.
super()
^^^^^^^
super foo, bar
^^^^^^^^^^^^^^
- name: SymbolNode
[ruby/prism] Expose flags on every node type https://github.com/ruby/prism/commit/9f12a56fd6
2024-07-02 22:43:01 +03:00
flags: SymbolFlags
[ruby/yarp] Rename child_nodes to fields https://github.com/ruby/yarp/commit/715fce9264
2023-08-30 23:09:51 +03:00
fields:
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: opening_loc
type: location?
- name: value_loc
[ruby/yarp] Ensure interpolated symbols converted to regular symbols get opening and closing https://github.com/ruby/yarp/commit/386655d54f
2023-08-22 04:00:00 +03:00
type: location?
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: closing_loc
type: location?
- name: unescaped
type: string
comment: |
Represents a symbol literal or a symbol contained within a `%i` list.
:foo
^^^^
%i[foo]
^^^
- name: TrueNode
comment: |
Represents the use of the literal `true` keyword.
true
^^^^
- name: UndefNode
[ruby/yarp] Rename child_nodes to fields https://github.com/ruby/yarp/commit/715fce9264
2023-08-30 23:09:51 +03:00
fields:
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: names
type: node[]
[ruby/prism] Give a kind to all node[] fields which can have one more specific than "any Node" * Fixes https://github.com/ruby/prism/issues/2058 https://github.com/ruby/prism/commit/f3e3310b5e
2024-02-25 15:04:42 +03:00
kind:
- SymbolNode
- InterpolatedSymbolNode
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: keyword_loc
type: location
comment: |
Represents the use of the `undef` keyword.
undef :foo, :bar, :baz
^^^^^^^^^^^^^^^^^^^^^^
- name: UnlessNode
[ruby/yarp] Rename child_nodes to fields https://github.com/ruby/yarp/commit/715fce9264
2023-08-30 23:09:51 +03:00
fields:
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: keyword_loc
type: location
[ruby/prism] Document UnlessNode fields https://github.com/ruby/prism/commit/eee8276ae6
2024-01-19 17:19:28 +03:00
comment: |
The location of the `unless` keyword.
unless cond then bar end
^^^^^^
bar unless cond
^^^^^^
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: predicate
type: node
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
kind: non-void expression
[ruby/prism] Document UnlessNode fields https://github.com/ruby/prism/commit/eee8276ae6
2024-01-19 17:19:28 +03:00
comment: |
[PRISM] Sync latest config.yml documentation updates
2024-04-26 22:03:07 +03:00
The condition to be evaluated for the unless expression. It can be any [non-void expression](https://github.com/ruby/prism/blob/main/docs/parsing_rules.md#non-void-expression).
[ruby/prism] Document UnlessNode fields https://github.com/ruby/prism/commit/eee8276ae6
2024-01-19 17:19:28 +03:00
unless cond then bar end
^^^^
bar unless cond
^^^^
[ruby/prism] Track the then keyword for conditionals https://github.com/ruby/prism/commit/fef0019a25
2023-11-16 01:55:16 +03:00
- name: then_keyword_loc
type: location?
[ruby/prism] Document `ForNode` fields (https://github.com/ruby/prism/pull/2845) * Add document * fix * fix fmt * fix fmt * Revert "fix fmt" This reverts commit https://github.com/ruby/prism/commit/b23a05a94148. * add potition * fix fmt * reposition * fix indent * fix comment * fix indent https://github.com/ruby/prism/commit/0dd4c1bba1
2024-05-29 16:36:06 +03:00
comment: |
[ruby/prism] Document UnlessNode fields https://github.com/ruby/prism/commit/eee8276ae6
2024-01-19 17:19:28 +03:00
The location of the `then` keyword, if present.
unless cond then bar end
^^^^
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: statements
type: node?
kind: StatementsNode
[ruby/prism] Document UnlessNode fields https://github.com/ruby/prism/commit/eee8276ae6
2024-01-19 17:19:28 +03:00
comment: |
The body of statements that will executed if the unless condition is
falsey. Will be `nil` if no body is provided.
unless cond then bar end
^^^
[PRISM] Field renaming Rename some fields that do not quite make sense. * CaseMatchNode#consequent -> CaseMatchNode#else_clause * CaseNode#consequent -> CaseNode#else_clause * IfNode#consequent -> IfNode#subsequent * RescueNode#consequent -> RescueNode#subsequent * UnlessNode#consequent -> UnlessNode#else_clause
2024-08-28 21:11:41 +03:00
- name: else_clause
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
type: node?
kind: ElseNode
[ruby/prism] Document UnlessNode fields https://github.com/ruby/prism/commit/eee8276ae6
2024-01-19 17:19:28 +03:00
comment: |
The else clause of the unless expression, if present.
unless cond then bar else baz end
^^^^^^^^
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: end_keyword_loc
type: location?
[ruby/prism] Document UnlessNode fields https://github.com/ruby/prism/commit/eee8276ae6
2024-01-19 17:19:28 +03:00
comment: |
The location of the `end` keyword, if present.
unless cond then bar end
^^^
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
newline: predicate
comment: |
Represents the use of the `unless` keyword, either in the block form or the modifier form.
bar unless foo
^^^^^^^^^^^^^^
unless foo then bar end
^^^^^^^^^^^^^^^^^^^^^^^
- name: UntilNode
[ruby/prism] Expose flags on every node type https://github.com/ruby/prism/commit/9f12a56fd6
2024-07-02 22:43:01 +03:00
flags: LoopFlags
[ruby/yarp] Rename child_nodes to fields https://github.com/ruby/yarp/commit/715fce9264
2023-08-30 23:09:51 +03:00
fields:
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: keyword_loc
type: location
[ruby/yarp] Add closing_loc to UntilNode https://github.com/ruby/yarp/commit/4362cecc2c
2023-08-22 01:07:32 +03:00
- name: closing_loc
type: location?
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: predicate
type: node
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
kind: non-void expression
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: statements
type: node?
kind: StatementsNode
newline: predicate
comment: |
Represents the use of the `until` keyword, either in the block form or the modifier form.
bar until foo
^^^^^^^^^^^^^
until foo do bar end
^^^^^^^^^^^^^^^^^^^^
- name: WhenNode
[ruby/yarp] Rename child_nodes to fields https://github.com/ruby/yarp/commit/715fce9264
2023-08-30 23:09:51 +03:00
fields:
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: keyword_loc
type: location
- name: conditions
type: node[]
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
kind: non-void expression
[ruby/prism] Add then keyword loc to when nodes https://github.com/ruby/prism/commit/e1e613df16
2024-03-04 17:39:33 +03:00
- name: then_keyword_loc
type: location?
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: statements
type: node?
kind: StatementsNode
comment: |
Represents the use of the `when` keyword within a case statement.
case true
when true
^^^^^^^^^
end
- name: WhileNode
[ruby/prism] Expose flags on every node type https://github.com/ruby/prism/commit/9f12a56fd6
2024-07-02 22:43:01 +03:00
flags: LoopFlags
[ruby/yarp] Rename child_nodes to fields https://github.com/ruby/yarp/commit/715fce9264
2023-08-30 23:09:51 +03:00
fields:
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: keyword_loc
type: location
[ruby/yarp] Add closing_loc to WhileNode https://github.com/ruby/yarp/commit/b4132b876d
2023-08-22 01:10:47 +03:00
- name: closing_loc
type: location?
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: predicate
type: node
[ruby/prism] Type every node field and mark on-error-only types explicitly * For Loader.java, do not deserialize the AST if there are errors, so then Java nodes only have non-error types for fields. https://github.com/ruby/prism/commit/ae78e3c605
2024-08-28 23:32:30 +03:00
kind: non-void expression
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: statements
type: node?
kind: StatementsNode
newline: predicate
comment: |
Represents the use of the `while` keyword, either in the block form or the modifier form.
bar while foo
^^^^^^^^^^^^^
while foo do bar end
^^^^^^^^^^^^^^^^^^^^
- name: XStringNode
[ruby/prism] Expose flags on every node type https://github.com/ruby/prism/commit/9f12a56fd6
2024-07-02 22:43:01 +03:00
flags: EncodingFlags
[ruby/yarp] Rename child_nodes to fields https://github.com/ruby/yarp/commit/715fce9264
2023-08-30 23:09:51 +03:00
fields:
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: opening_loc
type: location
- name: content_loc
type: location
- name: closing_loc
type: location
- name: unescaped
type: string
comment: |
Represents an xstring literal with no interpolation.
`foo`
^^^^^
- name: YieldNode
[ruby/yarp] Rename child_nodes to fields https://github.com/ruby/yarp/commit/715fce9264
2023-08-30 23:09:51 +03:00
fields:
Render YARP templates in the build process (#8228)
2023-08-18 00:39:04 +03:00
- name: keyword_loc
type: location
- name: lparen_loc
type: location?
- name: arguments
type: node?
kind: ArgumentsNode
- name: rparen_loc
type: location?
comment: |
Represents the use of the `yield` keyword.
yield 1
^^^^^^^