click-rs 1.0.2

A Rust port of Python's Click library for creating command-line interfaces
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83

//! Built-in shell completion helpers for common patterns.

use std::env;
use std::fs;
use std::path::{Path, PathBuf};

use crate::{CompletionItem, Context};

/// Complete environment variable names using case-insensitive substring matching.
pub fn env_vars(_ctx: &Context, incomplete: &str) -> Vec<CompletionItem> {
    let needle = incomplete.to_lowercase();
    env::vars()
        .filter(|(key, _)| key.to_lowercase().contains(&needle))
        .map(|(key, _)| CompletionItem::new(key))
        .collect()
}

/// Complete directory paths.
///
/// Supports both bare names (`src`) and nested prefixes (`foo/bar`).
pub fn directories(_ctx: &Context, incomplete: &str) -> Vec<CompletionItem> {
    let (base_dir, prefix) = match incomplete.rsplit_once(std::path::MAIN_SEPARATOR) {
        Some((parent, tail)) if !parent.is_empty() => (PathBuf::from(parent), tail),
        _ => (PathBuf::from("."), incomplete),
    };

    fs::read_dir(&base_dir)
        .into_iter()
        .flatten()
        .filter_map(|entry| entry.ok())
        .filter_map(|entry| {
            let path = entry.path();
            if !path.is_dir() {
                return None;
            }

            let name = entry.file_name().to_string_lossy().to_string();
            if !name.starts_with(prefix) {
                return None;
            }

            let value = if base_dir == Path::new(".") {
                name
            } else {
                format!(
                    "{}{}{}",
                    base_dir.display(),
                    std::path::MAIN_SEPARATOR,
                    name
                )
            };
            Some(CompletionItem::new(value))
        })
        .collect()
}

/// Build a completion callback from static values.
pub fn items(
    values: &'static [&'static str],
) -> impl Fn(&Context, &str) -> Vec<CompletionItem> + Send + Sync + 'static {
    move |_ctx: &Context, incomplete: &str| {
        values
            .iter()
            .copied()
            .filter(|value| value.contains(incomplete))
            .map(CompletionItem::new)
            .collect()
    }
}

/// Build a completion callback from static `(value, help)` pairs.
pub fn items_with_help(
    values: &'static [(&'static str, &'static str)],
) -> impl Fn(&Context, &str) -> Vec<CompletionItem> + Send + Sync + 'static {
    move |_ctx: &Context, incomplete: &str| {
        values
            .iter()
            .copied()
            .filter(|(value, help)| value.contains(incomplete) || help.contains(incomplete))
            .map(|(value, help)| CompletionItem::new(value).with_help(help))
            .collect()
    }
}