tcepsni 0.2.0 → 0.3.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3695b6a1a12979fa76824819d4f839ce4e3b9a2af040f97eca9e474609c5c1f2
-  data.tar.gz: 373da53b2e230d3510f2043f25b8ae7cf017fae689fdfbaa92a388be4155ebcd
+  metadata.gz: 40d96c10a7e7729b0c37648bedd7b693dff04602d9bc3ef9794e695d48986864
+  data.tar.gz: f6316e6ceba71e2a7cee7d99140357a08e52c598e31324016159d301ffb791e5
 SHA512:
-  metadata.gz: f646aecf1094e4e171581b52ca0e48dccddc4464bf158f4c30b93e8df7ef7b8989b240e9c61abf25a7cb65c2c9a29ec6978529f627a1c360f0fede299624d297
-  data.tar.gz: 573e5e82c5c7a0b476ee93255fe6b6fc7992febcee911e54ee1b852c9acacca29950bc67183ec01cbed7c3cf3cfcce3edd21137f1c04400bff42959d6f1d72c8
+  metadata.gz: e3235426ddaeed30dd132dfc2f904259abe5da867aa4e17aa683d43d42112d8ded52575e4cb3e218c39fcc0f4f1a84175594279f5e07e221da08a5d03afe79f7
+  data.tar.gz: 3e79b0c3e3f29d5044cdc7051e980db49d1a49fd54a7fa8299386056f38864887fe04238319177d5fa9f0bbe4bd07c773a9c4fe279b2875b80fdf7e9f5bcbac8

data/CHANGELOG.md

@@ -2,6 +2,22 @@
 
 ## Unreleased
 
+## 0.3.1 - 2024-07-21
+
+Update gemspec fields etc.
+There should be no API changes.
+
+## 0.3.0 - 2023-11-18
+
+### Changed
+
+- Introduced plugin system.
+  For example, if the source contains `Pathname` objects, use the `vendors` option like `Tcepsni.parse(str, vendors: [::Tcepsni::Vendor::Pathname])`.
+
+### Removed
+
+- `Tcepsni::Class#string_scanner?`, `Tcepsni::Class#pathname?`, `Tcepsni::Class#ipaddr?`, `Tcepsni::Class#active_support_ordered_options?`, and `Tcepsni::Class#rails_paths_root?`.
+
 ## 0.2.0 - 2023-10-20
 
 ### Added

data/README.md

@@ -15,7 +15,7 @@ Tcepsni has a parsing method `Tcepsni.parse(str)`, which returns a parsed Ruby o
 ## Development
 
 After checking out the repo, run `bin/setup` to install dependencies.
-Then, run `rake test-unit` to run the tests.
+Then, run `rake test` to run the tests.
 You can also run `bin/console` for an interactive prompt that will allow you to experiment.
 
 To install this gem onto your local machine, run `bundle exec rake install`.
@@ -27,7 +27,7 @@ Bug reports and pull requests are welcome.
 
 ## License
 
-Copyright 2023 gemmaro.
+Copyright 2023, 2024 gemmaro.
 
 Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License.
 You may obtain a copy of the License at [Apache Software Foundation - Apache License, Version 2.0][asl].

data/lib/tcepsni/parser.rb

