rbs 3.7.0.dev.1 → 3.7.0

data/stdlib/open-uri/0/manifest.yaml

@@ -1,3 +1,4 @@
 dependencies:
   - name: tempfile
   - name: uri
+  - name: stringio

data/stdlib/openssl/0/manifest.yaml

@@ -1,2 +1,3 @@
 dependencies:
   - name: socket
+  - name: digest

data/stdlib/openssl/0/openssl.rbs

@@ -3164,7 +3164,7 @@ module OpenSSL
   #     sha256.reset
   #     digest2 = sha256.digest(data2)
   #
-  class Digest
+  class Digest < ::Digest::Class
     # <!--
     #   rdoc-file=ext/openssl/lib/openssl/digest.rb
     #   - digest(name, data)
@@ -3665,6 +3665,23 @@ module OpenSSL
     #
     def self.hexdigest: (String | Digest algo, String key, String data) -> String
 
+    # <!--
+    #   rdoc-file=ext/openssl/lib/openssl/hmac.rb
+    #   - HMAC.base64digest(digest, key, data) -> aString
+    # -->
+    # Returns the authentication code as a Base64-encoded string. The *digest*
+    # parameter specifies the digest algorithm to use. This may be a String
+    # representing the algorithm name or an instance of OpenSSL::Digest.
+    #
+    # ### Example
+    #     key = 'key'
+    #     data = 'The quick brown fox jumps over the lazy dog'
+    #
+    #     hmac = OpenSSL::HMAC.base64digest('SHA1', key, data)
+    #     #=> "3nybhbi3iqa8ino29wqQcBydtNk="
+    #
+    def self.base64digest: (String | Digest algo, String key, String data) -> String
+
     # <!-- rdoc-file=ext/openssl/ossl_hmac.c -->
     # Returns *hmac* updated with the message to be authenticated. Can be called
     # repeatedly with chunks of the message.
@@ -3712,6 +3729,14 @@ module OpenSSL
     #
     def hexdigest: () -> String
 
+    # <!--
+    #   rdoc-file=ext/openssl/lib/openssl/hmac.rb
+    #   - hmac.base64digest -> string
+    # -->
+    # Returns the authentication code an a Base64-encoded string.
+    #
+    def base64digest: () -> String
+
     # <!-- rdoc-file=ext/openssl/lib/openssl/hmac.rb -->
     # Returns the authentication code as a hex-encoded string. The *digest*
     # parameter specifies the digest algorithm to use. This may be a String

data/stdlib/psych/0/core_ext.rbs

@@ -0,0 +1,12 @@
+%a{annotate:rdoc:skip}
+class Object
+  # <!--
+  #   rdoc-file=ext/psych/lib/psych/core_ext.rb
+  #   - to_yaml(options = {})
+  # -->
+  # Convert an object to YAML.  See Psych.dump for more information on the
+  # available `options`.
+  #
+  def to_yaml: (?indentation: Integer, ?line_width: Integer, ?canonical: bool, ?header: bool) -> String
+             | [IO] (IO, ?indentation: Integer, ?line_width: Integer, ?canonical: bool, ?header: bool) -> IO
+end

data/templates/include/rbs/constants.h.erb

@@ -0,0 +1,20 @@
+#ifndef RBS__CONSTANTS_H
+#define RBS__CONSTANTS_H
+
+extern VALUE RBS;
+
+extern VALUE RBS_AST;
+extern VALUE RBS_AST_Declarations;
+extern VALUE RBS_AST_Directives;
+extern VALUE RBS_AST_Members;
+extern VALUE RBS_Types;
+extern VALUE RBS_Types_Bases;
+extern VALUE RBS_ParsingError;
+
+<%- nodes.each do |node| -%>
+extern VALUE <%= node.c_constant_name %>;
+<%- end -%>
+
+void rbs__init_constants();
+
+#endif

data/templates/include/rbs/ruby_objs.h.erb

@@ -0,0 +1,10 @@
+#ifndef RBS__RUBY_OBJS_H
+#define RBS__RUBY_OBJS_H
+
+#include "ruby.h"
+
+<%- nodes.each do |node| -%>
+VALUE <%= node.c_function_name %>(<%= node.fields.map { |field| "#{field.c_type} #{field.name}" }.join(", ") %>);
+<%- end -%>
+
+#endif

