Eliteforge New Java Biz Package

interface:
  display_name: "Java 业务包骨架"
  short_description: "创建或补齐 Java 业务包目录骨架并对齐仓库分层规范"
  default_prompt: "使用 $eliteforge-new-java-biz-package 为当前仓库创建一个 Java 业务包目录骨架。"

#!/usr/bin/env python3
"""Scaffold a Java business-package directory layout."""

from __future__ import annotations

import argparse
from pathlib import Path

CONTROLLER_DIRS = ("api", "innerapi", "openapi")

COMMON_DIRS = (
    "docs",
    "domain",
    "model/converter",
    "model/dto",
    "model/enums",
    "model/entity",
    "model/record",
    "model/vo",
    "repository/impl",
    "repository/mapper",
    "service/impl",
    "util",
)

KEEP_FILES = (
    ".gitkeep",
    "repository/.gitkeep",
    "service/.gitkeep",
)


def parse_args() -> argparse.Namespace:
    """Parse command-line arguments."""
    parser = argparse.ArgumentParser(
        description="Create a Java business-package directory layout.",
    )
    parser.add_argument(
        "target_dir",
        help="Business-package root directory to create or complete.",
    )
    parser.add_argument(
        "--dry-run",
        action="store_true",
        help="Print planned changes without touching the filesystem.",
    )
    return parser.parse_args()


def build_layout(
    target_dir: Path,
) -> tuple[list[Path], list[Path]]:
    """Build directory and file creation plans."""
    directories = [target_dir]
    directories.extend(target_dir / "controller" / name for name in CONTROLLER_DIRS)
    directories.extend(target_dir / relative for relative in COMMON_DIRS)

    files = [target_dir / relative for relative in KEEP_FILES]
    return directories, files


def ensure_dir(path: Path, dry_run: bool) -> str:
    """Create a directory if needed."""
    if path.exists():
        return f"exists dir  {path}"
    if dry_run:
        return f"create dir  {path}"
    path.mkdir(parents=True, exist_ok=True)
    return f"create dir  {path}"


def ensure_file(path: Path, dry_run: bool) -> str:
    """Create a keep file if needed."""
    if path.exists():
        return f"exists file {path}"
    if dry_run:
        return f"create file {path}"
    path.parent.mkdir(parents=True, exist_ok=True)
    path.touch(exist_ok=True)
    return f"create file {path}"


def main() -> int:
    """Program entry."""
    args = parse_args()
    target_dir = Path(args.target_dir).expanduser().resolve()
    directories, files = build_layout(
        target_dir=target_dir,
    )

    print(f"target: {target_dir}")
    print(f"controller_dirs: {', '.join(CONTROLLER_DIRS)}")
    print("docs: create")
    print("util: create")
    print(f"mode: {'dry-run' if args.dry_run else 'apply'}")

    for directory in directories:
        print(ensure_dir(directory, args.dry_run))

    for file_path in files:
        print(ensure_file(file_path, args.dry_run))

    return 0


if __name__ == "__main__":
    raise SystemExit(main())