onevcs 0.52.0

Version control and remote-host abstraction for agent workflows: host-neutral change requests, sessions, and a rules system.
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

//! The generic-word list a bare or package term is narrowed by.
//!
//! A repository called `docs`, or a package called `server`, would refuse every
//! public write that used the word, so a name that is an ordinary English or software
//! word, or the conventional name of a test or tooling package such as `e2e` or
//! `test-utils`, is matched only as the fully qualified `owner/name`. An entry narrows
//! only the name equal to it as a whole, never a compound of entries. The list is data
//! rather than code — `generic-words.txt` beside this file, versioned by its own header
//! — so it can grow without a change here, and the version it is at and the format of
//! its entries are part of what `docs/contract.md` states.

use std::collections::HashSet;
use std::sync::OnceLock;

/// The list, as shipped.
const LIST: &str = include_str!("generic-words.txt");

fn words() -> &'static HashSet<&'static str> {
    static WORDS: OnceLock<HashSet<&'static str>> = OnceLock::new();
    WORDS.get_or_init(|| {
        LIST.lines()
            .map(str::trim)
            .filter(|line| !line.is_empty() && !line.starts_with('#'))
            .collect()
    })
}

/// Whether `word`, already in lower case, is on the list.
pub fn is_generic(word: &str) -> bool {
    words().contains(word)
}