From a992f5b4fa2f7d907cbe32cb8933f05546b598a4 Mon Sep 17 00:00:00 2001
From: Bruce Weirdan <weirdan@gmail.com>
Date: Sat, 22 Jun 2024 19:41:11 +0200
Subject: [PATCH] Add `jc` wrapper (#883)

This PR adds `jc` wrapper, so that `jc` output is automatically parsed
into a nushell data structure and you don't have to use `| from json`
filter to parse it.

References: https://kellyjonbrazil.github.io/jc/#jc
---
 modules/README.md | 41 +++++++++++++++++++++++++++++++++++++++++
 modules/jc/mod.nu | 30 ++++++++++++++++++++++++++++++
 2 files changed, 71 insertions(+)
 create mode 100644 modules/jc/mod.nu

diff --git a/modules/README.md b/modules/README.md
index b521f64c2..ef0d80c96 100644
--- a/modules/README.md
+++ b/modules/README.md
@@ -13,6 +13,7 @@
   - [fun](#fun)
   - [github](#github)
   - [gitlab](#gitlab)
+  - [jc](#jc)
   - [kubernetes](#kubernetes)
   - [make\_release](#make_release)
   - [maths](#maths)
@@ -116,6 +117,46 @@ Examples of input/output formatters:
 ## [gitlab](../sourced/gitlab/)
 Search files on your GitLab server
 
+## [jc](./jc/)
+
+Converts the output of many common external commands into nushell data structures.
+
+Example:
+```nushell
+: jc ping -4 -c 2 google.com
+╭──────────────────────┬──────────────────────────────────────────────────────────────────────────────────────────╮
+│ destination_ip       │ 216.58.209.46                                                                            │
+│ data_bytes           │ 56                                                                                       │
+│ pattern              │                                                                                          │
+│ destination          │ google.com                                                                               │
+│ duplicates           │ 0                                                                                        │
+│ packets_transmitted  │ 2                                                                                        │
+│ packets_received     │ 2                                                                                        │
+│ packet_loss_percent  │ 0.00                                                                                     │
+│ time_ms              │ 1001.00                                                                                  │
+│ round_trip_ms_min    │ 3.87                                                                                     │
+│ round_trip_ms_avg    │ 4.04                                                                                     │
+│ round_trip_ms_max    │ 4.21                                                                                     │
+│ round_trip_ms_stddev │ 0.17                                                                                     │
+│                      │ ╭───┬───────┬───────────┬───────┬───────────────┬──────────┬─────┬─────────┬───────────╮ │
+│ responses            │ │ # │ type  │ timestamp │ bytes │  response_ip  │ icmp_seq │ ttl │ time_ms │ duplicate │ │
+│                      │ ├───┼───────┼───────────┼───────┼───────────────┼──────────┼─────┼─────────┼───────────┤ │
+│                      │ │ 0 │ reply │           │    64 │ 216.58.209.46 │        1 │ 120 │    4.21 │ false     │ │
+│                      │ │ 1 │ reply │           │    64 │ 216.58.209.46 │        2 │ 120 │    3.87 │ false     │ │
+│                      │ ╰───┴───────┴───────────┴───────┴───────────────┴──────────┴─────┴─────────┴───────────╯ │
+╰──────────────────────┴──────────────────────────────────────────────────────────────────────────────────────────╯
+```
+```nushell
+: (jc ping -4 -c 2 google.com).round_trip_ms_avg
+6.054
+```
+For supported commands see [JC parsers documentation](https://kellyjonbrazil.github.io/jc/#parsers)
+
+Installation:
+
+  1. Install the `jc` command line: https://kellyjonbrazil.github.io/jc/#installation
+  2. Import this module in your `config.nu`: `import ~/.local/share/nu_scripts/modules/jc/`
+
 ## [kubernetes](./kubernetes/)
 ???
  
diff --git a/modules/jc/mod.nu b/modules/jc/mod.nu
new file mode 100644
index 000000000..f83e52228
--- /dev/null
+++ b/modules/jc/mod.nu
@@ -0,0 +1,30 @@
+# Run `jc` (Json Converter)
+#
+# This module provides a wrapper around the `jc` command line tool and automatically
+# parses its output into a structured data format.
+#
+# Dependencies:
+#     * `jc`
+#
+# Installation:
+#     1. Install the `jc` command line: https://kellyjonbrazil.github.io/jc/#installation
+#     2. Import this module in your `config.nu`: `import ~/.local/share/nu_scripts/modules/jc/`
+export def --wrapped main [...args]: [any -> table, any -> record, any -> string] {
+  let run = (^jc ...$args | complete)
+
+  if $run.exit_code != 0 {
+    error make {
+      msg: $run.stderr,
+      label: {
+        text: "jc execution failed",
+        span: (metadata $args).span
+      }
+    }
+  }
+
+  if '--help' in $args or '-h' in $args {
+    $run.stdout
+  } else {
+    $run.stdout | from json
+  }
+}