// Copyright 2020 The Jujutsu Authors // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // https://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. use std::io; use jujutsu_lib::backend::{Signature, Timestamp}; use crate::formatter::{FormatRecorder, Formatter, PlainTextFormatter}; use crate::time_util; pub trait Template { fn format(&self, context: &C, formatter: &mut dyn Formatter) -> io::Result<()>; } pub trait IntoTemplate<'a, C> { fn into_template(self) -> Box + 'a>; } impl + ?Sized> Template for Box { fn format(&self, context: &C, formatter: &mut dyn Formatter) -> io::Result<()> { >::format(self, context, formatter) } } impl Template<()> for Signature { fn format(&self, _: &(), formatter: &mut dyn Formatter) -> io::Result<()> { write!(formatter.labeled("name"), "{}", self.name)?; write!(formatter, " <")?; write!(formatter.labeled("email"), "{}", self.email)?; write!(formatter, ">")?; Ok(()) } } impl Template<()> for String { fn format(&self, _: &(), formatter: &mut dyn Formatter) -> io::Result<()> { formatter.write_str(self) } } impl Template<()> for Timestamp { fn format(&self, _: &(), formatter: &mut dyn Formatter) -> io::Result<()> { formatter.write_str(&time_util::format_absolute_timestamp(self)) } } #[derive(Clone, Debug, Eq, PartialEq)] pub struct TimestampRange { // Could be aliased to Range if needed. pub start: Timestamp, pub end: Timestamp, } impl TimestampRange { // TODO: Introduce duration type, and move formatting to it. pub fn duration(&self) -> String { let mut f = timeago::Formatter::new(); f.min_unit(timeago::TimeUnit::Microseconds).ago(""); let duration = time_util::format_duration(&self.start, &self.end, &f); if duration == "now" { "less than a microsecond".to_owned() } else { duration } } } impl Template<()> for TimestampRange { fn format(&self, _: &(), formatter: &mut dyn Formatter) -> io::Result<()> { self.start.format(&(), formatter)?; write!(formatter, " - ")?; self.end.format(&(), formatter)?; Ok(()) } } impl Template<()> for bool { fn format(&self, _: &(), formatter: &mut dyn Formatter) -> io::Result<()> { formatter.write_str(if *self { "true" } else { "false" }) } } impl Template<()> for i64 { fn format(&self, _: &(), formatter: &mut dyn Formatter) -> io::Result<()> { write!(formatter, "{self}") } } /// Indents each line by the given prefix. pub struct IndentTemplate { prefix: S, content: T, } impl IndentTemplate { pub fn new(prefix: S, content: T) -> Self where S: Template, T: Template, { IndentTemplate { prefix, content } } } impl Template for IndentTemplate where S: Template, T: Template, { fn format(&self, context: &C, formatter: &mut dyn Formatter) -> io::Result<()> { let mut recorder = FormatRecorder::new(); self.content.format(context, &mut recorder)?; let mut new_line = true; recorder.replay_with(formatter, |formatter, data| { for line in data.split_inclusive(|&c| c == b'\n') { if new_line && line != b"\n" { // Prefix inherits the current labels. This is implementation detail // and may be fixed later. self.prefix.format(context, formatter)?; } formatter.write_all(line)?; new_line = line.ends_with(b"\n"); } Ok(()) }) } } pub struct LabelTemplate { content: T, labels: L, } impl LabelTemplate { pub fn new(content: T, labels: L) -> Self where T: Template, L: TemplateProperty>, { LabelTemplate { content, labels } } } impl Template for LabelTemplate where T: Template, L: TemplateProperty>, { fn format(&self, context: &C, formatter: &mut dyn Formatter) -> io::Result<()> { let labels = self.labels.extract(context); for label in &labels { formatter.push_label(label)?; } self.content.format(context, formatter)?; for _label in &labels { formatter.pop_label()?; } Ok(()) } } pub struct ListTemplate(pub Vec); impl> Template for ListTemplate { fn format(&self, context: &C, formatter: &mut dyn Formatter) -> io::Result<()> { for template in &self.0 { template.format(context, formatter)? } Ok(()) } } /// Like `ListTemplate`, but inserts a separator between non-empty templates. pub struct SeparateTemplate { separator: S, contents: Vec, } impl SeparateTemplate { pub fn new(separator: S, contents: Vec) -> Self where S: Template, T: Template, { SeparateTemplate { separator, contents, } } } impl Template for SeparateTemplate where S: Template, T: Template, { fn format(&self, context: &C, formatter: &mut dyn Formatter) -> io::Result<()> { let mut content_recorders = self .contents .iter() .filter_map(|template| { let mut recorder = FormatRecorder::new(); match template.format(context, &mut recorder) { Ok(()) if recorder.data().is_empty() => None, // omit empty content Ok(()) => Some(Ok(recorder)), Err(e) => Some(Err(e)), } }) .fuse(); if let Some(recorder) = content_recorders.next() { recorder?.replay(formatter)?; } for recorder in content_recorders { self.separator.format(context, formatter)?; recorder?.replay(formatter)?; } Ok(()) } } pub trait TemplateProperty { type Output; fn extract(&self, context: &C) -> Self::Output; } impl + ?Sized> TemplateProperty for Box

