<commit_before>## json-utils ##
---

A group of utility applications to make working with the JSON file format easier, especially for shell scripting.

---

### Tools ###
  - `jsonread` - reads a field from a specified JSON file.
  - `jsonwrite` - writes a field (and optional sub-fields) and its value to a specified JSON file.
  - `jsonsemver` - implementation of semantic versioning (semver.org) using JSON to store the version data.  Includes functionality to auto-increment version numbers, making automating version numbers with scripts easy.
  - `jsonpp` - pretty-prints a JSON file.

---

### Examples ###
---
#### jsonread ####

  `jsonread` can read fields in the given JSON file, even if they are nested in an array or object.
  Given the following JSON file:
```javascript
{
  "obj": {
    "sub1": {
      "one": 1,
      "two": 2
    }
}
```
  `jsonread` can read any of these fields:

  - `$ jsonread myfile.json obj sub1` returns `{ "one": 1, "two": 2 }`
  - `$ jsonread myfile.json obj sub1 one` returns `1`
  - `$ jsonread myfile.json obj sub1 two` returns `2`

  `jsonread` can also access array items:

  Given the following JSON file:<commit_msg>readme update with prereqs for compiling<commit_after>## json-utils ##
---

A group of utility applications to make working with the JSON file format easier, especially for shell scripting.

---

### Tools ###
  - `jsonread` - reads a field from a specified JSON file.
  - `jsonwrite` - writes a field (and optional sub-fields) and its value to a specified JSON file.
  - `jsonsemver` - implementation of semantic versioning (semver.org) using JSON to store the version data.  Includes functionality to auto-increment version numbers, making automating version numbers with scripts easy.
  - `jsonpp` - pretty-prints a JSON file.

---

### Requirements ###
`json-utils` requires the `json-c` library, which can be found on GitHub: https://github.com/json-c/json-c

---
### Examples ###
---
#### jsonread ####

  `jsonread` can read fields in the given JSON file, even if they are nested in an array or object.
  Given the following JSON file:
```javascript
{
  "obj": {
    "sub1": {
      "one": 1,
      "two": 2
    }
}
```
  `jsonread` can read any of these fields:

  - `$ jsonread myfile.json obj sub1` returns `{ "one": 1, "two": 2 }`
  - `$ jsonread myfile.json obj sub1 one` returns `1`
  - `$ jsonread myfile.json obj sub1 two` returns `2`

  `jsonread` can also access array items:

  Given the following JSON file:
{'fraction_non_alphanumeric': 0.12078651685393259, 'fraction_numerical': 0.008025682182985553, 'mean_word_length': 3.2470187393526406, 'pattern_counts': {'":': 12, '<': 3, '<?xml version=': 0, '>': 3, 'https://': 1, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '4273848', 'n_tokens_mistral': 763, 'n_tokens_neox': 744, 'n_words': 317}