use std::process::ExitCode; use anyhow::Result; use clap::{CommandFactory, Parser}; use lune::Lune; use tokio::fs::{read_to_string, write}; use crate::{ gen::generate_docs_json_from_definitions, utils::{ files::find_parse_file_path, github::Client as GithubClient, listing::{find_lune_scripts, print_lune_scripts, sort_lune_scripts}, }, }; pub(crate) const LUNE_SELENE_FILE_NAME: &str = "lune.yml"; pub(crate) const LUNE_LUAU_FILE_NAME: &str = "luneTypes.d.luau"; pub(crate) const LUNE_DOCS_FILE_NAME: &str = "luneDocs.json"; /// Lune CLI #[derive(Parser, Debug, Default)] #[command(author, version, about, long_about = None)] #[allow(clippy::struct_excessive_bools)] pub struct Cli { /// Path to the file to run, or the name /// of a luau file in a lune directory /// /// Can be omitted when downloading type definitions script_path: Option, /// Arguments to pass to the file as vararg (...) script_args: Vec, /// Pass this flag to list scripts inside of /// nearby `lune` and / or `.lune` directories #[clap(long, short = 'l')] list: bool, /// Pass this flag to download the Selene type /// definitions file to the current directory #[clap(long)] download_selene_types: bool, /// Pass this flag to download the Luau type /// definitions file to the current directory #[clap(long)] download_luau_types: bool, /// Pass this flag to generate the Lune documentation file /// from a luau type definitions file in the current directory #[clap(long)] generate_docs_file: bool, } #[allow(dead_code)] impl Cli { pub fn from_path(path: S) -> Self where S: Into, { Self { script_path: Some(path.into()), ..Default::default() } } pub fn from_path_with_args(path: S, args: A) -> Self where S: Into, A: Into>, { Self { script_path: Some(path.into()), script_args: args.into(), ..Default::default() } } pub fn download_selene_types() -> Self { Self { download_selene_types: true, ..Default::default() } } pub fn download_luau_types() -> Self { Self { download_luau_types: true, ..Default::default() } } pub fn list() -> Self { Self { list: true, ..Default::default() } } pub async fn run(self) -> Result { // List files in `lune` and `.lune` directories, if wanted // This will also exit early and not run anything else if self.list { match find_lune_scripts().await { Ok(scripts) => { let sorted = sort_lune_scripts(scripts); if sorted.is_empty() { println!("No scripts found."); } else { print!("Available scripts:"); print_lune_scripts(sorted)?; } return Ok(ExitCode::SUCCESS); } Err(e) => { eprintln!("{e}"); return Ok(ExitCode::FAILURE); } } } // Download definition files, if wanted let download_types_requested = self.download_selene_types || self.download_luau_types; if download_types_requested { let client = GithubClient::new(); let release = client.fetch_release_for_this_version().await?; if self.download_selene_types { println!("Downloading Selene type definitions..."); client .fetch_release_asset(&release, LUNE_SELENE_FILE_NAME) .await?; } if self.download_luau_types { println!("Downloading Luau type definitions..."); client .fetch_release_asset(&release, LUNE_LUAU_FILE_NAME) .await?; } } // Generate docs file, if wanted if self.generate_docs_file { let defs_contents = read_to_string(LUNE_LUAU_FILE_NAME).await?; let docs_root = generate_docs_json_from_definitions(&defs_contents, "roblox/global")?; let docs_contents = serde_json::to_string_pretty(&docs_root)?; write(LUNE_DOCS_FILE_NAME, &docs_contents).await?; } if self.script_path.is_none() { // Only downloading types without running a script is completely // fine, and we should just exit the program normally afterwards // Same thing goes for generating the docs file if download_types_requested || self.generate_docs_file { return Ok(ExitCode::SUCCESS); } // HACK: We know that we didn't get any arguments here but since // script_path is optional clap will not error on its own, to fix // we will duplicate the cli command and make arguments required, // which will then fail and print out the normal help message let cmd = Cli::command(); cmd.arg_required_else_help(true).get_matches(); } // Parse and read the wanted file let file_path = find_parse_file_path(&self.script_path.unwrap())?; let file_contents = read_to_string(&file_path).await?; // Display the file path relative to cwd with no extensions in stack traces let file_display_name = file_path.with_extension("").display().to_string(); // Create a new lune object with all globals & run the script let lune = Lune::new().with_all_globals_and_args(self.script_args); let result = lune.run(&file_display_name, &file_contents).await; Ok(match result { Err(e) => { eprintln!("{e}"); ExitCode::FAILURE } Ok(code) => code, }) } }