@@ -0,0 +1,165 @@
+require 'strscan'
+require 'forwardable'
+
+module Tcepsni
+  class Parser
+    def initialize(source, vendors:)
+      @scanner = ::StringScanner.new(source)
+      @vendors = vendors.flat_map { |vendor| [*vendor.dependencies, vendor] }.uniq
+    end
+
+    # If it returned nil when failed, it collides with normal nil value.
+    def parse_expression
+      if @scanner.skip(/nil\b/)
+        nil
+      elsif @scanner.skip(/true\b/)
+        true
+      elsif @scanner.skip(/false\b/)
+        false
+      elsif @scanner.skip(':')
+        parse_identifier
+      elsif @scanner.skip('"')
+        parse_string
+      elsif @scanner.skip('[')
+        parse_array
+      elsif @scanner.skip('{')
+        parse_hash
+      elsif @scanner.skip('#<')
+        pos = @scanner.pos
+        @vendors.select { |vendor| vendor.object? }.each do |vendor|
+          @scanner.pos = pos
+          return vendor.parse(self)
+        rescue Error
+          next
+        end
+        @scanner.pos = pos
+        parse_object
+      elsif (digits = @scanner.scan(/\d+/))
+        int = Integer(digits)
+        if @scanner.skip('.')
+          int2 = parse_integer
+          Float("#{int}.#{int2}")
+        elsif digits.size == 4 && @scanner.skip(/-(?<month>[01]\d)-(?<day>\d\d) (?<hour>[012]\d):(?<minute>[0-5]\d):(?<second>[0-5]\d) (?<zone>[+-]\d\d\d\d)/)
+          Time.new(Integer(int), @scanner[:month], @scanner[:day],
+                   @scanner[:hour], @scanner[:minute], @scanner[:second],
+                   @scanner[:zone])
+        else
+          int
+        end
+      else
+        parse_class
+      end
+    end
+
+    alias parse parse_expression
+
+    def parse_integer
+      int = @scanner.scan(/\d+/) or raise Error, 'no digits'
+      Integer(int)
+    end
+
+    def parse_identifier
+      id = @scanner.scan(/[A-Za-z_][A-Za-z0-9_]*/) or raise Error, 'no identifier'
+      id.intern
+    end
+
+    def parse_string
+      result = ''
+      until @scanner.eos?
+        if @scanner.skip('"')
+          return result
+        elsif @scanner.skip('\\"')
+          result << '"'
+        else
+          result << @scanner.getch
+        end
+      end
+      result
+    end
+
+    def parse_array
+      result = []
+      until @scanner.eos?
+        begin
+          result << parse_expression
+        rescue StandardError
+          break
+        end
+        @scanner.skip(', ') or break
+      end
+      @scanner.skip(']') or raise Error, "no array closer: #{@scanner.inspect}"
+      result
+    end
+
+    def parse_hash
+      result = {}
+      until @scanner.eos?
+        key = begin
+          parse_expression
+        rescue StandardError
+          break
+        end
+        @scanner.skip('=>') or raise Error, 'no hash arrow'
+        value = parse_expression
+        result[key] = value
+        @scanner.skip(', ') or break
+      end
+      @scanner.skip('}') or raise Error, 'no hash closer'
+      result
+    end
+
+    def parse_class
+      namespaces = [parse_capitalized_identifier]
+      until @scanner.eos?
+        @scanner.skip('::') or break
+        @scanner.eos? and raise Error, 'incomplete class'
+        namespaces << parse_capitalized_identifier
+      end
+      *namespaces, name = namespaces
+      Tcepsni::Class.new(name:, namespaces:)
+    end
+
+    def parse_capitalized_identifier
+      id = @scanner.scan(/[A-Z][A-Za-z0-9_]*/) or raise Error, "no capitalized identifier: #{@scanner.inspect}"
+      id.intern
+    end
+
+    def parse_object
+      klass = parse_class
+      if klass.encoding?
+        @scanner.skip(':') or raise Error, 'no colon separator in encoding object'
+        @scanner.skip(/(?<name>[^>]+)>/) or raise Error, 'invalid encoding name'
+        Encoding.find(@scanner[:name])
+      else
+        memory_reference = parse_memory_reference
+        attributes = parse_attributes
+        Tcepsni::Object.new(klass:, memory_reference:, attributes:)
+      end
+    end
+
+    def parse_attributes
+      attributes = {}
+      unless @scanner.skip('>')
+        until @scanner.eos?
+          @scanner.skip(' @') or break
+          key = parse_identifier
+          @scanner.skip('=') or raise Error, 'no attribute keyval equal char'
+          attributes[key.intern] = parse_expression
+          unless @scanner.skip(',')
+            @scanner.skip('>') or raise Error, "no object closer: #{@scanner.inspect}"
+            break
+          end
+        end
+      end
+      attributes
+    end
+
+    def parse_memory_reference
+      @scanner.skip(/:(?<memory_reference>0x[0-9a-f]{16})/) or raise Error, "no memory reference: #{@scanner.inspect}"
+      Integer(@scanner[:memory_reference])
+    end
+
+    extend Forwardable
+    def_delegators :@scanner, :skip, :[]
+  end
+end