data/templates/src/constants.c.erb

@@ -0,0 +1,36 @@
+#include "rbs_extension.h"
+
+VALUE RBS_Parser;
+
+VALUE RBS;
+VALUE RBS_AST;
+VALUE RBS_AST_Declarations;
+VALUE RBS_AST_Directives;
+VALUE RBS_AST_Members;
+VALUE RBS_Parser;
+VALUE RBS_Types;
+VALUE RBS_Types_Bases;
+
+<%- nodes.each do |node| -%>
+VALUE <%= node.c_constant_name %>;
+<%- end -%>
+
+VALUE RBS_ParsingError;
+
+#define IMPORT_CONSTANT(var, parent, name) { var = rb_const_get(parent, rb_intern(name)); rb_gc_register_mark_object(var); }
+
+void rbs__init_constants(void) {
+  IMPORT_CONSTANT(RBS, rb_cObject, "RBS");
+  IMPORT_CONSTANT(RBS_ParsingError, RBS, "ParsingError");
+
+  IMPORT_CONSTANT(RBS_AST, RBS, "AST");
+  IMPORT_CONSTANT(RBS_AST_Declarations, RBS_AST, "Declarations");
+  IMPORT_CONSTANT(RBS_AST_Directives, RBS_AST, "Directives");
+  IMPORT_CONSTANT(RBS_AST_Members, RBS_AST, "Members");
+  IMPORT_CONSTANT(RBS_Types, RBS, "Types");
+  IMPORT_CONSTANT(RBS_Types_Bases, RBS_Types, "Bases");
+
+  <%- nodes.each do |node| -%>
+  IMPORT_CONSTANT(<%= node.c_constant_name %>, <%= node.c_parent_constant_name %>, "<%= node.ruby_class_name %>");
+  <%- end -%>
+}

data/templates/src/ruby_objs.c.erb

@@ -0,0 +1,27 @@
+#include "rbs_extension.h"
+
+#ifdef RB_PASS_KEYWORDS
+  // Ruby 2.7 or later
+  #define CLASS_NEW_INSTANCE(klass, argc, argv)\
+          rb_class_new_instance_kw(argc, argv, klass, RB_PASS_KEYWORDS)
+#else
+  // Ruby 2.6
+  #define CLASS_NEW_INSTANCE(receiver, argc, argv)\
+          rb_class_new_instance(argc, argv, receiver)
+#endif
+
+<%- nodes.each do |node| -%>
+VALUE <%= node.c_function_name %>(<%= node.fields.map { |field| "#{field.c_type} #{field.name}" }.join(", ") %>) {
+  VALUE _init_kwargs = rb_hash_new();
+  <%- node.fields.each do |field| -%>
+  rb_hash_aset(_init_kwargs, ID2SYM(rb_intern("<%= field.name %>")), <%= field.name %>);
+  <%- end -%>
+
+  return CLASS_NEW_INSTANCE(
+    <%= node.c_constant_name %>,
+    1,
+    &_init_kwargs
+  );
+}
+
+<%- end -%>

data/templates/template.rb

