JsonhPy 2.3__tar.gz → 2.5__tar.gz

{jsonhpy-2.3 → jsonhpy-2.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: JsonhPy
-Version: 2.3
+Version: 2.5
 Summary: JSON for Humans in Python.
 Author-email: Joyless <joyless.mod@gmail.com>
 License-Expression: MIT

{jsonhpy-2.3 → jsonhpy-2.5}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "JsonhPy"
-version = "2.3"
+version = "2.5"
 authors = [
   { name="Joyless", email="joyless.mod@gmail.com" },
 ]

{jsonhpy-2.3 → jsonhpy-2.5}/src/JsonhPy/JsonhPy.py

@@ -1,6 +1,7 @@
 import math
 from enum import Enum
 from typing import Iterator, Iterable
+import json
 
 class JsonhResult[T, E]:
     is_error: bool
@@ -546,7 +547,7 @@ class JsonhReader:
                     case _:
                         return JsonhResult.from_error("Token type not implemented")
 
-        next_element = parse_next_element()
+        next_element: JsonhResult[object, str] = parse_next_element()
 
         # Ensure exactly one element
         if not next_element.is_error:
@@ -557,6 +558,145 @@ class JsonhReader:
 
         return next_element
 
+    def parse_json(self, include_comments: bool = False, indent: str | None = None) -> JsonhResult[str, str]:
+        """
+        Parses a single element as JSON from the reader.
+
+        If `include_comments` is true, comments are included (`/*` and `*/` are escaped as `/ *` and `* /`).
+
+        If `indent` is not null, the output is pretty-printed with the given indentation.
+
+        Note: The result is **NOT** safe to embed in HTML. To safely embed in HTML, you need to escape characters like `<`, `>` and `&`.
+        """
+
+        def parse_next_element_as_json() -> JsonhResult[str, str]:
+            current_depth: int = 0
+            isStartOfStructure: bool = True
+            is_property_value: bool = False
+
+            result_builder: str = ""
+
+            for token_result in self.read_element():
+                # Check error
+                if (token_result.is_error):
+                    return JsonhResult.from_error(token_result.error())
+                token: JsonhToken = token_result.value()
+
+                # Add comments and indents
+                if not is_property_value:
+                    # Add comma before property/item
+                    if (token.json_type not in [JsonTokenType.NONE, JsonTokenType.COMMENT]) and (current_depth > 0) and (not isStartOfStructure):
+                        # Don't add trailing comma
+                        if token.json_type not in [JsonTokenType.END_OBJECT, JsonTokenType.END_ARRAY]:
+                            result_builder += ','
+
+                    # Apply indentation
+                    if indent != None:
+                        # Don't indent inside empty structures
+                        if not (token.json_type in [JsonTokenType.END_OBJECT, JsonTokenType.END_ARRAY] and isStartOfStructure):
+                            # Don't indent comment if not included
+                            if (not (token.json_type == JsonTokenType.COMMENT and (not include_comments))):
+                                # Don't indent root elements
+                                if current_depth > 0:
+                                    # Add newline before element
+                                    result_builder += '\n'
+
+                                    # Get current indent count
+                                    indent_count: int = current_depth
+                                    if token.json_type in [JsonTokenType.END_OBJECT, JsonTokenType.END_ARRAY]:
+                                        indent_count -= 1
+
+                                    # Add indent
+                                    for _ in range(0, indent_count):
+                                        result_builder += indent
+                # Track start of structure to avoid adding leading comma
+                if token.json_type not in [JsonTokenType.NONE, JsonTokenType.COMMENT]:
+                    isStartOfStructure = False
+                if token.json_type in [JsonTokenType.START_OBJECT, JsonTokenType.START_ARRAY]:
+                    isStartOfStructure = True
+
+                match token.json_type:
+                    # Null
+                    case JsonTokenType.NONE:
+                        result_builder += "null"
+                        if current_depth == 0:
+                            return JsonhResult.from_value(result_builder)
+                    # True
+                    case JsonTokenType.TRUE:
+                        result_builder += "true"
+                        if current_depth == 0:
+                            return JsonhResult.from_value(result_builder)
+                    # False
+                    case JsonTokenType.FALSE:
+                        result_builder += "false"
+                        if current_depth == 0:
+                            return JsonhResult.from_value(result_builder)
+                    # String
+                    case JsonTokenType.STRING:
+                        result_builder += json.dumps(token.value, ensure_ascii=False)
+                        if current_depth == 0:
+                            return JsonhResult.from_value(result_builder)
+                    # Number
+                    case JsonTokenType.NUMBER:
+                        result: JsonhResult[float] = JsonhNumberParser.parse(token_result.value().value)
+                        if (result.is_error):
+                            return JsonhResult.from_error(result.error())
+                        result_builder += str(result.value()).removesuffix(".0")
+                        if current_depth == 0:
+                            return JsonhResult.from_value(result_builder)
+                    # Start Object
+                    case JsonTokenType.START_OBJECT:
+                        result_builder += '{'
+                        current_depth += 1
+                    # Start Array
+                    case JsonTokenType.START_ARRAY:
+                        result_builder += '['
+                        current_depth += 1
+                    # End Object
+                    case JsonTokenType.END_OBJECT:
+                        result_builder += '}'
+                        current_depth -= 1
+                        if current_depth == 0:
+                            return JsonhResult.from_value(result_builder)
+                    # End Array
+                    case JsonTokenType.END_ARRAY:
+                        result_builder += ']'
+                        current_depth -= 1
+                        if current_depth == 0:
+                            return JsonhResult.from_value(result_builder)
+                    # Property Name
+                    case JsonTokenType.PROPERTY_NAME:
+                        result_builder += json.dumps(token.value, ensure_ascii=False)
+                        result_builder += ':'
+                        if indent != None:
+                            result_builder += ' '
+                    # Comment
+                    case JsonTokenType.COMMENT:
+                        if (include_comments):
+                            result_builder += "/*"
+                            result_builder += token.value.replace("/*", "/ *").replace("*/", "* /")
+                            result_builder += "*/"
+                    # Not implemented
+                    case _:
+                        return JsonhResult.from_error("Token type not implemented")
+
+                if token.json_type != JsonTokenType.COMMENT:
+                    is_property_value = token.json_type == JsonTokenType.PROPERTY_NAME
+
+            # End of input
+            return JsonhResult.from_error("Expected token, got end of input")
+
+        next_element_as_json: JsonhResult[str, str] = parse_next_element_as_json()
+
+        # Ensure exactly one element
+        if not next_element_as_json.is_error:
+            if self.options.parse_single_element:
+                for token in self.read_end_of_elements():
+                    if token.is_error:
+                        return JsonhResult.from_error(token.error())
+
+        return next_element_as_json
+
     def find_property_value(self, property_name: str) -> bool:
         """
         Tries to find the given property name in the reader.

{jsonhpy-2.3 → jsonhpy-2.5}/src/JsonhPy.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: JsonhPy
-Version: 2.3
+Version: 2.5
 Summary: JSON for Humans in Python.
 Author-email: Joyless <joyless.mod@gmail.com>
 License-Expression: MIT