| 1 | use super::{
|
| 2 | Align, BarcodeMode, BarcodeSymbology, Block, Document, ImageWidth, Inline, ParseError, QrEcc,
|
| 3 | QrMode,
|
| 4 | };
|
| 5 |
|
| 6 | pub fn parse(source: &str) -> Result<Document, ParseError> {
|
| 7 | let source = strip_comments(source);
|
| 8 | let mut blocks = Vec::new();
|
| 9 | let mut lines = source.lines().peekable();
|
| 10 | let mut line_no = 0usize;
|
| 11 | let mut current_align = Align::Left;
|
| 12 |
|
| 13 | while let Some(raw_line) = lines.next() {
|
| 14 | line_no += 1;
|
| 15 | let line = raw_line.trim_end();
|
| 16 |
|
| 17 | let (content, align_for_block) = match parse_align_line(line) {
|
| 18 | Some((align, None)) => {
|
| 19 | current_align = align;
|
| 20 | continue;
|
| 21 | }
|
| 22 | Some((align, Some(rest))) => {
|
| 23 | current_align = align;
|
| 24 | (rest, current_align)
|
| 25 | }
|
| 26 | None => (line, current_align),
|
| 27 | };
|
| 28 |
|
| 29 | if is_blank_feed_line(content) {
|
| 30 | blocks.push(Block::Feed(1));
|
| 31 | continue;
|
| 32 | }
|
| 33 |
|
| 34 | let segments = split_aligned_segments(content, align_for_block);
|
| 35 | if segments.is_empty() {
|
| 36 | continue;
|
| 37 | }
|
| 38 |
|
| 39 | for (idx, (seg_align, seg_text)) in segments.iter().enumerate() {
|
| 40 | current_align = *seg_align;
|
| 41 | let allow_multiline_paragraph = segments.len() == 1 && idx == segments.len() - 1;
|
| 42 |
|
| 43 | if is_blank_feed_line(seg_text) {
|
| 44 | blocks.push(Block::Feed(1));
|
| 45 | continue;
|
| 46 | }
|
| 47 |
|
| 48 | if seg_text.starts_with('#') {
|
| 49 | blocks.push(parse_heading(seg_text, line_no, *seg_align)?);
|
| 50 | continue;
|
| 51 | }
|
| 52 |
|
| 53 | if seg_text.trim() == "---" {
|
| 54 | blocks.push(Block::Rule);
|
| 55 | continue;
|
| 56 | }
|
| 57 |
|
| 58 | if seg_text.trim_start().starts_with("@") {
|
| 59 | blocks.push(parse_directive(seg_text.trim(), line_no, *seg_align)?);
|
| 60 | continue;
|
| 61 | }
|
| 62 |
|
| 63 | if is_list_item_line(seg_text) {
|
| 64 | let mut items = vec![parse_list_item_inlines(seg_text, line_no)?];
|
| 65 | while let Some(&next) = lines.peek() {
|
| 66 | if is_blank_feed_line(next)
|
| 67 | || next.starts_with('#')
|
| 68 | || next.trim() == "---"
|
| 69 | || next.trim_start().starts_with('@')
|
| 70 | || parse_align_line(next).is_some()
|
| 71 | || !is_list_item_line(next.trim_end())
|
| 72 | {
|
| 73 | break;
|
| 74 | }
|
| 75 | line_no += 1;
|
| 76 | let next_line = lines.next().unwrap().trim_end();
|
| 77 | items.push(parse_list_item_inlines(next_line, line_no)?);
|
| 78 | }
|
| 79 | blocks.push(Block::List {
|
| 80 | align: *seg_align,
|
| 81 | items,
|
| 82 | });
|
| 83 | continue;
|
| 84 | }
|
| 85 |
|
| 86 | if allow_multiline_paragraph {
|
| 87 | let mut paragraph_lines = vec![seg_text.clone()];
|
| 88 | while let Some(&next) = lines.peek() {
|
| 89 | if is_blank_feed_line(next)
|
| 90 | || next.starts_with('#')
|
| 91 | || next.trim() == "---"
|
| 92 | || next.trim_start().starts_with('@')
|
| 93 | || parse_align_line(next).is_some()
|
| 94 | || is_list_item_line(next.trim_end())
|
| 95 | {
|
| 96 | break;
|
| 97 | }
|
| 98 | line_no += 1;
|
| 99 | lines.next();
|
| 100 | paragraph_lines.push(next.trim_end().to_string());
|
| 101 | }
|
| 102 | let text = paragraph_lines.join("\n");
|
| 103 | blocks.push(Block::Paragraph {
|
| 104 | align: *seg_align,
|
| 105 | inlines: parse_inlines(&text, line_no, 1)?,
|
| 106 | });
|
| 107 | } else {
|
| 108 | blocks.push(Block::Paragraph {
|
| 109 | align: *seg_align,
|
| 110 | inlines: parse_inlines(seg_text, line_no, 1)?,
|
| 111 | });
|
| 112 | }
|
| 113 | }
|
| 114 | }
|
| 115 |
|
| 116 | Ok(Document { blocks })
|
| 117 | }
|
| 118 |
|
| 119 | /// True when the last substantive block is `@cut` (trailing blank-line feeds are ignored).
|
| 120 | pub fn document_ends_with_cut(document: &Document) -> bool {
|
| 121 | for block in document.blocks.iter().rev() {
|
| 122 | match block {
|
| 123 | Block::Feed(_) => continue,
|
| 124 | Block::Cut => return true,
|
| 125 | _ => return false,
|
| 126 | }
|
| 127 | }
|
| 128 | false
|
| 129 | }
|
| 130 |
|
| 131 | fn strip_comments(source: &str) -> String {
|
| 132 | let mut out = String::with_capacity(source.len());
|
| 133 | let mut chars = source.chars().peekable();
|
| 134 | while let Some(ch) = chars.next() {
|
| 135 | if ch == '<' && chars.peek() == Some(&'!') {
|
| 136 | let mut rest: String = chars.clone().collect();
|
| 137 | if rest.starts_with('!') {
|
| 138 | let _ = chars.next();
|
| 139 | rest = chars.clone().collect();
|
| 140 | if rest.starts_with("--") {
|
| 141 | for _ in 0..3 {
|
| 142 | chars.next();
|
| 143 | }
|
| 144 | while let Some(c) = chars.next() {
|
| 145 | if c == '-' && chars.peek() == Some(&'-') {
|
| 146 | chars.next();
|
| 147 | if chars.peek() == Some(&'>') {
|
| 148 | chars.next();
|
| 149 | break;
|
| 150 | }
|
| 151 | }
|
| 152 | }
|
| 153 | continue;
|
| 154 | }
|
| 155 | }
|
| 156 | out.push('<');
|
| 157 | } else {
|
| 158 | out.push(ch);
|
| 159 | }
|
| 160 | }
|
| 161 | out
|
| 162 | }
|
| 163 |
|
| 164 | /// Parse `:left:`, `:center:`, `:centre:`, or `:right:` at line start.
|
| 165 | /// Returns the alignment and optional remaining content on the same line.
|
| 166 | fn parse_align_line(line: &str) -> Option<(Align, Option<&str>)> {
|
| 167 | let trimmed = line.trim_start();
|
| 168 | if let Some(rest) = trimmed.strip_prefix(":left:") {
|
| 169 | let rest = rest.trim_start();
|
| 170 | return Some((
|
| 171 | Align::Left,
|
| 172 | if rest.is_empty() { None } else { Some(rest) },
|
| 173 | ));
|
| 174 | }
|
| 175 | if let Some(rest) = trimmed.strip_prefix(":center:") {
|
| 176 | let rest = rest.trim_start();
|
| 177 | return Some((
|
| 178 | Align::Center,
|
| 179 | if rest.is_empty() { None } else { Some(rest) },
|
| 180 | ));
|
| 181 | }
|
| 182 | if let Some(rest) = trimmed.strip_prefix(":centre:") {
|
| 183 | let rest = rest.trim_start();
|
| 184 | return Some((
|
| 185 | Align::Center,
|
| 186 | if rest.is_empty() { None } else { Some(rest) },
|
| 187 | ));
|
| 188 | }
|
| 189 | if let Some(rest) = trimmed.strip_prefix(":right:") {
|
| 190 | let rest = rest.trim_start();
|
| 191 | return Some((
|
| 192 | Align::Right,
|
| 193 | if rest.is_empty() { None } else { Some(rest) },
|
| 194 | ));
|
| 195 | }
|
| 196 | None
|
| 197 | }
|
| 198 |
|
| 199 | /// Split line content on embedded `:left:`, `:center:`, `:centre:`, or `:right:` markers.
|
| 200 | fn split_aligned_segments(content: &str, start_align: Align) -> Vec<(Align, String)> {
|
| 201 | let mut segments = Vec::new();
|
| 202 | let mut align = start_align;
|
| 203 | let mut rest = content;
|
| 204 |
|
| 205 | while let Some((pos, new_align, marker_len)) = find_next_align_marker(rest) {
|
| 206 | let before = rest[..pos].trim();
|
| 207 | if !before.is_empty() {
|
| 208 | segments.push((align, before.to_string()));
|
| 209 | }
|
| 210 | align = new_align;
|
| 211 | rest = rest[pos + marker_len..].trim_start();
|
| 212 | }
|
| 213 |
|
| 214 | let tail = rest.trim();
|
| 215 | if !tail.is_empty() {
|
| 216 | segments.push((align, tail.to_string()));
|
| 217 | }
|
| 218 | segments
|
| 219 | }
|
| 220 |
|
| 221 | fn find_next_align_marker(s: &str) -> Option<(usize, Align, usize)> {
|
| 222 | const MARKERS: &[(&str, Align)] = &[
|
| 223 | (":left:", Align::Left),
|
| 224 | (":center:", Align::Center),
|
| 225 | (":centre:", Align::Center),
|
| 226 | (":right:", Align::Right),
|
| 227 | ];
|
| 228 |
|
| 229 | let mut best: Option<(usize, Align, usize)> = None;
|
| 230 | for (pat, marker_align) in MARKERS {
|
| 231 | if let Some(pos) = s.find(pat) {
|
| 232 | if best.is_none() || pos < best.unwrap().0 {
|
| 233 | best = Some((pos, *marker_align, pat.len()));
|
| 234 | }
|
| 235 | }
|
| 236 | }
|
| 237 | best
|
| 238 | }
|
| 239 |
|
| 240 | /// True only when a line has no visible content (empty or whitespace-only).
|
| 241 | /// Lines with DSL markers (`:right:`, `@feed`, `#`, etc.) are never feed lines.
|
| 242 | fn is_blank_feed_line(line: &str) -> bool {
|
| 243 | line.chars().all(|c| c.is_whitespace())
|
| 244 | }
|
| 245 |
|
| 246 | fn parse_heading(line: &str, line_no: usize, align: Align) -> Result<Block, ParseError> {
|
| 247 | let mut level = 0u8;
|
| 248 | for ch in line.chars() {
|
| 249 | if ch == '#' {
|
| 250 | level += 1;
|
| 251 | } else {
|
| 252 | break;
|
| 253 | }
|
| 254 | }
|
| 255 | if level == 0 || level > 2 {
|
| 256 | return Err(err(line_no, 1, "heading must use # or ##"));
|
| 257 | }
|
| 258 | let text = line[level as usize..].trim();
|
| 259 | if text.is_empty() {
|
| 260 | return Err(err(line_no, 1, "heading text is empty"));
|
| 261 | }
|
| 262 | Ok(Block::Heading {
|
| 263 | level,
|
| 264 | align,
|
| 265 | inlines: parse_inlines(text, line_no, level as usize + 1)?,
|
| 266 | })
|
| 267 | }
|
| 268 |
|
| 269 | fn parse_directive(line: &str, line_no: usize, default_align: Align) -> Result<Block, ParseError> {
|
| 270 | let body = line
|
| 271 | .trim_start()
|
| 272 | .strip_prefix('@')
|
| 273 | .ok_or_else(|| err(line_no, 1, "expected directive"))?;
|
| 274 | let mut parts = body.split_whitespace();
|
| 275 | let name = parts.next().unwrap_or("").to_ascii_lowercase();
|
| 276 | match name.as_str() {
|
| 277 | "feed" => {
|
| 278 | let n = parts
|
| 279 | .next()
|
| 280 | .ok_or_else(|| err(line_no, 1, "@feed requires line count"))?;
|
| 281 | let lines: u8 = n
|
| 282 | .parse()
|
| 283 | .map_err(|_| err(line_no, 1, "@feed count must be 0-255"))?;
|
| 284 | Ok(Block::Feed(lines))
|
| 285 | }
|
| 286 | "cut" => Ok(Block::Cut),
|
| 287 | "image" => parse_image_directive(parts.collect(), line_no, default_align),
|
| 288 | "barcode" => parse_barcode_directive(parts.collect(), line_no, default_align),
|
| 289 | "qr" => parse_qr_directive(parts.collect(), line_no, default_align),
|
| 290 | "date" => parse_date_directive(parts.collect(), line_no, default_align),
|
| 291 | "time" => parse_time_directive(parts.collect(), line_no, default_align),
|
| 292 | _ => Err(err(line_no, 1, format!("unknown directive @{name}"))),
|
| 293 | }
|
| 294 | }
|
| 295 |
|
| 296 | fn parse_image_directive(
|
| 297 | parts: Vec<&str>,
|
| 298 | line_no: usize,
|
| 299 | default_align: Align,
|
| 300 | ) -> Result<Block, ParseError> {
|
| 301 | if parts.is_empty() {
|
| 302 | return Err(err(line_no, 1, "@image requires a path"));
|
| 303 | }
|
| 304 | let path = parts[0].to_string();
|
| 305 | let mut width = ImageWidth::Default;
|
| 306 | let mut align = default_align;
|
| 307 | for attr in &parts[1..] {
|
| 308 | if let Some((k, v)) = attr.split_once('=') {
|
| 309 | match k.to_ascii_lowercase().as_str() {
|
| 310 | "width" => {
|
| 311 | width = if let Some(p) = v.strip_suffix('%') {
|
| 312 | let pct: u8 = p
|
| 313 | .parse()
|
| 314 | .map_err(|_| err(line_no, 1, "invalid width percent"))?;
|
| 315 | ImageWidth::Percent(pct.min(100))
|
| 316 | } else {
|
| 317 | let dots: u16 = v
|
| 318 | .parse()
|
| 319 | .map_err(|_| err(line_no, 1, "invalid width dots"))?;
|
| 320 | ImageWidth::Dots(dots)
|
| 321 | };
|
| 322 | }
|
| 323 | "align" => align = parse_align_value(v, line_no)?,
|
| 324 | _ => return Err(err(line_no, 1, format!("unknown image attribute {k}"))),
|
| 325 | }
|
| 326 | }
|
| 327 | }
|
| 328 | Ok(Block::Image { path, width, align })
|
| 329 | }
|
| 330 |
|
| 331 | fn parse_barcode_directive(
|
| 332 | parts: Vec<&str>,
|
| 333 | line_no: usize,
|
| 334 | default_align: Align,
|
| 335 | ) -> Result<Block, ParseError> {
|
| 336 | if parts.len() < 2 {
|
| 337 | return Err(err(
|
| 338 | line_no,
|
| 339 | 1,
|
| 340 | "@barcode requires symbology and data (or RASTER symbology data)",
|
| 341 | ));
|
| 342 | }
|
| 343 |
|
| 344 | let (mode, sym_idx, data_idx) = if parts[0].eq_ignore_ascii_case("RASTER") {
|
| 345 | if parts.len() < 3 {
|
| 346 | return Err(err(
|
| 347 | line_no,
|
| 348 | 1,
|
| 349 | "@barcode RASTER requires symbology and data",
|
| 350 | ));
|
| 351 | }
|
| 352 | (BarcodeMode::Raster, 1, 2)
|
| 353 | } else {
|
| 354 | (BarcodeMode::Native, 0, 1)
|
| 355 | };
|
| 356 |
|
| 357 | let symbology = BarcodeSymbology::from_name(parts[sym_idx])
|
| 358 | .ok_or_else(|| err(line_no, 1, format!("unknown barcode symbology {}", parts[sym_idx])))?;
|
| 359 |
|
| 360 | if mode == BarcodeMode::Native && !symbology.supports_native() {
|
| 361 | return Err(err(
|
| 362 | line_no,
|
| 363 | 1,
|
| 364 | format!(
|
| 365 | "{} has no native ESC/POS support; use RASTER {}",
|
| 366 | symbology.as_str(),
|
| 367 | symbology.as_str()
|
| 368 | ),
|
| 369 | ));
|
| 370 | }
|
| 371 |
|
| 372 | let data = parts[data_idx].to_string();
|
| 373 | let attr_start = data_idx + 1;
|
| 374 | let mut height = 64u8;
|
| 375 | let mut align = default_align;
|
| 376 | let mut show_text = true;
|
| 377 | for attr in &parts[attr_start..] {
|
| 378 | if let Some((k, v)) = attr.split_once('=') {
|
| 379 | match k.to_ascii_lowercase().as_str() {
|
| 380 | "height" => {
|
| 381 | height = v
|
| 382 | .parse()
|
| 383 | .map_err(|_| err(line_no, 1, "invalid barcode height"))?;
|
| 384 | }
|
| 385 | "align" => align = parse_align_value(v, line_no)?,
|
| 386 | "show_text" => show_text = v == "true",
|
| 387 | _ => return Err(err(line_no, 1, format!("unknown barcode attribute {k}"))),
|
| 388 | }
|
| 389 | }
|
| 390 | }
|
| 391 | Ok(Block::Barcode {
|
| 392 | mode,
|
| 393 | symbology,
|
| 394 | data,
|
| 395 | height,
|
| 396 | align,
|
| 397 | show_text,
|
| 398 | })
|
| 399 | }
|
| 400 |
|
| 401 | fn parse_date_directive(
|
| 402 | parts: Vec<&str>,
|
| 403 | _line_no: usize,
|
| 404 | default_align: Align,
|
| 405 | ) -> Result<Block, ParseError> {
|
| 406 | let pattern = parts.join(" ");
|
| 407 | let format = if pattern.is_empty() {
|
| 408 | None
|
| 409 | } else {
|
| 410 | Some(pattern)
|
| 411 | };
|
| 412 | Ok(Block::Date {
|
| 413 | format,
|
| 414 | align: default_align,
|
| 415 | })
|
| 416 | }
|
| 417 |
|
| 418 | fn parse_time_directive(
|
| 419 | parts: Vec<&str>,
|
| 420 | line_no: usize,
|
| 421 | default_align: Align,
|
| 422 | ) -> Result<Block, ParseError> {
|
| 423 | use super::TimeFormatSpec;
|
| 424 | let spec = match parts.first().map(|s| s.to_ascii_lowercase()).as_deref() {
|
| 425 | None => TimeFormatSpec::Hours24,
|
| 426 | Some("12h") => TimeFormatSpec::Hours12,
|
| 427 | Some("24h") => TimeFormatSpec::Hours24,
|
| 428 | Some(other) => {
|
| 429 | return Err(err(
|
| 430 | line_no,
|
| 431 | 1,
|
| 432 | format!("unknown @time format '{other}' (use 12h or 24h)"),
|
| 433 | ));
|
| 434 | }
|
| 435 | };
|
| 436 | if parts.len() > 1 {
|
| 437 | return Err(err(
|
| 438 | line_no,
|
| 439 | 1,
|
| 440 | "@time accepts at most one format argument (12h or 24h)",
|
| 441 | ));
|
| 442 | }
|
| 443 | Ok(Block::Time {
|
| 444 | format: spec,
|
| 445 | align: default_align,
|
| 446 | })
|
| 447 | }
|
| 448 |
|
| 449 | fn parse_qr_directive(
|
| 450 | parts: Vec<&str>,
|
| 451 | line_no: usize,
|
| 452 | default_align: Align,
|
| 453 | ) -> Result<Block, ParseError> {
|
| 454 | if parts.is_empty() {
|
| 455 | return Err(err(line_no, 1, "@qr requires data"));
|
| 456 | }
|
| 457 |
|
| 458 | let (mode, data_idx) = if parts[0].eq_ignore_ascii_case("RASTER") {
|
| 459 | if parts.len() < 2 {
|
| 460 | return Err(err(line_no, 1, "@qr RASTER requires data"));
|
| 461 | }
|
| 462 | (QrMode::Raster, 1)
|
| 463 | } else {
|
| 464 | (QrMode::Native, 0)
|
| 465 | };
|
| 466 |
|
| 467 | let data = parts[data_idx].to_string();
|
| 468 | let attr_start = data_idx + 1;
|
| 469 | let mut size = 4u8;
|
| 470 | let mut ecc = QrEcc::M;
|
| 471 | let mut align = default_align;
|
| 472 | let mut version = None;
|
| 473 | for attr in &parts[attr_start..] {
|
| 474 | if let Some((k, v)) = attr.split_once('=') {
|
| 475 | match k.to_ascii_lowercase().as_str() {
|
| 476 | "size" => {
|
| 477 | size = v
|
| 478 | .parse::<u8>()
|
| 479 | .map_err(|_| err(line_no, 1, "invalid qr size"))?
|
| 480 | .clamp(1, 16);
|
| 481 | }
|
| 482 | "scale" => {
|
| 483 | size = v
|
| 484 | .parse::<u8>()
|
| 485 | .map_err(|_| err(line_no, 1, "invalid qr scale"))?
|
| 486 | .clamp(1, 16);
|
| 487 | }
|
| 488 | "version" => {
|
| 489 | let ver: u8 = v
|
| 490 | .parse()
|
| 491 | .map_err(|_| err(line_no, 1, "invalid qr version"))?;
|
| 492 | if !(1..=40).contains(&ver) {
|
| 493 | return Err(err(line_no, 1, "qr version must be 1-40"));
|
| 494 | }
|
| 495 | version = Some(ver);
|
| 496 | }
|
| 497 | "ecc" => {
|
| 498 | ecc = QrEcc::from_name(v)
|
| 499 | .ok_or_else(|| err(line_no, 1, "qr ecc must be L, M, Q, or H"))?;
|
| 500 | }
|
| 501 | "align" => align = parse_align_value(v, line_no)?,
|
| 502 | _ => return Err(err(line_no, 1, format!("unknown qr attribute {k}"))),
|
| 503 | }
|
| 504 | }
|
| 505 | }
|
| 506 | Ok(Block::Qr {
|
| 507 | mode,
|
| 508 | data,
|
| 509 | size,
|
| 510 | ecc,
|
| 511 | version,
|
| 512 | align,
|
| 513 | })
|
| 514 | }
|
| 515 |
|
| 516 | fn parse_align_value(value: &str, line_no: usize) -> Result<Align, ParseError> {
|
| 517 | match value.to_ascii_lowercase().as_str() {
|
| 518 | "left" => Ok(Align::Left),
|
| 519 | "center" | "centre" => Ok(Align::Center),
|
| 520 | "right" => Ok(Align::Right),
|
| 521 | _ => Err(err(line_no, 1, "align must be left, center, or right")),
|
| 522 | }
|
| 523 | }
|
| 524 |
|
| 525 | fn is_list_item_line(line: &str) -> bool {
|
| 526 | line.trim_start().starts_with("- ")
|
| 527 | }
|
| 528 |
|
| 529 | fn list_item_text(line: &str) -> &str {
|
| 530 | line.trim_start()
|
| 531 | .strip_prefix("- ")
|
| 532 | .map(str::trim_end)
|
| 533 | .unwrap_or(line.trim_end())
|
| 534 | }
|
| 535 |
|
| 536 | fn parse_list_item_inlines(line: &str, line_no: usize) -> Result<Vec<Inline>, ParseError> {
|
| 537 | parse_inlines(list_item_text(line), line_no, 1)
|
| 538 | }
|
| 539 |
|
| 540 | fn parse_inlines(input: &str, line: usize, col: usize) -> Result<Vec<Inline>, ParseError> {
|
| 541 | let mut out = Vec::new();
|
| 542 | let mut i = 0usize;
|
| 543 | let chars: Vec<char> = input.chars().collect();
|
| 544 | while i < chars.len() {
|
| 545 | if chars[i] == '$' && i + 1 < chars.len() && chars[i + 1] == '{' {
|
| 546 | let start = i + 2;
|
| 547 | let mut j = start;
|
| 548 | while j < chars.len() && chars[j] != '}' {
|
| 549 | j += 1;
|
| 550 | }
|
| 551 | if j >= chars.len() {
|
| 552 | return Err(err(line, col + i, "unclosed parameter ${...}"));
|
| 553 | }
|
| 554 | let name: String = chars[start..j].iter().collect();
|
| 555 | if !is_valid_param_name(&name) {
|
| 556 | return Err(err(
|
| 557 | line,
|
| 558 | col + i,
|
| 559 | format!("invalid parameter name '{name}'"),
|
| 560 | ));
|
| 561 | }
|
| 562 | out.push(Inline::Param(name));
|
| 563 | i = j + 1;
|
| 564 | continue;
|
| 565 | }
|
| 566 | if let Some((checked, consumed)) = try_parse_checkbox(&chars[i..]) {
|
| 567 | out.push(Inline::Checkbox { checked });
|
| 568 | i += consumed;
|
| 569 | continue;
|
| 570 | }
|
| 571 | let start = i;
|
| 572 | while i < chars.len() && chars[i] != '$' {
|
| 573 | // Stop before a checkbox so it becomes its own inline.
|
| 574 | if try_parse_checkbox(&chars[i..]).is_some() {
|
| 575 | break;
|
| 576 | }
|
| 577 | i += 1;
|
| 578 | }
|
| 579 | if i == start {
|
| 580 | i += 1;
|
| 581 | continue;
|
| 582 | }
|
| 583 | out.push(Inline::Text(chars[start..i].iter().collect()));
|
| 584 | }
|
| 585 | Ok(out)
|
| 586 | }
|
| 587 |
|
| 588 | /// Parse `[]`, `[ ]`, `[x]`, or `[X]` at the start of `chars`.
|
| 589 | /// Returns `(checked, chars_consumed)`.
|
| 590 | fn try_parse_checkbox(chars: &[char]) -> Option<(bool, usize)> {
|
| 591 | if chars.first() != Some(&'[') {
|
| 592 | return None;
|
| 593 | }
|
| 594 | match chars.get(1) {
|
| 595 | Some(']') => Some((false, 2)),
|
| 596 | Some(' ') if chars.get(2) == Some(&']') => Some((false, 3)),
|
| 597 | Some('x' | 'X') if chars.get(2) == Some(&']') => Some((true, 3)),
|
| 598 | _ => None,
|
| 599 | }
|
| 600 | }
|
| 601 |
|
| 602 | fn is_valid_param_name(name: &str) -> bool {
|
| 603 | let mut chars = name.chars();
|
| 604 | match chars.next() {
|
| 605 | Some(c) if c.is_ascii_alphabetic() || c == '_' => {}
|
| 606 | _ => return false,
|
| 607 | }
|
| 608 | chars.all(|c| c.is_ascii_alphanumeric() || c == '_')
|
| 609 | }
|
| 610 |
|
| 611 | fn err(line: usize, column: usize, message: impl Into<String>) -> ParseError {
|
| 612 | ParseError {
|
| 613 | line,
|
| 614 | column,
|
| 615 | message: message.into(),
|
| 616 | }
|
| 617 | }
|
| 618 |
|
| 619 | #[cfg(test)]
|
| 620 | mod tests {
|
| 621 | use super::*;
|
| 622 | use crate::dsl::{BarcodeMode, BarcodeSymbology, Inline, TimeFormatSpec};
|
| 623 |
|
| 624 | fn inlines_to_text(inlines: &[Inline]) -> String {
|
| 625 | let mut out = String::new();
|
| 626 | for inline in inlines {
|
| 627 | match inline {
|
| 628 | Inline::Text(t) | Inline::Param(t) => out.push_str(t),
|
| 629 | Inline::Checkbox { checked } => {
|
| 630 | out.push_str(crate::dsl::checkbox_glyph(*checked));
|
| 631 | }
|
| 632 | }
|
| 633 | }
|
| 634 | out
|
| 635 | }
|
| 636 |
|
| 637 | #[test]
|
| 638 | fn parses_inline_checkboxes() {
|
| 639 | let doc = parse("[] empty\n[ ] spaced\n[x] done\n[X] also").unwrap();
|
| 640 | assert_eq!(doc.blocks.len(), 1);
|
| 641 | let Block::Paragraph { inlines, .. } = &doc.blocks[0] else {
|
| 642 | panic!("expected paragraph");
|
| 643 | };
|
| 644 | let glyphs: Vec<_> = inlines
|
| 645 | .iter()
|
| 646 | .filter_map(|i| match i {
|
| 647 | Inline::Checkbox { checked } => Some(*checked),
|
| 648 | _ => None,
|
| 649 | })
|
| 650 | .collect();
|
| 651 | assert_eq!(glyphs, vec![false, false, true, true]);
|
| 652 | }
|
| 653 |
|
| 654 | #[test]
|
| 655 | fn parses_heading_and_paragraph() {
|
| 656 | let doc = parse("# Store\nHello world").unwrap();
|
| 657 | assert_eq!(doc.blocks.len(), 2);
|
| 658 | assert!(matches!(doc.blocks[0], Block::Heading { level: 1, .. }));
|
| 659 | assert!(matches!(doc.blocks[1], Block::Paragraph { .. }));
|
| 660 | }
|
| 661 |
|
| 662 | #[test]
|
| 663 | fn parses_bullet_list() {
|
| 664 | let doc = parse("- this\n- is then\n- a list").unwrap();
|
| 665 | assert_eq!(doc.blocks.len(), 1);
|
| 666 | let Block::List { items, .. } = &doc.blocks[0] else {
|
| 667 | panic!("expected list");
|
| 668 | };
|
| 669 | assert_eq!(items.len(), 3);
|
| 670 | assert_eq!(inlines_to_text(&items[0]), "this");
|
| 671 | assert_eq!(inlines_to_text(&items[1]), "is then");
|
| 672 | assert_eq!(inlines_to_text(&items[2]), "a list");
|
| 673 | }
|
| 674 |
|
| 675 | #[test]
|
| 676 | fn blank_line_breaks_bullet_list() {
|
| 677 | let doc = parse("- one\n\n- two").unwrap();
|
| 678 | assert_eq!(doc.blocks.len(), 3);
|
| 679 | assert!(matches!(doc.blocks[0], Block::List { .. }));
|
| 680 | assert!(matches!(doc.blocks[1], Block::Feed(1)));
|
| 681 | assert!(matches!(doc.blocks[2], Block::List { .. }));
|
| 682 | }
|
| 683 |
|
| 684 | #[test]
|
| 685 | fn parses_parameters() {
|
| 686 | let doc = parse("Order ${OrderId}").unwrap();
|
| 687 | let Block::Paragraph { inlines, .. } = &doc.blocks[0] else {
|
| 688 | panic!("expected paragraph");
|
| 689 | };
|
| 690 | assert!(matches!(
|
| 691 | inlines.as_slice(),
|
| 692 | [
|
| 693 | Inline::Text(_),
|
| 694 | Inline::Param(name)
|
| 695 | ] if name == "OrderId"
|
| 696 | ));
|
| 697 | }
|
| 698 |
|
| 699 | #[test]
|
| 700 | fn dedupes_collect_is_separate_module() {
|
| 701 | let doc = parse("@barcode CODE128 ${A}\n@qr ${A}").unwrap();
|
| 702 | assert_eq!(doc.blocks.len(), 2);
|
| 703 | }
|
| 704 |
|
| 705 | #[test]
|
| 706 | fn strips_comments() {
|
| 707 | let doc = parse("<!-- hidden -->Visible").unwrap();
|
| 708 | assert_eq!(doc.blocks.len(), 1);
|
| 709 | let doc = parse("<!-- hidden -->\nVisible").unwrap();
|
| 710 | assert!(matches!(doc.blocks[0], Block::Feed(1)));
|
| 711 | }
|
| 712 |
|
| 713 | #[test]
|
| 714 | fn rejects_unknown_directive() {
|
| 715 | assert!(parse("@unknown x").is_err());
|
| 716 | }
|
| 717 |
|
| 718 | #[test]
|
| 719 | fn parses_alignment_prefix() {
|
| 720 | let doc = parse(":center:\nCentered").unwrap();
|
| 721 | let Block::Paragraph { align, .. } = &doc.blocks[0] else {
|
| 722 | panic!();
|
| 723 | };
|
| 724 | assert_eq!(*align, Align::Center);
|
| 725 | }
|
| 726 |
|
| 727 | #[test]
|
| 728 | fn persistent_center_applies_to_heading_and_directives() {
|
| 729 | let doc = parse(
|
| 730 | ":center:\n# Hello\n@qr ${Data}\n@barcode RASTER CODE128 ${Data}\n:left:\nLeft\n",
|
| 731 | )
|
| 732 | .unwrap();
|
| 733 | assert_eq!(doc.blocks.len(), 4);
|
| 734 | assert!(matches!(
|
| 735 | doc.blocks[0],
|
| 736 | Block::Heading {
|
| 737 | align: Align::Center,
|
| 738 | ..
|
| 739 | }
|
| 740 | ));
|
| 741 | assert!(matches!(
|
| 742 | doc.blocks[1],
|
| 743 | Block::Qr {
|
| 744 | align: Align::Center,
|
| 745 | ..
|
| 746 | }
|
| 747 | ));
|
| 748 | assert!(matches!(
|
| 749 | doc.blocks[2],
|
| 750 | Block::Barcode {
|
| 751 | align: Align::Center,
|
| 752 | ..
|
| 753 | }
|
| 754 | ));
|
| 755 | assert!(matches!(
|
| 756 | doc.blocks[3],
|
| 757 | Block::Paragraph {
|
| 758 | align: Align::Left,
|
| 759 | ..
|
| 760 | }
|
| 761 | ));
|
| 762 | }
|
| 763 |
|
| 764 | #[test]
|
| 765 | fn persistent_center_groups_following_paragraph_lines() {
|
| 766 | let doc = parse(":center:\nLine one\nLine two").unwrap();
|
| 767 | assert_eq!(doc.blocks.len(), 1);
|
| 768 | let Block::Paragraph { align, inlines } = &doc.blocks[0] else {
|
| 769 | panic!();
|
| 770 | };
|
| 771 | assert_eq!(*align, Align::Center);
|
| 772 | assert_eq!(inlines_to_text(inlines), "Line one\nLine two");
|
| 773 | }
|
| 774 |
|
| 775 | #[test]
|
| 776 | fn align_prefix_on_same_line_sets_persistent_state() {
|
| 777 | let doc = parse(":center: Inline\nNext").unwrap();
|
| 778 | assert_eq!(doc.blocks.len(), 1);
|
| 779 | let Block::Paragraph { align, inlines } = &doc.blocks[0] else {
|
| 780 | panic!();
|
| 781 | };
|
| 782 | assert_eq!(*align, Align::Center);
|
| 783 | assert_eq!(inlines_to_text(inlines), "Inline\nNext");
|
| 784 | }
|
| 785 |
|
| 786 | #[test]
|
| 787 | fn multiple_align_prefixes_on_one_line() {
|
| 788 | let doc = parse(":left:left :right:right").unwrap();
|
| 789 | assert_eq!(doc.blocks.len(), 2);
|
| 790 | assert!(matches!(
|
| 791 | doc.blocks[0],
|
| 792 | Block::Paragraph {
|
| 793 | align: Align::Left,
|
| 794 | ..
|
| 795 | }
|
| 796 | ));
|
| 797 | assert!(matches!(
|
| 798 | doc.blocks[1],
|
| 799 | Block::Paragraph {
|
| 800 | align: Align::Right,
|
| 801 | ..
|
| 802 | }
|
| 803 | ));
|
| 804 | let Block::Paragraph { inlines: left, .. } = &doc.blocks[0] else {
|
| 805 | panic!();
|
| 806 | };
|
| 807 | let Block::Paragraph { inlines: right, .. } = &doc.blocks[1] else {
|
| 808 | panic!();
|
| 809 | };
|
| 810 | assert_eq!(inlines_to_text(left), "left");
|
| 811 | assert_eq!(inlines_to_text(right), "right");
|
| 812 | }
|
| 813 |
|
| 814 | #[test]
|
| 815 | fn align_only_line_does_not_emit_block() {
|
| 816 | let doc = parse(":center:\n:center:").unwrap();
|
| 817 | assert!(doc.blocks.is_empty());
|
| 818 | }
|
| 819 |
|
| 820 | #[test]
|
| 821 | fn parses_date_and_time_directives() {
|
| 822 | let doc = parse("@date\n@date DD-YYYY-MM\n@time\n@time 12h").unwrap();
|
| 823 | assert!(matches!(
|
| 824 | doc.blocks[0],
|
| 825 | Block::Date {
|
| 826 | format: None,
|
| 827 | ..
|
| 828 | }
|
| 829 | ));
|
| 830 | assert!(matches!(
|
| 831 | doc.blocks[1],
|
| 832 | Block::Date {
|
| 833 | format: Some(ref f),
|
| 834 | ..
|
| 835 | } if f == "DD-YYYY-MM"
|
| 836 | ));
|
| 837 | assert!(matches!(
|
| 838 | doc.blocks[2],
|
| 839 | Block::Time {
|
| 840 | format: TimeFormatSpec::Hours24,
|
| 841 | ..
|
| 842 | }
|
| 843 | ));
|
| 844 | assert!(matches!(
|
| 845 | doc.blocks[3],
|
| 846 | Block::Time {
|
| 847 | format: TimeFormatSpec::Hours12,
|
| 848 | ..
|
| 849 | }
|
| 850 | ));
|
| 851 | }
|
| 852 |
|
| 853 | #[test]
|
| 854 | fn rejects_unknown_time_format() {
|
| 855 | assert!(parse("@time 24").is_err());
|
| 856 | }
|
| 857 |
|
| 858 | #[test]
|
| 859 | fn blank_line_inserts_feed() {
|
| 860 | let doc = parse("A\n\nB").unwrap();
|
| 861 | assert!(matches!(doc.blocks[1], Block::Feed(1)));
|
| 862 | }
|
| 863 |
|
| 864 | #[test]
|
| 865 | fn whitespace_only_line_inserts_feed() {
|
| 866 | let doc = parse("A\n \nB").unwrap();
|
| 867 | assert!(matches!(doc.blocks[1], Block::Feed(1)));
|
| 868 | }
|
| 869 |
|
| 870 | #[test]
|
| 871 | fn document_ends_with_cut_ignores_trailing_blank_lines() {
|
| 872 | let doc = parse("Line\n@cut\n\n").unwrap();
|
| 873 | assert!(document_ends_with_cut(&doc));
|
| 874 | }
|
| 875 |
|
| 876 | #[test]
|
| 877 | fn document_without_cut_at_end() {
|
| 878 | let doc = parse("Line\n@feed 1").unwrap();
|
| 879 | assert!(!document_ends_with_cut(&doc));
|
| 880 | }
|
| 881 |
|
| 882 | #[test]
|
| 883 | fn blank_line_between_barcode_and_qr_is_feed() {
|
| 884 | let doc = parse("@barcode RASTER CODE128 X\n\n:center:@qr RASTER Y scale=4").unwrap();
|
| 885 | assert!(matches!(
|
| 886 | doc.blocks.as_slice(),
|
| 887 | [
|
| 888 | Block::Barcode { .. },
|
| 889 | Block::Feed(1),
|
| 890 | Block::Qr { .. },
|
| 891 | ]
|
| 892 | ));
|
| 893 | }
|
| 894 |
|
| 895 | #[test]
|
| 896 | fn dsl_marker_lines_are_not_feed() {
|
| 897 | for src in [
|
| 898 | ":left:\nNext",
|
| 899 | ":center:\nNext",
|
| 900 | ":right:\nNext",
|
| 901 | ":centre:\nNext",
|
| 902 | "# Title\n",
|
| 903 | "---\n",
|
| 904 | "@cut\n",
|
| 905 | ] {
|
| 906 | let doc = parse(src).unwrap();
|
| 907 | assert!(
|
| 908 | !doc.blocks.iter().any(|b| matches!(b, Block::Feed(1))),
|
| 909 | "unexpected feed for {src:?}"
|
| 910 | );
|
| 911 | }
|
| 912 | }
|
| 913 |
|
| 914 | #[test]
|
| 915 | fn parses_raster_barcode() {
|
| 916 | let doc = parse("@barcode RASTER CODE128 ABC").unwrap();
|
| 917 | assert!(matches!(
|
| 918 | doc.blocks[0],
|
| 919 | Block::Barcode {
|
| 920 | mode: BarcodeMode::Raster,
|
| 921 | symbology: BarcodeSymbology::Code128,
|
| 922 | ..
|
| 923 | }
|
| 924 | ));
|
| 925 | }
|
| 926 | }
|