Struct PathPrompt 

pub struct PathPrompt { /* private fields */ }

Builder returned by path().

Implementations

impl PathPrompt

pub fn initial(self, v: impl Into<String>) -> Self

Initial path shown — falls back to the current working directory.

pub fn directory(self, v: bool) -> Self

When true, only accept directories.

pub fn max_items(self, n: usize) -> Self

Maximum number of completion suggestions shown at once.

pub fn run(self) -> Result<PathBuf>

Run the prompt to completion.

Trait Implementations

impl Prompt for PathPrompt

type Output = PathBuf

The value returned to the caller on successful submission.

fn handle(&mut self, key: Key) -> Step<PathBuf>

Apply a key press to the prompt’s internal state. Return:

fn render(&self, _ctx: RenderCtx<'_>) -> Frame

Render the prompt’s current state as one frame (a Vec<String>, one entry per terminal row). The runner takes care of writing the frame and clearing it on the next iteration — prompts never call eprintln! themselves.

fn render_answered(&self, value: &PathBuf) -> Frame

Render the prompt’s post-submission display. Typically the ◇ question / │ value / │ triple from theme::answered.

fn run_fallback(self) -> Result<PathBuf>

Optional non-interactive fallback for piped/CI environments. The default is to refuse — most prompts override this with a numeric or line-buffered alternative.