Roland Thomas
5d8f3aa603
- add CommandExecutor to unify shared command execution lifecycle across Falyx and standalone command execution - add CommandRunner for running a single Command directly as a CLI or programmatic entrypoint - add Command.build() factory and rename parse_args() to resolve_args() to clarify the parsing-to-execution boundary - introduce ExecutionOption and wire execution-scoped flags into CommandArgumentParser and Command construction - refactor Falyx to use FalyxParser/ParseResult and CommandExecutor instead of the older argparse-based flow and run_key path - simplify __main__.py bootstrap by building a bootstrap Falyx instance directly and running flx.run() - improve completer support for preview commands and unique-prefix command resolution - default BottomBar toggle namespace to "default" - expand module/class docstrings to reflect the new execution architecture
88 lines
2.1 KiB
Python
88 lines
2.1 KiB
Python
"""
|
|
Falyx CLI Framework
|
|
|
|
Copyright (c) 2025 rtj.dev LLC.
|
|
Licensed under the MIT License. See LICENSE file for details.
|
|
"""
|
|
|
|
import asyncio
|
|
import os
|
|
import sys
|
|
from pathlib import Path
|
|
from typing import Any
|
|
|
|
from falyx.config import loader
|
|
from falyx.falyx import Falyx
|
|
from falyx.parser import CommandArgumentParser
|
|
|
|
|
|
def find_falyx_config() -> Path | None:
|
|
candidates = [
|
|
Path.cwd() / "falyx.yaml",
|
|
Path.cwd() / "falyx.toml",
|
|
Path.cwd() / ".falyx.yaml",
|
|
Path.cwd() / ".falyx.toml",
|
|
Path(os.environ.get("FALYX_CONFIG", "falyx.yaml")),
|
|
Path.home() / ".config" / "falyx" / "falyx.yaml",
|
|
Path.home() / ".config" / "falyx" / "falyx.toml",
|
|
Path.home() / ".falyx.yaml",
|
|
Path.home() / ".falyx.toml",
|
|
]
|
|
return next((p for p in candidates if p.exists()), None)
|
|
|
|
|
|
def bootstrap() -> Path | None:
|
|
config_path = find_falyx_config()
|
|
if config_path and str(config_path.parent) not in sys.path:
|
|
sys.path.insert(0, str(config_path.parent))
|
|
return config_path
|
|
|
|
|
|
def init_config(parser: CommandArgumentParser) -> None:
|
|
parser.add_argument(
|
|
"name",
|
|
type=str,
|
|
help="Name of the new Falyx project",
|
|
default=".",
|
|
nargs="?",
|
|
)
|
|
|
|
|
|
def build_bootstrap_falyx() -> Falyx:
|
|
from falyx.init import init_global, init_project
|
|
|
|
flx = Falyx()
|
|
|
|
flx.add_command(
|
|
"I",
|
|
"Initialize a new Falyx project",
|
|
init_project,
|
|
aliases=["init"],
|
|
argument_config=init_config,
|
|
help_epilog="If no name is provided, the current directory will be used.",
|
|
)
|
|
flx.add_command(
|
|
"G",
|
|
"Initialize Falyx global configuration",
|
|
init_global,
|
|
aliases=["init-global"],
|
|
help_text="Create a global Falyx configuration at ~/.config/falyx/.",
|
|
)
|
|
return flx
|
|
|
|
|
|
def build_falyx() -> Falyx:
|
|
bootstrap_path = bootstrap()
|
|
if bootstrap_path:
|
|
return loader(bootstrap_path)
|
|
return build_bootstrap_falyx()
|
|
|
|
|
|
def main() -> Any:
|
|
flx = build_falyx()
|
|
return asyncio.run(flx.run())
|
|
|
|
|
|
if __name__ == "__main__":
|
|
main()
|