python-dmon 0.2.1__py3-none-any.whl → 0.2.3__py3-none-any.whl

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()

dmon/config.py

@@ -10,79 +10,60 @@ else:
 from .types import CmdType, DmonTaskConfig
 
 
-def find_pyproject_toml(start: Optional[Path] = None):
+def search_config(start_dir: Path, recursive: bool) -> Optional[Path]:
     """
-    Search for pyproject.toml from the current directory (or specified directory) upwards.
-    Return a Path object if found.
+    Search for dmon.yaml, dmon.yml, or pyproject.toml from the given directory upwards.
+    Return the path if found, None otherwise.
     """
-    start = start or Path.cwd()
-    current = start.resolve()
-
-    for parent in [current, *current.parents]:
-        candidate = parent / "pyproject.toml"
-        if candidate.is_file():
-            return candidate
-
-    # raise FileNotFoundError(f"No pyproject.toml found from {start} upwards.")
-
-
-def find_dmon_yaml(start: Optional[Path] = None):
-    """
-    Search for dmon.yaml / dmon.yml from the current directory (or specified directory) upwards.
-    Return a Path object if found.
-    """
-    start = start or Path.cwd()
-    current = start.resolve()
-
-    for parent in [current, *current.parents]:
-        for filename in ["dmon.yaml", "dmon.yml"]:
-            candidate = parent / filename
-            if candidate.is_file():
-                return candidate
-
-    # raise FileNotFoundError(f"No dmon.yaml or dmon.yml found from {start} upwards.")
+    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 for dmon.yaml or pyproject.toml.
+    Load configuration from the given path, or search it from the current working directory upwards.
     """
 
-    # Load configuration from the given path
     if cfg_path:
+        # Load configuration from the given path
         path = Path(cfg_path).resolve()
         if not path.exists():
-            raise FileNotFoundError(f"Config file '{path}' does not exist.")
-        if path.suffix in [".yaml", ".yml"]:
-            import yaml
-
-            with path.open("r", encoding="utf-8") as f:
-                cfg = yaml.safe_load(f)
-        elif path.suffix == ".toml":
-            with path.open("rb") as f:
-                cfg = tomllib.load(f)
-            cfg = cfg.get("tool", {}).get("dmon", {})
-        else:
-            raise ValueError("Config file must be YAML (.yaml/.yml) or TOML (.toml)")
-        return cfg, path
-
-    # No path provided, search for dmon.yaml first, then pyproject.toml
-    path = find_dmon_yaml()
-    if path:
-        import yaml
-
-        with path.open("r", encoding="utf-8") as f:
-            cfg = yaml.safe_load(f)
+            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:
-        path = find_pyproject_toml()
+        # 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."
             )
 
+    if path.suffix in [".yaml", ".yml"]:
+        import yaml
+
+        with path.open("r", encoding="utf-8") as f:
+            cfg = yaml.safe_load(f)
+    elif path.suffix == ".toml":
         with path.open("rb") as f:
             cfg = tomllib.load(f)
         cfg = cfg.get("tool", {}).get("dmon", {})
+    else:
+        raise ValueError("Config file must be YAML (.yaml/.yml) or TOML (.toml)")
     return cfg, path
 
 
@@ -188,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}")

dmon/control.py

@@ -525,14 +525,14 @@ def print_process_table(metas: List[DmonMeta], full_width: bool = False):
 
 def list_processes(dir: PathType, full_width: bool):
     target_dmon_dir = Path(dir).resolve()
-    metas = []
+    metas: List[DmonMeta] = []
     if target_dmon_dir.exists() and target_dmon_dir.is_dir():
         for meta_file in target_dmon_dir.glob(f"*{META_SUFFIX}"):
             meta = DmonMeta.load(meta_file)
             if meta is not None:
                 metas.append(meta)
     # sort by name (case-insensitive)
-    metas.sort(key=lambda m: m.name.lower())
+    metas.sort(key=lambda m: m.task.lower())
     n_task = len(metas)
     processes = print_process_table(metas, full_width)
     n_proc = len(processes)
@@ -557,6 +557,9 @@ def execute(cfg: DmonTaskConfig):
         env = {**os.environ, **cfg.env}
 
     shell = isinstance(cfg.cmd, str)
+    if ON_WINDOWS and isinstance(cfg.cmd, list) and len(cfg.cmd) > 0:
+        # On Windows, use full path for the executable when shell=False
+        cfg.cmd[0] = shutil.which(cfg.cmd[0]) or cfg.cmd[0]
 
     def signal_handler(signum: int, frame) -> None:
         if ON_WINDOWS and signum == signal.SIGINT:

{python_dmon-0.2.1.dist-info → python_dmon-0.2.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: python-dmon
-Version: 0.2.1
+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
@@ -86,14 +111,38 @@ dmon stop app
 
 # Check task status
 dmon status app
+
+# Execute a task in the foreground (useful for debugging)
+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
 dmon stop
 dmon status
+dmon exec
+```
+
+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:
+
+```yaml
+tasks:
+  app: ["python", "-u", "server.py"]
+  nested: pwd && dmon exec app  # nest `dmon exec`
+  subdir_task1:
+    cwd: /path/to/dir
+    cmd: ["dmon", "exec", "app"]  # run task defined in another folder
+  subdir_task2: dmon exec app --config /path/to/dir/dmon.yaml  # like above
 ```
 
 
@@ -121,7 +170,7 @@ dmon list
 ```
 
 
-## Example Task Configuration
+## Example Configuration
 
 A task can be a **string**, **list**, or **dictionary**.
 
@@ -142,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.1.dist-info → python_dmon-0.2.3.dist-info}/RECORD

@@ -1,14 +1,14 @@
 dmon/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 dmon/__main__.py,sha256=wu5N2wk8mvBgyvr2ghmQf4prezAe0_i-p123VVreyYc,62
-dmon/cli.py,sha256=Dqu43_hcsx8iCJXAL1YXqBpp1jFt0Y7qBEr9mYzkAn8,8764
-dmon/config.py,sha256=a7YM4U_iMB1wQ03NpWGAjbX-N-8Rdt9n6XTzKzeGZq4,7566
+dmon/cli.py,sha256=CdlgGTWWbTbJ-yz1Cct1EoJtaNGI3zs_3puoMRtrqbg,8780
+dmon/config.py,sha256=RXcQEgyXSmx_sIXzcrMnc_XkyV0uc20MEv5DTNxFHrw,7204
 dmon/constants.py,sha256=uJPI66IJvT6vhamqEDeqHjZQS12RxCPe3DD5yCU0UR8,407
-dmon/control.py,sha256=u1sz2MtxHHDqsaFyc7QaG7HFPLnAkser_8riTYxFK1A,17276
+dmon/control.py,sha256=KpGNPPsuAsDNX3FTJxnGNnt9f4Q18omvG42zO1CwTy4,17494
 dmon/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 dmon/runner.py,sha256=iyotNIrbO6I_u02EcqwO7R7N3BEBP6b_8eL8yb3zeJQ,6082
 dmon/types.py,sha256=tTVoJzWk-Z8XiZCUt0VE8Z7-URpXMoS54HfVYXhW-0Q,1795
 dmon/utils.py,sha256=zVQC9YNhMQu4hrAp9k2ds2egnbWZZv7S5w8i2oVIPJg,808
-python_dmon-0.2.1.dist-info/WHEEL,sha256=eh7sammvW2TypMMMGKgsM83HyA_3qQ5Lgg3ynoecH3M,79
-python_dmon-0.2.1.dist-info/entry_points.txt,sha256=rad5ugz4K_IyNXS_IrFPu0tS-UXlBCSJRhJv-OWd_yk,45
-python_dmon-0.2.1.dist-info/METADATA,sha256=gIMrWHILmOEnjtU-gZAoYdz8JAOxFYibkos4DYs_ba0,4496
-python_dmon-0.2.1.dist-info/RECORD,,
+python_dmon-0.2.3.dist-info/WHEEL,sha256=eh7sammvW2TypMMMGKgsM83HyA_3qQ5Lgg3ynoecH3M,79
+python_dmon-0.2.3.dist-info/entry_points.txt,sha256=1XmEpyjShANXEHMIMa4p3WXpcllIZfGt5DQyTFuSI74,78
+python_dmon-0.2.3.dist-info/METADATA,sha256=7k6z_ZfbmzpHEAiUKY_O0MQVwkEuWE53PLPz1Th66wA,5984
+python_dmon-0.2.3.dist-info/RECORD,,

{python_dmon-0.2.1.dist-info → python_dmon-0.2.3.dist-info}/entry_points.txt

@@ -1,3 +1,4 @@
 [console_scripts]
 dmon = dmon.__main__:main
+python-dmon = dmon.__main__:main