data/lib/tcepsni/vendor/activesupport/ordered_options.rb

@@ -0,0 +1,28 @@
+require 'active_support/ordered_options'
+
+module Tcepsni
+  module Vendor
+    module ActiveSupport
+      class OrderedOptions
+        def self.parse(parser)
+          parser.skip('ActiveSupport::OrderedOptions {') or raise Error, 'no space between ActiveSupport::OrderedOptions class name and hash opener'
+          hash = parser.parse_hash
+          parser.skip('>') or raise Error, "no ActiveSupport ordered options closer: #{parser.scanner.inspect}"
+          options = ::ActiveSupport::OrderedOptions.new
+          hash.each do |key, val|
+            options[key] = val
+          end
+          options
+        end
+
+        def self.dependencies
+          []
+        end
+
+        def self.object?
+          true
+        end
+      end
+    end
+  end
+end

data/lib/tcepsni/vendor/ipaddr.rb

@@ -0,0 +1,20 @@
+require 'ipaddr'
+
+module Tcepsni
+  module Vendor
+    class IPAddr
+      def self.parse(parser)
+        parser.skip(/IPAddr: IPv[46]:(?<addr>[^>]+)>/) or raise Error, 'invalid IP address format error'
+        ::IPAddr.new(parser[:addr])
+      end
+
+      def self.object?
+        true
+      end
+
+      def self.dependencies
+        []
+      end
+    end
+  end
+end

data/lib/tcepsni/vendor/pathname.rb

@@ -0,0 +1,21 @@
+require 'pathname'
+
+module Tcepsni
+  module Vendor
+    class Pathname
+      def self.parse(parser)
+        parser.skip('Pathname:') or raise Error, 'no colon between Pathname class name and path string'
+        parser.skip(/(?<path>[^>]+)>/) or raise Error, 'invalid path string and closer'
+        ::Pathname.new(parser[:path])
+      end
+
+      def self.object?
+        true
+      end
+
+      def self.dependencies
+        []
+      end
+    end
+  end
+end

data/lib/tcepsni/vendor/rails/paths/root.rb

@@ -0,0 +1,37 @@
+require 'rails/paths'
+
+module Tcepsni
+  module Vendor
+    module Rails
+      module Paths
+        class Root
+          attr_reader :memory_reference, :attributes
+
+          def initialize(memory_reference, attributes)
+            @memory_reference = memory_reference
+            @attributes = attributes
+          end
+
+          def self.parse(parser)
+            parser.skip('Rails::Paths::Root') or raise Error, 'this is not Rails::Paths::Root'
+            memory_reference = parser.parse_memory_reference
+            attributes = if parser.skip(' ...>')
+                           {}
+                         else
+                           parser.parse_attributes
+                         end
+            Tcepsni::Vendor::Rails::Paths::Root.new(memory_reference, attributes)
+          end
+
+          def self.object?
+            true
+          end
+
+          def self.dependencies
+            [::Tcepsni::Vendor::Pathname]
+          end
+        end
+      end
+    end
+  end
+end

data/lib/tcepsni/vendor/string_scanner.rb

@@ -0,0 +1,35 @@
+module Tcepsni
+  module Vendor
+    class StringScanner
+      attr_reader :pos, :total, :scanned, :rest
+
+      def initialize(pos:, total:, scanned:, rest:)
+        @pos = pos
+        @total = total
+        @scanned = scanned
+        @rest = rest
+      end
+
+      def self.parse(parser)
+        parser.skip('StringScanner ') or raise Error, 'no space after string scanner class name'
+        pos = parser.parse_integer
+        parser.skip('/') or raise Error, 'no string scanner progress delimiter slash'
+        total = parser.parse_integer
+        parser.skip(' "') or raise Error, 'no space after string scanner progress'
+        scanned = parser.parse_string
+        parser.skip(' @ "') or raise Error, "no string scanner mark in string: #{parser.scanner.inspect}"
+        rest = parser.parse_string
+        parser.skip('>') or raise Error, 'no string scanner closer'
+        Tcepsni::Vendor::StringScanner.new(pos:, total:, scanned:, rest:)
+      end
+
+      def self.dependencies
+        []
+      end
+
+      def self.object?
+        true
+      end
+    end
+  end
+end

