python-dmon 0.2.2__tar.gz → 0.2.3__tar.gz

{python_dmon-0.2.2 → python_dmon-0.2.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: python-dmon
-Version: 0.2.2
+Version: 0.2.3
 Summary: A lightweight, cross-platform daemon manager that runs any command as a background process.
 Keywords: python-dmon,dmon,daemon,background,detach,process management
 Author: Atomie CHEN
@@ -41,10 +41,35 @@ It is a Python-based and more powerful successor to the [handy-backend shell scr
 
 ## Installation
 
+`python-dmon` is available on [PyPI](https://pypi.org/project/python-dmon/):
+
 ```sh
 pip install python-dmon
 ```
 
+We recommend installing into an isolated environment, e.g., with `uv` / `pipx`:
+
+```sh
+# Install globally with uv tool
+uv tool install python-dmon
+
+# Or with pipx
+pipx install python-dmon
+
+# Add as a dev dependency in your project
+uv add --dev python-dmon
+```
+
+You can also invoke without installing:
+
+```sh
+# With uvx (uv tool run)
+uvx python-dmon
+
+# Or with pipx
+pipx run python-dmon
+```
+
 To get the latest features, install from source:
 
 ```sh
@@ -70,7 +95,7 @@ app = ["python", "-u", "server.py"]
 ```
 
 Commands can be a single string (run in shell), or list of strings (exec form).
-See [Example Task Configuration](#example-task-configuration) for more configuration options.
+See [Example Configuration](#example-configuration) for more configuration options.
 
 
 ### Run tasks
@@ -91,7 +116,7 @@ dmon status app
 dmon exec app
 ```
 
-If only one task is defined in the config file, you can omit the task name:
+If you have defined `default_task`, or only one task is defined in the config file, you can omit the task name:
 
 ```sh
 dmon start
@@ -100,11 +125,12 @@ dmon status
 dmon exec
 ```
 
-You can use `--config` to specify a custom config file:
+You can use `--config` to specify a custom config file or the directory containing it:
 
 ```sh
 dmon start --config /path/to/dmon.yaml app  # YAML
 dmon start --config /path/to/pyproject.toml app  # or TOML
+dmon start --config /path/to/dir app  # dir with `dmon.y(a)ml` or `pyproject.toml`
 ```
 
 And yes, you can use `dmon` to run in a nested manner:
@@ -144,7 +170,7 @@ dmon list
 ```
 
 
-## Example Task Configuration
+## Example Configuration
 
 A task can be a **string**, **list**, or **dictionary**.
 
@@ -165,8 +191,23 @@ tasks:
     rotate_log_path: "logs/<task>.rotate.log"  # path to rotation log
     rotate_log_max_size: 5  # max rotation log file size in MB
     meta_path: ".dmon/<task>.meta.json"  # path to meta file
+default_task: your_task_name  # the default task name
 ```
 
+In TOML, write like this:
+
+```toml
+[tool.dmon.tasks]
+your_task_name = { cmd = [
+  "python", "-u", "server.py"
+], ... }
+another_task = "cd subdir && ls && bash start.sh"
+
+[tool.dmon]
+default_task = "your_task_name"
+```
+
+
 ## Under the Hood
 
 Each task is associated with a meta file (e.g. `.dmon/<task>.meta.json`) stored in the current working directory.

{python_dmon-0.2.2 → python_dmon-0.2.3}/README.md

@@ -23,10 +23,35 @@ It is a Python-based and more powerful successor to the [handy-backend shell scr
 
 ## Installation
 
+`python-dmon` is available on [PyPI](https://pypi.org/project/python-dmon/):
+
 ```sh
 pip install python-dmon
 ```
 
+We recommend installing into an isolated environment, e.g., with `uv` / `pipx`:
+
+```sh
+# Install globally with uv tool
+uv tool install python-dmon
+
+# Or with pipx
+pipx install python-dmon
+
+# Add as a dev dependency in your project
+uv add --dev python-dmon
+```
+
+You can also invoke without installing:
+
+```sh
+# With uvx (uv tool run)
+uvx python-dmon
+
+# Or with pipx
+pipx run python-dmon
+```
+
 To get the latest features, install from source:
 
 ```sh
@@ -52,7 +77,7 @@ app = ["python", "-u", "server.py"]
 ```
 
 Commands can be a single string (run in shell), or list of strings (exec form).
-See [Example Task Configuration](#example-task-configuration) for more configuration options.
+See [Example Configuration](#example-configuration) for more configuration options.
 
 
 ### Run tasks
@@ -73,7 +98,7 @@ dmon status app
 dmon exec app
 ```
 
-If only one task is defined in the config file, you can omit the task name:
+If you have defined `default_task`, or only one task is defined in the config file, you can omit the task name:
 
 ```sh
 dmon start
@@ -82,11 +107,12 @@ dmon status
 dmon exec
 ```
 
-You can use `--config` to specify a custom config file:
+You can use `--config` to specify a custom config file or the directory containing it:
 
 ```sh
 dmon start --config /path/to/dmon.yaml app  # YAML
 dmon start --config /path/to/pyproject.toml app  # or TOML
+dmon start --config /path/to/dir app  # dir with `dmon.y(a)ml` or `pyproject.toml`
 ```
 
 And yes, you can use `dmon` to run in a nested manner:
@@ -126,7 +152,7 @@ dmon list
 ```
 
 
-## Example Task Configuration
+## Example Configuration
 
 A task can be a **string**, **list**, or **dictionary**.
 
@@ -147,8 +173,23 @@ tasks:
     rotate_log_path: "logs/<task>.rotate.log"  # path to rotation log
     rotate_log_max_size: 5  # max rotation log file size in MB
     meta_path: ".dmon/<task>.meta.json"  # path to meta file
+default_task: your_task_name  # the default task name
 ```
 
+In TOML, write like this:
+
+```toml
+[tool.dmon.tasks]
+your_task_name = { cmd = [
+  "python", "-u", "server.py"
+], ... }
+another_task = "cd subdir && ls && bash start.sh"
+
+[tool.dmon]
+default_task = "your_task_name"
+```
+
+
 ## Under the Hood
 
 Each task is associated with a meta file (e.g. `.dmon/<task>.meta.json`) stored in the current working directory.

{python_dmon-0.2.2 → python_dmon-0.2.3}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "python-dmon"
-version = "0.2.2"
+version = "0.2.3"
 description = "A lightweight, cross-platform daemon manager that runs any command as a background process."
 readme = "README.md"
 authors = [
@@ -23,6 +23,7 @@ Changelog = "https://github.com/atomiechen/python-dmon/blob/main/CHANGELOG.md"
 
 [project.scripts]
 dmon = "dmon.__main__:main"
+python-dmon = "dmon.__main__:main"
 
 [build-system]
 requires = ["uv_build>=0.8.4,<0.9.0"]

{python_dmon-0.2.2 → python_dmon-0.2.3}/src/dmon/cli.py

@@ -191,7 +191,7 @@ def main():
     for sp in [sp_start, sp_stop, sp_restart, sp_status, sp_exec]:
         sp.add_argument(
             "--config",
-            help="Path to config file (YAML or TOML) (default: search from current directory upwards)",
+            help="Path to config file or the directory containing it (default: search from current directory upwards)",
         )
 
     args = parser.parse_args()

{python_dmon-0.2.2 → python_dmon-0.2.3}/src/dmon/config.py

@@ -10,6 +10,21 @@ else:
 from .types import CmdType, DmonTaskConfig
 
 
+def search_config(start_dir: Path, recursive: bool) -> Optional[Path]:
+    """
+    Search for dmon.yaml, dmon.yml, or pyproject.toml from the given directory upwards.
+    Return the path if found, None otherwise.
+    """
+    current = start_dir.resolve()
+    directories = [current] if not recursive else [current, *current.parents]
+    for parent in directories:
+        for filename in ["dmon.yaml", "dmon.yml", "pyproject.toml"]:
+            path = parent / filename
+            if path.is_file():
+                return path
+    return None
+
+
 def load_config(cfg_path: Optional[str] = None):
     """
     Load configuration from the given path, or search it from the current working directory upwards.
@@ -19,20 +34,20 @@ def load_config(cfg_path: Optional[str] = None):
         # Load configuration from the given path
         path = Path(cfg_path).resolve()
         if not path.exists():
-            raise FileNotFoundError(f"Config file '{path}' does not exist.")
+            raise FileNotFoundError(
+                f"Config file or directory '{path}' does not exist."
+            )
+        elif path.is_dir():
+            # If it's a directory, search for config files in it
+            result = search_config(path, recursive=False)
+            if not result:
+                raise FileNotFoundError(
+                    f"No dmon.yaml or pyproject.toml found in directory '{path}'."
+                )
+            path = result
     else:
-        # No path provided, search for config files
-        # starting from the current working directory upwards
-        current = Path.cwd().resolve()
-        path = None
-        for parent in [current, *current.parents]:
-            for filename in ["dmon.yaml", "dmon.yml", "pyproject.toml"]:
-                path = parent / filename
-                if path.is_file():
-                    break
-            else:
-                continue  # Only break out of the inner loop if a file was found
-            break  # Break out of the outer loop if a file was found
+        # No path provided, search from the current working directory upwards
+        path = search_config(Path.cwd(), recursive=True)
         if not path:
             raise FileNotFoundError(
                 "No dmon.yaml or pyproject.toml found in current or any parent directory."
@@ -154,6 +169,8 @@ def get_task_config(name: Optional[str], cfg_path: Optional[str]):
     if not isinstance(tasks, dict):
         raise TypeError("'tasks' must be a table")
 
+    name = name or cfg.get("default_task", None)
+
     if not name:
         if len(tasks) == 0:
             raise ValueError(f"No task found in {path}")