@@ -0,0 +1,122 @@
+# frozen_string_literal: true
+
+require "erb"
+require "fileutils"
+require "yaml"
+
+module RBS
+  class Template
+    class Field
+      attr_reader :name
+      attr_reader :c_type
+
+      def initialize(yaml)
+        @name = yaml["name"]
+        @c_type = "VALUE"
+      end
+    end
+
+    class Type
+      # The fully-qualified name of the auto-generated Ruby class for this type,
+      # e.g. `RBS::AST::Declarations::TypeAlias`
+      attr_reader :ruby_full_name #: String
+
+      # The name of the name of the auto-generated Ruby class for this type,
+      # e.g. `TypeAlias`
+      attr_reader :ruby_class_name #: String
+
+      # The name of the auto-generated C struct for this type,
+      # e.g. `rbs_ast_declarations_typealias_t`
+      attr_reader :c_type_name #: String
+
+      # The name of the pre-existing C function which constructs new Ruby objects of this type.
+      # e.g. `rbs_ast_declarations_typealias_new`
+      attr_reader :c_function_name #: String
+
+      # The name of the C constant which stores the Ruby VALUE pointing to the generated class.
+      # e.g. `RBS_AST_Declarations_TypeAlias`
+      attr_reader :c_constant_name #: String
+
+      # The name of the C constant in which the `c_constant_name` is nested.
+      # e.g. `RBS_AST_Declarations`
+      attr_reader :c_parent_constant_name #: String
+
+      attr_reader :fields #: Array[RBS::Template::Field]
+
+      def initialize(yaml)
+        @ruby_full_name = yaml["name"]
+        @ruby_class_name = @ruby_full_name[/[^:]+\z/] # demodulize-like
+        name = @ruby_full_name.gsub("::", "_")
+        @c_function_name = name.gsub(/(^)?(_)?([A-Z](?:[A-Z]*(?=[A-Z_])|[a-z0-9]*))/) { ($1 || $2 || "_") + $3.downcase } # underscore-like
+        @c_function_name.gsub!(/^rbs_types_/, 'rbs_')
+        @c_function_name.gsub!(/^rbs_ast_declarations_/, 'rbs_ast_decl_')
+        @c_constant_name = @ruby_full_name.gsub("::", "_")
+        @c_parent_constant_name = @ruby_full_name.split("::")[0..-2].join("::").gsub("::", "_")
+
+        @fields = yaml.fetch("fields", []).map { |field| Field.new(field) }.freeze
+      end
+    end
+
+    class << self
+      def render(out_file)
+        filepath = "templates/#{out_file}.erb"
+        template = File.expand_path("../#{filepath}", __dir__)
+
+        erb = read_template(template)
+        extension = File.extname(filepath.gsub(".erb", ""))
+
+        heading = <<~HEADING
+          /*----------------------------------------------------------------------------*/
+          /* This file is generated by the templates/template.rb script and should not  */
+          /* be modified manually.                                                      */
+          /* To change the template see                                                 */
+          /* #{filepath + " " * (74 - filepath.size) } */
+          /*----------------------------------------------------------------------------*/
+        HEADING
+
+        write_to = File.expand_path("../#{out_file}", __dir__)
+        contents = heading + "\n" + erb.result_with_hash(locals)
+
+        if (extension == ".c" || extension == ".h") && !contents.ascii_only?
+          # Enforce that we only have ASCII characters here. This is necessary
+          # for non-UTF-8 locales that only allow ASCII characters in C source
+          # files.
+          contents.each_line.with_index(1) do |line, line_number|
+            raise "Non-ASCII character on line #{line_number} of #{write_to}" unless line.ascii_only?
+          end
+        end
+
+        FileUtils.mkdir_p(File.dirname(write_to))
+        File.write(write_to, contents)
+      end
+
+      private
+
+      def read_template(filepath)
+        template = File.read(filepath, encoding: Encoding::UTF_8)
+        erb = erb(template)
+        erb.filename = filepath
+        erb
+      end
+
+      def erb(template)
+        ERB.new(template, trim_mode: "-")
+      end
+
+      def locals
+        config = YAML.load_file(File.expand_path("../config.yml", __dir__))
+        {
+          nodes: config.fetch("nodes").map { |node| Type.new(node) }.sort_by(&:ruby_full_name),
+        }
+      end
+    end
+  end
+end
+
+unless ARGV.size == 1
+  $stderr.puts "Usage: ruby template.rb <out_file>"
+  exit 1
+end
+
+out_file = ARGV.first
+RBS::Template.render(out_file)

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: rbs
 version: !ruby/object:Gem::Version
-  version: 3.7.0.dev.1
+  version: 3.7.0
 platform: ruby
 authors:
 - Soutaro Matsumoto
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2024-11-15 00:00:00.000000000 Z
+date: 2024-12-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: logger
@@ -48,6 +48,7 @@ files:
 - README.md
 - Rakefile
 - Steepfile
+- config.yml
 - core/array.rbs
 - core/basic_object.rbs
 - core/binding.rbs
@@ -121,7 +122,6 @@ files:
 - core/set.rbs
 - core/signal.rbs
 - core/string.rbs
-- core/string_io.rbs
 - core/struct.rbs
 - core/symbol.rbs
 - core/thread.rbs
@@ -143,8 +143,6 @@ files:
 - docs/syntax.md
 - docs/tools.md
 - exe/rbs