data/lib/tcepsni/version.rb

@@ -1,3 +1,3 @@
 module Tcepsni
-  VERSION = '0.2.0'
+  VERSION = '0.3.1'
 end

data/lib/tcepsni.rb

@@ -1,190 +1,11 @@
-require 'strscan'
-require 'pathname'
-require 'ipaddr'
-require 'active_support/ordered_options'
-require 'rails/paths'
 require_relative 'tcepsni/version'
+require_relative 'tcepsni/parser'
 
 module Tcepsni
-  class Error < StandardError; end
+  Error = Class.new(StandardError)
 
-  def self.parse(str)
-    scanner = ::StringScanner.new(str)
-    parse_expression(scanner)
-  end
-
-  class << self
-    private
-
-    # If it returned nil when failed, it collides with normal nil value.
-    def parse_expression(scanner)
-      if scanner.skip(/nil\b/)
-        nil
-      elsif scanner.skip(/true\b/)
-        true
-      elsif scanner.skip(/false\b/)
-        false
-      elsif scanner.skip(':')
-        parse_identifier(scanner)
-      elsif scanner.skip('"')
-        parse_string(scanner)
-      elsif scanner.skip('[')
-        parse_array(scanner)
-      elsif scanner.skip('{')
-        parse_hash(scanner)
-      elsif scanner.skip('#<')
-        parse_object(scanner)
-      else
-        if (digits = scanner.scan(/\d+/))
-          int = Integer(digits)
-          if scanner.skip('.')
-            int2 = parse_integer(scanner)
-            Float("#{int}.#{int2}")
-          elsif digits.size == 4 && scanner.skip(/-(?<month>[01]\d)-(?<day>\d\d) (?<hour>[012]\d):(?<minute>[0-5]\d):(?<second>[0-5]\d) (?<zone>[+-]\d\d\d\d)/)
-            Time.new(Integer(int), scanner[:month], scanner[:day],
-                     scanner[:hour], scanner[:minute], scanner[:second],
-                     scanner[:zone])
-          else
-            int
-          end
-        else
-          parse_class(scanner)
-        end
-      end
-    end
-
-    def parse_integer(scanner)
-      int = scanner.scan(/\d+/) or raise Error, 'no digits'
-      Integer(int)
-    end
-
-    def parse_identifier(scanner)
-      id = scanner.scan(/[A-Za-z_][A-Za-z0-9_]*/) or raise Error, 'no identifier'
-      id.intern
-    end
-
-    def parse_string(scanner)
-      result = ''
-      until scanner.eos?
-        if scanner.skip('"')
-          return result
-        elsif scanner.skip('\\"')
-          result << '"'
-        else
-          result << scanner.getch
-        end
-      end
-      result
-    end
-
-    def parse_array(scanner)
-      result = []
-      until scanner.eos?
-        result << parse_expression(scanner) rescue break
-        scanner.skip(', ') or break
-      end
-      scanner.skip(']') or raise Error, "no array closer: #{scanner.inspect}"
-      result
-    end
-
-    def parse_hash(scanner)
-      result = {}
-      until scanner.eos?
-        key = parse_expression(scanner) rescue break
-        scanner.skip('=>') or raise Error, 'no hash arrow'
-        value = parse_expression(scanner)
-        result[key] = value
-        scanner.skip(', ') or break
-      end
-      scanner.skip('}') or raise Error, 'no hash closer'
-      result
-    end
-
-    def parse_class(scanner)
-      namespaces = [parse_capitalized_identifier(scanner)]
-      until scanner.eos?
-        scanner.skip('::') or break
-        scanner.eos? and raise Error, 'incomplete class'
-        namespaces << parse_capitalized_identifier(scanner)
-      end
-      *namespaces, name = namespaces
-      Tcepsni::Class.new(name: name, namespaces: namespaces)
-    end
-
-    def parse_capitalized_identifier(scanner)
-      id = scanner.scan(/[A-Z][A-Za-z0-9_]*/) or raise Error, "no capitalized identifier: #{scanner.inspect}"
-      id.intern
-    end
-
-    def parse_object(scanner)
-      klass = parse_class(scanner)
-      if klass.string_scanner?
-        scanner.skip(' ') or raise Error, 'no space after string scanner class name'
-        pos = parse_integer(scanner)
-        scanner.skip('/') or raise Error, 'no string scanner progress delimiter slash'
-        total = parse_integer(scanner)
-        scanner.skip(' "') or raise Error, 'no space after string scanner progress'
-        scanned = parse_string(scanner)
-        scanner.skip(' @ "') or raise Error, "no string scanner mark in string: #{scanner.inspect}"
-        rest = parse_string(scanner)
-        scanner.skip('>') or raise Error, 'no string scanner closer'
-        Tcepsni::Vendor::StringScanner.new(pos: pos, total: total, scanned: scanned, rest: rest)
-      elsif klass.pathname?
-        scanner.skip(':') or raise Error, 'no colon between Pathname class name and path string'
-        scanner.skip(/(?<path>[^>]+)>/) or raise Error, 'invalid path string and closer'
-        Pathname(scanner[:path])
-      elsif klass.encoding?
-        scanner.skip(':') or raise Error, 'no colon separator in encoding object'
-        scanner.skip(/(?<name>[^>]+)>/) or raise Error, 'invalid encoding name'
-        Encoding.find(scanner[:name])
-      elsif klass.ipaddr?
-        scanner.skip(/: IPv[46]:(?<addr>[^>]+)>/) or raise Error, 'invalid IP address format error'
-        IPAddr.new(scanner[:addr])
-      elsif klass.active_support_ordered_options?
-        scanner.skip(' {') or raise Error, 'no space between ActiveSupport::OrderedOptions class name and hash opener'
-        hash = parse_hash(scanner)
-        scanner.skip('>') or raise Error, "no ActiveSupport ordered options closer: #{scanner.inspect}"
-        options = ActiveSupport::OrderedOptions.new
-        hash.each do |key, val|
-          options[key] = val
-        end
-        options
-      elsif klass.rails_paths_root?
-        memory_reference = parse_memory_reference(scanner)
-        if scanner.skip(' ...>')
-          attributes = {}
-        else
-          attributes = parse_attributes(scanner)
-        end
-        Tcepsni::Vendor::Rails::Paths::Root.new(memory_reference, attributes)
-      else
-        memory_reference = parse_memory_reference(scanner)
-        attributes = parse_attributes(scanner)
-        Tcepsni::Object.new(klass: klass, memory_reference: memory_reference, attributes: attributes)
-      end
-    end
-
-    def parse_attributes(scanner)
-      attributes = {}
-      unless scanner.skip('>')
-        until scanner.eos?
-          scanner.skip(' @') or break
-          key = parse_identifier(scanner)
-          scanner.skip('=') or raise Error, 'no attribute keyval equal char'
-          attributes[key.intern] = parse_expression(scanner)
-          unless scanner.skip(',')
-            scanner.skip('>') or raise Error, "no object closer: #{scanner.inspect}"
-            break
-          end
-        end
-      end
-      attributes
-    end
-
-    def parse_memory_reference(scanner)
-      scanner.skip(/:(?<memory_reference>0x[0-9a-f]{16})/) or raise Error, "no memory reference: #{scanner.inspect}"
-      Integer(scanner[:memory_reference])
-    end
+  def self.parse(str, vendors: [])
+    Parser.new(str, vendors:).parse
   end
 
   class Class
