prism 0.29.0 → 1.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4ac8167684c0f975fdba449e77206d97756f6c39f22ce871f79a79a61260503f
-  data.tar.gz: 6a2dd5c0a47df7c8c575ad2e5b344c789d548e93cfe82e5fa29974d46a52bb3c
+  metadata.gz: cc945a81285247ae139110607116e5ad0211e008f8e69d76002238755deca5dc
+  data.tar.gz: 81703e9b86fd950af63fbea201f8cd9ddec3a3a330d24c80aba7461782bb347b
 SHA512:
-  metadata.gz: dfa7fe63285b85cb45aa0be681916d6891ee5e5adf2162ab5c18423417f7938afc99f00eca8fd6187fbd0b7168af088d932fbda3c1361d1c73953f39329bed70
-  data.tar.gz: 79bc51db60600d74a6bfbeae5eba3a8ec505e9809d0f7ff0b05563f1f7a8cd284cc293233397323a443217a4a5271f90b4c40516168ae3a8be0ddc2d7376cef9
+  metadata.gz: 39fb25eec8d603cd26f31ce75281e3cf257f8f21451e6687eda11d14e090013651284b1f7b35612004b0603105883d0e1d8de1d82b192ce5238843e03203e9fa
+  data.tar.gz: 4544a22d735276ca60cf3dd4e7b91ce64aa60539d555466d73d3eebb91502a0a357232bd1c0722232f3745481e554ba6ab2eb7a23f05a25e5d0c114f9077dc52

data/CHANGELOG.md

@@ -6,6 +6,115 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/) a
 
 ## [Unreleased]
 
+## [1.3.0] - 2024-12-21
+
+### Added
+
+- Introduce `Prism::StringQuery`.
+- Introduce `Prism::Relocation`.
+- Track `do` keyword for `WhileNode` and `UntilNode`.
+- Change the way the gem is built to rely on `mkmf` instead of `make`.
+- Lots more documentation on node fields.
+
+### Changed
+
+- Properly add an error for `def @foo; end`.
+- Properly add an error for `foo(**, *)`.
+- Fix up regression in string parsing in `RubyParser` translation.
+- Reject invalid dot method call after match expression.
+- Reject invalid operator after match expression.
+- Fix up %-literals delimited by newlines.
+- Properly add an error for `-> { _1; -> { _1 } }`.
+- Reject blocks and keywords in index writes.
+
+## [1.2.0] - 2024-10-10
+
+### Added
+
+- Introduce `Prism::CodeUnitsCache`.
+
+### Changed
+
+- Properly handle lexing global variables that begin with `$-`.
+- Properly reject invalid multi writes within parentheses.
+- Fix unary `*` binding power.
+- Set `contains_keywords` flag for implicit `gets` calls when `-p` is used.
+- Properly reject invalid non-associative operator patterns.
+- Do not warn about unused variables declared on negative lines.
+
+## [1.1.0] - 2024-10-02
+
+### Added
+
+- Explicitly type each child node field in the Ruby API.
+- Add the `main_script` option to the parse APIs, which controls whether or not shebangs are considered.
+- Add the `partial_script` options to the parse APIs, which controls whether or not jumps that would otherwise be considered invalid are allowed. This is useful for parsing things like ERB sources, where you know it will be evaluated in a different context. Note that this functionality is replacing the previous idiom of passing in a list of scopes to indicate an `eval` context, because that behavior has changed upstream in `ruby/ruby`.
+- Add `ArgumentsNode#contains_multiple_splats?`.
+- Add `ArgumentsNode#contains_forwarding?`.
+- Accept all valid Ruby versions for the `version` option on parse APIs.
+- Accept version shorthands like `"3.3"` and `"3.4"` for the `version` option on parse APIs.
+- Support a max depth to protect against malicious payloads without hitting the stack limit.
+
+### Changed
+
+- Fix some token incompatibilities in the `parser` translation.
+- Fix up parsing tempfiles on Windows.
+- Fix up handling UTF-8 characters in file paths on Windows.
+- Do not warn for a `\r` at the end of a shebang on Windows.
+- Properly handle erroring for parsing a directory on Windows.
+- When a numbered reference is out of range, warn instead of raise.
+- Allow returns in default parameter values.
+- Reject many more invalid syntax patterns.
+
+## [1.0.0] - 2024-08-28
+
+### Added
+
+- Add `Node#breadth_first_search`.
+- Add `Node#node_id`.
+- Add `ArgumentsNode#contains_splat?`.
+- Passing the special value `false` for the `encoding` option tells Prism to ignore magic encoding comments.
+- Expose flags on every node type (allows checking static literal and newline).
+- Implement mismatched indentation warning.
+- Add C API for receiving a callback when parsing shebangs with additional flags.
+
+### Changed
+
+- **BREAKING**: Some fields are renamed that had illogical names. The previous names all now emit deprecation warnings.
+  - `CaseMatchNode#consequent` was renamed to `CaseMatchNode#else_clause`
+  - `CaseNode#consequent` was renamed to `CaseNode#else_clause`
+  - `IfNode#consequent` was renamed to `IfNode#subsequent`
+  - `RescueNode#consequent` was renamed to `RescueNode#subsequent`
+  - `UnlessNode#consequent` was renamed to `UnlessNode#else_clause`
+- Block exits are now allowed in loop predicates (e.g., `while _ && break do end`).
+- Multi-writes are now disallowed when not at the statement level.
+- Ensure that range operators are non-associative.
+- (JavaScript) Correctly deserialize encoded strings.
+- Properly support parsing regular expressions in extended mode.
+- Use gmake on FreeBSD.
+- Parsing streams now handles NUL bytes in the middle of the stream.
+- Properly detect invalid returns.
+
+## [0.30.0] - 2024-06-07
+
+### Added
+
+- More correctly raise mixed encoding errors.
+- Implement ambiguous binary operator warning.
+- Fix up regexp escapes with control and meta characters.
+- Fix up support for the `it` implicit local variable.
+- Heredoc identifiers now properly disallow CLRF.
+- Errors added for void value expressions in begin clauses.
+- Many updates to more closely match the `parser` gem in parser translation.
+- Many errors added for invalid regular expressions.
+
+### Changed
+
+- Handle parser translation missing the `parser` gem.
+- Handle ruby_parser translation missing the `ruby_parser` gem.
+- Various error messages have been updated to more closely match CRuby.
+- `RationalNode` now has a `numerator` and `denominator` field instead of a `numeric` field. For the Ruby API we provide a `RationalNode#numeric` method for backwards-compatibility.
+
 ## [0.29.0] - 2024-05-10
 
 ### Added
