On this page
Run and manage the file-driven development environment
#fastware dev
Run and manage the file-driven development environment
#dev run
Start the dev environment by reading [tool.fastware.dev] from the nearest pyproject.toml, running pre-spawn gates to check prerequisites, launching auxiliary services and the Vite frontend dev server, wrapping the ASGI app with ViteDevProxy for backend-first routing, and starting the Granian server in the foreground by default
Effect: mutating
#Flags
| Name | Short | Type | Presence | Env | Description |
|---|---|---|---|---|---|
--daemon, --no-daemon | bool | optional | Detach and run the dev environment in the background, registering it in the instance registry (query with 'dev status', stop with 'dev stop'). When neither --daemon nor --no-daemon is passed, the dev environment runs in the foreground and blocks until Ctrl+C. | ||
--grace | int | optional | Seconds to wait for a component to stop gracefully before SIGKILL. When the flag is not passed, 10 seconds is used. |
#dev status
List all running fastware dev environments registered in the instance registry, showing the instance name, process ID, and port for each entry. Instances register when started with --daemon and are automatically removed when they exit or are stopped with dev stop
Effect: mutating
#dev stop
Stop all running dev environments by sending SIGTERM for a graceful shutdown. If a process does not exit within the grace period (default 10 seconds, configurable with --grace), it is forcibly terminated with SIGKILL. Stopped instances are removed from the instance registry
Effect: mutating
#Flags
| Name | Short | Type | Presence | Env | Description |
|---|---|---|---|---|---|
--grace | int | optional | Seconds to wait for a dev environment to stop gracefully before SIGKILL. When the flag is not passed, 10 seconds is used. |