@@ -195,29 +16,9 @@ module Tcepsni
       @namespaces = namespaces
     end
 
-    def string_scanner?
-      @name == :StringScanner && @namespaces.empty?
-    end
-
-    def pathname?
-      @name == :Pathname
-    end
-
     def encoding?
       @name == :Encoding && @namespaces.empty?
     end
-
-    def ipaddr?
-      @name == :IPAddr && @namespaces.empty?
-    end
-
-    def active_support_ordered_options?
-      @name == :OrderedOptions && @namespaces == [:ActiveSupport]
-    end
-
-    def rails_paths_root?
-      @name == :Root && @namespaces == [:Rails, :Paths]
-    end
   end
 
   class Object
@@ -229,30 +30,4 @@ module Tcepsni
       @memory_reference = memory_reference
     end
   end
-
-  module Vendor
-    class StringScanner
-      attr_reader :pos, :total, :scanned, :rest
-
-      def initialize(pos:, total:, scanned:, rest:)
-        @pos = pos
-        @total = total
-        @scanned = scanned
-        @rest = rest
-      end
-    end
-
-    module Rails
-      module Paths
-        class Root
-          attr_reader :memory_reference, :attributes
-
-          def initialize(memory_reference, attributes)
-            @memory_reference = memory_reference
-            @attributes = attributes
-          end
-        end
-      end
-    end
-  end
 end

