1use std::io::{self, Write};
2#[cfg(feature = "paging")]
3use std::process::Child;
5#[cfg(feature = "paging")]
6use crate::config::PagingMode;
8#[cfg(feature = "paging")]
9use crate::less::retrieve_less_version;
13 #[cfg(feature = "paging")]
19 #[cfg(feature = "paging")]
20 pub fn from_mode(mode: PagingMode, pager: Option<&str>) -> Result<Self> {
21 use self::PagingMode::*;
23 Always => OutputType::try_pager(false, pager)?,
24 QuitIfOneScreen => OutputType::try_pager(true, pager)?,
25 _ => OutputType::stdout(),
29 /// Try to launch the pager. Fall back to stdout in case of errors.
30 #[cfg(feature = "paging")]
31 fn try_pager(quit_if_one_screen: bool, pager_from_config: Option<&str>) -> Result<Self> {
33 use std::ffi::OsString;
34 use std::path::PathBuf;
35 use std::process::{Command, Stdio};
37 let mut replace_arguments_to_less = false;
39 let pager_from_env = match (env::var("BAT_PAGER"), env::var("PAGER")) {
40 (Ok(bat_pager), _) => Some(bat_pager),
42 // less needs to be called with the '-R' option in order to properly interpret the
43 // ANSI color sequences printed by bat. If someone has set PAGER="less -F", we
44 // therefore need to overwrite the arguments and add '-R'.
46 // We only do this for PAGER (as it is not specific to 'bat'), not for BAT_PAGER
47 // or bats '--pager' command line option.
48 replace_arguments_to_less = true;
54 let pager_from_config = pager_from_config.map(|p| p.to_string());
56 if pager_from_config.is_some() {
57 replace_arguments_to_less = false;
60 let pager = pager_from_config
62 .unwrap_or_else(|| String::from("less"));
65 shell_words::split(&pager).chain_err(|| "Could not parse pager command.")?;
67 match pagerflags.split_first() {
68 Some((pager_name, args)) => {
69 let mut pager_path = PathBuf::from(pager_name);
71 if pager_path.file_stem() == Some(&OsString::from("bat")) {
72 pager_path = PathBuf::from("less");
75 let is_less = pager_path.file_stem() == Some(&OsString::from("less"));
77 let mut process = if is_less {
78 let mut p = Command::new(&pager_path);
79 if args.is_empty() || replace_arguments_to_less {
80 p.arg("--RAW-CONTROL-CHARS");
81 if quit_if_one_screen {
82 p.arg("--quit-if-one-screen");
85 // Passing '--no-init' fixes a bug with '--quit-if-one-screen' in older
86 // versions of 'less'. Unfortunately, it also breaks mouse-wheel support.
88 // See: http://www.greenwoodsoftware.com/less/news.530.html
89 match retrieve_less_version() {
93 Some(version) if version < 530 => {
101 p.env("LESSCHARSET", "UTF-8");
104 let mut p = Command::new(&pager_path);
110 .stdin(Stdio::piped())
112 .map(OutputType::Pager)
113 .unwrap_or_else(|_| OutputType::stdout()))
115 None => Ok(OutputType::stdout()),
119 pub(crate) fn stdout() -> Self {
120 OutputType::Stdout(io::stdout())
123 pub fn handle(&mut self) -> Result<&mut dyn Write> {
125 #[cfg(feature = "paging")]
126 OutputType::Pager(ref mut command) => command
129 .chain_err(|| "Could not open stdin for pager")?,
130 OutputType::Stdout(ref mut handle) => handle,
135#[cfg(feature = "paging")]
136impl Drop for OutputType {
138 if let OutputType::Pager(ref mut command) = *self {
139 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