nils-codex-cli 0.7.3

CLI crate for nils-codex-cli in the nils-cli workspace.
Documentation
use chrono::{Local, TimeZone};
use nils_common::env as shared_env;
use std::path::Path;

use crate::rate_limits::ansi;

#[derive(Clone, Debug)]
pub struct CacheEntry {
    pub fetched_at_epoch: i64,
    pub non_weekly_label: String,
    pub non_weekly_remaining: i64,
    pub non_weekly_reset_epoch: Option<i64>,
    pub weekly_remaining: i64,
    pub weekly_reset_epoch: i64,
}

pub fn read_cache_file(path: &Path) -> Option<CacheEntry> {
    let content = std::fs::read_to_string(path).ok()?;
    parse_cache_kv(&content)
}

fn parse_cache_kv(content: &str) -> Option<CacheEntry> {
    let mut fetched_at_epoch: Option<i64> = None;
    let mut non_weekly_label: Option<String> = None;
    let mut non_weekly_remaining: Option<i64> = None;
    let mut non_weekly_reset_epoch: Option<i64> = None;
    let mut weekly_remaining: Option<i64> = None;
    let mut weekly_reset_epoch: Option<i64> = None;

    for line in content.lines() {
        if let Some(value) = line.strip_prefix("fetched_at=") {
            fetched_at_epoch = value.parse::<i64>().ok();
        } else if let Some(value) = line.strip_prefix("non_weekly_label=") {
            non_weekly_label = Some(value.to_string());
        } else if let Some(value) = line.strip_prefix("non_weekly_remaining=") {
            non_weekly_remaining = value.parse::<i64>().ok();
        } else if let Some(value) = line.strip_prefix("non_weekly_reset_epoch=") {
            non_weekly_reset_epoch = value.parse::<i64>().ok();
        } else if let Some(value) = line.strip_prefix("weekly_remaining=") {
            weekly_remaining = value.parse::<i64>().ok();
        } else if let Some(value) = line.strip_prefix("weekly_reset_epoch=") {
            weekly_reset_epoch = value.parse::<i64>().ok();
        }
    }

    let fetched_at_epoch = fetched_at_epoch?;
    let non_weekly_label = non_weekly_label?;
    if non_weekly_label.trim().is_empty() {
        return None;
    }
    let non_weekly_remaining = non_weekly_remaining?;
    let weekly_remaining = weekly_remaining?;
    let weekly_reset_epoch = weekly_reset_epoch?;

    Some(CacheEntry {
        fetched_at_epoch,
        non_weekly_label,
        non_weekly_remaining,
        non_weekly_reset_epoch,
        weekly_remaining,
        weekly_reset_epoch,
    })
}

pub fn render_line(
    entry: &CacheEntry,
    prefix: &str,
    show_5h: bool,
    weekly_reset_time_format: &str,
) -> Option<String> {
    let weekly_reset_time = format_epoch_local(entry.weekly_reset_epoch, weekly_reset_time_format)
        .unwrap_or_else(|| "?".to_string());

    let color_enabled = should_color();
    let weekly_token = ansi::format_percent_token(
        &format!("W:{}%", entry.weekly_remaining),
        Some(color_enabled),
    );

    if show_5h {
        let non_weekly_token = ansi::format_percent_token(
            &format!("{}:{}%", entry.non_weekly_label, entry.non_weekly_remaining),
            Some(color_enabled),
        );
        return Some(format!(
            "{prefix}{non_weekly_token} {weekly_token} {weekly_reset_time}"
        ));
    }

    Some(format!("{prefix}{weekly_token} {weekly_reset_time}"))
}

fn format_epoch_local(epoch: i64, fmt: &str) -> Option<String> {
    let dt = Local.timestamp_opt(epoch, 0).single()?;
    Some(dt.format(fmt).to_string())
}

fn should_color() -> bool {
    shared_env::prompt_segment_color_enabled("CODEX_PROMPT_SEGMENT_COLOR_ENABLED")
}

#[cfg(test)]
mod tests {
    use super::should_color;
    use nils_test_support::{EnvGuard, GlobalStateLock};

    #[test]
    fn should_color_no_color_has_highest_priority() {
        let lock = GlobalStateLock::new();
        let _no_color = EnvGuard::set(&lock, "NO_COLOR", "1");
        let _explicit = EnvGuard::set(&lock, "CODEX_PROMPT_SEGMENT_COLOR_ENABLED", "true");
        let _session = EnvGuard::set(&lock, "STARSHIP_SESSION_KEY", "session");
        assert!(!should_color());
    }

    #[test]
    fn should_color_explicit_truthy_and_falsey_values_are_stable() {
        let lock = GlobalStateLock::new();
        let _no_color = EnvGuard::remove(&lock, "NO_COLOR");
        let _session = EnvGuard::remove(&lock, "STARSHIP_SESSION_KEY");
        let _shell = EnvGuard::remove(&lock, "STARSHIP_SHELL");

        for value in ["1", " true ", "YES", "on"] {
            let _explicit = EnvGuard::set(&lock, "CODEX_PROMPT_SEGMENT_COLOR_ENABLED", value);
            assert!(should_color(), "expected truthy value: {value}");
        }

        for value in ["", " ", "0", "false", "no", "off", "y", "enabled"] {
            let _explicit = EnvGuard::set(&lock, "CODEX_PROMPT_SEGMENT_COLOR_ENABLED", value);
            assert!(!should_color(), "expected falsey value: {value}");
        }
    }

    #[test]
    fn should_color_falls_back_to_prompt_markers_when_not_overridden() {
        let lock = GlobalStateLock::new();
        let _no_color = EnvGuard::remove(&lock, "NO_COLOR");
        let _explicit = EnvGuard::remove(&lock, "CODEX_PROMPT_SEGMENT_COLOR_ENABLED");
        let _session = EnvGuard::set(&lock, "STARSHIP_SESSION_KEY", "session");
        assert!(should_color());
    }
}