json-repair 0.2.0 → 0.4.0

data/sig/json/repair/string_utils.rbs

@@ -0,0 +1,165 @@
+module JSON
+  module Repair
+    module StringUtils
+      @output: untyped
+
+      @index: untyped
+
+      # Constants for character chars
+      BACKSLASH: "\\"
+
+      SLASH: "/"
+
+      ASTERISK: "*"
+
+      OPENING_BRACE: "{"
+
+      CLOSING_BRACE: "}"
+
+      OPENING_BRACKET: "["
+
+      CLOSING_BRACKET: "]"
+
+      OPEN_PARENTHESIS: "("
+
+      CLOSE_PARENTHESIS: ")"
+
+      SPACE: " "
+
+      NEWLINE: "\n"
+
+      TAB: "\t"
+
+      RETURN: "\r"
+
+      BACKSPACE: "\b"
+
+      FORM_FEED: "\f"
+
+      DOUBLE_QUOTE: "\""
+
+      PLUS: "+"
+
+      MINUS: "-"
+
+      QUOTE: "'"
+
+      ZERO: "0"
+
+      NINE: "9"
+
+      COMMA: ","
+
+      DOT: "."
+
+      COLON: ":"
+
+      SEMICOLON: ";"
+
+      UPPERCASE_A: "A"
+
+      LOWERCASE_A: "a"
+
+      UPPERCASE_E: "E"
+
+      LOWERCASE_E: "e"
+
+      UPPERCASE_F: "F"
+
+      LOWERCASE_F: "f"
+
+      NON_BREAKING_SPACE: ::String
+
+      MONGOLIAN_VOWEL_SEPARATOR: ::String
+
+      EN_QUAD: ::String
+
+      ZERO_WIDTH_SPACE: ::String
+
+      NARROW_NO_BREAK_SPACE: ::String
+
+      MEDIUM_MATHEMATICAL_SPACE: ::String
+
+      IDEOGRAPHIC_SPACE: ::String
+
+      ZERO_WIDTH_NO_BREAK_SPACE: ::String
+
+      DOUBLE_QUOTE_LEFT: ::String
+
+      DOUBLE_QUOTE_RIGHT: ::String
+
+      QUOTE_LEFT: ::String
+
+      QUOTE_RIGHT: ::String
+
+      GRAVE_ACCENT: "`"
+
+      ACUTE_ACCENT: ::String
+
+      REGEX_DELIMITER: ::Regexp
+
+      REGEX_UNQUOTED_STRING_DELIMITER: ::Regexp
+
+      REGEX_START_OF_VALUE: ::Regexp
+
+      REGEX_URL_START: ::Regexp
+
+      REGEX_URL_CHAR: ::Regexp
+
+      REGEX_FUNCTION_NAME_CHAR_START: ::Regexp
+
+      REGEX_FUNCTION_NAME_CHAR: ::Regexp
+
+      # Functions to check character chars
+      def hex?: (untyped char) -> untyped
+
+      def digit?: (untyped char) -> untyped
+
+      def valid_string_character?: (untyped char) -> untyped
+
+      def delimiter?: (untyped char) -> untyped
+
+      def unquoted_string_delimiter?: (untyped char) -> untyped
+
+      def function_name_char_start?: (untyped char) -> untyped
+
+      def function_name_char?: (untyped char) -> untyped
+
+      def start_of_value?: (untyped char) -> untyped
+
+      def control_character?: (untyped char) -> untyped
+
+      def whitespace?: (untyped char) -> untyped
+
+      def whitespace_except_newline?: (untyped char) -> untyped
+
+      def special_whitespace?: (untyped char) -> untyped
+
+      def quote?: (untyped char) -> untyped
+
+      def double_quote?: (untyped char) -> untyped
+
+      def single_quote?: (untyped char) -> untyped
+
+      def double_quote_like?: (untyped char) -> untyped
+
+      def single_quote_like?: (untyped char) -> untyped
+
+      # Strip last occurrence of text_to_strip from text
+      def strip_last_occurrence: (untyped text, untyped text_to_strip, ?strip_remaining_text: bool) -> untyped
+
+      def insert_before_last_whitespace: (untyped text, untyped text_to_insert) -> untyped
+
+      # Parse keywords true, false, null
+      # Repair Python keywords True, False, None
+      # Repair Ruby keyword nil
+      def parse_keywords: () -> untyped
+
+      def parse_keyword: (untyped name, untyped value) -> (true | false)
+
+      def remove_at_index: (untyped text, untyped start, untyped count) -> untyped
+
+      def ends_with_comma_or_newline?: (untyped text) -> untyped
+    end
+  end
+end

data/sig/json/repair.rbs

@@ -1,7 +1,10 @@
 module JSON
+  class JSONRepairError < StandardError
+  end
+
   module Repair
-    VERSION: String
+    VERSION: ::String
   end
 
-  def self.repair(String) -> ?String
+  def self.repair: (::String json) -> ::String
 end

data/sig/json/repairer.rbs