data/sig/tcepsni.gen.rbs

@@ -4,18 +4,27 @@
 module Tcepsni
   VERSION: String
 
-# def self.parse: (String str) -> parsed
-  def self.parse_expression: (untyped scanner) -> ((Array[(Array[(Class | Float | Integer | Object | String | Time | bool)?] | Hash[Object?, Object?] | Object)?] | Hash[Object?, (Array[Object?] | Hash[Object?, Object?] | Object)?] | Object)?)
-  def self.parse_integer: (untyped scanner) -> Integer
-  def self.parse_identifier: (untyped scanner) -> untyped
-  def self.parse_string: (untyped scanner) -> String
-  def self.parse_array: (untyped scanner) -> (Array[(Array[(Array[untyped] | Class | Float | Hash[(Class | Float | Integer | Object | String | Time | bool)?, untyped] | Integer | Object | String | Time | bool)?] | Hash[Object?, (Array[untyped] | Hash[Object?, untyped] | Object)?] | Object)?])
-  def self.parse_hash: (untyped scanner) -> (Hash[Object?, (Array[(Array[untyped] | Hash[Object?, untyped] | Object)?] | Hash[Object?, (Array[untyped] | Hash[Object?, untyped] | Object)?] | Object)?])
-  def self.parse_class: (untyped scanner) -> Class
-  def self.parse_capitalized_identifier: (untyped scanner) -> untyped
-  def self.parse_object: (untyped scanner) -> (Encoding | IPAddr | Object | Pathname | Vendor::Rails::Paths::Root | Vendor::StringScanner)
-  def self.parse_attributes: (untyped scanner) -> (Hash[untyped, (Array[(Array[untyped] | Hash[Object?, untyped] | Object)?] | Hash[Object?, (Array[untyped] | Hash[Object?, untyped] | Object)?] | Object)?])
-  def self.parse_memory_reference: (untyped scanner) -> Integer
+# def self.parse: (String str) -> untyped
+
+  class Parser
+    extend Forwardable
+    @scanner: StringScanner
+    @vendors: Array[Array[untyped]]
+
+  # def initialize: (String source, vendors: Array[untyped]?) -> void
+  # def parse_expression: -> untyped
+    alias parse parse_expression
+  # def parse_integer: -> Integer
+  # def parse_identifier: -> Symbol
+  # def parse_string: -> String
+  # def parse_array: -> Array[untyped]
+  # def parse_hash: -> Hash[untyped, untyped]
+  # def parse_class: -> Class
+  # def parse_capitalized_identifier: -> Symbol
+  # def parse_object: -> Object
+  # def parse_attributes: -> Hash[Symbol, untyped]
+  # def parse_memory_reference: -> Integer
+  end
 
   class Class
   # def initialize: (name: Symbol?, namespaces: Array[Symbol]) -> void
