1use std::io::{self, Write};
2#[cfg(feature = "paging")]
3use std::process::Child;
6#[cfg(feature = "paging")]
7use crate::less::retrieve_less_version;
8#[cfg(feature = "paging")]
9use crate::paging::PagingMode;
10#[cfg(feature = "paging")]
11use crate::wrapping::WrappingMode;
13#[cfg(feature = "paging")]
14#[derive(Debug, PartialEq)]
15enum SingleScreenAction {
22 #[cfg(feature = "paging")]
28 #[cfg(feature = "paging")]
30 paging_mode: PagingMode,
31 wrapping_mode: WrappingMode,
34 use self::PagingMode::*;
35 Ok(match paging_mode {
36 Always => OutputType::try_pager(SingleScreenAction::Nothing, wrapping_mode, pager)?,
38 OutputType::try_pager(SingleScreenAction::Quit, wrapping_mode, pager)?
40 _ => OutputType::stdout(),
44 /// Try to launch the pager. Fall back to stdout in case of errors.
45 #[cfg(feature = "paging")]
47 single_screen_action: SingleScreenAction,
48 wrapping_mode: WrappingMode,
49 pager_from_config: Option<&str>,
51 use crate::pager::{self, PagerKind, PagerSource};
52 use std::process::{Command, Stdio};
55 pager::get_pager(pager_from_config).chain_err(|| "Could not parse pager command.")?;
57 let pager = match pager_opt {
59 None => return Ok(OutputType::stdout()),
62 if pager.kind == PagerKind::Bat {
63 return Err(ErrorKind::InvalidPagerValueBat.into());
66 let resolved_path = match grep_cli::resolve_binary(&pager.bin) {
69 return Ok(OutputType::stdout());
73 let mut p = Command::new(resolved_path);
74 let args = pager.args;
76 if pager.kind == PagerKind::Less {
77 // less needs to be called with the '-R' option in order to properly interpret the
78 // ANSI color sequences printed by bat. If someone has set PAGER="less -F", we
79 // therefore need to overwrite the arguments and add '-R'.
81 // We only do this for PAGER (as it is not specific to 'bat'), not for BAT_PAGER
82 // or bats '--pager' command line option.
83 let replace_arguments_to_less = pager.source == PagerSource::EnvVarPager;
85 if args.is_empty() || replace_arguments_to_less {
86 p.arg("--RAW-CONTROL-CHARS");
87 if single_screen_action == SingleScreenAction::Quit {
88 p.arg("--quit-if-one-screen");
91 if wrapping_mode == WrappingMode::NoWrapping(true) {
92 p.arg("--chop-long-lines");
95 // Passing '--no-init' fixes a bug with '--quit-if-one-screen' in older
96 // versions of 'less'. Unfortunately, it also breaks mouse-wheel support.
98 // See: http://www.greenwoodsoftware.com/less/news.530.html
100 // For newer versions (530 or 558 on Windows), we omit '--no-init' as it
101 // is not needed anymore.
102 match retrieve_less_version(&pager.bin) {
106 Some(version) if (version < 530 || (cfg!(windows) && version < 558)) => {
114 p.env("LESSCHARSET", "UTF-8");
119 Ok(p.stdin(Stdio::piped())
121 .map(OutputType::Pager)
122 .unwrap_or_else(|_| OutputType::stdout()))
125 pub(crate) fn stdout() -> Self {
126 OutputType::Stdout(io::stdout())
129 #[cfg(feature = "paging")]
130 pub(crate) fn is_pager(&self) -> bool {
131 matches!(self, OutputType::Pager(_))
134 #[cfg(not(feature = "paging"))]
135 pub(crate) fn is_pager(&self) -> bool {
139 pub fn handle(&mut self) -> Result<&mut dyn Write> {
141 #[cfg(feature = "paging")]
142 OutputType::Pager(ref mut command) => command
145 .chain_err(|| "Could not open stdin for pager")?,
146 OutputType::Stdout(ref mut handle) => handle,
151#[cfg(feature = "paging")]
152impl Drop for OutputType {
154 if let OutputType::Pager(ref mut command) = *self {
155 let _ = command.wait();
keysesc to close
- j k
- move down, up
- enter
- open
- esc
- back, or up a level
- 1 2 3 4
- readme, files, commits, refs
- /
- filter
- y
- copy the clone command
- c
- compare the chosen commit with another (or shift-click both)
- ?
- show or hide this list