rtimelogger 0.8.0

use crate::export::ExportFormat;
use clap::{Parser, Subcommand};

/// Command-line interface definition for rTimelogger
/// CLI application to track working hours with SQLite
#[derive(Parser)]
#[command(
    name = "rtimelogger",
    version = env!("CARGO_PKG_VERSION"),
    about = "A simple time logging CLI: track working hours and calculate surplus using SQLite",
    long_about = None
)]
pub struct Cli {
    /// Override database path (useful for tests or custom DB)
    #[arg(global = true, long = "db")]
    pub db: Option<String>,

    /// Run in test mode (no config file update)
    #[arg(global = true, long = "test", hide = true)]
    pub test: bool,

    #[command(subcommand)]
    pub command: Commands,
}

#[derive(Subcommand)]
pub enum Commands {
    /// Initialize the database and configuration
    Init,

    /// Manage the configuration file (view or edit)
    Config {
        #[arg(long = "print", help = "Print the current configuration file")]
        print_config: bool,

        #[arg(long = "check", help = "Check configuration file for missing fields")]
        check: bool,

        #[arg(long = "migrate", help = "Run configuration file migrations if needed")]
        migrate: bool,

        #[arg(
            long = "edit",
            help = "Edit the configuration file (default editor: $EDITOR, or nano/vim/notepad)"
        )]
        edit_config: bool,

        #[arg(
            long = "editor",
            help = "Specify the editor to use (vim, nano, or custom path)"
        )]
        editor: Option<String>,
    },

    /// Manage the database (migrations, integrity checks, etc.)
    Db {
        #[arg(long = "migrate", help = "Run pending database migrations")]
        migrate: bool,

        #[arg(long = "check", help = "Check database integrity")]
        check: bool,

        #[arg(long = "vacuum", help = "Optimize the database using VACUUM")]
        vacuum: bool,

        #[arg(long = "info", help = "Show database information")]
        info: bool,
    },

    /// Print or manage the internal log table
    Log {
        #[arg(long = "print", help = "Print rows from the internal log table")]
        print: bool,
    },

    /// Add or update a work session
    Add {
        /// Date of the event (YYYY-MM-DD)
        date: String,

        /// Position (O = Office, R = Remote, H = Home, C = Client, M = Mixed)
        #[arg(
            long = "pos",
            help = "Work position: O=Office, R=Remote, H=Home, C=Client, M=Mixed"
        )]
        pos: Option<String>,

        /// Clock-in time (HH:MM)
        #[arg(long = "in", help = "Clock-in time (HH:MM)")]
        start: Option<String>,

        /// Lunch break in minutes
        #[arg(long = "lunch", help = "Lunch break duration in minutes")]
        lunch: Option<i32>,

        /// Mark this pair as a work gap between OUT and IN events
        #[arg(
            long = "work-gap",
            conflicts_with = "no_work_gap",
            help = "Mark this pair as a work gap between OUT and IN events"
        )]
        work_gap: bool,

        /// Do not mark this pair as a work gap between OUT and IN events
        #[arg(
            long = "no-work-gap",
            conflicts_with = "work_gap",
            help = "Do not mark this pair as a work gap between OUT and IN events"
        )]
        no_work_gap: bool,

        /// Clock-out time (HH:MM)
        #[arg(long = "out", help = "Clock-out time (HH:MM)")]
        end: Option<String>,

        /// Edit an existing pair instead of creating a new one
        #[arg(long = "pair", help = "Pair ID to edit (used with --edit)")]
        edit_pair: Option<usize>,

        /// Enable edit mode (requires --pair)
        #[arg(
            long = "edit",
            requires = "edit_pair",
            help = "Edit existing pair instead of creating a new one"
        )]
        edit: bool,
    },

    /// Delete a work session by ID
    Del {
        #[arg(long = "pair", help = "Pair id to delete for the given date")]
        pair: Option<usize>,

        date: String,
    },

    /// List sessions
    List {
        #[arg(long, short, help = "Filter by year/month/day or a custom range")]
        period: Option<String>,

        #[arg(long)]
        pos: Option<String>,

        #[arg(long = "today", help = "Show only today's record")]
        now: bool,

        #[arg(long = "details", help = "Show today's detailed events")]
        details: bool,

        #[arg(long = "events", help = "List all events (in/out)")]
        events: bool,

        #[arg(long = "pairs", help = "Filter by pair id (only with --events)")]
        pairs: Option<usize>,

        #[arg(long = "summary", help = "Show summarized per-pair rows")]
        summary: bool,
    },

    /// Create a backup copy of the database
    Backup {
        #[arg(long, value_name = "FILE")]
        file: String,

        #[arg(long)]
        compress: bool,
    },

    /// Export work session data
    Export {
        #[arg(long, value_enum, default_value = "csv")]
        format: ExportFormat,

        #[arg(long, value_name = "FILE")]
        file: String,

        #[arg(
            long,
            value_name = "RANGE",
            help = "Filter export by year/month/day or a custom range"
        )]
        range: Option<String>,

        #[arg(long, short = 'e')]
        events: bool,

        #[arg(long, short = 'f')]
        force: bool,
    },
}