@@ -31,29 +40,55 @@ module Tcepsni
   end
 
   class Object
-  # def initialize: (klass: Class, attributes: Hash[Symbol, parsed], memory_reference: Integer) -> void
+  # def initialize: (klass: Class, attributes: Hash[Symbol, untyped], memory_reference: Integer) -> void
   # attr_reader klass: Class
-  # attr_reader attributes: Hash[Symbol, (Array[untyped] | Array[untyped] | Class | Hash[untyped, untyped] | Hash[untyped, untyped] | Integer | Object | String | StringScanner | Symbol | bool)?]
+  # attr_reader attributes: Hash[Symbol, untyped]
   # attr_reader memory_reference: Integer
   end
 
   module Vendor
     class StringScanner
-    # def initialize: (pos: Integer, total: Integer, scanned: String, rest: String) -> void
-    # attr_reader pos: Integer
-    # attr_reader total: Integer
-    # attr_reader scanned: String
-    # attr_reader rest: String
+      attr_reader pos: untyped
+      attr_reader total: untyped
+      attr_reader scanned: untyped
+      attr_reader rest: untyped
+      def initialize: (pos: untyped, total: untyped, scanned: untyped, rest: untyped) -> void
+      def self.parse: (untyped parser) -> StringScanner
+      def self.dependencies: -> Array[untyped]
+      def self.object?: -> true
     end
 
     module Rails
       module Paths
         class Root
-        # def initialize: (Integer memory_reference, Hash[Symbol, parsed?] attributes) -> void
-        # attr_reader memory_reference: Integer
-        # attr_reader attributes: Hash[Symbol, (Array[untyped] | Array[untyped] | Class | Hash[untyped, untyped] | Hash[untyped, untyped] | Integer | Object | String | StringScanner | Symbol | bool)?]
+          attr_reader memory_reference: untyped
+          attr_reader attributes: Hash[untyped, untyped]
+          def initialize: (untyped memory_reference, Hash[untyped, untyped] attributes) -> void
+          def self.parse: (untyped parser) -> Root
+          def self.object?: -> true
+          def self.dependencies: -> [singleton(Pathname)]
         end
       end
     end
+
+    module ActiveSupport
+      class OrderedOptions
+        def self.parse: (untyped parser) -> untyped
+        def self.dependencies: -> Array[untyped]
+        def self.object?: -> true
+      end
+    end
+
+    class IPAddr
+      def self.parse: (untyped parser) -> IPAddr
+      def self.object?: -> true
+      def self.dependencies: -> Array[untyped]
+    end
+
+    class Pathname
+      def self.parse: (untyped parser) -> Pathname
+      def self.object?: -> true
+      def self.dependencies: -> Array[untyped]
+    end
   end
 end

data/sig/tcepsni.rbs

@@ -4,11 +4,23 @@ module Tcepsni
   class Error < StandardError
   end
 
-  type parsed = nil | Symbol | FalseClass | TrueClass | Integer | String |
-                Array[parsed] | Hash[parsed, parsed] |
-		Class | Object | StringScanner
+  def self.parse: (String str) -> untyped
 
-  def self.parse: (String str) -> parsed
+  class Parser
+    def initialize: (String source, vendors: Array[untyped]?) -> void
+    def parse_expression: -> untyped
+    alias parse parse_expression
+    def parse_integer: -> Integer
+    def parse_identifier: -> Symbol
+    def parse_string: -> String
+    def parse_array: -> Array[untyped]
+    def parse_hash: -> Hash[untyped, untyped]
+    def parse_class: -> Class
+    def parse_capitalized_identifier: -> Symbol
+    def parse_object: -> Object
+    def parse_attributes: -> Hash[Symbol, untyped]
+    def parse_memory_reference: -> Integer
+  end
 
   class Class
     attr_reader name: Symbol
@@ -25,28 +37,31 @@ module Tcepsni
 
   class Object
     attr_reader klass: ::Class
-    attr_reader attributes: Hash[Symbol, parsed]
+    attr_reader attributes: Hash[Symbol, untyped]
     attr_reader memory_reference: Integer
