json-processing-with-jq

Files (1)

• SKILL.md

SKILL.md (first lines)

# JSON Processing with jq

## Installation

```bash
# Ubuntu/Debian
sudo apt-get install jq

# macOS
brew install jq

# Verify
jq --version
```

## Basic Usage

### Pretty Print JSON
```bash
curl -s http://api.example.com/data | jq '.'

# Or from file
jq '.' data.json
```

### Extract Single Field
```bash
# Get "name" field from JSON object
echo '{"name": "Alice", "age": 30}' | jq '.name'
# Output: "Alice"

# Get field from nested object
echo '{"user": {"name": "Alice"}}' | jq '.user.name'
# Output: "Alice"
```

### Extract Array Elements
```bash
# Get all items in array
echo '[1, 2, 3]' | jq '.[]'
# Output:
# 1
# 2
# 3

# Get specific index
echo '[1, 2, 3]' | jq '.[0]'
# Output: 1
```

## LLM API Response Parsing

### Extract Tool Calls
```bash
curl -s http://localhost:8000/v1/chat/completions \
  -H "Content-Type: application/json" \
  -d '{...}' | jq '.choices[0].message.tool_calls'
```

### Extract Tool Arguments as JSON Object
```bash
curl -s http://localhost:8000/v1/chat/completions \
  -H "Content-Type: application/json" \
  -d '{...}' | jq -r '.choices[0].message.tool_calls[0].function.arguments | fromjson'
```

The `-r` flag outputs raw strings (without quotes). The `fromjson` converts JSON string to object.

### Extract Multiple Fields
```bash
# Get all tool call names
curl -s http://localhost:8000/v1/chat/completions \
  -H "Content-Type: application/json" \
  -d '{...}' | jq '.choices[0].message.tool_calls[].function.name'
```

### Validate Tool Arguments are Valid JSON
```bash
# Test if arguments parse as JSON
curl -s http://localhost:8000/v1/chat/completions \
  -H "Content-Type: application/json" \
  -d '{...}' | jq -e '.choices[0].message.tool_calls[0].function.arguments | fromjson' > /dev/null && echo "Valid JSON" || echo "Invalid JSON"
```

## Configuration File Parsing

### Extract Configuration Value
```bash
# From .continue/config.json
jq '.models[0].temperature' .continue/config.json
# Output: 0.5

# Get all model names
jq '.models[].title' .continue/config.json
```

### Validate Configuration Structure
```bash
# Check if required fields exist
jq 'has("models") and has("tools")' .continue/config.json
# Output: true
```

### Merge Configuration Objects
```bash
# Combine two config files
jq -s '.[0] * .[1]' config1.json config2.json
```

## Common jq Patterns

### Filter Objects
```bash
# Select objects where condition is true
echo '[{"name": "Alice", "age": 30}, {"name": "Bob", "age": 25}]' \
  | jq '.[] | select(.age > 26)'
# Output:
# {
#   "name": "Alice",
#   "age": 30

From AndrewBrown-USDA/aigb-skills-usda, MIT.

More from AndrewBrown-USDA/aigb-skills-usda