python-dmon 0.2.2__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,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}")

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

@@ -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.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=Q8TvcYDwUTlL_8bcjxVsA-lLE_AlcSmxYpbnMaCkFrw,6650
+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=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.2.dist-info/WHEEL,sha256=eh7sammvW2TypMMMGKgsM83HyA_3qQ5Lgg3ynoecH3M,79
-python_dmon-0.2.2.dist-info/entry_points.txt,sha256=rad5ugz4K_IyNXS_IrFPu0tS-UXlBCSJRhJv-OWd_yk,45
-python_dmon-0.2.2.dist-info/METADATA,sha256=tncJt5ouNhwjFYaGHEKEQgxas34QDLW6IRY1Qd2bO6g,5106
-python_dmon-0.2.2.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.2.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