Add new uber-simple vendor/jsonx.jl for true no-dependency JSON functionality that can be directly vendored in

Author: quinnj

.github/workflows/vendor-tests.yml

@@ -0,0 +1,48 @@
+name: Vendor Tests
+
+on:
+  push:
+    paths:
+      - 'vendor/**'
+  pull_request:
+    paths:
+      - 'vendor/**'
+
+jobs:
+  test:
+    name: Julia ${{ matrix.version }} - ${{ matrix.os }} - ${{ matrix.arch }}
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        version:
+          - '1' # automatically expands to the latest stable 1.x release of Julia
+          - 'min'
+          - 'pre'
+        os:
+          - ubuntu-latest
+          - windows-latest
+        arch:
+          - x64
+        include:
+          - os: macOS-latest
+            arch: aarch64
+            version: 1
+    
+    steps:
+    - name: Checkout code
+      uses: actions/checkout@v4
+      
+    - name: Setup Julia
+      uses: julia-actions/setup-julia@v2
+      with:
+        version: ${{ matrix.version }}
+        arch: ${{ matrix.arch }}
+        
+    - name: Cache Julia packages
+      uses: julia-actions/cache@v2
+      
+    - name: Run vendor tests
+      run: |
+        cd vendor
+        julia test.jl 

README.md

@@ -71,6 +71,10 @@ JSON.isvalidjson(json)
 JSON.json("test.json", j)
 ```
 
+## Vendor Directory
+
+This package includes a `vendor/` directory containing a simplified, no-dependency JSON parser (`JSONX`) that can be vendored (copied) into other projects. See the [vendor README](vendor/README.md) for details.
+
 ## Contributing and Questions
 
 Contributions are very welcome, as are feature requests and suggestions. Please open an

vendor/README.md

@@ -0,0 +1,96 @@
+# JSONX - Simple JSON Parser
+
+A simple, no-dependency JSON parser that can be vendored (copied/pasted) into other packages.
+
+## Features
+
+### Parsing
+- `JSONX.parse(json_str::String)` - Parse a JSON string
+- `JSONX.parse(bytes::AbstractVector{UInt8})` - Parse JSON from byte array
+- `JSONX.parsefile(filename::String)` - Parse JSON from a file
+
+### Writing
+- `JSONX.json(value)` - Convert a Julia value to JSON string
+
+### Supported Types
+
+**Reading (JSON → Julia):**
+- `null` → `nothing`
+- `true`/`false` → `Bool`
+- Numbers → `Float64` (all numbers are parsed as Float64)
+- Strings → `String` (with full Unicode support)
+- Arrays → `Vector{Any}`
+- Objects → `Dict{String, Any}`
+
+**Writing (Julia → JSON):**
+- `nothing`/`missing` → `null`
+- `Bool` → `true`/`false`
+- `Number` → JSON number
+- `AbstractString` → JSON string
+- `AbstractVector`/`AbstractSet`/`Tuple` → JSON array
+- `AbstractDict`/`NamedTuple` → JSON object
+- `Symbol`/`Enum` → JSON string
+
+### Unicode Support
+
+JSONX includes full Unicode support:
+- Proper Unicode escape sequence parsing (`\uXXXX`)
+- UTF-16 surrogate pair handling
+- Lone surrogate handling
+- All standard JSON escape sequences (`\"`, `\\`, `\/`, `\b`, `\f`, `\n`, `\r`, `\t`)
+
+## Usage
+
+```julia
+using JSONX
+
+# Parse JSON
+data = JSONX.parse("{\"name\":\"John\",\"age\":30}")
+# Returns: Dict("name" => "John", "age" => 30.0)
+
+# Parse from bytes
+bytes = Vector{UInt8}("{\"key\":\"value\"}")
+data = JSONX.parse(bytes)
+
+# Parse from file
+data = JSONX.parsefile("data.json")
+
+# Write JSON
+json_str = JSONX.json(Dict("a" => 1, "b" => 2))
+# Returns: "{\"a\":1,\"b\":2}"
+
+# Unicode examples
+JSONX.parse("\"Hello 世界! 🌍\"")  # Full Unicode support
+JSONX.parse("\"\\u0048\\u0065\\u006C\\u006C\\u006F\"")  # Unicode escapes
+```
+
+## Error Handling
+
+JSONX provides detailed error messages for invalid JSON:
+- Unexpected end of input
+- Invalid escape sequences
+- Malformed Unicode escapes
+- Trailing commas
+- Control characters in strings
+- Invalid number formats
+
+## Limitations
+
+Compared to the full JSON.jl package, JSONX is intentionally simplified:
+
+- **No integer parsing**: All numbers are parsed as Float64
+- **No custom type parsing**: Only returns basic Julia types
+- **No configuration options**: Uses fixed defaults
+- **No streaming**: Loads entire input into memory
+- **No pretty printing**: Output is compact only
+- **No schema validation**: Basic JSON validation only
+- **No performance optimizations**: Simple, readable implementation
+
+## Implementation Notes
+
+- **No dependencies**: Uses only Base Julia functionality
+- **Byte-level processing**: Uses `codeunit` for accurate string handling
+- **Memory efficient**: Avoids unnecessary string concatenation
+- **Error robust**: Comprehensive error checking and reporting
+
+Note: Functions are not exported, so use `JSONX.parse` and `JSONX.json` with the module prefix.