prism 2.0.0.rc1-aarch64-linux-gnu → 2.0.0.rc2-aarch64-linux-gnu

data/sig/generated/prism/parse_result.rbs

@@ -30,8 +30,11 @@ module Prism
     # empty when the source is created by the parser and filled in afterward,
     # because the comments themselves refer to the source.
     #
-    # : (String source, Integer start_line, Array[Integer] offsets, ?Array[Comment] comments, ?Array[Comment] comment_attachments, ?Array[Integer?] comment_ranges) -> Source
-    def self.for: (String source, Integer start_line, Array[Integer] offsets, ?Array[Comment] comments, ?Array[Comment] comment_attachments, ?Array[Integer?] comment_ranges) -> Source
+    # The checksum parameter is the value described by the attribute of the same
+    # name. It is nil when the source is not created by the parser.
+    #
+    # : (String source, Integer start_line, Array[Integer] offsets, ?Array[Comment] comments, ?Array[Comment] comment_attachments, ?Array[Integer?] comment_ranges, ?Integer? checksum) -> Source
+    def self.for: (String source, Integer start_line, Array[Integer] offsets, ?Array[Comment] comments, ?Array[Comment] comment_attachments, ?Array[Integer?] comment_ranges, ?Integer? checksum) -> Source
 
     # The source code that this source object represents.
     attr_reader source: String
@@ -39,6 +42,10 @@ module Prism
     # The line number where this source starts.
     attr_reader start_line: Integer
 
+    # The checksum of the source code which can be used to quickly determine if
+    # the source has changed.
+    attr_reader checksum: Integer?
+
     # The list of comments that were encountered during parsing. When the source
     # is parsed with the attach_comments option, these are sorted by start
     # offset.
@@ -66,14 +73,19 @@ module Prism
     # parameter can be either an Array of Integer byte offsets or a packed
     # binary string of uint32_t values (from the C extension).
     #
-    # : (String source, Integer start_line, Array[Integer] | String offsets, ?Array[Comment] comments, ?Array[Comment] comment_attachments, ?Array[Integer?] comment_ranges) -> void
-    def initialize: (String source, Integer start_line, Array[Integer] | String offsets, ?Array[Comment] comments, ?Array[Comment] comment_attachments, ?Array[Integer?] comment_ranges) -> void
+    # : (String source, Integer start_line, Array[Integer] | String offsets, ?Array[Comment] comments, ?Array[Comment] comment_attachments, ?Array[Integer?] comment_ranges, ?Integer? checksum) -> void
+    def initialize: (String source, Integer start_line, Array[Integer] | String offsets, ?Array[Comment] comments, ?Array[Comment] comment_attachments, ?Array[Integer?] comment_ranges, ?Integer? checksum) -> void
 
     # Replace the value of start_line with the given value.
     #
     # : (Integer start_line) -> void
     def replace_start_line: (Integer start_line) -> void
 
+    # Replace the value of checksum with the given value.
+    #
+    # : (Integer checksum) -> void
+    def replace_checksum: (Integer checksum) -> void
+
     # Replace the value of offsets with the given value.
     #
     # : (Array[Integer] offsets) -> void

data/sig/generated/prism/serialize.rbs

@@ -149,6 +149,9 @@ module Prism
       # : () -> Integer
       def load_uint32: () -> Integer
 
+      # : () -> Integer
+      def load_uint64: () -> Integer
+
       # : (ConstantPool constant_pool, Encoding encoding, bool freeze) -> node?
       def load_optional_node: (ConstantPool constant_pool, Encoding encoding, bool freeze) -> node?
 

data/sig/generated/prism/string_query.rbs

@@ -10,6 +10,8 @@ module Prism
 
     def self.method_name?: (String string) -> bool
 
+    def self.keyword?: (String string) -> bool
+
     # The string that this query is wrapping.
     attr_reader string: String
 
@@ -32,5 +34,10 @@ module Prism
     #
     # : () -> bool
     def method_name?: () -> bool
+
+    # Whether or not this string is a valid keyword.
+    #
+    # : () -> bool
+    def keyword?: () -> bool
   end
 end

data/src/buffer.c

@@ -186,6 +186,15 @@ pm_buffer_append_double(pm_buffer_t *buffer, double value) {
     pm_buffer_append(buffer, source, sizeof(double));
 }
 
+/**
+ * Append a 64-bit unsigned integer to the buffer in native endian order.
+ */
+void
+pm_buffer_append_uint64(pm_buffer_t *buffer, uint64_t value) {
+    const void *source = &value;
+    pm_buffer_append(buffer, source, sizeof(uint64_t));
+}
+
 /**
  * Append a unicode codepoint to the buffer.
  */

data/src/parser.c

@@ -5,8 +5,10 @@
 #include "prism/internal/diagnostic.h"
 #include "prism/internal/encoding.h"
 #include "prism/internal/magic_comments.h"
+#include "prism/internal/xxh3.h"
 
 #include <stdlib.h>
+#include <string.h>
 
 /**
  * Register a callback that will be called whenever prism changes the encoding
@@ -131,6 +133,22 @@ pm_parser_data_loc(const pm_parser_t *parser) {
     return &parser->data_loc;
 }
 
+/**
+ * Returns the checksum of the source code that was parsed.
+ */
+uint64_t
+pm_parser_checksum(const pm_parser_t *parser) {
+    const uint8_t *end = parser->end;
+
+    if (parser->data_loc.length != 0) {
+        const uint8_t *cursor = parser->start + parser->data_loc.start;
+        const uint8_t *newline = memchr(cursor, '\n', (size_t) (end - cursor));
+        if (newline != NULL) end = newline + 1;
+    }
+
+    return pm_xxh3(parser->start, (size_t) (end - parser->start));
+}
+
 /**
  * Returns whether the given parser is continuable, meaning that it could become
  * valid if more input were appended, as opposed to being definitively invalid.