stata-cli 0.5.0__tar.gz → 0.5.2__tar.gz

{stata_cli-0.5.0 → stata_cli-0.5.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: stata-cli
-Version: 0.5.0
+Version: 0.5.2
 Summary: Command-line interface for running Stata commands via PyStata
 License: MIT
 Keywords: stata,cli,statistics,data-science
@@ -51,7 +51,7 @@ A command-line interface for [Stata](https://www.stata.com/) via PyStata — bui
 | **Frame Management** | List Stata frames and current working frame via `frame` |
 | **Help System** | Browse Stata help topics with SMCL-to-plain-text conversion |
 | **Graph Export** | Auto-detect and export graphs as PNG/SVG/PDF to `~/.stata-cli/graphs/` |
-| **Daemon Mode** | Persistent background process for sub-second execution via Unix socket |
+| **Daemon Mode** | Persistent background process for sub-second execution; parallel sessions via `--session` |
 | **Output Control** | Compact mode, JSON output, token limit management, log file output |
 | **Interruption** | Send break signal to stop long-running commands |
 | **Skill Library** | Built-in Stata reference with 57 topics: syntax, econometrics, causal inference, packages |
@@ -290,13 +290,32 @@ stata-cli daemon stop        # Shut down
 |---------|-------------|
 | `daemon start` | Start the background daemon process |
 | `daemon stop` | Graceful shutdown |
-| `daemon status` | Show PID, Stata path, uptime, idle time |
+| `daemon stop --all` | Stop all running sessions |
+| `daemon status` | Show all running sessions (PID, uptime, idle) |
 | `daemon restart` | Stop + start (clean Stata state) |
 
 Commands auto-route through the daemon when it is running. Use `--no-daemon` to force direct execution.
 
 The daemon auto-shuts down after 1 hour of inactivity (configurable with `--idle-timeout`).
 
+### Parallel Sessions
+
+Run multiple independent Stata instances — like opening multiple Stata windows:
+
+```bash
+# Start named sessions
+stata-cli --session proj_a daemon start
+stata-cli --session proj_b daemon start
+
+# Each session has its own data, estimates, and macros
+stata-cli --session proj_a run "use project_a.dta, clear"
+stata-cli --session proj_b run "use project_b.dta, clear"
+
+# Route any command to a specific session
+stata-cli --session proj_a run "regress price mpg weight"
+stata-cli --session proj_b return e
+```
+
 ## Advanced Usage
 
 ### Global Options
@@ -305,6 +324,7 @@ The daemon auto-shuts down after 1 hour of inactivity (configurable with `--idle
 |--------|-------------|---------|
 | `--stata-path PATH` | Stata installation directory | auto-detected |
 | `--edition [mp\|se\|be]` | Stata edition | `mp` |
+| `--session NAME` | Daemon session name (for parallel sessions) | `default` |
 | `--compact` | Strip verbose output noise | off |
 | `--json` | Structured JSON output | off |
 | `--timeout SECONDS` | Execution timeout | 600 |

{stata_cli-0.5.0 → stata_cli-0.5.2}/README.md

@@ -38,7 +38,7 @@ A command-line interface for [Stata](https://www.stata.com/) via PyStata — bui
 | **Frame Management** | List Stata frames and current working frame via `frame` |
 | **Help System** | Browse Stata help topics with SMCL-to-plain-text conversion |
 | **Graph Export** | Auto-detect and export graphs as PNG/SVG/PDF to `~/.stata-cli/graphs/` |
-| **Daemon Mode** | Persistent background process for sub-second execution via Unix socket |
+| **Daemon Mode** | Persistent background process for sub-second execution; parallel sessions via `--session` |
 | **Output Control** | Compact mode, JSON output, token limit management, log file output |
 | **Interruption** | Send break signal to stop long-running commands |
 | **Skill Library** | Built-in Stata reference with 57 topics: syntax, econometrics, causal inference, packages |
@@ -277,13 +277,32 @@ stata-cli daemon stop        # Shut down
 |---------|-------------|
 | `daemon start` | Start the background daemon process |
 | `daemon stop` | Graceful shutdown |
-| `daemon status` | Show PID, Stata path, uptime, idle time |
+| `daemon stop --all` | Stop all running sessions |
+| `daemon status` | Show all running sessions (PID, uptime, idle) |
 | `daemon restart` | Stop + start (clean Stata state) |
 
 Commands auto-route through the daemon when it is running. Use `--no-daemon` to force direct execution.
 
 The daemon auto-shuts down after 1 hour of inactivity (configurable with `--idle-timeout`).
 
+### Parallel Sessions
+
+Run multiple independent Stata instances — like opening multiple Stata windows:
+
+```bash
+# Start named sessions
+stata-cli --session proj_a daemon start
+stata-cli --session proj_b daemon start
+
+# Each session has its own data, estimates, and macros
+stata-cli --session proj_a run "use project_a.dta, clear"
+stata-cli --session proj_b run "use project_b.dta, clear"
+
+# Route any command to a specific session
+stata-cli --session proj_a run "regress price mpg weight"
+stata-cli --session proj_b return e
+```
+
 ## Advanced Usage
 
 ### Global Options
@@ -292,6 +311,7 @@ The daemon auto-shuts down after 1 hour of inactivity (configurable with `--idle
 |--------|-------------|---------|
 | `--stata-path PATH` | Stata installation directory | auto-detected |
 | `--edition [mp\|se\|be]` | Stata edition | `mp` |
+| `--session NAME` | Daemon session name (for parallel sessions) | `default` |
 | `--compact` | Strip verbose output noise | off |
 | `--json` | Structured JSON output | off |
 | `--timeout SECONDS` | Execution timeout | 600 |

{stata_cli-0.5.0 → stata_cli-0.5.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "stata-cli"
-version = "0.5.0"
+version = "0.5.2"
 description = "Command-line interface for running Stata commands via PyStata"
 readme = "README.md"
 requires-python = ">=3.9"

stata_cli-0.5.2/src/stata_cli/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.5.2"

{stata_cli-0.5.0 → stata_cli-0.5.2}/src/stata_cli/daemon.py

@@ -137,12 +137,13 @@ class DaemonServer:
     @staticmethod
     def _find_free_port() -> int:
         for port in range(_DEFAULT_PORT, _DEFAULT_PORT + 200):
+            s = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
             try:
-                s = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
                 s.bind(("127.0.0.1", port))
                 s.close()
                 return port
             except OSError:
+                s.close()
                 continue
         raise RuntimeError("No free port found")
 

{stata_cli-0.5.0 → stata_cli-0.5.2}/src/stata_cli/main.py

@@ -447,6 +447,58 @@ def skill_cmd(ctx, topic, list_topics):
         click.echo(content)
 
 
+# ── Config subcommands ──────────────────────────────────────────────────
+
+@cli.group("config")
+def config_cmd():
+    """Manage stata-cli configuration (~/.stata-cli/config.json)."""
+
+
+@config_cmd.command("set")
+@click.argument("key")
+@click.argument("value")
+def config_set(key, value):
+    """Set a configuration value.
+
+    \b
+    Examples:
+      stata-cli config set stata-path "/usr/local/stata19"
+      stata-cli config set edition se
+    """
+    from .utils import set_config
+    set_config(key, value)
+    click.echo(f"{key} = {value}")
+
+
+@config_cmd.command("get")
+@click.argument("key")
+def config_get(key):
+    """Get a configuration value.
+
+    \b
+    Examples:
+      stata-cli config get stata-path
+    """
+    from .utils import get_config
+    value = get_config(key)
+    if value is None:
+        click.echo(f"{key}: (not set)")
+    else:
+        click.echo(f"{key} = {value}")
+
+
+@config_cmd.command("list")
+def config_list():
+    """Show all configuration values."""
+    from .utils import get_all_config
+    data = get_all_config()
+    if not data:
+        click.echo("No configuration set. Use 'stata-cli config set <key> <value>' to configure.")
+        return
+    for k, v in data.items():
+        click.echo(f"{k} = {v}")
+
+
 # ── Daemon subcommands ───────────────────────────────────────────────────
 
 @cli.group()

{stata_cli-0.5.0 → stata_cli-0.5.2}/src/stata_cli/utils.py

@@ -1,6 +1,7 @@
 """Platform detection and Stata path auto-discovery."""
 from __future__ import annotations
 
+import json
 import os
 import platform
 
@@ -10,37 +11,90 @@ IS_WINDOWS = PLATFORM == "Windows"
 IS_MACOS = PLATFORM == "Darwin"
 IS_LINUX = PLATFORM == "Linux"
 
+_CONFIG_DIR = os.path.join(os.path.expanduser("~"), ".stata-cli")
+_CONFIG_FILE = os.path.join(_CONFIG_DIR, "config.json")
+
+
+def get_config(key: str) -> str | None:
+    """Read a value from ~/.stata-cli/config.json."""
+    if not os.path.isfile(_CONFIG_FILE):
+        return None
+    try:
+        with open(_CONFIG_FILE, encoding="utf-8") as f:
+            data = json.load(f)
+        return data.get(key)
+    except (json.JSONDecodeError, OSError):
+        return None
+
+
+def set_config(key: str, value: str) -> None:
+    """Write a value to ~/.stata-cli/config.json."""
+    os.makedirs(_CONFIG_DIR, exist_ok=True)
+    data = {}
+    if os.path.isfile(_CONFIG_FILE):
+        try:
+            with open(_CONFIG_FILE, encoding="utf-8") as f:
+                data = json.load(f)
+        except (json.JSONDecodeError, OSError):
+            pass
+    data[key] = value
+    with open(_CONFIG_FILE, "w", encoding="utf-8") as f:
+        json.dump(data, f, indent=2, ensure_ascii=False)
+
+
+def get_all_config() -> dict:
+    """Read all config values."""
+    if not os.path.isfile(_CONFIG_FILE):
+        return {}
+    try:
+        with open(_CONFIG_FILE, encoding="utf-8") as f:
+            return json.load(f)
+    except (json.JSONDecodeError, OSError):
+        return {}
+
 
 def detect_stata_path() -> str | None:
     """Auto-detect the Stata installation directory.
 
     Checks, in order:
     1. STATA_PATH environment variable
-    2. Platform-specific default locations
+    2. ~/.stata-cli/config.json (user-configured path)
+    3. Platform-specific default locations
     """
     env_path = os.environ.get("STATA_PATH")
     if env_path and os.path.exists(env_path):
         return env_path
 
+    config_path = get_config("stata-path")
+    if config_path and os.path.exists(config_path):
+        return config_path
+
     if IS_MACOS:
         for candidate in [
             "/Applications/Stata",
             "/Applications/StataNow",
-            "/Applications/Stata18",
-            "/Applications/Stata17",
         ]:
             if os.path.exists(candidate):
                 return candidate
 
     elif IS_WINDOWS:
-        for version in ["18", "17", "16"]:
-            for prefix in [r"C:\Program Files\Stata", r"C:\Program Files (x86)\Stata"]:
+        for version in ["19", "18", "17", "16"]:
+            for prefix in [
+                r"C:\Program Files\Stata",
+                r"C:\Program Files\StataNow",
+            ]:
                 candidate = prefix + version
                 if os.path.exists(candidate):
                     return candidate
 
     elif IS_LINUX:
-        for candidate in ["/usr/local/stata18", "/usr/local/stata17", "/usr/local/stata"]:
+        for candidate in [
+            "/usr/local/stata19",
+            "/usr/local/statanow19",
+            "/usr/local/stata18",
+            "/usr/local/stata17",
+            "/usr/local/stata",
+        ]:
             if os.path.exists(candidate):
                 return candidate
 

{stata_cli-0.5.0 → stata_cli-0.5.2}/src/stata_cli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: stata-cli
-Version: 0.5.0
+Version: 0.5.2
 Summary: Command-line interface for running Stata commands via PyStata
 License: MIT
 Keywords: stata,cli,statistics,data-science
@@ -51,7 +51,7 @@ A command-line interface for [Stata](https://www.stata.com/) via PyStata — bui
 | **Frame Management** | List Stata frames and current working frame via `frame` |
 | **Help System** | Browse Stata help topics with SMCL-to-plain-text conversion |
 | **Graph Export** | Auto-detect and export graphs as PNG/SVG/PDF to `~/.stata-cli/graphs/` |
-| **Daemon Mode** | Persistent background process for sub-second execution via Unix socket |
+| **Daemon Mode** | Persistent background process for sub-second execution; parallel sessions via `--session` |
 | **Output Control** | Compact mode, JSON output, token limit management, log file output |
 | **Interruption** | Send break signal to stop long-running commands |
 | **Skill Library** | Built-in Stata reference with 57 topics: syntax, econometrics, causal inference, packages |
@@ -290,13 +290,32 @@ stata-cli daemon stop        # Shut down
 |---------|-------------|
 | `daemon start` | Start the background daemon process |
 | `daemon stop` | Graceful shutdown |
-| `daemon status` | Show PID, Stata path, uptime, idle time |
+| `daemon stop --all` | Stop all running sessions |
+| `daemon status` | Show all running sessions (PID, uptime, idle) |
 | `daemon restart` | Stop + start (clean Stata state) |
 
 Commands auto-route through the daemon when it is running. Use `--no-daemon` to force direct execution.
 
 The daemon auto-shuts down after 1 hour of inactivity (configurable with `--idle-timeout`).
 
+### Parallel Sessions
+
+Run multiple independent Stata instances — like opening multiple Stata windows:
+
+```bash
+# Start named sessions
+stata-cli --session proj_a daemon start
+stata-cli --session proj_b daemon start
+
+# Each session has its own data, estimates, and macros
+stata-cli --session proj_a run "use project_a.dta, clear"
+stata-cli --session proj_b run "use project_b.dta, clear"
+
+# Route any command to a specific session
+stata-cli --session proj_a run "regress price mpg weight"
+stata-cli --session proj_b return e
+```
+
 ## Advanced Usage
 
 ### Global Options
@@ -305,6 +324,7 @@ The daemon auto-shuts down after 1 hour of inactivity (configurable with `--idle
 |--------|-------------|---------|
 | `--stata-path PATH` | Stata installation directory | auto-detected |
 | `--edition [mp\|se\|be]` | Stata edition | `mp` |
+| `--session NAME` | Daemon session name (for parallel sessions) | `default` |
 | `--compact` | Strip verbose output noise | off |
 | `--json` | Structured JSON output | off |
 | `--timeout SECONDS` | Execution timeout | 600 |

stata_cli-0.5.0/src/stata_cli/__init__.py

@@ -1 +0,0 @@
-__version__ = "0.5.0"