use std::{
env,
ffi::OsString,
io::{self, IsTerminal, Write},
path::PathBuf,
process::{Command, ExitCode},
};
use phoenix_cli::{
ControllerOptions, DependencySource, DevConfig, DevSupervisor, GenerateOptions, ModelOptions,
NewProjectOptions, ProjectDatabase, ProjectFrontend, ProjectGenerator, ProjectRenderMode,
UpdateProjectOptions, create_project, release_build, release_install, release_rollback,
release_status,
};
const HELP: &str = r"Phoenix-rs application CLI (px)
Install: cargo install px-cli
cargo install --git https://github.com/MageGojo/Phoenix-rs px-cli
cargo install --path crates/phoenix-cli
Usage:
px new [project] [--render-mode islands|spa|ssr] [--database sqlite|pgsql|mysql|all]
[--tailwind] [--git] [--frontend tsx|jsx]
[--framework-path <path>] [--no-install] [--no-git]
px update [--framework-path <path>] [--no-install] [--dry-run]
px dev
px migrate
px status
px rollback [--step <count>]
px fresh [--seed]
px seed
px make:controller <name> [--resource] [--route] [--force]
px make:model <name> [--all] [--migration] [--controller] [--resource]
[--request] [--api-resource] [--page] [--force]
px make:migration <name> [--force]
px make:request <name> [--force]
px make:resource <name> [--force]
px make:middleware <name> [--force]
px make:page <path> [--force]
px make:island <name> [--force]
px make:command <name> [--force]
px list
px release [--version <v>] [--output <dir>] [--tarball] [--bin <name>]
[--skip-npm] [--skip-types] [--target <triple>]
px release:install --tarball <path> | --path <dir> [--deploy-root <dir>]
[--version <v>] [--skip-migrate] [--no-switch]
[--restart-cmd <shell>] [--dry-run]
px release:rollback [--deploy-root <dir>] [--to <version>] [--steps <n>]
[--restart-cmd <shell>] [--skip-restart] [--dry-run]
px release:status [--deploy-root <dir>] [--json]
Examples:
px new my-app
px update
px migrate
px rollback --step 2
px fresh --seed
px make:model Post --all
px make:controller Admin/ReportController --resource
px make:page posts/index
px make:command Update
px release --version 0.1.0 --tarball
px release:install --tarball ./app-0.1.0.tar.gz --version 0.1.0
px release:status
";
#[tokio::main]
async fn main() -> ExitCode {
match run(env::args_os().skip(1).collect()).await {
Ok(()) => ExitCode::SUCCESS,
Err(error) => {
eprintln!("px failed: {error}");
ExitCode::FAILURE
}
}
}
async fn run(raw: Vec<OsString>) -> Result<(), String> {
let mut arguments = raw
.into_iter()
.map(|argument| {
argument
.into_string()
.map_err(|_| "arguments must be valid UTF-8".to_owned())
})
.collect::<Result<Vec<_>, _>>()?;
if arguments.is_empty() || matches!(arguments[0].as_str(), "help" | "--help" | "-h") {
print!("{HELP}");
return Ok(());
}
let command = arguments.remove(0);
match command.as_str() {
"dev" => dev(arguments).await,
"new" => new_project(arguments),
"update" => update_project(arguments),
"migrate" => database_command("migrate", &no_options(&arguments)?),
"status" => database_command("status", &no_options(&arguments)?),
"rollback" => database_command("rollback", &rollback_options(&arguments)?),
"fresh" => database_command("fresh", &fresh_options(&arguments)?),
"seed" => database_command("seed", &no_options(&arguments)?),
"make:controller" => make_controller(arguments),
"make:model" => make_model(arguments),
"make:migration" => make_simple(arguments, |generator, name, options| {
generator.migration(name, options)
}),
"make:request" => make_simple(arguments, |generator, name, options| {
generator.request(name, options)
}),
"make:resource" => make_simple(arguments, |generator, name, options| {
generator.resource(name, options)
}),
"make:middleware" => make_simple(arguments, |generator, name, options| {
generator.middleware(name, options)
}),
"make:page" => make_simple(arguments, |generator, name, options| {
generator.page(name, options)
}),
"make:island" => make_simple(arguments, |generator, name, options| {
generator.island(name, options)
}),
"make:command" => make_simple(arguments, |generator, name, options| {
generator.command(name, options)
}),
"list" => {
require_empty(&arguments)?;
print!("{HELP}");
Ok(())
}
"release" | "release:build" => release_build(arguments),
"release:install" => release_install(arguments),
"release:rollback" => release_rollback(arguments),
"release:status" => release_status(arguments),
_ => Err(format!("unknown command `{command}`\n\n{HELP}")),
}
}
async fn dev(arguments: Vec<String>) -> Result<(), String> {
require_empty(&arguments)?;
let generator = current_generator()?;
if !generator.root().join("node_modules").is_dir() {
return Err("JavaScript dependencies are missing; run `npm install` first".to_owned());
}
println!("Phoenix development environment");
println!(" application: {}", generator.root().display());
println!(" build: npm run build:client && npm run build:ssr (automatic)");
println!(" backend: cargo run -- serve (restarts after Rust/React changes)");
println!(" frontend: npm run dev -- --strictPort");
println!("Press Ctrl-C to stop both processes.\n");
DevSupervisor::new(DevConfig::default().working_directory(generator.root()))
.run()
.await
.map_err(|error| error.to_string())
}
fn database_command(command: &str, arguments: &[String]) -> Result<(), String> {
let generator = current_generator()?;
let manager = generator.root().join("src/bin/phoenix-manage.rs");
if !manager.is_file() {
return Err(format!(
"{} is missing; add the Phoenix management binary before running database commands",
manager.display()
));
}
let cargo = env::var_os("CARGO").unwrap_or_else(|| OsString::from("cargo"));
let status = Command::new(cargo)
.args(["run", "--quiet", "--bin", "phoenix-manage", "--", command])
.args(arguments)
.current_dir(generator.root())
.status()
.map_err(|error| format!("failed to start the project management binary: {error}"))?;
if status.success() {
Ok(())
} else {
Err(format!(
"project management command `{command}` exited with {status}"
))
}
}
fn no_options(arguments: &[String]) -> Result<Vec<String>, String> {
require_empty(arguments)?;
Ok(Vec::new())
}
fn rollback_options(arguments: &[String]) -> Result<Vec<String>, String> {
let mut steps = 1_usize;
let mut index = 0;
while index < arguments.len() {
let argument = &arguments[index];
if argument == "--step" {
index += 1;
let value = arguments.get(index).ok_or("--step requires a count")?;
steps = parse_steps(value)?;
} else if let Some(value) = argument.strip_prefix("--step=") {
steps = parse_steps(value)?;
} else {
return Err(format!("unknown rollback option `{argument}`"));
}
index += 1;
}
Ok(vec![steps.to_string()])
}
fn parse_steps(value: &str) -> Result<usize, String> {
value
.parse::<usize>()
.ok()
.filter(|steps| *steps > 0)
.ok_or_else(|| "rollback step count must be a positive integer".to_owned())
}
fn fresh_options(arguments: &[String]) -> Result<Vec<String>, String> {
match arguments {
[] => Ok(Vec::new()),
[option] if option == "--seed" => Ok(vec![option.clone()]),
[option] => Err(format!("unknown fresh option `{option}`")),
_ => Err(format!("unexpected arguments: {}", arguments.join(" "))),
}
}
fn new_project(mut arguments: Vec<String>) -> Result<(), String> {
let target = if arguments
.first()
.is_some_and(|argument| !argument.starts_with('-'))
{
arguments.remove(0)
} else {
prompt_name()?
};
let flags = arguments;
let mut options = NewProjectOptions::new(&target);
let interactive = io::stdin().is_terminal();
let mut render_mode_set = false;
let mut database_set = false;
let mut tailwind_set = false;
let mut git_set = false;
let mut frontend_set = false;
let mut index = 0;
while index < flags.len() {
match flags[index].as_str() {
"--no-install" => options.install_dependencies = false,
"--no-git" => {
options.initialize_git = false;
git_set = true;
}
"--git" => {
options.initialize_git = true;
git_set = true;
}
"--tailwind" | "--tailwindcss" => {
options.tailwind = true;
tailwind_set = true;
}
"--no-tailwind" => {
options.tailwind = false;
tailwind_set = true;
}
"--render-mode" => {
index += 1;
let value = flags.get(index).ok_or("--render-mode requires a value")?;
options.render_mode = value.parse::<ProjectRenderMode>()?;
render_mode_set = true;
}
"--database" => {
index += 1;
let value = flags.get(index).ok_or("--database requires a value")?;
options.database = Some(value.parse::<ProjectDatabase>()?);
database_set = true;
}
"--no-database" => {
options.database = None;
database_set = true;
}
"--frontend" => {
index += 1;
let value = flags.get(index).ok_or("--frontend requires a value")?;
options.frontend = value.parse::<ProjectFrontend>()?;
frontend_set = true;
}
"--framework-path" => {
index += 1;
let path = flags.get(index).ok_or("--framework-path requires a path")?;
options.dependencies = DependencySource::Local(PathBuf::from(path));
}
flag => return Err(format!("unknown new-project option `{flag}`")),
}
index += 1;
}
if interactive {
println!();
println!("交互配置：输入序号后回车；直接回车 = 保留默认项（标了 ← 默认）。");
println!();
if !render_mode_set {
options.render_mode = prompt_render_mode()?;
}
if !database_set {
options.database = prompt_database()?;
}
if !tailwind_set {
options.tailwind = prompt_yes_no(
"Tailwind CSS",
&[
("0", "否", "不用 Tailwind，仅普通 CSS", true),
("1", "是", "启用 Tailwind CSS v4（@tailwindcss/vite）", false),
],
false,
)?;
}
if !git_set {
options.initialize_git = prompt_yes_no(
"初始化 Git",
&[
("0", "否", "不执行 git init", true),
("1", "是", "在新项目里执行 git init", false),
],
false,
)?;
}
if !frontend_set {
options.frontend = prompt_frontend()?;
}
}
create_project(&options).map_err(|error| error.to_string())?;
println!(
"Created Phoenix application at {}",
options.target.display()
);
println!("Next: cd {} && px dev", options.target.display());
Ok(())
}
fn update_project(arguments: Vec<String>) -> Result<(), String> {
let mut options = UpdateProjectOptions::new();
let mut index = 0;
while index < arguments.len() {
match arguments[index].as_str() {
"--no-install" => options.install_dependencies = false,
"--dry-run" => options.dry_run = true,
"--framework-path" => {
index += 1;
let path = arguments
.get(index)
.ok_or("--framework-path requires a path")?;
options.dependencies = DependencySource::Local(PathBuf::from(path));
}
flag => return Err(format!("unknown update option `{flag}`")),
}
index += 1;
}
let generator = current_generator()?;
let changed = generator
.update_core(&options)
.map_err(|error| error.to_string())?;
if changed.is_empty() {
println!("Core files already up to date at {}", generator.root().display());
return Ok(());
}
let label = if options.dry_run { "WOULD UPDATE" } else { "UPDATED" };
for path in &changed {
println!(
"{label} {}",
path.strip_prefix(generator.root())
.unwrap_or(path)
.display()
);
}
if options.dry_run {
println!("Dry run only; re-run without --dry-run to apply.");
} else {
println!(
"Updated Phoenix core files in {} (business code left untouched).",
generator.root().display()
);
}
Ok(())
}
fn prompt_name() -> Result<String, String> {
println!("── 项目名称");
println!(" 将作为目录名 / Cargo 包名（字母、数字、短横线）。");
println!();
let name = prompt_input(None)?;
if name.is_empty() {
return Err("必须填写项目名；也可直接：px new my-app".to_owned());
}
Ok(name)
}
fn prompt_render_mode() -> Result<ProjectRenderMode, String> {
match prompt_menu(
"渲染模式",
"决定 React 页面如何交付到浏览器。",
&[
(
"0",
"Islands",
"岛屿水合：默认推荐，按需激活组件",
true,
),
("1", "SPA", "纯客户端壳：首屏由浏览器接管路由", false),
("2", "SSR", "全量服务端渲染：每次请求出完整 HTML", false),
],
"0",
)?
.as_str()
{
"0" | "islands" | "island" => Ok(ProjectRenderMode::Islands),
"1" | "spa" => Ok(ProjectRenderMode::Spa),
"2" | "ssr" => Ok(ProjectRenderMode::Ssr),
_ => Err("请输入 0 / 1 / 2，或 islands / spa / ssr".to_owned()),
}
}
fn prompt_database() -> Result<Option<ProjectDatabase>, String> {
match prompt_menu(
"数据库",
"可选；选中后才会写入 Toasty 依赖、配置与迁移脚手架。",
&[
("0", "无", "不带数据库（体积最小，默认可发版）", true),
("1", "SQLite", "本地文件库，零配置上手", false),
("2", "PostgreSQL", "启用 pgsql 驱动 feature", false),
("3", "MySQL", "启用 mysql / MariaDB 驱动 feature", false),
("4", "全部", "同时编译 sqlite+pgsql+mysql（二进制更大）", false),
],
"0",
)?
.as_str()
{
"0" | "none" | "no" | "n" | "无" => Ok(None),
"1" | "sqlite" => Ok(Some(ProjectDatabase::Sqlite)),
"2" | "pgsql" | "postgres" | "postgresql" => Ok(Some(ProjectDatabase::Pgsql)),
"3" | "mysql" | "mariadb" => Ok(Some(ProjectDatabase::Mysql)),
"4" | "all" | "全部" => Ok(Some(ProjectDatabase::All)),
_ => Err("请输入 0–4，或 none / sqlite / pgsql / mysql / all".to_owned()),
}
}
fn prompt_frontend() -> Result<ProjectFrontend, String> {
match prompt_menu(
"React 源码格式",
"页面与 island 文件扩展名。",
&[
("0", "TSX", "TypeScript + JSX（推荐）", true),
("1", "JSX", "JavaScript + JSX", false),
],
"0",
)?
.as_str()
{
"0" | "tsx" | "ts" => Ok(ProjectFrontend::Tsx),
"1" | "jsx" | "js" => Ok(ProjectFrontend::Jsx),
_ => Err("请输入 0 / 1，或 tsx / jsx".to_owned()),
}
}
fn prompt_yes_no(
title: &str,
choices: &[(&str, &str, &str, bool)],
default: bool,
) -> Result<bool, String> {
let default_key = if default { "1" } else { "0" };
match prompt_menu(title, "", choices, default_key)?.as_str() {
"0" | "n" | "no" | "否" => Ok(false),
"1" | "y" | "yes" | "是" => Ok(true),
_ => Err("请输入 0 / 1，或 y / n".to_owned()),
}
}
fn prompt_menu(
title: &str,
blurb: &str,
choices: &[(&str, &str, &str, bool)],
default_key: &str,
) -> Result<String, String> {
println!("── {title}");
if !blurb.is_empty() {
println!(" {blurb}");
}
println!(" 默认项: {default_key} （直接回车即选此项）");
println!();
for (key, label, help, is_default) in choices {
let mark = if *is_default { " ← 默认" } else { "" };
println!(" {key}) {label:<12} — {help}{mark}");
}
println!();
prompt_input(Some(default_key))
}
fn prompt_input(default: Option<&str>) -> Result<String, String> {
print!("> ");
io::stdout().flush().map_err(|error| error.to_string())?;
let mut line = String::new();
io::stdin()
.read_line(&mut line)
.map_err(|error| error.to_string())?;
let trimmed = line.trim();
Ok(if trimmed.is_empty() {
default.unwrap_or_default().to_owned()
} else {
trimmed.to_ascii_lowercase()
})
}
fn make_controller(arguments: Vec<String>) -> Result<(), String> {
let (name, flags) = required_name(arguments)?;
let mut options = ControllerOptions::default();
for flag in flags {
match flag.as_str() {
"--resource" | "-r" => {
options.resource = true;
options.route = true;
}
"--route" => options.route = true,
"--force" | "-f" => options.force = true,
_ => return Err(format!("unknown controller option `{flag}`")),
}
}
let generator = current_generator()?;
let written = generator
.controller(&name, options)
.map_err(|error| error.to_string())?;
finish_generation(&generator, &written)
}
fn make_model(arguments: Vec<String>) -> Result<(), String> {
let (name, flags) = required_name(arguments)?;
let mut options = ModelOptions::default();
for flag in flags {
match flag.as_str() {
"--all" | "-a" => options.all = true,
"--migration" | "-m" => options.migration = true,
"--controller" | "-c" => options.controller = true,
"--resource" | "-r" => {
options.controller = true;
options.resource_controller = true;
}
"--request" => options.request = true,
"--api-resource" => options.api_resource = true,
"--page" => options.page = true,
"--force" | "-f" => options.force = true,
_ => return Err(format!("unknown model option `{flag}`")),
}
}
let generator = current_generator()?;
let written = generator
.model(&name, options)
.map_err(|error| error.to_string())?;
finish_generation(&generator, &written)
}
fn make_simple<F>(arguments: Vec<String>, generate: F) -> Result<(), String>
where
F: FnOnce(
&ProjectGenerator,
&str,
GenerateOptions,
) -> Result<Vec<PathBuf>, phoenix_cli::ScaffoldError>,
{
let (name, flags) = required_name(arguments)?;
let mut options = GenerateOptions::default();
for flag in flags {
match flag.as_str() {
"--force" | "-f" => options.force = true,
_ => return Err(format!("unknown generator option `{flag}`")),
}
}
let generator = current_generator()?;
let written = generate(&generator, &name, options).map_err(|error| error.to_string())?;
finish_generation(&generator, &written)
}
fn required_name(mut arguments: Vec<String>) -> Result<(String, Vec<String>), String> {
if arguments.is_empty() {
return Err("this command requires a name".to_owned());
}
let name = arguments.remove(0);
if name.starts_with('-') {
return Err("the generated artifact name must come before options".to_owned());
}
Ok((name, arguments))
}
fn current_generator() -> Result<ProjectGenerator, String> {
let current = env::current_dir().map_err(|error| error.to_string())?;
ProjectGenerator::discover(current).map_err(|error| error.to_string())
}
fn print_written(generator: &ProjectGenerator, paths: &[PathBuf]) {
for path in paths {
println!(
"WROTE {}",
path.strip_prefix(generator.root())
.unwrap_or(path)
.display()
);
}
}
fn finish_generation(generator: &ProjectGenerator, paths: &[PathBuf]) -> Result<(), String> {
print_written(generator, paths);
if generator
.refresh_types()
.map_err(|error| error.to_string())?
{
println!("REFRESHED views/generated contracts and routes");
} else {
println!("Type files will refresh automatically after npm install or px dev");
}
Ok(())
}
fn require_empty(arguments: &[String]) -> Result<(), String> {
if arguments.is_empty() {
Ok(())
} else {
Err(format!("unexpected arguments: {}", arguments.join(" ")))
}
}