From 533374db14087ac54fdc86afa5f009487ac1b850 Mon Sep 17 00:00:00 2001 From: Laurenz Date: Sun, 2 Aug 2020 16:31:34 +0200 Subject: =?UTF-8?q?Refactor=20argument=20parsing=20=F0=9F=94=AC?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- src/syntax/decoration.rs | 41 +++++++ src/syntax/expr.rs | 242 ++++++++++--------------------------- src/syntax/func/keys.rs | 169 -------------------------- src/syntax/func/maps.rs | 233 ----------------------------------- src/syntax/func/mod.rs | 107 ---------------- src/syntax/func/values.rs | 301 ---------------------------------------------- src/syntax/mod.rs | 181 +--------------------------- src/syntax/model.rs | 134 +++++++++++++++++++++ src/syntax/parsing.rs | 100 ++++++++++++--- src/syntax/scope.rs | 2 +- src/syntax/span.rs | 2 +- src/syntax/test.rs | 65 +++++++--- src/syntax/tokens.rs | 3 +- src/syntax/value.rs | 193 +++++++++++++++++++++++++++++ 14 files changed, 571 insertions(+), 1202 deletions(-) create mode 100644 src/syntax/decoration.rs delete mode 100644 src/syntax/func/keys.rs delete mode 100644 src/syntax/func/maps.rs delete mode 100644 src/syntax/func/mod.rs delete mode 100644 src/syntax/func/values.rs create mode 100644 src/syntax/model.rs create mode 100644 src/syntax/value.rs (limited to 'src/syntax') diff --git a/src/syntax/decoration.rs b/src/syntax/decoration.rs new file mode 100644 index 00000000..ab327237 --- /dev/null +++ b/src/syntax/decoration.rs @@ -0,0 +1,41 @@ +//! Decorations for semantic syntax highlighting. + +use serde::Serialize; +use super::span::SpanVec; + +/// A list of spanned decorations. +pub type Decorations = SpanVec; + +/// Decorations for semantic syntax highlighting. +#[derive(Debug, Copy, Clone, Eq, PartialEq, Hash, Serialize)] +#[serde(rename_all = "camelCase")] +pub enum Decoration { + /// A valid function name. + /// ```typst + /// [box] + /// ^^^ + /// ``` + ValidFuncName, + /// An invalid function name. + /// ```typst + /// [blabla] + /// ^^^^^^ + /// ``` + InvalidFuncName, + /// A key of a keyword argument. + /// ```typst + /// [box: width=5cm] + /// ^^^^^ + /// ``` + ArgumentKey, + /// A key in an object. + /// ```typst + /// [box: padding={ left: 1cm, right: 2cm}] + /// ^^^^ ^^^^^ + /// ``` + ObjectKey, + /// An italic word. + Italic, + /// A bold word. + Bold, +} diff --git a/src/syntax/expr.rs b/src/syntax/expr.rs index 51daf304..a551c2b6 100644 --- a/src/syntax/expr.rs +++ b/src/syntax/expr.rs @@ -1,16 +1,15 @@ //! Expressions in function headers. use std::fmt::{self, Debug, Formatter}; -use std::iter::FromIterator; use std::ops::Deref; use std::str::FromStr; use std::u8; -use crate::diagnostic::Diagnostics; +use crate::Feedback; use crate::length::Length; -use super::func::{Key, Value}; -use super::span::{Span, Spanned}; +use super::span::Spanned; use super::tokens::is_identifier; +use super::value::Value; /// An argument or return value. #[derive(Clone, PartialEq)] @@ -238,103 +237,63 @@ impl fmt::Display for ParseColorError { /// (false, 12cm, "hi") /// ``` #[derive(Default, Clone, PartialEq)] -pub struct Tuple { - /// The elements of the tuple. - pub items: Vec>, -} +pub struct Tuple(pub Vec>); impl Tuple { /// Create an empty tuple. pub fn new() -> Tuple { - Tuple { items: vec![] } + Tuple(vec![]) } /// Add an element. - pub fn add(&mut self, item: Spanned) { - self.items.push(item); + pub fn push(&mut self, item: Spanned) { + self.0.push(item); } - /// Extract (and remove) the first matching value and remove and generate - /// diagnostics for all previous items that did not match. - pub fn get(&mut self, diagnostics: &mut Diagnostics) -> Option { - while !self.items.is_empty() { - let expr = self.items.remove(0); - let span = expr.span; - match V::parse(expr) { - Ok(output) => return Some(output), - Err(v) => diagnostics.push(Spanned { v, span }), + /// Expect a specific value type and generate errors for every argument + /// until an argument of the value type is found. + pub fn expect(&mut self, f: &mut Feedback) -> Option { + while !self.0.is_empty() { + let item = self.0.remove(0); + if let Some(val) = V::parse(item, f) { + return Some(val); } } None } - /// Extract (and remove) the first matching value without removing and - /// generating diagnostics for all previous items that did not match. - pub fn get_first(&mut self, _: &mut Diagnostics) -> Option { - let mut i = 0; - while i < self.items.len() { - let expr = self.items[i].clone(); - match V::parse(expr) { - Ok(output) => { - self.items.remove(i); - return Some(output) - } - Err(_) => {}, + /// Extract the first argument of the value type if there is any. + pub fn get(&mut self) -> Option { + for (i, item) in self.0.iter().enumerate() { + if let Some(val) = V::parse(item.clone(), &mut Feedback::new()) { + self.0.remove(i); + return Some(val); } - i += 1; } - None } - /// Extract and return an iterator over all values that match and generate - /// diagnostics for all items that do not match. - pub fn get_all<'a, V: Value>(&'a mut self, diagnostics: &'a mut Diagnostics) - -> impl Iterator + 'a { - self.items.drain(..).filter_map(move |expr| { - let span = expr.span; - match V::parse(expr) { - Ok(output) => Some(output), - Err(v) => { diagnostics.push(Spanned { v, span }); None } + /// Extract all arguments of the value type. + pub fn all<'a, V: Value>(&'a mut self) -> impl Iterator + 'a { + let mut i = 0; + std::iter::from_fn(move || { + while i < self.0.len() { + let val = V::parse(self.0[i].clone(), &mut Feedback::new()); + if val.is_some() { + self.0.remove(i); + return val; + } else { + i += 1; + } } + None }) } - - /// Iterate over the items of this tuple. - pub fn iter<'a>(&'a self) -> std::slice::Iter<'a, Spanned> { - self.items.iter() - } -} - -impl IntoIterator for Tuple { - type Item = Spanned; - type IntoIter = std::vec::IntoIter>; - - fn into_iter(self) -> Self::IntoIter { - self.items.into_iter() - } -} - -impl<'a> IntoIterator for &'a Tuple { - type Item = &'a Spanned; - type IntoIter = std::slice::Iter<'a, Spanned>; - - fn into_iter(self) -> Self::IntoIter { - self.iter() - } -} - -impl FromIterator> for Tuple { - fn from_iter>>(iter: I) -> Self { - Tuple { items: iter.into_iter().collect() } - } } impl Debug for Tuple { fn fmt(&self, f: &mut Formatter) -> fmt::Result { - f.debug_list() - .entries(&self.items) - .finish() + f.debug_list().entries(&self.0).finish() } } @@ -374,10 +333,7 @@ impl Deref for NamedTuple { /// { fit: false, width: 12cm, items: (1, 2, 3) } /// ``` #[derive(Default, Clone, PartialEq)] -pub struct Object { - /// The key-value pairs of the object. - pub pairs: Vec>, -} +pub struct Object(pub Vec>); /// A key-value pair in an object. #[derive(Debug, Clone, PartialEq)] @@ -399,126 +355,52 @@ pub struct Pair { impl Object { /// Create an empty object. pub fn new() -> Object { - Object { pairs: vec![] } + Object(vec![]) } /// Add a pair to object. - pub fn add(&mut self, pair: Spanned) { - self.pairs.push(pair); - } - - /// Extract (and remove) a pair with the given key string and matching - /// value. - /// - /// Inserts an error if the value does not match. If the key is not - /// contained, no error is inserted. - pub fn get(&mut self, diagnostics: &mut Diagnostics, key: &str) -> Option { - let index = self.pairs.iter().position(|pair| pair.v.key.v.as_str() == key)?; - self.get_index::(diagnostics, index) + pub fn push(&mut self, pair: Spanned) { + self.0.push(pair); } - /// Extract (and remove) a pair with a matching key and value. + /// Extract an argument with the given key if there is any. /// - /// Inserts an error if the value does not match. If no matching key is - /// found, no error is inserted. - pub fn get_with_key( - &mut self, - diagnostics: &mut Diagnostics, - ) -> Option<(K, V)> { - for (index, pair) in self.pairs.iter().enumerate() { - let key = Spanned { v: pair.v.key.v.as_str(), span: pair.v.key.span }; - if let Some(key) = K::parse(key) { - return self.get_index::(diagnostics, index).map(|value| (key, value)); + /// Generates an error if there is a matching key, but the value is of the + /// wrong type. + pub fn get(&mut self, key: &str, f: &mut Feedback) -> Option { + for (i, pair) in self.0.iter().enumerate() { + if pair.v.key.v.as_str() == key { + let pair = self.0.remove(i); + return V::parse(pair.v.value, f); } } None } - /// Extract (and remove) all pairs with matching keys and values. - /// - /// Inserts errors for values that do not match. - pub fn get_all<'a, K: Key, V: Value>( - &'a mut self, - diagnostics: &'a mut Diagnostics, - ) -> impl Iterator + 'a { - let mut index = 0; + /// Extract all key-value pairs where the value is of the given type. + pub fn all<'a, V: Value>(&'a mut self) + -> impl Iterator, V)> + 'a + { + let mut i = 0; std::iter::from_fn(move || { - if index < self.pairs.len() { - let key = &self.pairs[index].v.key; - let key = Spanned { v: key.v.as_str(), span: key.span }; - - Some(if let Some(key) = K::parse(key) { - self.get_index::(diagnostics, index).map(|v| (key, v)) - } else { - index += 1; - None - }) - } else { - None + while i < self.0.len() { + let val = V::parse(self.0[i].v.value.clone(), &mut Feedback::new()); + if let Some(val) = val { + let pair = self.0.remove(i); + return Some((pair.v.key, val)); + } else { + i += 1; + } } - }).filter_map(|x| x) - } - - /// Extract all key value pairs with span information. - /// - /// The spans are over both key and value, like so: - /// ```typst - /// { key: value } - /// ^^^^^^^^^^ - /// ``` - pub fn get_all_spanned<'a, K: Key + 'a, V: Value + 'a>( - &'a mut self, - diagnostics: &'a mut Diagnostics, - ) -> impl Iterator> + 'a { - self.get_all::, Spanned>(diagnostics) - .map(|(k, v)| Spanned::new((k.v, v.v), Span::merge(k.span, v.span))) - } - - /// Extract the argument at the given index and insert an error if the value - /// does not match. - fn get_index(&mut self, diagnostics: &mut Diagnostics, index: usize) -> Option { - let expr = self.pairs.remove(index).v.value; - let span = expr.span; - match V::parse(expr) { - Ok(output) => Some(output), - Err(v) => { diagnostics.push(Spanned { v, span }); None } - } - } - - /// Iterate over the pairs of this object. - pub fn iter<'a>(&'a self) -> std::slice::Iter<'a, Spanned> { - self.pairs.iter() - } -} - -impl IntoIterator for Object { - type Item = Spanned; - type IntoIter = std::vec::IntoIter>; - - fn into_iter(self) -> Self::IntoIter { - self.pairs.into_iter() - } -} - -impl<'a> IntoIterator for &'a Object { - type Item = &'a Spanned; - type IntoIter = std::slice::Iter<'a, Spanned>; - - fn into_iter(self) -> Self::IntoIter { - self.iter() - } -} - -impl FromIterator> for Object { - fn from_iter>>(iter: I) -> Self { - Object { pairs: iter.into_iter().collect() } + None + }) } } impl Debug for Object { fn fmt(&self, f: &mut Formatter) -> fmt::Result { f.debug_map() - .entries(self.pairs.iter().map(|p| (&p.v.key.v, &p.v.value.v))) + .entries(self.0.iter().map(|p| (&p.v.key.v, &p.v.value.v))) .finish() } } diff --git a/src/syntax/func/keys.rs b/src/syntax/func/keys.rs deleted file mode 100644 index 558667dd..00000000 --- a/src/syntax/func/keys.rs +++ /dev/null @@ -1,169 +0,0 @@ -//! Key types for identifying keyword arguments. - -use crate::layout::prelude::*; -use super::values::AlignmentValue::{self, *}; -use super::*; - -use self::AxisKey::*; -use self::PaddingKey::*; - -/// Key types are used to extract keyword arguments from -/// [`Objects`](crate::syntax::expr::Object). They represent the key part of a -/// keyword argument. -/// ```typst -/// [func: key=value] -/// ^^^ -/// ``` -/// -/// # Example implementation -/// An implementation for the `AxisKey` that identifies layouting axes might -/// look as follows: -/// ``` -/// # use typstc::syntax::func::Key; -/// # use typstc::syntax::span::Spanned; -/// # #[derive(Eq, PartialEq)] enum Axis { Horizontal, Vertical, Primary, Secondary } -/// # #[derive(Eq, PartialEq)] enum AxisKey { Specific(Axis), Generic(Axis) } -/// # use Axis::*; -/// # use AxisKey::*; -/// impl Key for AxisKey { -/// fn parse(key: Spanned<&str>) -> Option { -/// match key.v { -/// "horizontal" | "h" => Some(Specific(Horizontal)), -/// "vertical" | "v" => Some(Specific(Vertical)), -/// "primary" | "p" => Some(Generic(Primary)), -/// "secondary" | "s" => Some(Generic(Secondary)), -/// _ => None, -/// } -/// } -/// } -/// ``` -pub trait Key: Sized + Eq { - /// Parse a key string into this type if it is valid for it. - fn parse(key: Spanned<&str>) -> Option; -} - -impl Key for String { - fn parse(key: Spanned<&str>) -> Option { - Some(key.v.to_string()) - } -} - -impl Key for Spanned { - fn parse(key: Spanned<&str>) -> Option { - K::parse(key).map(|v| Spanned { v, span: key.span }) - } -} - -/// Implements [`Key`] for types that just need to match on strings. -macro_rules! key { - ($type:ty, $($($p:pat)|* => $r:expr),* $(,)?) => { - impl Key for $type { - fn parse(key: Spanned<&str>) -> Option { - match key.v { - $($($p)|* => Some($r)),*, - _ => None, - } - } - } - }; -} - -/// A key which identifies a layouting axis. -#[derive(Debug, Copy, Clone, Eq, PartialEq, Hash)] -#[allow(missing_docs)] -pub enum AxisKey { - Generic(GenericAxis), - Specific(SpecificAxis), -} - -impl AxisKey { - /// The generic version of this axis key in the given system of axes. - pub fn to_generic(self, axes: LayoutAxes) -> GenericAxis { - match self { - Generic(axis) => axis, - Specific(axis) => axis.to_generic(axes), - } - } - - /// The specific version of this axis key in the given system of axes. - pub fn to_specific(self, axes: LayoutAxes) -> SpecificAxis { - match self { - Generic(axis) => axis.to_specific(axes), - Specific(axis) => axis, - } - } -} - -key!(AxisKey, - "horizontal" | "h" => Specific(Horizontal), - "vertical" | "v" => Specific(Vertical), - "primary" | "p" => Generic(Primary), - "secondary" | "s" => Generic(Secondary), -); - -/// A key which is equivalent to a [`AxisKey`] but uses typical extent keywords -/// instead of axis keywords, e.g. `width` instead of `horizontal`. -#[derive(Debug, Copy, Clone, Eq, PartialEq, Hash)] -pub struct ExtentKey(pub AxisKey); - -key!(ExtentKey, - "width" | "w" => ExtentKey(Specific(Horizontal)), - "height" | "h" => ExtentKey(Specific(Vertical)), - "primary-size" | "ps" => ExtentKey(Generic(Primary)), - "secondary-size" | "ss" => ExtentKey(Generic(Secondary)), -); - -impl From for AxisKey { - fn from(key: ExtentKey) -> AxisKey { - key.0 - } -} - -/// A key which identifies an axis, but alternatively allows for two positional -/// arguments with unspecified axes. -/// -/// This type does not implement `Key` in itself since it cannot be parsed from -/// a string. Rather, [`AxisKeys`](AxisKey) and positional arguments should be -/// parsed separately and mapped onto this key, as happening in the -/// [`PosAxisMap`](super::maps::PosAxisMap). -#[derive(Debug, Copy, Clone, Eq, PartialEq, Hash)] -pub enum PosAxisKey { - /// The first positional argument. - First, - /// The second positional argument. - Second, - /// An axis keyword argument. - Keyword(AxisKey), -} - -/// An argument key which identifies a margin or padding target. -#[derive(Debug, Copy, Clone, Eq, PartialEq, Hash)] -pub enum PaddingKey { - /// All four sides should have the specified padding. - All, - /// Both sides of the given axis should have the specified padding. - Both(Axis), - /// Only the given side of the given axis should have the specified padding. - Side(Axis, AlignmentValue), -} - -key!(PaddingKey, - "horizontal" | "h" => Both(Specific(Horizontal)), - "vertical" | "v" => Both(Specific(Vertical)), - "primary" | "p" => Both(Generic(Primary)), - "secondary" | "s" => Both(Generic(Secondary)), - - "left" => Side(Specific(Horizontal), Left), - "right" => Side(Specific(Horizontal), Right), - "top" => Side(Specific(Vertical), Top), - "bottom" => Side(Specific(Vertical), Bottom), - - "primary-origin" => Side(Generic(Primary), Align(Origin)), - "primary-end" => Side(Generic(Primary), Align(End)), - "secondary-origin" => Side(Generic(Secondary), Align(Origin)), - "secondary-end" => Side(Generic(Secondary), Align(End)), - "horizontal-origin" => Side(Specific(Horizontal), Align(Origin)), - "horizontal-end" => Side(Specific(Horizontal), Align(End)), - "vertical-origin" => Side(Specific(Vertical), Align(Origin)), - "vertical-end" => Side(Specific(Vertical), Align(End)), -); diff --git a/src/syntax/func/maps.rs b/src/syntax/func/maps.rs deleted file mode 100644 index bc290a9e..00000000 --- a/src/syntax/func/maps.rs +++ /dev/null @@ -1,233 +0,0 @@ -//! Deduplicating maps and keys for argument parsing. - -use crate::diagnostic::Diagnostics; -use crate::geom::Value4; -use crate::layout::prelude::*; -use crate::length::ScaleLength; -use crate::syntax::span::Spanned; -use super::keys::*; -use super::values::*; -use super::*; - -/// A map which deduplicates redundant arguments. -/// -/// Whenever a duplicate argument is inserted into the map, through the -/// functions `from_iter`, `insert` or `extend` an diagnostics is added to the error -/// list that needs to be passed to those functions. -/// -/// All entries need to have span information to enable the error reporting. -#[derive(Debug, Default, Clone, Eq, PartialEq)] -pub struct DedupMap where K: Eq { - map: Vec>, -} - -impl DedupMap where K: Eq { - /// Create a new deduplicating map. - pub fn new() -> DedupMap { - DedupMap { map: vec![] } - } - - /// Create a new map from an iterator of spanned keys and values. - pub fn from_iter(diagnostics: &mut Diagnostics, iter: I) -> DedupMap - where I: IntoIterator> { - let mut map = DedupMap::new(); - map.extend(diagnostics, iter); - map - } - - /// Add a spanned key-value pair. - pub fn insert(&mut self, diagnostics: &mut Diagnostics, entry: Spanned<(K, V)>) { - if self.map.iter().any(|e| e.v.0 == entry.v.0) { - diagnostics.push(error!(entry.span, "duplicate argument")); - } else { - self.map.push(entry); - } - } - - /// Add multiple spanned key-value pairs. - pub fn extend(&mut self, diagnostics: &mut Diagnostics, items: I) - where I: IntoIterator> { - for item in items.into_iter() { - self.insert(diagnostics, item); - } - } - - /// Get the value corresponding to a key if it is present. - pub fn get(&self, key: K) -> Option<&V> { - self.map.iter().find(|e| e.v.0 == key).map(|e| &e.v.1) - } - - /// Get the value and its span corresponding to a key if it is present. - pub fn get_spanned(&self, key: K) -> Option> { - self.map.iter().find(|e| e.v.0 == key) - .map(|e| Spanned { v: &e.v.1, span: e.span }) - } - - /// Call a function with the value if the key is present. - pub fn with(&self, key: K, callback: F) where F: FnOnce(&V) { - if let Some(value) = self.get(key) { - callback(value); - } - } - - /// Create a new map where keys and values are mapped to new keys and - /// values. When the mapping introduces new duplicates, diagnostics are - /// generated. - pub fn dedup(&self, diagnostics: &mut Diagnostics, mut f: F) -> DedupMap - where F: FnMut(&K, &V) -> (K2, V2), K2: Eq { - let mut map = DedupMap::new(); - - for Spanned { v: (key, value), span } in self.map.iter() { - let (key, value) = f(key, value); - map.insert(diagnostics, Spanned { v: (key, value), span: *span }); - } - - map - } - - /// Iterate over the (key, value) pairs. - pub fn iter(&self) -> impl Iterator { - self.map.iter().map(|e| &e.v) - } -} - -/// A map for storing a value for axes given by keyword arguments. -#[derive(Debug, Clone, PartialEq)] -pub struct AxisMap(DedupMap); - -impl AxisMap { - /// Parse an axis map from the object. - pub fn parse( - diagnostics: &mut Diagnostics, - object: &mut Object, - ) -> AxisMap where K: Key + Into { - let values: Vec<_> = object - .get_all_spanned::(diagnostics) - .map(|s| s.map(|(k, v)| (k.into(), v))) - .collect(); - - AxisMap(DedupMap::from_iter(diagnostics, values)) - } - - /// Deduplicate from specific or generic to just specific axes. - pub fn dedup(&self, diagnostics: &mut Diagnostics, axes: LayoutAxes) -> DedupMap - where V: Clone { - self.0.dedup(diagnostics, |key, val| (key.to_specific(axes), val.clone())) - } -} - -/// A map for storing values for axes that are given through a combination of -/// (two) positional and keyword arguments. -#[derive(Debug, Clone, PartialEq)] -pub struct PosAxisMap(DedupMap); - -impl PosAxisMap { - /// Parse a positional/axis map from the function arguments. - pub fn parse( - diagnostics: &mut Diagnostics, - args: &mut FuncArgs, - ) -> PosAxisMap where K: Key + Into { - let mut map = DedupMap::new(); - - for &key in &[PosAxisKey::First, PosAxisKey::Second] { - if let Some(Spanned { v, span }) = args.pos.get::>(diagnostics) { - map.insert(diagnostics, Spanned { v: (key, v), span }) - } - } - - let keywords: Vec<_> = args.key - .get_all_spanned::(diagnostics) - .map(|s| s.map(|(k, v)| (PosAxisKey::Keyword(k.into()), v))) - .collect(); - - map.extend(diagnostics, keywords); - - PosAxisMap(map) - } - - /// Deduplicate from positional arguments and keyword arguments for generic - /// or specific axes to just generic axes. - pub fn dedup( - &self, - diagnostics: &mut Diagnostics, - axes: LayoutAxes, - mut f: F, - ) -> DedupMap - where - F: FnMut(&V) -> Option, - V: Clone, - { - self.0.dedup(diagnostics, |key, val| { - (match key { - PosAxisKey::First => f(val).unwrap_or(GenericAxis::Primary), - PosAxisKey::Second => f(val).unwrap_or(GenericAxis::Secondary), - PosAxisKey::Keyword(AxisKey::Specific(axis)) => axis.to_generic(axes), - PosAxisKey::Keyword(AxisKey::Generic(axis)) => *axis, - }, val.clone()) - }) - } -} - -/// A map for storing padding given for a combination of all sides, opposing -/// sides or single sides. -#[derive(Debug, Clone, PartialEq)] -pub struct PaddingMap(DedupMap, Option>); - -impl PaddingMap { - /// Parse a padding map from the function arguments. - pub fn parse(diagnostics: &mut Diagnostics, args: &mut FuncArgs) -> PaddingMap { - let mut map = DedupMap::new(); - - let all = args.key.get::>>(diagnostics, "margins"); - if let Some(Spanned { v, span }) = all { - map.insert(diagnostics, Spanned { v: (PaddingKey::All, v.into()), span }); - } - - let paddings: Vec<_> = args.key - .get_all_spanned::, Defaultable>(diagnostics) - .map(|s| s.map(|(k, v)| (k, v.into()))) - .collect(); - - map.extend(diagnostics, paddings); - - PaddingMap(map) - } - - /// Apply the specified padding on a value box of optional, scalable sizes. - pub fn apply( - &self, - diagnostics: &mut Diagnostics, - axes: LayoutAxes, - padding: &mut Value4> - ) { - use PaddingKey::*; - - let map = self.0.dedup(diagnostics, |key, &val| { - (match key { - All => All, - Both(axis) => Both(axis.to_specific(axes)), - Side(axis, alignment) => { - let generic = axis.to_generic(axes); - let axis = axis.to_specific(axes); - Side(axis, alignment.to_specific(axes, generic)) - } - }, val) - }); - - map.with(All, |&val| padding.set_all(val)); - map.with(Both(Horizontal), |&val| padding.set_horizontal(val)); - map.with(Both(Vertical), |&val| padding.set_vertical(val)); - - for &(key, val) in map.iter() { - if let Side(_, alignment) = key { - match alignment { - AlignmentValue::Left => padding.left = val, - AlignmentValue::Right => padding.right = val, - AlignmentValue::Top => padding.top = val, - AlignmentValue::Bottom => padding.bottom = val, - _ => {}, - } - } - } - } -} diff --git a/src/syntax/func/mod.rs b/src/syntax/func/mod.rs deleted file mode 100644 index 37dccc3d..00000000 --- a/src/syntax/func/mod.rs +++ /dev/null @@ -1,107 +0,0 @@ -//! Primitives for argument parsing in library functions. - -use std::iter::FromIterator; -use crate::diagnostic::{Diagnostic, Diagnostics}; -use super::expr::{Expr, Ident, Tuple, Object, Pair}; -use super::span::{Span, Spanned}; - -pub_use_mod!(maps); -pub_use_mod!(keys); -pub_use_mod!(values); - -/// An invocation of a function. -#[derive(Debug, Clone, PartialEq)] -pub struct FuncCall<'s> { - pub header: FuncHeader, - /// The body as a raw string containing what's inside of the brackets. - pub body: Option>, -} - -/// The parsed header of a function (everything in the first set of brackets). -#[derive(Debug, Clone, PartialEq)] -pub struct FuncHeader { - pub name: Spanned, - pub args: FuncArgs, -} - -/// The positional and keyword arguments passed to a function. -#[derive(Debug, Default, Clone, PartialEq)] -pub struct FuncArgs { - /// The positional arguments. - pub pos: Tuple, - /// They keyword arguments. - pub key: Object, -} - -impl FuncArgs { - /// Create new empty function arguments. - pub fn new() -> FuncArgs { - FuncArgs { - pos: Tuple::new(), - key: Object::new(), - } - } - - /// Add an argument. - pub fn add(&mut self, arg: Spanned) { - match arg.v { - FuncArg::Pos(item) => self.pos.add(Spanned::new(item, arg.span)), - FuncArg::Key(pair) => self.key.add(Spanned::new(pair, arg.span)), - } - } - - /// Iterate over all arguments. - pub fn into_iter(self) -> impl Iterator> { - let pos = self.pos.items.into_iter() - .map(|spanned| spanned.map(|item| FuncArg::Pos(item))); - - let key = self.key.pairs.into_iter() - .map(|spanned| spanned.map(|pair| FuncArg::Key(pair))); - - pos.chain(key) - } -} - -impl FromIterator> for FuncArgs { - fn from_iter>>(iter: I) -> Self { - let mut args = FuncArgs::new(); - for item in iter.into_iter() { - args.add(item); - } - args - } -} - -/// Either a positional or keyword argument. -#[derive(Debug, Clone, PartialEq)] -pub enum FuncArg { - /// A positional argument. - Pos(Expr), - /// A keyword argument. - Key(Pair), -} - -/// Extra methods on [`Options`](Option) used for argument parsing. -pub trait OptionExt: Sized { - /// Calls `f` with `val` if this is `Some(val)`. - fn with(self, f: impl FnOnce(T)); - - /// Add an error about a missing argument `arg` with the given span if the - /// option is `None`. - fn or_missing(self, diagnostics: &mut Diagnostics, span: Span, arg: &str) -> Self; -} - -impl OptionExt for Option { - fn with(self, f: impl FnOnce(T)) { - if let Some(val) = self { - f(val); - } - } - - fn or_missing(self, diagnostics: &mut Diagnostics, span: Span, arg: &str) -> Self { - if self.is_none() { - diagnostics.push(error!(span, "missing argument: {}", arg)); - } - self - } -} diff --git a/src/syntax/func/values.rs b/src/syntax/func/values.rs deleted file mode 100644 index d5e9c6e8..00000000 --- a/src/syntax/func/values.rs +++ /dev/null @@ -1,301 +0,0 @@ -//! Value types for extracting function arguments. - -use std::fmt::{self, Display, Formatter}; -use fontdock::{FontStyle, FontWeight, FontWidth}; - -use crate::layout::prelude::*; -use crate::length::{Length, ScaleLength}; -use crate::paper::Paper; -use super::*; - -use self::AlignmentValue::*; - -/// Value types are used to extract the values of positional and keyword -/// arguments from [`Tuples`](crate::syntax::expr::Tuple) and -/// [`Objects`](crate::syntax::expr::Object). They represent the value part of -/// an argument. -/// ```typst -/// [func: value, key=value] -/// ^^^^^ ^^^^^ -/// ``` -/// -/// # Example implementation -/// An implementation for `bool` might look as follows: -/// ``` -/// # use typstc::error; -/// # use typstc::diagnostic::Diagnostic; -/// # use typstc::syntax::expr::Expr; -/// # use typstc::syntax::func::Value; -/// # use typstc::syntax::span::Spanned; -/// # struct Bool; /* -/// impl Value for bool { -/// # */ impl Value for Bool { -/// fn parse(expr: Spanned) -> Result { -/// match expr.v { -/// # /* -/// Expr::Bool(b) => Ok(b), -/// # */ Expr::Bool(_) => Ok(Bool), -/// other => Err(error!("expected bool, found {}", other.name())), -/// } -/// } -/// } -/// ``` -pub trait Value: Sized { - /// Parse an expression into this value or return an error if the expression - /// is valid for this value type. - fn parse(expr: Spanned) -> Result; -} - -impl Value for Spanned { - fn parse(expr: Spanned) -> Result { - let span = expr.span; - V::parse(expr).map(|v| Spanned { v, span }) - } -} - -/// Implements [`Value`] for types that just need to match on expressions. -macro_rules! value { - ($type:ty, $name:expr, $($p:pat => $r:expr),* $(,)?) => { - impl Value for $type { - fn parse(expr: Spanned) -> Result { - #[allow(unreachable_patterns)] - match expr.v { - $($p => Ok($r)),*, - other => Err( - error!("expected {}, found {}", $name, other.name()) - ), - } - } - } - }; -} - -value!(Expr, "expression", e => e); - -value!(Ident, "identifier", Expr::Ident(i) => i); -value!(String, "string", Expr::Str(s) => s); -value!(f64, "number", Expr::Number(n) => n); -value!(bool, "bool", Expr::Bool(b) => b); -value!(Length, "length", Expr::Length(l) => l); -value!(Tuple, "tuple", Expr::Tuple(t) => t); -value!(Object, "object", Expr::Object(o) => o); - -value!(ScaleLength, "number or length", - Expr::Length(length) => ScaleLength::Absolute(length), - Expr::Number(scale) => ScaleLength::Scaled(scale), -); - -/// A value type that matches [`Expr::Ident`] and [`Expr::Str`] and implements -/// `Into`. -pub struct StringLike(pub String); - -value!(StringLike, "identifier or string", - Expr::Ident(Ident(s)) => StringLike(s), - Expr::Str(s) => StringLike(s), -); - -impl From for String { - fn from(like: StringLike) -> String { - like.0 - } -} - -/// A value type that matches the identifier `default` or a value type `V` and -/// implements `Into