-- ext/rbs_extension/constants.c
-- ext/rbs_extension/constants.h
 - ext/rbs_extension/extconf.rb
 - ext/rbs_extension/lexer.c
 - ext/rbs_extension/lexer.h
@@ -158,10 +156,11 @@ files:
 - ext/rbs_extension/parserstate.c
 - ext/rbs_extension/parserstate.h
 - ext/rbs_extension/rbs_extension.h
-- ext/rbs_extension/ruby_objs.c
-- ext/rbs_extension/ruby_objs.h
 - ext/rbs_extension/unescape.c
 - goodcheck.yml
+- include/rbs.h
+- include/rbs/constants.h
+- include/rbs/ruby_objs.h
 - lib/rbs.rb
 - lib/rbs/ancestor_graph.rb
 - lib/rbs/annotate.rb
@@ -342,6 +341,8 @@ files:
 - sig/version.rbs
 - sig/visitor.rbs
 - sig/writer.rbs
+- src/constants.c
+- src/ruby_objs.c
 - stdlib/abbrev/0/abbrev.rbs
 - stdlib/abbrev/0/array.rbs
 - stdlib/base64/0/base64.rbs
@@ -379,7 +380,6 @@ files:
 - stdlib/logger/0/period.rbs
 - stdlib/logger/0/severity.rbs
 - stdlib/minitest/0/kernel.rbs
-- stdlib/minitest/0/manifest.yaml
 - stdlib/minitest/0/minitest.rbs
 - stdlib/minitest/0/minitest/abstract_reporter.rbs
 - stdlib/minitest/0/minitest/assertion.rbs
@@ -388,6 +388,8 @@ files:
 - stdlib/minitest/0/minitest/bench_spec.rbs
 - stdlib/minitest/0/minitest/benchmark.rbs
 - stdlib/minitest/0/minitest/composite_reporter.rbs
+- stdlib/minitest/0/minitest/compress.rbs
+- stdlib/minitest/0/minitest/error_on_warning.rbs
 - stdlib/minitest/0/minitest/expectation.rbs
 - stdlib/minitest/0/minitest/expectations.rbs
 - stdlib/minitest/0/minitest/guard.rbs
@@ -412,6 +414,7 @@ files:
 - stdlib/minitest/0/minitest/test.rbs
 - stdlib/minitest/0/minitest/test/lifecycle_hooks.rbs
 - stdlib/minitest/0/minitest/unexpected_error.rbs
+- stdlib/minitest/0/minitest/unexpected_warning.rbs
 - stdlib/minitest/0/minitest/unit.rbs
 - stdlib/minitest/0/minitest/unit/test_case.rbs
 - stdlib/monitor/0/monitor.rbs
@@ -436,6 +439,7 @@ files:
 - stdlib/pp/0/pp.rbs
 - stdlib/prettyprint/0/prettyprint.rbs
 - stdlib/pstore/0/pstore.rbs
+- stdlib/psych/0/core_ext.rbs
 - stdlib/psych/0/dbm.rbs
 - stdlib/psych/0/manifest.yaml
 - stdlib/psych/0/psych.rbs
@@ -467,6 +471,7 @@ files:
 - stdlib/socket/0/udp_socket.rbs
 - stdlib/socket/0/unix_server.rbs
 - stdlib/socket/0/unix_socket.rbs
+- stdlib/stringio/0/stringio.rbs
 - stdlib/strscan/0/string_scanner.rbs
 - stdlib/tempfile/0/tempfile.rbs
 - stdlib/time/0/time.rbs
@@ -509,6 +514,11 @@ files:
 - stdlib/zlib/0/version_error.rbs
 - stdlib/zlib/0/zlib.rbs
 - stdlib/zlib/0/zstream.rbs
+- templates/include/rbs/constants.h.erb
+- templates/include/rbs/ruby_objs.h.erb
+- templates/src/constants.c.erb
+- templates/src/ruby_objs.c.erb
+- templates/template.rb
 homepage: https://github.com/ruby/rbs
 licenses:
 - BSD-2-Clause
@@ -532,7 +542,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.23
+rubygems_version: 3.5.22
 signing_key:
 specification_version: 4
 summary: Type signature for Ruby.