feat(output): implement YAML and JSON output

CHANGELOG.md

@@ -2,6 +2,7 @@
 
 ## Features
 
+- Add `--json` flag for JSONL format output. 
 
 ## Bugfixes
 

Cargo.toml

@@ -5,19 +5,13 @@ description = "fd is a simple, fast and user-friendly alternative to find."
 exclude = ["/benchmarks/*"]
 homepage = "https://github.com/sharkdp/fd"
 documentation = "https://docs.rs/fd-find"
-keywords = [
-    "search",
-    "find",
-    "file",
-    "filesystem",
-    "tool",
-]
+keywords = ["search", "find", "file", "filesystem", "tool"]
 license = "MIT OR Apache-2.0"
 name = "fd-find"
 readme = "README.md"
 repository = "https://github.com/sharkdp/fd"
 version = "10.3.0"
-edition= "2024"
+edition = "2024"
 rust-version = "1.90.0"
 
 [badges.appveyor]
@@ -43,9 +37,10 @@ anyhow = "1.0"
 etcetera = "0.11"
 normpath = "1.1.1"
 crossbeam-channel = "0.5.15"
-clap_complete = {version = "4.5.60", optional = true}
+clap_complete = { version = "4.5.60", optional = true }
 faccess = "0.2.4"
 jiff = "0.2.14"
+base64 = "0.22.1"
 
 [dependencies.clap]
 version = "4.5.51"
@@ -57,7 +52,11 @@ default-features = false
 features = ["nu-ansi-term"]
 
 [target.'cfg(unix)'.dependencies]
-nix = { version = "0.30.1", default-features = false, features = ["signal", "user", "hostname"] }
+nix = { version = "0.30.1", default-features = false, features = [
+    "signal",
+    "user",
+    "hostname",
+] }
 
 [target.'cfg(all(unix, not(target_os = "redox")))'.dependencies]
 libc = "0.2"
@@ -68,13 +67,14 @@ libc = "0.2"
 # This has to be kept in sync with src/main.rs where the allocator for
 # the program is set.
 [target.'cfg(all(not(windows), not(target_os = "android"), not(target_os = "macos"), not(target_os = "freebsd"), not(target_os = "openbsd"), not(target_os = "illumos"), not(all(target_env = "musl", target_pointer_width = "32")), not(target_arch = "riscv64")))'.dependencies]
-tikv-jemallocator = {version = "0.6.0", optional = true}
+tikv-jemallocator = { version = "0.6.0", optional = true }
 
 [dev-dependencies]
 diff = "0.1"
 tempfile = "3.23"
 filetime = "0.2"
 test-case = "3.3"
+serde_json = "1.0.145"
 
 [profile.release]
 lto = true

doc/fd.1

@@ -510,6 +510,30 @@ Maximum number of arguments to pass to the command given with -X. If the number
 greater than the given size, the command given with -X is run again with remaining arguments. A
 batch size of zero means there is no limit (default), but note that batching might still happen
 due to OS restrictions on the maximum length of command lines.
+.TP
+.BI "\-\-json "
+.RS
+Specify JSONL (as known as NDJSON) format to use for the output. 
+
+Output fields:
+
+  - "path": The file path as a UTF\-8 string.
+
+        Note that when the path contains invalid UTF-8 sequences, it is encoded in base64 and stored in the "path_b64" field instead.
+
+  - "type": The file type (e.g., "file", "directory").
+
+  - "size": The file size in bytes.
+
+  - "mode": The file permissions in octal (e.g., 644).
+
+  - "modified": The last modification time in ISO 8601 format (e.g., 2000-01-01T12:00:00Z).
+
+  - "accessed": The last access time in ISO 8601 format.
+
+  - "created": The creation time in ISO 8601 format.
+.RE
+.TP
 .SH PATTERN SYNTAX
 The regular expression syntax used by fd is documented here:
 

src/cli.rs

@@ -648,6 +648,15 @@ pub struct Opts {
     )]
     search_path: Vec<PathBuf>,
 
+    /// Print results in JSONL format.
+    #[arg(
+        long,
+        value_name = "json",
+        help = "Print results in JSONL format so you can pipe it to tools.",
+        long_help
+    )]
+    pub json: bool,
+
     /// By default, relative paths are prefixed with './' when -x/--exec,
     /// -X/--exec-batch, or -0/--print0 are given, to reduce the risk of a
     /// path starting with '-' being treated as a command line option. Use
@@ -825,6 +834,15 @@ pub enum HyperlinkWhen {
     Never,
 }
 
+#[derive(Copy, Clone, PartialEq, Eq, Debug, ValueEnum)]
+pub enum OutputFormat {
+    /// Plain text output (default)
+    Plain,
+    /// JSONL (JSON Lines, as known as Newline Delimited JSON) output
+    #[value(alias = "ndjson")]
+    Jsonl,
+}
+
 // there isn't a derive api for getting grouped values yet,
 // so we have to use hand-rolled parsing for exec and exec-batch
 pub struct Exec {

src/config.rs

@@ -130,6 +130,9 @@ pub struct Config {
 
     /// Whether or not to use hyperlinks on paths
     pub hyperlink: bool,
+
+    /// Whether to print results in JSONL format
+    pub jsonl: bool,
 }
 
 impl Config {

src/main.rs

@@ -326,6 +326,7 @@ fn construct_config(mut opts: Opts, pattern_regexps: &[String]) -> Result<Config
         actual_path_separator,
         max_results: opts.max_results(),
         strip_cwd_prefix: opts.strip_cwd_prefix(|| !(opts.null_separator || has_command)),
+        jsonl: opts.json,
     })
 }