{ type Output =

>::Output; fn extract(&self, context: &C) -> Self::Output {

>::extract(self, context) } } impl> TemplateProperty for Option

{ type Output = Option; fn extract(&self, context: &C) -> Self::Output { self.as_ref().map(|property| property.extract(context)) } } // Implement TemplateProperty for tuples macro_rules! tuple_impls { ($( ( $($n:tt $T:ident),+ ) )+) => { $( impl,)+> TemplateProperty for ($($T,)+) { type Output = ($($T::Output,)+); fn extract(&self, context: &C) -> Self::Output { ($(self.$n.extract(context),)+) } } )+ } } tuple_impls! { (0 T0) (0 T0, 1 T1) (0 T0, 1 T1, 2 T2) (0 T0, 1 T1, 2 T2, 3 T3) } /// Adapter to drop template context. pub struct Literal(pub O); impl> Template for Literal { fn format(&self, _context: &C, formatter: &mut dyn Formatter) -> io::Result<()> { self.0.format(&(), formatter) } } impl TemplateProperty for Literal { type Output = O; fn extract(&self, _context: &C) -> O { self.0.clone() } } /// Adapter to turn closure into property. pub struct TemplatePropertyFn(pub F); impl O> TemplateProperty for TemplatePropertyFn { type Output = O; fn extract(&self, context: &C) -> Self::Output { (self.0)(context) } } /// Adapter to extract context-less template value from property for displaying. pub struct FormattablePropertyTemplate

{ property: P, } impl

FormattablePropertyTemplate

{ pub fn new(property: P) -> Self where P: TemplateProperty, P::Output: Template<()>, { FormattablePropertyTemplate { property } } } impl Template for FormattablePropertyTemplate

where P: TemplateProperty, P::Output: Template<()>, { fn format(&self, context: &C, formatter: &mut dyn Formatter) -> io::Result<()> { let template = self.property.extract(context); template.format(&(), formatter) } } impl<'a, C: 'a, O> IntoTemplate<'a, C> for Box + 'a> where O: Template<()> + 'a, { fn into_template(self) -> Box + 'a> { Box::new(FormattablePropertyTemplate::new(self)) } } /// Adapter to turn template back to string property. pub struct PlainTextFormattedProperty { template: T, } impl PlainTextFormattedProperty { pub fn new(template: T) -> Self { PlainTextFormattedProperty { template } } } impl> TemplateProperty for PlainTextFormattedProperty { type Output = String; fn extract(&self, context: &C) -> Self::Output { let mut output = vec![]; self.template .format(context, &mut PlainTextFormatter::new(&mut output)) .expect("write() to PlainTextFormatter should never fail"); // TODO: Use from_utf8_lossy() if we added template that embeds file content String::from_utf8(output).expect("template output should be utf-8 bytes") } } pub struct ConditionalTemplate { pub condition: P, pub true_template: T, pub false_template: Option, } impl ConditionalTemplate { pub fn new(condition: P, true_template: T, false_template: Option) -> Self where P: TemplateProperty, T: Template, U: Template, { ConditionalTemplate { condition, true_template, false_template, } } } impl Template for ConditionalTemplate where P: TemplateProperty, T: Template, U: Template, { fn format(&self, context: &C, formatter: &mut dyn Formatter) -> io::Result<()> { if self.condition.extract(context) { self.true_template.format(context, formatter)?; } else if let Some(false_template) = &self.false_template { false_template.format(context, formatter)?; } Ok(()) } } // TODO: If needed, add a ContextualTemplateFunction where the function also // gets the context pub struct TemplateFunction { pub property: P, pub function: F, } impl TemplateFunction { pub fn new(property: P, function: F) -> Self where P: TemplateProperty, F: Fn(P::Output) -> O, { TemplateFunction { property, function } } } impl TemplateProperty for TemplateFunction where P: TemplateProperty, F: Fn(P::Output) -> O, { type Output = O; fn extract(&self, context: &C) -> Self::Output { (self.function)(self.property.extract(context)) } }