-    def initialize: (klass: Class, attributes: Hash[Symbol, parsed], memory_reference: Integer) -> void
+    def initialize: (klass: Class, attributes: Hash[Symbol, untyped], memory_reference: Integer) -> void
   end
 
   module Vendor
     class StringScanner
-      attr_reader pos: Integer
-      attr_reader total: Integer
-      attr_reader scanned: String
-      attr_reader rest: String
-      def initialize: (pos: Integer, total: Integer, scanned: String, rest: String) -> void
     end
 
     module Rails
       module Paths
         class Root
-          attr_reader memory_reference: Integer
-          attr_reader attributes: Hash[Symbol, parsed?]
-          def initialize: (Integer memory_reference, Hash[Symbol, parsed?] attributes) -> void
         end
       end
     end
+
+    module ActiveSupport
+      class OrderedOptions
+      end
+    end
+
+    class IPAddr
+    end
+
+    class Pathname
+    end
   end
 end

data/tcepsni.gemspec

@@ -9,10 +9,22 @@ Gem::Specification.new do |spec|
   spec.summary = 'inspected Ruby objects parser'
   spec.description = 'Tcepsni gem is a parser library for inspected strings of Ruby objects.'
   spec.license = 'Apache-2.0'
+
+  spec.homepage = 'https://codeberg.org/gemmaro/tcepsni'
+
   spec.required_ruby_version = '>= 3.1.0'
 
   spec.files = Dir['lib/**/*.rb'] + Dir['sig/**/*.rbs'] +
                ['CHANGELOG.md', 'tcepsni.gemspec', 'README.md', 'LICENSE.txt']
   spec.require_paths = ['lib']
-  spec.metadata['rubygems_mfa_required'] = 'true'
+
+  spec.metadata = {
+    'rubygems_mfa_required' => 'true',
+    'bug_tracker_uri' => 'https://codeberg.org/gemmaro/tcepsni/issues',
+    'changelog_uri' => 'https://codeberg.org/gemmaro/tcepsni/src/branch/main/CHANGELOG.md',
+    'documentation_uri' => 'https://www.rubydoc.info/gems/tcepsni',
+    'homepage_uri' => spec.homepage,
+    'source_code_uri' => spec.homepage,
+    'wiki_uri' => 'https://codeberg.org/gemmaro/tcepsni/wiki'
+  }
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: tcepsni
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.1
 platform: ruby
 authors:
 - gemmaro
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2023-10-20 00:00:00.000000000 Z
+date: 2024-07-21 00:00:00.000000000 Z
 dependencies: []
 description: Tcepsni gem is a parser library for inspected strings of Ruby objects.
 email:
@@ -21,15 +21,27 @@ files:
 - LICENSE.txt
 - README.md
 - lib/tcepsni.rb
+- lib/tcepsni/parser.rb
+- lib/tcepsni/vendor/activesupport/ordered_options.rb
+- lib/tcepsni/vendor/ipaddr.rb
+- lib/tcepsni/vendor/pathname.rb
+- lib/tcepsni/vendor/rails/paths/root.rb
+- lib/tcepsni/vendor/string_scanner.rb
 - lib/tcepsni/version.rb
 - sig/tcepsni.gen.rbs
 - sig/tcepsni.rbs
 - tcepsni.gemspec
-homepage:
+homepage: https://codeberg.org/gemmaro/tcepsni
 licenses:
 - Apache-2.0
 metadata:
   rubygems_mfa_required: 'true'
+  bug_tracker_uri: https://codeberg.org/gemmaro/tcepsni/issues
+  changelog_uri: https://codeberg.org/gemmaro/tcepsni/src/branch/main/CHANGELOG.md
+  documentation_uri: https://www.rubydoc.info/gems/tcepsni
+  homepage_uri: https://codeberg.org/gemmaro/tcepsni
+  source_code_uri: https://codeberg.org/gemmaro/tcepsni
+  wiki_uri: https://codeberg.org/gemmaro/tcepsni/wiki
 post_install_message:
 rdoc_options: []
 require_paths: