djangoplay-cli 1.0.0__py3-none-any.whl

djangoplay_cli-1.0.0.dist-info/METADATA

@@ -0,0 +1,10 @@
+Metadata-Version: 2.4
+Name: djangoplay-cli
+Version: 1.0.0
+Summary: CLI tools for DjangoPlay developers. 'djangoplay-cli' provides a lightweight command-line interface for developers working on the 'DjangoPlay ecosystem'.
+Requires-Python: >=3.11
+License-File: LICENSE
+Requires-Dist: typer>=0.9
+Requires-Dist: rich>=13
+Requires-Dist: pyyaml>=6.0
+Dynamic: license-file

djangoplay_cli-1.0.0.dist-info/RECORD

@@ -0,0 +1,29 @@
+djangoplay_cli-1.0.0.dist-info/licenses/LICENSE,sha256=GLJEF-NBZTCkIR0TUMpun47uhcMBy3xFLAT3bhSt5hA,1091
+dplay/__init__.py,sha256=GUmte5vPzPopdUowmGLKJcGSzQJelYiKwEx293xyQEg,123
+dplay/cli.py,sha256=6CMNJk7yDy4YmW3Cu9yk-166mbKuOTDdsJb8rpHtIeg,2725
+dplay/commands/__init__.py,sha256=uzPlh23O3s_Ej9r0QLr-ePJvp4BrS0Pnsv0UA3gZOxo,316
+dplay/commands/dev/__init__.py,sha256=Avwl4U1Nkyejc5dd-a5lC1uNGc3L1IB6FXtE8MIfYGs,718
+dplay/commands/dev/down.py,sha256=1r2VKDgJ1YTAngnktub6xlnhBdt7I7p9w77ibdNL74k,416
+dplay/commands/dev/http.py,sha256=bkTHtmGIwzAZa67oYLL7EyVbfPw9BpCZ_o2x8qG9ibA,961
+dplay/commands/dev/logs.py,sha256=t29RgZ6-6qRlemnzy23dnZsdJXhY_YJMWUKuKwpPXiA,292
+dplay/commands/dev/ssl.py,sha256=LgZJmInwfZ5-7iqhR981qNAcTQxLe7xuxwhFwXhjxvs,1056
+dplay/commands/dev/up.py,sha256=xsBakFQ5YsJQ7rvw-TKY86NZKYW_uYhuvWe5LQnb3tk,547
+dplay/commands/dev/worker.py,sha256=cnoLGvdTT5ftdpwoi7eJ9y4xW5IaIAMkKzawS4TcXwg,546
+dplay/commands/system/__init__.py,sha256=N6giylwo5seyiv0AC_yvEohrOayrdPXV2wzaphAumA0,42
+dplay/commands/system/doctor.py,sha256=kL-unHtdvfvR9LIohCR9ddQ0hNa65F3_8d7SJ-EKxyM,699
+dplay/commands/system/reset.py,sha256=8nb_lkB3aBjUGLBf9tV1w126FXMJF0CvmnzQVeiOT7A,779
+dplay/core/__init__.py,sha256=vWXi1-Ij3kTYUwN1XU0ag9FVOzo91PyNy5sAO65fCIg,277
+dplay/core/config_loader.py,sha256=qHqyRBX5W-vKvqAqhFIsdaDoaD73m9v45U_LNLmZ-Iw,1247
+dplay/core/process_manager.py,sha256=T_ufAOkXnDnAMo_uG6QS9ti-19lQzao3qTprJL81Qb0,886
+dplay/core/repo_detector.py,sha256=TFRZ_m-8mouTLU7VSyHzlGOKAKFNqqzgCaN1WR-ZAe4,890
+dplay/environment/__init__.py,sha256=TkR95dCBFa2qkJtgoNj6SCI1-l-qXy0tRRBO-8jftHs,307
+dplay/environment/diagnostics.py,sha256=ROdmnAp0-in8br8I49l72t9GZYlSIhkezRDZhHXR--o,2089
+dplay/environment/venv_detector.py,sha256=2CzOh35KipDOHLwdonbQG67IbX1MNxvBhtLQtED2OoY,526
+dplay/utils/__init__.py,sha256=GrLowM1HNEFoMsBNlyk6cFugmllsamloS6R0ytwoLXg,191
+dplay/utils/dev_startup.py,sha256=DyjQ7-bt6fgItq5L6aXgWuPYt2BED--ZCKz_41Iiq94,1576
+dplay/utils/subprocess_utils.py,sha256=96rzSMQz4GmZvQinM46EAvtVdfQQExYnojgh6O3GnTE,68
+djangoplay_cli-1.0.0.dist-info/METADATA,sha256=mGbQ3N2dfKmox-xgLEJ5BEN-5pVPtbkMIVxkGagBSqA,366
+djangoplay_cli-1.0.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+djangoplay_cli-1.0.0.dist-info/entry_points.txt,sha256=ECAidkbZn6XuAeH0yxrB8S326pRBGpMj9EGV46Bilok,41
+djangoplay_cli-1.0.0.dist-info/top_level.txt,sha256=IC9uHIzHrULkJq7PH4tRaKIBybQwng00VbDa509v0is,6
+djangoplay_cli-1.0.0.dist-info/RECORD,,

djangoplay_cli-1.0.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

djangoplay_cli-1.0.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+dplay = dplay.cli:main

djangoplay_cli-1.0.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 binaryfleet chandrashekhar-bhosale
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

djangoplay_cli-1.0.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+dplay

dplay/__init__.py

@@ -0,0 +1,8 @@
+"""
+DjangoPlay CLI package.
+
+This package provides developer tooling used by the
+DjangoPlay ecosystem.
+
+Version: 1.0.0
+"""

dplay/cli.py

@@ -0,0 +1,99 @@
+"""
+CLI entrypoint for djangoplay-cli.
+
+This module defines the root CLI application and registers
+all command groups.
+"""
+
+from importlib.metadata import version
+
+import typer
+
+from dplay.commands.dev.down import down_command
+from dplay.commands.dev.http import http_command
+from dplay.commands.dev.logs import logs_command
+from dplay.commands.dev.ssl import ssl_command
+from dplay.commands.dev.up import up_command
+from dplay.commands.dev.worker import worker_command
+from dplay.commands.system.doctor import doctor_command
+from dplay.commands.system.reset import reset_command
+
+app = typer.Typer(help="DjangoPlay CLI")
+
+
+# ------------------------------------------------------------------
+# EXTENSIBLE METADATA
+# ------------------------------------------------------------------
+
+
+def get_cli_version() -> str:
+    """
+    Retrieve CLI version from installed package metadata.
+    """
+
+    try:
+        return version("djangoplay-cli")
+    except Exception:
+        return "unknown"
+
+
+# ------------------------------------------------------------------
+# DEV COMMAND GROUP
+# ------------------------------------------------------------------
+
+dev_app = typer.Typer(help="Development commands")
+
+dev_app.command("http")(http_command)
+dev_app.command("ssl")(ssl_command)
+dev_app.command("worker")(worker_command)
+dev_app.command("up")(up_command)
+dev_app.command("down")(down_command)
+
+app.add_typer(dev_app, name="dev")
+
+# ------------------------------------------------------------------
+# SYSTEM COMMAND GROUP
+# ------------------------------------------------------------------
+
+system_app = typer.Typer(help="System environment commands")
+
+system_app.command("doctor")(doctor_command)
+system_app.command("reset")(reset_command)
+
+app.add_typer(system_app, name="system")
+
+# ------------------------------------------------------------------
+# LOG COMMAND
+# ------------------------------------------------------------------
+
+app.command("logs")(logs_command)
+
+# -------------------------------------------------------------
+# GLOBAL OPTIONS
+# ------------------------------------------------------------------
+
+
+@app.callback(invoke_without_command=True)
+def callback(
+    ctx: typer.Context,
+    version_flag: bool = typer.Option(None, "--version", "-v", is_eager=True),
+):
+    """
+    CLI entrypoint used by the console script.
+
+    This wrapper ensures compatibility with Python packaging
+    and avoids exposing the Typer object directly and handles
+    global CLI option such as --version.
+    """
+
+    if version_flag:
+        typer.echo(get_cli_version())
+        raise typer.Exit()
+
+    if ctx.invoked_subcommand is None:
+        typer.echo(ctx.get_help())
+        raise typer.Exit()
+
+
+def main():
+    app()

dplay/commands/__init__.py

@@ -0,0 +1,15 @@
+"""
+CLI command packages for djangoplay-cli.
+
+This module groups all user-facing CLI commands exposed
+through the `dplay` command-line interface.
+
+Submodules implement command groups such as:
+
+- dev
+- env (future)
+- repo (future)
+
+The command structure follows the Typer CLI architecture
+defined in `dplay.cli`.
+"""

dplay/commands/dev/__init__.py

@@ -0,0 +1,25 @@
+"""
+Development command group for djangoplay-cli.
+
+This package contains CLI commands responsible for managing
+the local DjangoPlay development environment.
+
+Available commands include:
+
+- dev http     → start Django development server (HTTP)
+- dev ssl      → start Django development server (HTTPS)
+- dev worker   → start Celery worker
+- dev up       → start full development environment
+- dev down     → stop development environment
+- dev logs     → display development logs
+
+The commands in this package coordinate services such as:
+
+- Django development server
+- Celery worker and beat
+- Redis
+- PostgreSQL
+
+These commands are registered under the `dplay dev` command
+group defined in `dplay.cli`.
+"""

dplay/commands/dev/down.py

@@ -0,0 +1,20 @@
+"""
+Stop development environment.
+"""
+
+from dplay.core.process_manager import stop_celery
+
+
+# ------------------------------------------------------------------
+# EXTENSIBLE METADATA
+# ------------------------------------------------------------------
+def down_command():
+    """
+    Stop all development services.
+    """
+
+    print("Stopping DjangoPlay services")
+
+    stop_celery()
+
+    print("Services stopped")

dplay/commands/dev/http.py

@@ -0,0 +1,42 @@
+"""
+HTTP development server command.
+"""
+
+import subprocess
+
+from dplay.core.repo_detector import ensure_repo
+from dplay.environment.venv_detector import ensure_venv
+from dplay.utils.dev_startup import print_environment, restart_celery
+
+
+# ------------------------------------------------------------------
+# EXTENSIBLE METADATA
+# ------------------------------------------------------------------
+def http_command():
+    """
+    Start DjangoPlay HTTP development server.
+
+    Starts:
+    - Celery worker
+    - Celery beat
+    - Django development server
+    """
+
+    repo_path = ensure_repo()
+    python_exec = ensure_venv()
+
+    print_environment(repo_path, python_exec)
+
+    restart_celery()
+
+    print("✔ Django server starting\n")
+
+    print("Server URL:")
+    print("http://localhost:3333\n")
+
+    print("Press CTRL+C to stop the server.\n")
+
+    subprocess.run(
+        ["python", "manage.py", "runserver", "localhost:3333"],
+        check=True,
+    )

dplay/commands/dev/logs.py

@@ -0,0 +1,14 @@
+"""
+CLI log command.
+"""
+
+
+# ------------------------------------------------------------------
+# EXTENSIBLE METADATA
+# ------------------------------------------------------------------
+def logs_command():
+    """
+    Display development logs.
+    """
+
+    print("Logs feature coming soon")

dplay/commands/dev/ssl.py

@@ -0,0 +1,43 @@
+"""
+HTTPS development server command.
+"""
+
+import subprocess
+
+from dplay.core.repo_detector import ensure_repo
+from dplay.environment.venv_detector import ensure_venv
+from dplay.utils.dev_startup import print_environment, restart_celery
+
+
+# ------------------------------------------------------------------
+# EXTENSIBLE METADATA
+# ------------------------------------------------------------------
+def ssl_command():
+    """
+    Start DjangoPlay HTTPS development server.
+
+    Uses runserver_plus when available.
+    """
+
+    repo_path = ensure_repo()
+    python_exec = ensure_venv()
+
+    print_environment(repo_path, python_exec)
+
+    restart_celery()
+
+    print("✔ Django HTTPS server starting\n")
+
+    print("Server URL:")
+    print("https://localhost:9999\n")
+
+    try:
+        subprocess.run(
+            ["python", "manage.py", "runserver_plus", "localhost:9999"],
+            check=True,
+        )
+    except Exception:
+        subprocess.run(
+            ["python", "manage.py", "runserver", "localhost:9999"],
+            check=True,
+        )

dplay/commands/dev/up.py

@@ -0,0 +1,24 @@
+"""
+Start full development environment.
+"""
+
+import subprocess
+
+from dplay.core.process_manager import start_celery
+
+
+# ------------------------------------------------------------------
+# EXTENSIBLE METADATA
+# ------------------------------------------------------------------
+def up_command():
+    """
+    Start Redis, Celery and Django services.
+    """
+
+    print("Starting DjangoPlay development environment\n")
+
+    start_celery()
+
+    subprocess.Popen(["python", "manage.py", "runserver", "localhost:3333"])
+
+    print("Environment is up")

dplay/commands/dev/worker.py

@@ -0,0 +1,25 @@
+"""
+Celery worker command.
+"""
+
+import subprocess
+
+from dplay.core.repo_detector import ensure_repo
+from dplay.environment.venv_detector import ensure_venv
+
+
+# ------------------------------------------------------------------
+# EXTENSIBLE METADATA
+# ------------------------------------------------------------------
+def worker_command():
+    """
+    Start Celery worker and beat services.
+    """
+
+    ensure_repo()
+    ensure_venv()
+
+    subprocess.run(
+        ["celery", "-A", "paystream", "worker", "-l", "info"],
+        check=True,
+    )

dplay/commands/system/__init__.py

@@ -0,0 +1,3 @@
+"""
+DjangoPlay CLI Health Diagnostics
+"""

dplay/commands/system/doctor.py

@@ -0,0 +1,31 @@
+"""
+Environment diagnostics command.
+"""
+
+from dplay.core.repo_detector import ensure_repo
+from dplay.environment.diagnostics import run_diagnostics
+from dplay.environment.venv_detector import ensure_venv
+
+
+# ------------------------------------------------------------------
+# EXTENSIBLE METADATA
+# ------------------------------------------------------------------
+def doctor_command():
+    """
+    Run environment diagnostics.
+    """
+
+    ensure_repo()
+    ensure_venv()
+
+    print("\nEnvironment Diagnostics\n")
+
+    results = run_diagnostics()
+
+    for ok, message in results:
+        if ok:
+            print(f"✔ {message}")
+        else:
+            print(f"✖ {message}")
+
+    print("")

dplay/commands/system/reset.py

@@ -0,0 +1,37 @@
+"""
+Environment reset command.
+"""
+
+import subprocess
+
+
+# ------------------------------------------------------------------
+# EXTENSIBLE METADATA
+# ------------------------------------------------------------------
+def reset_command():
+    """
+    Reset development environment.
+    """
+
+    print("\nResetting development environment\n")
+
+    subprocess.run(
+        'pkill -9 -f "celery.*paystream" 2>/dev/null || true',
+        shell=True,
+    )
+
+    subprocess.run(
+        'pkill -9 -f "celery.*beat" 2>/dev/null || true',
+        shell=True,
+    )
+
+    print("✔ Celery processes stopped")
+
+    subprocess.run(
+        "redis-cli flushall",
+        shell=True,
+        stdout=subprocess.DEVNULL,
+        stderr=subprocess.DEVNULL,
+    )
+
+    print("✔ Redis flushed\n")

dplay/core/__init__.py

@@ -0,0 +1,12 @@
+"""
+Core infrastructure utilities for djangoplay-cli.
+
+This package contains low-level helpers responsible for:
+
+- repository detection
+- process management (future)
+- configuration loading (future)
+
+Core modules should remain lightweight and reusable
+across CLI commands.
+"""

dplay/core/config_loader.py

@@ -0,0 +1,53 @@
+"""
+Configuration loader for DjangoPlay CLI.
+
+Loads configuration from ~/.dplay/config.yaml
+and secrets from ~/.dplay/.secrets
+"""
+
+import os
+from pathlib import Path
+
+import yaml
+
+CONFIG_DIR = Path.home() / ".dplay"
+CONFIG_FILE = CONFIG_DIR / "config.yaml"
+SECRETS_FILE = CONFIG_DIR / ".secrets"
+
+
+# ------------------------------------------------------------------
+# EXTENSIBLE METADATA
+# ------------------------------------------------------------------
+def load_config():
+    """
+    Load YAML configuration file.
+    """
+
+    if not CONFIG_FILE.exists():
+        raise RuntimeError("Missing configuration file ~/.dplay/config.yaml")
+
+    with open(CONFIG_FILE) as f:
+        return yaml.safe_load(f)
+
+
+# ------------------------------------------------------------------
+# EXTENSIBLE METADATA
+# ------------------------------------------------------------------
+def load_secrets():
+    """
+    Load secrets into environment variables.
+    """
+
+    if not SECRETS_FILE.exists():
+        return
+
+    with open(SECRETS_FILE) as f:
+        for line in f:
+            line = line.strip()
+
+            if not line or line.startswith("#"):
+                continue
+
+            key, value = line.split("=", 1)
+
+            os.environ[key] = value

dplay/core/process_manager.py

@@ -0,0 +1,37 @@
+"""
+Process management utilities.
+"""
+
+import subprocess
+
+
+# ------------------------------------------------------------------
+# EXTENSIBLE METADATA
+# ------------------------------------------------------------------
+def start_celery():
+    """
+    Start celery worker and beat.
+    """
+
+    subprocess.Popen(["celery", "-A", "paystream", "worker", "-l", "info"])
+
+    subprocess.Popen(["celery", "-A", "paystream", "beat", "-l", "info"])
+
+
+# ------------------------------------------------------------------
+# EXTENSIBLE METADATA
+# ------------------------------------------------------------------
+def stop_celery():
+    """
+    Stop running celery workers.
+    """
+
+    subprocess.run(
+        'pkill -9 -f "celery.*paystream" 2>/dev/null || true',
+        shell=True,
+    )
+
+    subprocess.run(
+        'pkill -9 -f "celery.*beat" 2>/dev/null || true',
+        shell=True,
+    )

dplay/core/repo_detector.py

@@ -0,0 +1,40 @@
+"""
+Repository detection utilities.
+"""
+
+import subprocess
+import sys
+
+
+# ------------------------------------------------------------------
+# EXTENSIBLE METADATA
+# ------------------------------------------------------------------
+def ensure_repo():
+    """
+    Ensure command runs inside DjangoPlay repository.
+
+    Returns
+    -------
+    str
+        Repository root path.
+    """
+
+    try:
+        result = subprocess.check_output(
+            ["git", "rev-parse", "--show-toplevel"],
+            stderr=subprocess.DEVNULL,
+        )
+
+        repo_path = result.decode().strip()
+
+        if "djangoplay" not in repo_path.lower():
+            raise RuntimeError
+
+        return repo_path
+
+    except Exception:
+        print(
+            "Error: DjangoPlay repository not detected.\n"
+            "Run this command inside the DjangoPlay project directory."
+        )
+        sys.exit(1)

dplay/environment/__init__.py

@@ -0,0 +1,15 @@
+"""
+Environment validation utilities.
+
+Modules in this package verify the runtime environment
+required to execute DjangoPlay development commands.
+
+Current responsibilities include:
+
+- Python virtual environment validation
+
+Future responsibilities may include:
+
+- dependency checks
+- system diagnostics
+"""

dplay/environment/diagnostics.py

@@ -0,0 +1,79 @@
+"""
+Environment diagnostics utilities.
+"""
+
+import shutil
+import socket
+import sys
+
+
+# ------------------------------------------------------------------
+# EXTENSIBLE METADATA
+# ------------------------------------------------------------------
+def check_python():
+    """Verify Python version."""
+
+    version = sys.version_info
+    if version.major >= 3 and version.minor >= 11:
+        return True, "Python version OK"
+    return False, "Python >=3.11 required"
+
+
+# ------------------------------------------------------------------
+# EXTENSIBLE METADATA
+# ------------------------------------------------------------------
+def check_redis():
+    """Check Redis availability."""
+
+    try:
+        sock = socket.create_connection(("127.0.0.1", 6379), timeout=1)
+        sock.close()
+        return True, "Redis reachable"
+    except Exception:
+        return False, "Redis not reachable"
+
+
+# ------------------------------------------------------------------
+# EXTENSIBLE METADATA
+# ------------------------------------------------------------------
+def check_postgres():
+    """Check Postgres availability."""
+
+    try:
+        sock = socket.create_connection(("127.0.0.1", 5432), timeout=1)
+        sock.close()
+        return True, "Postgres reachable"
+    except Exception:
+        return False, "Postgres not reachable"
+
+
+# ------------------------------------------------------------------
+# EXTENSIBLE METADATA
+# ------------------------------------------------------------------
+def check_celery():
+    """Check Celery availability."""
+
+    if shutil.which("celery"):
+        return True, "Celery available"
+    return False, "Celery not installed"
+
+
+# ------------------------------------------------------------------
+# EXTENSIBLE METADATA
+# ------------------------------------------------------------------
+def run_diagnostics():
+    """Run all environment checks."""
+
+    checks = [
+        check_python,
+        check_redis,
+        check_postgres,
+        check_celery,
+    ]
+
+    results = []
+
+    for check in checks:
+        results.append(check())
+
+    return results

dplay/environment/venv_detector.py

@@ -0,0 +1,26 @@
+"""
+Virtual environment detection utilities.
+"""
+
+import os
+import sys
+
+
+# ------------------------------------------------------------------
+# EXTENSIBLE METADATA
+# ------------------------------------------------------------------
+def ensure_venv():
+    """
+    Ensure Python virtual environment is active.
+
+    Returns
+    -------
+    str
+        Python executable path.
+    """
+
+    if "VIRTUAL_ENV" not in os.environ:
+        print("Error: Virtual environment not active.")
+        sys.exit(1)
+
+    return sys.executable

dplay/utils/__init__.py

@@ -0,0 +1,9 @@
+"""
+Utility helpers used across the CLI implementation.
+
+These modules provide reusable functionality such as:
+
+- development startup helpers
+- subprocess wrappers
+- future CLI utilities
+"""

dplay/utils/dev_startup.py

@@ -0,0 +1,66 @@
+"""
+Development startup helpers.
+
+Shared utilities used by development commands such as:
+
+- dev http
+- dev ssl
+"""
+
+import subprocess
+
+
+# ------------------------------------------------------------------
+# EXTENSIBLE METADATA
+# ------------------------------------------------------------------
+def print_environment(repo_path: str, python_exec: str):
+    """
+    Print CLI environment summary.
+    """
+
+    print("\nDjangoPlay CLI\n")
+
+    print(f"Repository:   {repo_path}")
+    print(f"Python:       {python_exec}")
+    print("Environment:  development\n")
+
+
+# ------------------------------------------------------------------
+# EXTENSIBLE METADATA
+# ------------------------------------------------------------------
+def restart_celery():
+    """
+    Stop existing celery processes and start fresh ones.
+    """
+
+    print("Stopping existing Celery workers...")
+
+    subprocess.run(
+        'pkill -9 -f "celery.*paystream" 2>/dev/null || true',
+        shell=True,
+    )
+
+    subprocess.run(
+        'pkill -9 -f "celery.*beat" 2>/dev/null || true',
+        shell=True,
+    )
+
+    print("✔ Existing Celery processes cleared\n")
+
+    print("Starting services...\n")
+
+    subprocess.Popen(
+        ["celery", "-A", "paystream", "worker", "-l", "info"],
+        stdout=subprocess.DEVNULL,
+        stderr=subprocess.DEVNULL,
+    )
+
+    print("✔ Celery worker started")
+
+    subprocess.Popen(
+        ["celery", "-A", "paystream", "beat", "-l", "info"],
+        stdout=subprocess.DEVNULL,
+        stderr=subprocess.DEVNULL,
+    )
+
+    print("✔ Celery beat started\n")

dplay/utils/subprocess_utils.py

@@ -0,0 +1,5 @@
+"""
+Subprocess helper utilities.
+
+Reserved for future releases.
+"""