@@ -518,7 +627,12 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/) a
 
 - 🎉 Initial release! 🎉
 
-[unreleased]: https://github.com/ruby/prism/compare/v0.29.0...HEAD
+[unreleased]: https://github.com/ruby/prism/compare/v1.3.0...HEAD
+[1.3.0]: https://github.com/ruby/prism/compare/v1.2.0...v1.3.0
+[1.2.0]: https://github.com/ruby/prism/compare/v1.1.0...v1.2.0
+[1.1.0]: https://github.com/ruby/prism/compare/v1.0.0...v1.1.0
+[1.0.0]: https://github.com/ruby/prism/compare/v0.30.0...v1.0.0
+[0.30.0]: https://github.com/ruby/prism/compare/v0.29.0...v0.30.0
 [0.29.0]: https://github.com/ruby/prism/compare/v0.28.0...v0.29.0
 [0.28.0]: https://github.com/ruby/prism/compare/v0.27.0...v0.28.0
 [0.27.0]: https://github.com/ruby/prism/compare/v0.26.0...v0.27.0

data/CONTRIBUTING.md

@@ -10,10 +10,6 @@ The discussions page on the GitHub repository are open. If you have a question o
 
 If you want to contribute code, please first open or contribute to a discussion. A lot of the project is in flux, and we want to make sure that you are contributing to the right place. Once you have a discussion going, you can open a pull request with your changes. We will review your code and get it merged in.
 
-### Ruby Features
-
-Pattern matching and endless method definitions should be avoided as long as the latest TruffleRuby release does not support it.
-
 ## Tests
 
 We could always use more tests! One of the biggest challenges of this project is building up a big test suite. If you want to contribute tests, feel free to open a pull request. These will get merged in as soon as possible.

data/Makefile

@@ -11,7 +11,7 @@ FUZZ_OUTPUT_DIR = $(CURDIR)/fuzz/output
 SOEXT ?= $(shell ruby -e 'puts RbConfig::CONFIG["SOEXT"]')
 
 CPPFLAGS := -Iinclude $(CPPFLAGS)
-CFLAGS := -g -O2 -std=c99 -Wall -Werror -Wextra -Wpedantic -Wundef -Wconversion -Wno-missing-braces -fPIC -fvisibility=hidden $(CFLAGS)
+CFLAGS := -g -O2 -std=c99 -Wall -Werror -Wextra -Wpedantic -Wundef -Wconversion -Wno-missing-braces -fPIC -fvisibility=hidden -Wimplicit-fallthrough $(CFLAGS)
 CC ?= cc
 AR ?= ar
 WASI_SDK_PATH := /opt/wasi-sdk

data/README.md

@@ -40,6 +40,8 @@ The repository contains the infrastructure for both a shared library (libprism)
 ├── rust
 │   ├── ruby-prism        Rustified crate for the shared library
 │   └── ruby-prism-sys    FFI binding for Rust
+├── sample
+│   └── prism             Sample code that uses the Ruby API for documentation purposes
 ├── sig                   RBS type signatures for the Ruby library
 ├── src
 │   ├── util              various utility files
@@ -119,6 +121,7 @@ Prism has been integrated into the majority of Ruby runtimes, many libraries, an
 ### Libraries
 
 * [dispersion](https://github.com/joeldrapper/dispersion)
+* [minifyrb](https://github.com/koic/minifyrb)
 * [packwerk](https://github.com/Shopify/packwerk/pull/388) (via parser translator)
 * [rbi](https://github.com/Shopify/rbi)
 * [rails](https://github.com/rails/rails)
@@ -131,6 +134,7 @@ Prism has been integrated into the majority of Ruby runtimes, many libraries, an
 * [smart_todo](https://github.com/Shopify/smart_todo/pull/69)
 * [sorbet-eraser](https://github.com/kddnewton/sorbet-eraser/pull/25)
 * [synvert](https://github.com/xinminlabs/synvert-core-ruby)
+* [typeprof](https://github.com/ruby/typeprof)
 
 ### Applications