mirror of https://github.com/sharkdp/bat.git
616 lines
26 KiB
Rust
616 lines
26 KiB
Rust
use clap::{crate_name, crate_version, App as ClapApp, AppSettings, Arg, ArgGroup, SubCommand};
|
|
use once_cell::sync::Lazy;
|
|
use std::env;
|
|
use std::path::Path;
|
|
|
|
static VERSION: Lazy<String> = Lazy::new(|| {
|
|
#[cfg(feature = "bugreport")]
|
|
let git_version = bugreport::git_version!(fallback = "");
|
|
#[cfg(not(feature = "bugreport"))]
|
|
let git_version = "";
|
|
|
|
if git_version.is_empty() {
|
|
crate_version!().to_string()
|
|
} else {
|
|
format!("{} ({})", crate_version!(), git_version)
|
|
}
|
|
});
|
|
|
|
pub fn build_app(interactive_output: bool) -> ClapApp<'static> {
|
|
let clap_color_setting = if interactive_output && env::var_os("NO_COLOR").is_none() {
|
|
AppSettings::ColoredHelp
|
|
} else {
|
|
AppSettings::ColorNever
|
|
};
|
|
|
|
let mut app = ClapApp::new(crate_name!())
|
|
.version(VERSION.as_str())
|
|
.global_setting(clap_color_setting)
|
|
.global_setting(AppSettings::DeriveDisplayOrder)
|
|
.global_setting(AppSettings::UnifiedHelpMessage)
|
|
.global_setting(AppSettings::HidePossibleValuesInHelp)
|
|
.setting(AppSettings::ArgsNegateSubcommands)
|
|
.setting(AppSettings::AllowExternalSubcommands)
|
|
.setting(AppSettings::DisableHelpSubcommand)
|
|
.max_term_width(100)
|
|
.about(
|
|
"A cat(1) clone with wings.\n\n\
|
|
Use '--help' instead of '-h' to see a more detailed version of the help text.",
|
|
)
|
|
.after_help(
|
|
"Note: `bat -h` prints a short and concise overview while `bat --help` gives all \
|
|
details.",
|
|
)
|
|
.long_about("A cat(1) clone with syntax highlighting and Git integration.")
|
|
.arg(
|
|
Arg::with_name("FILE")
|
|
.help("File(s) to print / concatenate. Use '-' for standard input.")
|
|
.long_help(
|
|
"File(s) to print / concatenate. Use a dash ('-') or no argument at all \
|
|
to read from standard input.",
|
|
)
|
|
.takes_value(true)
|
|
.multiple(true)
|
|
.empty_values(false)
|
|
.allow_invalid_utf8(true),
|
|
)
|
|
.arg(
|
|
Arg::with_name("show-all")
|
|
.long("show-all")
|
|
.alias("show-nonprintable")
|
|
.short('A')
|
|
.conflicts_with("language")
|
|
.help("Show non-printable characters (space, tab, newline, ..).")
|
|
.long_help(
|
|
"Show non-printable characters like space, tab or newline. \
|
|
This option can also be used to print binary files. \
|
|
Use '--tabs' to control the width of the tab-placeholders.",
|
|
),
|
|
)
|
|
.arg(
|
|
Arg::with_name("plain")
|
|
.overrides_with("plain")
|
|
.overrides_with("number")
|
|
.short('p')
|
|
.long("plain")
|
|
.multiple_occurrences(true)
|
|
.help("Show plain style (alias for '--style=plain').")
|
|
.long_help(
|
|
"Only show plain style, no decorations. This is an alias for \
|
|
'--style=plain'. When '-p' is used twice ('-pp'), it also disables \
|
|
automatic paging (alias for '--style=plain --paging=never').",
|
|
),
|
|
)
|
|
.arg(
|
|
Arg::with_name("language")
|
|
.short('l')
|
|
.long("language")
|
|
.overrides_with("language")
|
|
.help("Set the language for syntax highlighting.")
|
|
.long_help(
|
|
"Explicitly set the language for syntax highlighting. The language can be \
|
|
specified as a name (like 'C++' or 'LaTeX') or possible file extension \
|
|
(like 'cpp', 'hpp' or 'md'). Use '--list-languages' to show all supported \
|
|
language names and file extensions.",
|
|
)
|
|
.takes_value(true),
|
|
)
|
|
.arg(
|
|
Arg::with_name("highlight-line")
|
|
.long("highlight-line")
|
|
.short('H')
|
|
.takes_value(true)
|
|
.number_of_values(1)
|
|
.multiple(true)
|
|
.value_name("N:M")
|
|
.help("Highlight lines N through M.")
|
|
.long_help(
|
|
"Highlight the specified line ranges with a different background color \
|
|
For example:\n \
|
|
'--highlight-line 40' highlights line 40\n \
|
|
'--highlight-line 30:40' highlights lines 30 to 40\n \
|
|
'--highlight-line :40' highlights lines 1 to 40\n \
|
|
'--highlight-line 40:' highlights lines 40 to the end of the file\n \
|
|
'--highlight-line 30:+10' highlights lines 30 to 40",
|
|
),
|
|
)
|
|
.arg(
|
|
Arg::with_name("file-name")
|
|
.long("file-name")
|
|
.takes_value(true)
|
|
.number_of_values(1)
|
|
.multiple(true)
|
|
.value_name("name")
|
|
.allow_invalid_utf8(true)
|
|
.help("Specify the name to display for a file.")
|
|
.long_help(
|
|
"Specify the name to display for a file. Useful when piping \
|
|
data to bat from STDIN when bat does not otherwise know \
|
|
the filename. Note that the provided file name is also \
|
|
used for syntax detection.",
|
|
),
|
|
);
|
|
|
|
#[cfg(feature = "git")]
|
|
{
|
|
app = app
|
|
.arg(
|
|
Arg::with_name("diff")
|
|
.long("diff")
|
|
.short('d')
|
|
.conflicts_with("line-range")
|
|
.help("Only show lines that have been added/removed/modified.")
|
|
.long_help(
|
|
"Only show lines that have been added/removed/modified with respect \
|
|
to the Git index. Use --diff-context=N to control how much context you want to see.",
|
|
),
|
|
)
|
|
.arg(
|
|
Arg::with_name("diff-context")
|
|
.long("diff-context")
|
|
.overrides_with("diff-context")
|
|
.takes_value(true)
|
|
.value_name("N")
|
|
.validator(
|
|
|n| {
|
|
n.parse::<usize>()
|
|
.map_err(|_| "must be a number")
|
|
.map(|_| ()) // Convert to Result<(), &str>
|
|
.map_err(|e| e.to_string())
|
|
}, // Convert to Result<(), String>
|
|
)
|
|
.hidden_short_help(true)
|
|
.long_help(
|
|
"Include N lines of context around added/removed/modified lines when using '--diff'.",
|
|
),
|
|
)
|
|
}
|
|
|
|
app = app.arg(
|
|
Arg::with_name("tabs")
|
|
.long("tabs")
|
|
.overrides_with("tabs")
|
|
.takes_value(true)
|
|
.value_name("T")
|
|
.validator(
|
|
|t| {
|
|
t.parse::<u32>()
|
|
.map_err(|_t| "must be a number")
|
|
.map(|_t| ()) // Convert to Result<(), &str>
|
|
.map_err(|e| e.to_string())
|
|
}, // Convert to Result<(), String>
|
|
)
|
|
.help("Set the tab width to T spaces.")
|
|
.long_help(
|
|
"Set the tab width to T spaces. Use a width of 0 to pass tabs through \
|
|
directly",
|
|
),
|
|
)
|
|
.arg(
|
|
Arg::with_name("wrap")
|
|
.long("wrap")
|
|
.overrides_with("wrap")
|
|
.takes_value(true)
|
|
.value_name("mode")
|
|
.possible_values(&["auto", "never", "character"])
|
|
.default_value("auto")
|
|
.hide_default_value(true)
|
|
.help("Specify the text-wrapping mode (*auto*, never, character).")
|
|
.long_help("Specify the text-wrapping mode (*auto*, never, character). \
|
|
The '--terminal-width' option can be used in addition to \
|
|
control the output width."),
|
|
)
|
|
.arg(
|
|
Arg::with_name("terminal-width")
|
|
.long("terminal-width")
|
|
.takes_value(true)
|
|
.value_name("width")
|
|
.hidden_short_help(true)
|
|
.allow_hyphen_values(true)
|
|
.validator(
|
|
|t| {
|
|
let is_offset = t.starts_with('+') || t.starts_with('-');
|
|
t.parse::<i32>()
|
|
.map_err(|_e| "must be an offset or number")
|
|
.and_then(|v| if v == 0 && !is_offset {
|
|
Err("terminal width cannot be zero")
|
|
} else {
|
|
Ok(())
|
|
})
|
|
.map_err(|e| e.to_string())
|
|
})
|
|
.help(
|
|
"Explicitly set the width of the terminal instead of determining it \
|
|
automatically. If prefixed with '+' or '-', the value will be treated \
|
|
as an offset to the actual terminal width. See also: '--wrap'.",
|
|
),
|
|
)
|
|
.arg(
|
|
Arg::with_name("number")
|
|
.long("number")
|
|
.overrides_with("number")
|
|
.short('n')
|
|
.help("Show line numbers (alias for '--style=numbers').")
|
|
.long_help(
|
|
"Only show line numbers, no other decorations. This is an alias for \
|
|
'--style=numbers'",
|
|
),
|
|
)
|
|
.arg(
|
|
Arg::with_name("color")
|
|
.long("color")
|
|
.overrides_with("color")
|
|
.takes_value(true)
|
|
.value_name("when")
|
|
.possible_values(&["auto", "never", "always"])
|
|
.hide_default_value(true)
|
|
.default_value("auto")
|
|
.help("When to use colors (*auto*, never, always).")
|
|
.long_help(
|
|
"Specify when to use colored output. The automatic mode \
|
|
only enables colors if an interactive terminal is detected - \
|
|
colors are automatically disabled if the output goes to a pipe.\n\
|
|
Possible values: *auto*, never, always.",
|
|
),
|
|
)
|
|
.arg(
|
|
Arg::with_name("italic-text")
|
|
.long("italic-text")
|
|
.takes_value(true)
|
|
.value_name("when")
|
|
.possible_values(&["always", "never"])
|
|
.default_value("never")
|
|
.hide_default_value(true)
|
|
.help("Use italics in output (always, *never*)")
|
|
.long_help("Specify when to use ANSI sequences for italic text in the output. Possible values: always, *never*."),
|
|
)
|
|
.arg(
|
|
Arg::with_name("decorations")
|
|
.long("decorations")
|
|
.overrides_with("decorations")
|
|
.takes_value(true)
|
|
.value_name("when")
|
|
.possible_values(&["auto", "never", "always"])
|
|
.default_value("auto")
|
|
.hide_default_value(true)
|
|
.help("When to show the decorations (*auto*, never, always).")
|
|
.long_help(
|
|
"Specify when to use the decorations that have been specified \
|
|
via '--style'. The automatic mode only enables decorations if \
|
|
an interactive terminal is detected. Possible values: *auto*, never, always.",
|
|
),
|
|
)
|
|
.arg(
|
|
Arg::with_name("force-colorization")
|
|
.long("force-colorization")
|
|
.short('f')
|
|
.conflicts_with("color")
|
|
.conflicts_with("decorations")
|
|
.overrides_with("force-colorization")
|
|
.hidden_short_help(true)
|
|
.long_help("Alias for '--decorations=always --color=always'. This is useful \
|
|
if the output of bat is piped to another program, but you want \
|
|
to keep the colorization/decorations.")
|
|
)
|
|
.arg(
|
|
Arg::with_name("paging")
|
|
.long("paging")
|
|
.overrides_with("paging")
|
|
.overrides_with("no-paging")
|
|
.takes_value(true)
|
|
.value_name("when")
|
|
.possible_values(&["auto", "never", "always"])
|
|
.default_value("auto")
|
|
.hide_default_value(true)
|
|
.help("Specify when to use the pager, or use `-P` to disable (*auto*, never, always).")
|
|
.long_help(
|
|
"Specify when to use the pager. To disable the pager, use \
|
|
--paging=never' or its alias,'-P'. To disable the pager permanently, \
|
|
set BAT_PAGER to an empty string. To control which pager is used, see the \
|
|
'--pager' option. Possible values: *auto*, never, always."
|
|
),
|
|
)
|
|
.arg(
|
|
Arg::with_name("no-paging")
|
|
.short('P')
|
|
.long("no-paging")
|
|
.alias("no-pager")
|
|
.overrides_with("no-paging")
|
|
.hidden(true)
|
|
.hidden_short_help(true)
|
|
.help("Alias for '--paging=never'")
|
|
)
|
|
.arg(
|
|
Arg::with_name("pager")
|
|
.long("pager")
|
|
.overrides_with("pager")
|
|
.takes_value(true)
|
|
.value_name("command")
|
|
.hidden_short_help(true)
|
|
.help("Determine which pager to use.")
|
|
.long_help(
|
|
"Determine which pager is used. This option will override the \
|
|
PAGER and BAT_PAGER environment variables. The default pager is 'less'. \
|
|
To control when the pager is used, see the '--paging' option. \
|
|
Example: '--pager \"less -RF\"'."
|
|
),
|
|
)
|
|
.arg(
|
|
Arg::with_name("map-syntax")
|
|
.short('m')
|
|
.long("map-syntax")
|
|
.multiple(true)
|
|
.takes_value(true)
|
|
.number_of_values(1)
|
|
.value_name("glob:syntax")
|
|
.help("Use the specified syntax for files matching the glob pattern ('*.cpp:C++').")
|
|
.long_help(
|
|
"Map a glob pattern to an existing syntax name. The glob pattern is matched \
|
|
on the full path and the filename. For example, to highlight *.build files \
|
|
with the Python syntax, use -m '*.build:Python'. To highlight files named \
|
|
'.myignore' with the Git Ignore syntax, use -m '.myignore:Git Ignore'. Note \
|
|
that the right-hand side is the *name* of the syntax, not a file extension.",
|
|
)
|
|
.takes_value(true),
|
|
)
|
|
.arg(
|
|
Arg::with_name("ignored-suffix")
|
|
.number_of_values(1)
|
|
.multiple(true)
|
|
.takes_value(true)
|
|
.long("ignored-suffix")
|
|
.hidden_short_help(true)
|
|
.help(
|
|
"Ignore extension. For example:\n \
|
|
'bat --ignored-suffix \".dev\" my_file.json.dev' will use JSON syntax, and ignore '.dev'"
|
|
)
|
|
)
|
|
.arg(
|
|
Arg::with_name("theme")
|
|
.long("theme")
|
|
.overrides_with("theme")
|
|
.takes_value(true)
|
|
.help("Set the color theme for syntax highlighting.")
|
|
.long_help(
|
|
"Set the theme for syntax highlighting. Use '--list-themes' to \
|
|
see all available themes. To set a default theme, add the \
|
|
'--theme=\"...\"' option to the configuration file or export the \
|
|
BAT_THEME environment variable (e.g.: export \
|
|
BAT_THEME=\"...\").",
|
|
),
|
|
)
|
|
.arg(
|
|
Arg::with_name("list-themes")
|
|
.long("list-themes")
|
|
.help("Display all supported highlighting themes.")
|
|
.long_help("Display a list of supported themes for syntax highlighting."),
|
|
)
|
|
.arg(
|
|
Arg::with_name("style")
|
|
.long("style")
|
|
.value_name("components")
|
|
// Need to turn this off for overrides_with to work as we want. See the bottom most
|
|
// example at https://docs.rs/clap/2.32.0/clap/struct.Arg.html#method.overrides_with
|
|
.use_delimiter(false)
|
|
.takes_value(true)
|
|
.overrides_with("style")
|
|
.overrides_with("plain")
|
|
.overrides_with("number")
|
|
// Cannot use claps built in validation because we have to turn off clap's delimiters
|
|
.validator(|val| {
|
|
let mut invalid_vals = val.split(',').filter(|style| {
|
|
!&[
|
|
"auto",
|
|
"full",
|
|
"default",
|
|
"plain",
|
|
"header",
|
|
"header-filename",
|
|
"header-filesize",
|
|
"grid",
|
|
"rule",
|
|
"numbers",
|
|
"snip",
|
|
#[cfg(feature = "git")]
|
|
"changes",
|
|
].contains(style)
|
|
});
|
|
|
|
if let Some(invalid) = invalid_vals.next() {
|
|
Err(format!("Unknown style, '{}'", invalid))
|
|
} else {
|
|
Ok(())
|
|
}
|
|
})
|
|
.help(
|
|
"Comma-separated list of style elements to display \
|
|
(*default*, auto, full, plain, changes, header, header-filename, header-filesize, grid, rule, numbers, snip).",
|
|
)
|
|
.long_help(
|
|
"Configure which elements (line numbers, file headers, grid \
|
|
borders, Git modifications, ..) to display in addition to the \
|
|
file contents. The argument is a comma-separated list of \
|
|
components to display (e.g. 'numbers,changes,grid') or a \
|
|
pre-defined style ('full'). To set a default style, add the \
|
|
'--style=\"..\"' option to the configuration file or export the \
|
|
BAT_STYLE environment variable (e.g.: export BAT_STYLE=\"..\").\n\n\
|
|
Possible values:\n\n \
|
|
* default: enables recommended style components (default).\n \
|
|
* full: enables all available components.\n \
|
|
* auto: same as 'default', unless the output is piped.\n \
|
|
* plain: disables all available components.\n \
|
|
* changes: show Git modification markers.\n \
|
|
* header: alias for 'header-filename'.\n \
|
|
* header-filename: show filenames before the content.\n \
|
|
* header-filesize: show file sizes before the content.\n \
|
|
* grid: vertical/horizontal lines to separate side bar\n \
|
|
and the header from the content.\n \
|
|
* rule: horizontal lines to delimit files.\n \
|
|
* numbers: show line numbers in the side bar.\n \
|
|
* snip: draw separation lines between distinct line ranges.",
|
|
),
|
|
)
|
|
.arg(
|
|
Arg::with_name("line-range")
|
|
.long("line-range")
|
|
.short('r')
|
|
.multiple(true)
|
|
.takes_value(true)
|
|
.number_of_values(1)
|
|
.value_name("N:M")
|
|
.help("Only print the lines from N to M.")
|
|
.long_help(
|
|
"Only print the specified range of lines for each file. \
|
|
For example:\n \
|
|
'--line-range 30:40' prints lines 30 to 40\n \
|
|
'--line-range :40' prints lines 1 to 40\n \
|
|
'--line-range 40:' prints lines 40 to the end of the file\n \
|
|
'--line-range 40' only prints line 40\n \
|
|
'--line-range 30:+10' prints lines 30 to 40",
|
|
),
|
|
)
|
|
.arg(
|
|
Arg::with_name("list-languages")
|
|
.long("list-languages")
|
|
.short('L')
|
|
.conflicts_with("list-themes")
|
|
.help("Display all supported languages.")
|
|
.long_help("Display a list of supported languages for syntax highlighting."),
|
|
)
|
|
.arg(
|
|
Arg::with_name("unbuffered")
|
|
.short('u')
|
|
.long("unbuffered")
|
|
.hidden_short_help(true)
|
|
.long_help(
|
|
"This option exists for POSIX-compliance reasons ('u' is for \
|
|
'unbuffered'). The output is always unbuffered - this option \
|
|
is simply ignored.",
|
|
),
|
|
)
|
|
.arg(
|
|
Arg::with_name("no-config")
|
|
.long("no-config")
|
|
.hidden(true)
|
|
.help("Do not use the configuration file"),
|
|
)
|
|
.arg(
|
|
Arg::with_name("no-custom-assets")
|
|
.long("no-custom-assets")
|
|
.hidden(true)
|
|
.help("Do not load custom assets"),
|
|
)
|
|
.arg(
|
|
Arg::with_name("config-file")
|
|
.long("config-file")
|
|
.conflicts_with("list-languages")
|
|
.conflicts_with("list-themes")
|
|
.hidden(true)
|
|
.help("Show path to the configuration file."),
|
|
)
|
|
.arg(
|
|
Arg::with_name("generate-config-file")
|
|
.long("generate-config-file")
|
|
.conflicts_with("list-languages")
|
|
.conflicts_with("list-themes")
|
|
.hidden(true)
|
|
.help("Generates a default configuration file."),
|
|
)
|
|
.arg(
|
|
Arg::with_name("config-dir")
|
|
.long("config-dir")
|
|
.hidden(true)
|
|
.help("Show bat's configuration directory."),
|
|
)
|
|
.arg(
|
|
Arg::with_name("cache-dir")
|
|
.long("cache-dir")
|
|
.hidden(true)
|
|
.help("Show bat's cache directory."),
|
|
)
|
|
.arg(
|
|
Arg::with_name("diagnostic")
|
|
.long("diagnostic")
|
|
.alias("diagnostics")
|
|
.hidden_short_help(true)
|
|
.help("Show diagnostic information for bug reports.")
|
|
)
|
|
.arg(
|
|
Arg::with_name("acknowledgements")
|
|
.long("acknowledgements")
|
|
.hidden_short_help(true)
|
|
.help("Show acknowledgements."),
|
|
)
|
|
.help_message("Print this help message.");
|
|
|
|
// Check if the current directory contains a file name cache. Otherwise,
|
|
// enable the 'bat cache' subcommand.
|
|
if Path::new("cache").exists() {
|
|
app
|
|
} else {
|
|
app.subcommand(
|
|
SubCommand::with_name("cache")
|
|
.about("Modify the syntax-definition and theme cache")
|
|
.arg(
|
|
Arg::with_name("build")
|
|
.long("build")
|
|
.short('b')
|
|
.help("Initialize (or update) the syntax/theme cache.")
|
|
.long_help(
|
|
"Initialize (or update) the syntax/theme cache by loading from \
|
|
the source directory (default: the configuration directory).",
|
|
),
|
|
)
|
|
.arg(
|
|
Arg::with_name("clear")
|
|
.long("clear")
|
|
.short('c')
|
|
.help("Remove the cached syntax definitions and themes."),
|
|
)
|
|
.group(
|
|
ArgGroup::with_name("cache-actions")
|
|
.args(&["build", "clear"])
|
|
.required(true),
|
|
)
|
|
.arg(
|
|
Arg::with_name("source")
|
|
.long("source")
|
|
.requires("build")
|
|
.takes_value(true)
|
|
.value_name("dir")
|
|
.help("Use a different directory to load syntaxes and themes from."),
|
|
)
|
|
.arg(
|
|
Arg::with_name("target")
|
|
.long("target")
|
|
.requires("build")
|
|
.takes_value(true)
|
|
.value_name("dir")
|
|
.help(
|
|
"Use a different directory to store the cached syntax and theme set.",
|
|
),
|
|
)
|
|
.arg(
|
|
Arg::with_name("blank")
|
|
.long("blank")
|
|
.requires("build")
|
|
.help(
|
|
"Create completely new syntax and theme sets \
|
|
(instead of appending to the default sets).",
|
|
),
|
|
)
|
|
.arg(
|
|
Arg::with_name("acknowledgements")
|
|
.long("acknowledgements")
|
|
.requires("build")
|
|
.help("Build acknowledgements.bin."),
|
|
),
|
|
)
|
|
}
|
|
}
|
|
|
|
#[test]
|
|
fn verify_app() {
|
|
build_app(false).debug_assert();
|
|
}
|