jsonx-cli 0.1.0__tar.gz

jsonx_cli-0.1.0/.gitignore

@@ -0,0 +1,2 @@
+.env
+.vercel

jsonx_cli-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Marcus
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

jsonx_cli-0.1.0/PKG-INFO

@@ -0,0 +1,228 @@
+Metadata-Version: 2.4
+Name: jsonx-cli
+Version: 0.1.0
+Summary: JSON query and transform CLI - simpler than jq
+Project-URL: Homepage, https://github.com/marcusbuildsthings-droid/jsonx
+Project-URL: Repository, https://github.com/marcusbuildsthings-droid/jsonx
+Project-URL: Issues, https://github.com/marcusbuildsthings-droid/jsonx/issues
+Author-email: Marcus <marcus.builds.things@gmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: automation,cli,jq,json,query,transform
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Utilities
+Requires-Python: >=3.8
+Requires-Dist: click>=8.0.0
+Provides-Extra: schema
+Requires-Dist: jsonschema>=4.0.0; extra == 'schema'
+Description-Content-Type: text/markdown
+
+# jsonx
+
+JSON query and transform CLI — simpler than jq.
+
+[![PyPI version](https://badge.fury.io/py/jsonx-cli.svg)](https://pypi.org/project/jsonx-cli/)
+
+## Installation
+
+```bash
+pip install jsonx-cli
+```
+
+For JSON Schema validation:
+```bash
+pip install jsonx-cli[schema]
+```
+
+## Quick Start
+
+```bash
+# Get a nested value
+jsonx get .users[0].name data.json
+
+# From stdin
+cat data.json | jsonx get .config.debug
+
+# Set a value
+jsonx set .config.debug true data.json
+
+# List all keys
+jsonx keys data.json
+
+# Pretty print
+jsonx format data.json
+```
+
+## Path Syntax
+
+jsonx uses simple dot notation:
+
+| Pattern | Meaning |
+|---------|---------|
+| `.key` | Object property |
+| `.nested.key` | Nested property |
+| `[0]` | Array index |
+| `[-1]` | Last array item |
+| `[*]` | All array items |
+| `[0:3]` | Array slice |
+
+Examples:
+```bash
+jsonx get .name data.json           # Get "name" property
+jsonx get .users[0] data.json       # First user
+jsonx get .users[-1] data.json      # Last user
+jsonx get .users[*].email data.json # All user emails
+jsonx get .items[0:5] data.json     # First 5 items
+```
+
+## Commands
+
+### get - Extract values
+
+```bash
+jsonx get .path [file]          # Extract value at path
+jsonx get .path file --raw      # Raw output (no quotes)
+jsonx get .path file --json     # Force JSON output
+```
+
+### set - Modify values
+
+```bash
+jsonx set .path value [file]    # Set and output
+jsonx set .path value file -i   # Modify in place
+jsonx set .path value file -o out.json  # Write to file
+```
+
+Value is parsed as JSON:
+```bash
+jsonx set .debug true data.json           # boolean
+jsonx set .count 42 data.json             # number
+jsonx set .name '"Alice"' data.json       # string (note quotes)
+jsonx set .tags '["a","b"]' data.json     # array
+```
+
+### del - Delete values
+
+```bash
+jsonx del .path [file]          # Delete and output
+jsonx del .path file -i         # Delete in place
+```
+
+### keys - List keys
+
+```bash
+jsonx keys [file]               # Top-level keys
+jsonx keys file -r              # All keys recursively
+```
+
+### flatten / unflatten - Structure transformation
+
+```bash
+# Flatten nested structure
+jsonx flatten data.json
+# {"users[0].name": "Alice", "config.debug": true}
+
+# Unflatten back
+echo '{"user.name": "Alice"}' | jsonx unflatten
+# {"user": {"name": "Alice"}}
+```
+
+### merge - Combine files
+
+```bash
+jsonx merge base.json override.json     # Deep merge
+jsonx merge a.json b.json --shallow     # Shallow merge
+```
+
+### diff - Compare files
+
+```bash
+jsonx diff old.json new.json
+# + config.newKey: "value"      (green - added)
+# - config.removed: true        (red - removed)  
+# ~ config.changed: 1 → 2       (yellow - changed)
+```
+
+### format / minify - Pretty print
+
+```bash
+jsonx format data.json              # Pretty print
+jsonx format data.json -i 4         # 4-space indent
+jsonx minify data.json              # Compact
+```
+
+### validate - JSON Schema
+
+```bash
+jsonx validate data.json schema.json
+# ✓ Valid
+# or
+# ✗ Invalid: 'email' is required
+```
+
+### type - Show value type
+
+```bash
+echo '[]' | jsonx type        # array
+echo '{}' | jsonx type        # object
+echo '42' | jsonx type        # integer
+```
+
+### count - Count items
+
+```bash
+jsonx count data.json                     # Top-level count
+jsonx get .users data.json | jsonx count  # Count array items
+```
+
+### each - Iterate arrays
+
+```bash
+# Output each item as JSON
+jsonx each data.json -p .users
+
+# With template
+jsonx each data.json -p .users -t '{.name}: {.email}'
+```
+
+## Piping
+
+jsonx works great in pipelines:
+
+```bash
+# Extract, transform, merge
+cat config.json | jsonx get .database | jsonx set .host '"prod.db"'
+
+# Count users
+jsonx get .users data.json | jsonx count
+
+# Extract all emails
+jsonx get .users[*].email data.json
+
+# Filter and format
+curl api/data | jsonx get .results | jsonx format
+```
+
+## For AI Agents
+
+See [SKILL.md](SKILL.md) for agent-optimized documentation.
+
+## Exit Codes
+
+- `0` - Success
+- `1` - Error (invalid JSON, path not found, etc.)
+
+## License
+
+MIT

jsonx_cli-0.1.0/README.md

@@ -0,0 +1,198 @@
+# jsonx
+
+JSON query and transform CLI — simpler than jq.
+
+[![PyPI version](https://badge.fury.io/py/jsonx-cli.svg)](https://pypi.org/project/jsonx-cli/)
+
+## Installation
+
+```bash
+pip install jsonx-cli
+```
+
+For JSON Schema validation:
+```bash
+pip install jsonx-cli[schema]
+```
+
+## Quick Start
+
+```bash
+# Get a nested value
+jsonx get .users[0].name data.json
+
+# From stdin
+cat data.json | jsonx get .config.debug
+
+# Set a value
+jsonx set .config.debug true data.json
+
+# List all keys
+jsonx keys data.json
+
+# Pretty print
+jsonx format data.json
+```
+
+## Path Syntax
+
+jsonx uses simple dot notation:
+
+| Pattern | Meaning |
+|---------|---------|
+| `.key` | Object property |
+| `.nested.key` | Nested property |
+| `[0]` | Array index |
+| `[-1]` | Last array item |
+| `[*]` | All array items |
+| `[0:3]` | Array slice |
+
+Examples:
+```bash
+jsonx get .name data.json           # Get "name" property
+jsonx get .users[0] data.json       # First user
+jsonx get .users[-1] data.json      # Last user
+jsonx get .users[*].email data.json # All user emails
+jsonx get .items[0:5] data.json     # First 5 items
+```
+
+## Commands
+
+### get - Extract values
+
+```bash
+jsonx get .path [file]          # Extract value at path
+jsonx get .path file --raw      # Raw output (no quotes)
+jsonx get .path file --json     # Force JSON output
+```
+
+### set - Modify values
+
+```bash
+jsonx set .path value [file]    # Set and output
+jsonx set .path value file -i   # Modify in place
+jsonx set .path value file -o out.json  # Write to file
+```
+
+Value is parsed as JSON:
+```bash
+jsonx set .debug true data.json           # boolean
+jsonx set .count 42 data.json             # number
+jsonx set .name '"Alice"' data.json       # string (note quotes)
+jsonx set .tags '["a","b"]' data.json     # array
+```
+
+### del - Delete values
+
+```bash
+jsonx del .path [file]          # Delete and output
+jsonx del .path file -i         # Delete in place
+```
+
+### keys - List keys
+
+```bash
+jsonx keys [file]               # Top-level keys
+jsonx keys file -r              # All keys recursively
+```
+
+### flatten / unflatten - Structure transformation
+
+```bash
+# Flatten nested structure
+jsonx flatten data.json
+# {"users[0].name": "Alice", "config.debug": true}
+
+# Unflatten back
+echo '{"user.name": "Alice"}' | jsonx unflatten
+# {"user": {"name": "Alice"}}
+```
+
+### merge - Combine files
+
+```bash
+jsonx merge base.json override.json     # Deep merge
+jsonx merge a.json b.json --shallow     # Shallow merge
+```
+
+### diff - Compare files
+
+```bash
+jsonx diff old.json new.json
+# + config.newKey: "value"      (green - added)
+# - config.removed: true        (red - removed)  
+# ~ config.changed: 1 → 2       (yellow - changed)
+```
+
+### format / minify - Pretty print
+
+```bash
+jsonx format data.json              # Pretty print
+jsonx format data.json -i 4         # 4-space indent
+jsonx minify data.json              # Compact
+```
+
+### validate - JSON Schema
+
+```bash
+jsonx validate data.json schema.json
+# ✓ Valid
+# or
+# ✗ Invalid: 'email' is required
+```
+
+### type - Show value type
+
+```bash
+echo '[]' | jsonx type        # array
+echo '{}' | jsonx type        # object
+echo '42' | jsonx type        # integer
+```
+
+### count - Count items
+
+```bash
+jsonx count data.json                     # Top-level count
+jsonx get .users data.json | jsonx count  # Count array items
+```
+
+### each - Iterate arrays
+
+```bash
+# Output each item as JSON
+jsonx each data.json -p .users
+
+# With template
+jsonx each data.json -p .users -t '{.name}: {.email}'
+```
+
+## Piping
+
+jsonx works great in pipelines:
+
+```bash
+# Extract, transform, merge
+cat config.json | jsonx get .database | jsonx set .host '"prod.db"'
+
+# Count users
+jsonx get .users data.json | jsonx count
+
+# Extract all emails
+jsonx get .users[*].email data.json
+
+# Filter and format
+curl api/data | jsonx get .results | jsonx format
+```
+
+## For AI Agents
+
+See [SKILL.md](SKILL.md) for agent-optimized documentation.
+
+## Exit Codes
+
+- `0` - Success
+- `1` - Error (invalid JSON, path not found, etc.)
+
+## License
+
+MIT

jsonx_cli-0.1.0/SKILL.md

@@ -0,0 +1,102 @@
+# jsonx - JSON Query & Transform CLI
+
+## Quick Reference
+
+| Command | Purpose |
+|---------|---------|
+| `jsonx get .path file` | Extract value |
+| `jsonx set .path value file` | Set value |
+| `jsonx del .path file` | Delete value |
+| `jsonx keys file` | List keys |
+| `jsonx flatten file` | Flatten to dot notation |
+| `jsonx merge a.json b.json` | Merge files |
+| `jsonx diff a.json b.json` | Show differences |
+| `jsonx format file` | Pretty print |
+| `jsonx minify file` | Compact output |
+| `jsonx validate file schema` | Validate schema |
+
+## Path Syntax
+
+```
+.key          → object property
+.a.b.c        → nested property
+[0]           → array index
+[-1]          → last item
+[*]           → all items (returns array)
+[0:3]         → slice (items 0, 1, 2)
+```
+
+## Common Tasks
+
+### Extract nested value
+```bash
+jsonx get .config.database.host config.json
+```
+
+### Get all items from array
+```bash
+jsonx get .users[*].email data.json
+# ["alice@x.com", "bob@x.com"]
+```
+
+### Set value in place
+```bash
+jsonx set .debug true config.json -i
+```
+
+### Merge configs
+```bash
+jsonx merge defaults.json overrides.json > merged.json
+```
+
+### Compare files
+```bash
+jsonx diff old.json new.json --json
+```
+
+### Flatten for easier processing
+```bash
+jsonx flatten nested.json
+# {"users[0].name": "Alice", "config.timeout": 30}
+```
+
+### Iterate array with template
+```bash
+jsonx each data.json -p .users -t '{.id}: {.name}'
+# 1: Alice
+# 2: Bob
+```
+
+## JSON Output
+
+Most commands output JSON by default. For scalar values, use `--raw` to strip quotes:
+
+```bash
+jsonx get .name data.json        # "Alice"
+jsonx get .name data.json --raw  # Alice
+```
+
+## Stdin Support
+
+All commands accept stdin:
+```bash
+curl api/endpoint | jsonx get .results
+cat data.json | jsonx set .updated true
+```
+
+## Error Handling
+
+- Missing key: exits 1, prints "Key not found: keyname"
+- Invalid JSON: exits 1, prints "Invalid JSON: ..."
+- Type mismatch: exits 1, prints "Cannot index/get key from type"
+
+Always check exit code in scripts.
+
+## Schema Validation
+
+Requires `pip install jsonx-cli[schema]`:
+```bash
+jsonx validate data.json schema.json
+# ✓ Valid  (exit 0)
+# ✗ Invalid: message (exit 1)
+```

jsonx_cli-0.1.0/a.json

@@ -0,0 +1 @@
+{"name":"Alice","age":30}

jsonx_cli-0.1.0/b.json

@@ -0,0 +1 @@
+{"name":"Alice","age":31,"email":"a@x.com"}

jsonx_cli-0.1.0/jsonx/__init__.py

@@ -0,0 +1,3 @@
+"""jsonx - JSON query and transform CLI"""
+
+__version__ = "0.1.0"