feat: add release context export tool

Author: NthTensor

tools/export-content/Cargo.toml

@@ -0,0 +1,15 @@
+[package]
+name = "export-content"
+version = "0.1.0"
+edition = "2024"
+
+[dependencies]
+miette = { version = "7.6.0", features = ["fancy"] }
+ratatui = "0.29.0"
+regex = "1.11.1"
+serde = { version = "1.0", features = ["derive"] }
+serde_yml = "0.0.12"
+thiserror = "2.0.12"
+
+[lints]
+workspace = true

tools/export-content/src/app.rs

@@ -0,0 +1,351 @@
+use std::{env, fs, io::Write, path};
+
+use miette::{diagnostic, Context, Diagnostic, IntoDiagnostic, Result};
+use ratatui::{
+    crossterm::event::{self, Event, KeyCode, KeyModifiers},
+    prelude::*,
+    widgets::*,
+};
+use regex::Regex;
+use serde::Deserialize;
+use thiserror::Error;
+
+enum Mode {
+    ReleaseNotes,
+    MigrationGuides,
+}
+
+pub struct App {
+    content_dir: path::PathBuf,
+    release_notes: Vec<Entry>,
+    release_notes_state: ListState,
+    migration_guides: Vec<Entry>,
+    migration_guide_state: ListState,
+    text_entry: Option<String>,
+    mode: Mode,
+    exit: bool,
+}
+
+impl App {
+    pub fn new() -> Result<App> {
+        let exe_dir = env::current_exe()
+            .into_diagnostic()
+            .wrap_err("failed to determine path to binary")?;
+
+        let content_dir = exe_dir
+            .ancestors()
+            .nth(3)
+            .ok_or(diagnostic!("failed to determine path to repo root"))?
+            .join("release-content");
+
+        let release_notes_dir = content_dir.join("release-notes");
+        let release_notes = load_content(release_notes_dir, "release note")?;
+
+        let migration_guides_dir = content_dir.join("migration-guides");
+        let migration_guides = load_content(migration_guides_dir, "migration guide")?;
+
+        Ok(App {
+            content_dir,
+            release_notes,
+            release_notes_state: ListState::default().with_selected(Some(0)),
+            migration_guides,
+            migration_guide_state: ListState::default().with_selected(Some(0)),
+            text_entry: None,
+            mode: Mode::ReleaseNotes,
+            exit: false,
+        })
+    }
+
+    pub fn run<B: Backend>(mut self, terminal: &mut Terminal<B>) -> Result<()> {
+        while !self.exit {
+            terminal
+                .draw(|frame| self.render(frame))
+                .into_diagnostic()?;
+
+            let (mode_state, mode_entries) = match self.mode {
+                Mode::ReleaseNotes => (&mut self.release_notes_state, &mut self.release_notes),
+                Mode::MigrationGuides => {
+                    (&mut self.migration_guide_state, &mut self.migration_guides)
+                }
+            };
+
+            if let Event::Key(key) = event::read().into_diagnostic()? {
+                // If text entry is enabled, capture all input events
+                if let Some(text) = &mut self.text_entry {
+                    match key.code {
+                        KeyCode::Esc => self.text_entry = None,
+                        KeyCode::Backspace => {
+                            text.pop();
+                        }
+                        KeyCode::Enter => {
+                            if text != "" {
+                                if let Some(index) = mode_state.selected() {
+                                    mode_entries.insert(
+                                        index,
+                                        Entry::Section {
+                                            title: text.clone(),
+                                        },
+                                    );
+                                }
+                            }
+                            self.text_entry = None;
+                        }
+                        KeyCode::Char(c) => text.push(c),
+                        _ => {}
+                    }
+
+                    continue;
+                }
+
+                match key.code {
+                    KeyCode::Esc => self.exit = true,
+                    KeyCode::Tab => match self.mode {
+                        Mode::ReleaseNotes => self.mode = Mode::MigrationGuides,
+                        Mode::MigrationGuides => self.mode = Mode::ReleaseNotes,
+                    },
+                    KeyCode::Down => {
+                        if key.modifiers.contains(KeyModifiers::SHIFT) {
+                            if let Some(index) = mode_state.selected() {
+                                if index < mode_entries.len() - 1 {
+                                    mode_entries.swap(index, index + 1);
+                                }
+                            }
+                        }
+                        mode_state.select_next();
+                    }
+                    KeyCode::Up => {
+                        if key.modifiers.contains(KeyModifiers::SHIFT) {
+                            if let Some(index) = mode_state.selected() {
+                                if index > 0 {
+                                    mode_entries.swap(index, index - 1);
+                                }
+                            }
+                        }
+                        mode_state.select_previous();
+                    }
+                    KeyCode::Char('+') => {
+                        self.text_entry = Some(String::new());
+                    }
+                    KeyCode::Char('d') => {
+                        if let Some(index) = mode_state.selected() {
+                            if let Entry::Section { .. } = mode_entries[index] {
+                                mode_entries.remove(index);
+                            }
+                        }
+                    }
+                    _ => {}
+                }
+            }
+        }
+
+        self.write_output()
+    }
+
+    pub fn render(&mut self, frame: &mut Frame) {
+        use Constraint::*;
+
+        let page_area = frame.area().inner(Margin::new(1, 1));
+        let [header_area, instructions_area, _, block_area, _, typing_area] = Layout::vertical([
+            Length(2), // header
+            Length(2), // instructions
+            Length(1), // gap
+            Fill(1),   // blocks
+            Length(1), // gap
+            Length(2), // text input
+        ])
+        .areas(page_area);
+
+        frame.render_widget(self.header(), header_area);
+        frame.render_widget(self.instructions(), instructions_area);
+
+        let (title, mode_state, mode_entries) = match self.mode {
+            Mode::ReleaseNotes => (
+                "Release Notes",
+                &mut self.release_notes_state,
+                &self.release_notes,
+            ),
+            Mode::MigrationGuides => (
+                "Migration Guides",
+                &mut self.migration_guide_state,
+                &self.migration_guides,
+            ),
+        };
+        let items = mode_entries.iter().map(|e| e.as_list_entry());
+        let list = List::new(items)
+            .block(Block::new().title(title).padding(Padding::uniform(1)))
+            .highlight_symbol(">>")
+            .highlight_style(Color::Green);
+
+        frame.render_stateful_widget(list, block_area, mode_state);
+
+        if let Some(text) = &self.text_entry {
+            let text_entry = Paragraph::new(format!("Section Title: {}", text)).fg(Color::Blue);
+            frame.render_widget(text_entry, typing_area);
+        }
+    }
+
+    fn header(&self) -> impl Widget {
+        let text = "Content Exporter Tool";
+        text.bold().underlined().into_centered_line()
+    }
+
+    fn instructions(&self) -> impl Widget {
+        let text =
+            "▲ ▼ : navagate    shift + ▲ ▼ : re-order    + : insert section    d : delete section    tab : change focus    esc : save and quit";
+        Paragraph::new(text)
+            .fg(Color::Magenta)
+            .centered()
+            .wrap(Wrap { trim: false })
+    }
+
+    fn write_output(self) -> Result<()> {
+        // Write release notes
+        let mut file =
+            fs::File::create(self.content_dir.join("merged_release_notes.md")).into_diagnostic()?;
+
+        for entry in self.release_notes {
+            match entry {
+                Entry::Section { title } => write!(file, "# {title}\n\n").into_diagnostic()?,
+                Entry::File { metadata, content } => {
+                    let title = metadata.title;
+
+                    let authors = metadata
+                        .authors
+                        .iter()
+                        .flatten()
+                        .map(|a| format!("\"{a}\""))
+                        .collect::<Vec<_>>()
+                        .join(", ");
+
+                    let pull_requests = metadata
+                        .pull_requests
+                        .iter()
+                        .map(|n| format!("{}", n))
+                        .collect::<Vec<_>>()
+                        .join(", ");
+
+                    write!(
+                        file,
+                        "## {title}\n{{% heading_metadata(authors=[{authors}] prs=[{pull_requests}]) %}}\n{content}\n\n"
+                    )
+                    .into_diagnostic()?;
+                }
+            }
+        }
+
+        // Write migration guide
+        let mut file = fs::File::create(self.content_dir.join("merged_migration_guides.md"))
+            .into_diagnostic()?;
+
+        for entry in self.migration_guides {
+            match entry {
+                Entry::Section { title } => write!(file, "## {title}\n\n").into_diagnostic()?,
+                Entry::File { metadata, content } => {
+                    let title = metadata.title;
+
+                    let pull_requests = metadata
+                        .pull_requests
+                        .iter()
+                        .map(|n| format!("{}", n))
+                        .collect::<Vec<_>>()
+                        .join(", ");
+
+                    write!(
+                        file,
+                        "### {title}\n{{% heading_metadata(prs=[{pull_requests}]) %}}\n{content}\n\n"
+                    )
+                    .into_diagnostic()?;
+                }
+            }
+        }
+
+        Ok(())
+    }
+}
+
+#[derive(Deserialize, Debug)]
+struct Metadata {
+    title: String,
+    authors: Option<Vec<String>>,
+    pull_requests: Vec<u32>,
+}
+
+#[derive(Debug)]
+pub enum Entry {
+    Section { title: String },
+    File { metadata: Metadata, content: String },
+}
+
+impl Entry {
+    fn as_list_entry(&'_ self) -> ListItem<'_> {
+        match self {
+            Entry::Section { title } => ListItem::new(title.as_str()).underlined().fg(Color::Blue),
+            Entry::File { metadata, .. } => ListItem::new(metadata.title.as_str()),
+        }
+    }
+}
+
+/// Loads release content from files in the specified directory
+pub fn load_content(dir: path::PathBuf, kind: &'static str) -> Result<Vec<Entry>> {
+    let re = Regex::new(r"(?s)^---\s*\n(.*?)\n---\n(.*)").unwrap();
+
+    let mut entries = vec![];
+
+    for dir_entry in fs::read_dir(dir)
+        .into_diagnostic()
+        .wrap_err("unable to read directory")?
+    {
+        let dir_entry = dir_entry
+            .into_diagnostic()
+            .wrap_err(format!("unable to access {} file", kind))?;
+
+        // Skip directories
+        if !dir_entry.path().is_file() {
+            continue;
+        }
+        // Skip files with invalid names
+        let Ok(file_name) = dir_entry.file_name().into_string() else {
+            continue;
+        };
+        // Skip hidden files (like .gitkeep or .DS_Store)
+        if file_name.starts_with(".") {
+            continue;
+        }
+
+        let file_content = fs::read_to_string(&dir_entry.path())
+            .into_diagnostic()
+            .wrap_err(format!("unable to read {} file", kind))?;
+
+        let caps = re.captures(&file_content).ok_or(diagnostic!(
+            "failed to find frontmatter in {} file {}",
+            kind,
+            file_name
+        ))?;
+
+        let frontmatter = caps.get(1).unwrap().as_str();
+        let metadata = serde_yml::from_str::<Metadata>(frontmatter).map_err(|e| ParseError {
+            src: frontmatter.to_owned(),
+            kind,
+            file_name,
+            err_span: e.location().map(|l| l.index()),
+            error: e,
+        })?;
+        let content = caps.get(2).unwrap().as_str().to_owned();
+
+        entries.push(Entry::File { metadata, content })
+    }
+
+    Ok(entries)
+}
+
+#[derive(Diagnostic, Debug, Error)]
+#[error("failed to parse metadata in {kind} file {file_name}")]
+pub struct ParseError {
+    #[source_code]
+    src: String,
+    kind: &'static str,
+    file_name: String,
+    #[label("{error}")]
+    err_span: Option<usize>,
+    error: serde_yml::Error,
+}