@@ -0,0 +1,103 @@
+module JSON
+  class Repairer
+    @json: ::String
+
+    @index: Integer
+
+    @output: ::String
+
+    include Repair::StringUtils
+
+    CONTROL_CHARACTERS: ::Hash[::String, "\\b" | "\\f" | "\\n" | "\\r" | "\\t"]
+
+    ESCAPE_CHARACTERS: ::Hash[::String, "\"" | "\\" | "/" | "\b" | "\f" | "\n" | "\r" | "\t"]
+
+    MARKDOWN_OPEN_BLOCKS: ::Array[::String]
+
+    MARKDOWN_CLOSE_BLOCKS: ::Array[::String]
+
+    def initialize: (::String json) -> void
+
+    def repair: () -> ::String
+
+    private
+
+    def parse_value: () -> untyped
+
+    def parse_whitespace: (?skip_newline: bool) -> (true | false)
+
+    def parse_comment: () -> (true | false)
+
+    # Find and skip over a Markdown fenced code block
+    def parse_markdown_code_block: (::Array[::String] blocks) -> (true | false)
+
+    def skip_markdown_code_block: (::Array[::String] blocks) -> (true | false)
+
+    # Parse an object like '{"key": "value"}'
+    def parse_object: () -> (false | true)
+
+    def skip_character: (untyped char) -> (true | false)
+
+    # Skip ellipsis like "[1,2,3,...]" or "[1,2,3,...,9]" or "[...,7,8,9]"
+    # or a similar construct in objects.
+    def skip_ellipsis: () -> untyped
+
+    # Parse a string enclosed by double quotes "...". Can contain escaped quotes
+    # Repair strings enclosed in single quotes or special quotes
+    # Repair an escaped string
+    #
+    # The function can run in two stages:
+    # - First, it assumes the string has a valid end quote
+    # - If it turns out that the string does not have a valid end quote followed
+    #   by a delimiter (which should be the case), the function runs again in a
+    #   more conservative way, stopping the string at the first next delimiter
+    #   and fixing the string by inserting a quote there, or stopping at a
+    #   stop index detected in the first iteration.
+    def parse_string: (?stop_at_delimiter: bool, ?stop_at_index: ::Integer) -> (untyped | true | false)
+
+    # Repair an unquoted string by adding quotes around it
+    # Repair a MongoDB function call like NumberLong("2")
+    # Repair a JSONP function call like callback({...});
+    def parse_unquoted_string: (bool is_key) -> (false | true)
+
+    # Parse a regular expression literal like /foo/ or /foo\/bar/
+    def parse_regex: () -> (false | true)
+
+    def parse_character: (untyped char) -> (true | false)
+
+    def parse_whitespace_and_skip_comments: (?skip_newline: bool) -> untyped
+
+    # Parse a number like 2.4 or 2.4e6
+    def parse_number: () -> (true | false)
+
+    def at_end_of_number?: () -> untyped
+
+    # Parse an array like '["item1", "item2", ...]'
+    def parse_array: () -> (true | false)
+
+    def prev_non_whitespace_index: (untyped start) -> untyped
+
+    # Repair concatenated strings like "hello" + "world", change this into "helloworld"
+    def parse_concatenated_string: () -> untyped
+
+    def repair_number_ending_with_numeric_symbol: (untyped start) -> untyped
+
+    # Parse and repair Newline Delimited JSON (NDJSON):
+    # multiple JSON objects separated by a newline character
+    def parse_newline_delimited_json: () -> untyped
+
+    def skip_escape_character: () -> untyped
+
+    def throw_invalid_character: (untyped char) -> untyped
+
+    def throw_unexpected_character: () -> untyped
+
+    def throw_unexpected_end: () -> untyped
+
+    def throw_object_key_expected: () -> untyped
+
+    def throw_colon_expected: () -> untyped
+
+    def throw_invalid_unicode_character: () -> untyped
+  end
+end

metadata

@@ -1,34 +1,41 @@
 --- !ruby/object:Gem::Specification
 name: json-repair
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.4.0
 platform: ruby
 authors:
 - Aleksandr Zykov
-autorequire:
 bindir: exe
 cert_chain: []
-date: 2024-06-04 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies: []
 description: This is a simple gem that repairs broken JSON strings.
 email:
 - alexandrz@gmail.com
-executables: []
+executables:
+- json-repair
 extensions: []
 extra_rdoc_files: []
 files:
 - ".rspec"
 - ".rubocop.yml"
 - CHANGELOG.md
+- CLAUDE.md
 - CODE_OF_CONDUCT.md
 - LICENSE.txt
 - README.md
 - Rakefile
+- Steepfile
+- exe/json-repair
 - lib/json/repair.rb
+- lib/json/repair/cli.rb
 - lib/json/repair/string_utils.rb
 - lib/json/repair/version.rb
 - lib/json/repairer.rb
 - sig/json/repair.rbs
+- sig/json/repair/cli.rbs
+- sig/json/repair/string_utils.rbs
+- sig/json/repairer.rbs
 homepage: https://github.com/sashazykov/json-repair-rb
 licenses:
 - ISC
@@ -37,7 +44,6 @@ metadata:
   homepage_uri: https://github.com/sashazykov/json-repair-rb
   source_code_uri: https://github.com/sashazykov/json-repair-rb
   changelog_uri: https://github.com/sashazykov/json-repair-rb/blob/main/CHANGELOG.md
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -52,8 +58,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.10
-signing_key:
+rubygems_version: 3.6.9
 specification_version: 4
 summary: Repairs broken JSON strings.
 test_files: []