plain.dev 0.36.0__py3-none-any.whl → 0.38.0__py3-none-any.whl

plain/dev/AGENTS.md

@@ -0,0 +1,3 @@
+# Plain Dev AGENTS.md
+
+- `plain dev logs`: Show the log output for the running `plain dev` processes

plain/dev/CHANGELOG.md

@@ -1,5 +1,25 @@
 # plain-dev changelog
 
+## [0.38.0](https://github.com/dropseed/plain/releases/plain-dev@0.38.0) (2025-09-30)
+
+### What's changed
+
+- Added an `AGENTS.md` file with package-specific agent instructions for the `plain dev logs` command ([5841a3f](https://github.com/dropseed/plain/commit/5841a3fb0b))
+
+### Upgrade instructions
+
+- No changes required
+
+## [0.37.0](https://github.com/dropseed/plain/releases/plain-dev@0.37.0) (2025-09-29)
+
+### What's changed
+
+- Added a `p` alias prompt that suggests setting up a shell alias for `uv run plain` to make command execution faster ([d913b44](https://github.com/dropseed/plain/commit/d913b44fab), [6632529](https://github.com/dropseed/plain/commit/663252925b))
+
+### Upgrade instructions
+
+- No changes required
+
 ## [0.36.0](https://github.com/dropseed/plain/releases/plain-dev@0.36.0) (2025-09-25)
 
 ### What's changed

plain/dev/alias.py

@@ -0,0 +1,152 @@
+import os
+import subprocess
+import sys
+from functools import cached_property
+from pathlib import Path
+
+import click
+
+
+class AliasManager:
+    """Manages the 'p' alias for 'uv run plain'."""
+
+    MARKER_FILE = Path.home() / ".plain" / "dev" / ".alias_prompted"
+    ALIAS_COMMAND = "uv run plain"
+    ALIAS_NAME = "p"
+
+    @cached_property
+    def shell(self):
+        """Detect the current shell."""
+        shell = os.environ.get("SHELL", "")
+        if "zsh" in shell:
+            return "zsh"
+        elif "bash" in shell:
+            return "bash"
+        elif "fish" in shell:
+            return "fish"
+        return None
+
+    @cached_property
+    def shell_config_file(self):
+        """Get the appropriate shell configuration file."""
+        home = Path.home()
+
+        if self.shell == "zsh":
+            return home / ".zshrc"
+        elif self.shell == "bash":
+            # Check for .bash_aliases first (Ubuntu/Debian convention)
+            if (home / ".bash_aliases").exists():
+                return home / ".bash_aliases"
+            return home / ".bashrc"
+        elif self.shell == "fish":
+            return home / ".config" / "fish" / "config.fish"
+
+        return None
+
+    def _command_exists(self, command):
+        """Check if a command exists in the system."""
+        try:
+            result = subprocess.run(
+                ["which", command], capture_output=True, text=True, check=False
+            )
+            return result.returncode == 0
+        except Exception:
+            return False
+
+    def _alias_exists(self):
+        """Check if the 'p' alias already exists."""
+        # First check if 'p' is already a command
+        if self._command_exists(self.ALIAS_NAME):
+            return True
+
+        # Check if alias is defined in shell
+        try:
+            # Try to run the alias to see if it exists
+            result = subprocess.run(
+                [self.shell, "-i", "-c", f"alias {self.ALIAS_NAME}"],
+                capture_output=True,
+                text=True,
+                check=False,
+                timeout=2,
+            )
+            return result.returncode == 0
+        except (subprocess.TimeoutExpired, Exception):
+            return False
+
+    def _add_alias_to_shell(self):
+        """Add the alias to the shell configuration file."""
+        if not self.shell_config_file or not self.shell_config_file.exists():
+            return False
+
+        alias_line = f'alias {self.ALIAS_NAME}="{self.ALIAS_COMMAND}"'
+        comment = "# Added by Plain"
+
+        # Check if alias already in file
+        try:
+            with open(self.shell_config_file) as f:
+                content = f.read()
+                if alias_line in content:
+                    return True
+        except Exception:
+            return False
+
+        # Add alias to file
+        try:
+            with open(self.shell_config_file, "a") as f:
+                f.write(f"\n{comment}\n{alias_line}\n")
+
+            click.secho(
+                f"✓ Added '{self.ALIAS_NAME}' alias to {self.shell_config_file.name}. Restart your shell!",
+                fg="green",
+            )
+            return True
+        except Exception as e:
+            click.secho(
+                f"Failed to add alias to {self.shell_config_file.name}: {e}", fg="red"
+            )
+            return False
+
+    def check_and_prompt(self):
+        """Check if alias exists and prompt user to set it up if needed."""
+        # Only suggest if project uses uv (has uv.lock file)
+        if not Path("uv.lock").exists():
+            return
+
+        # Don't prompt if already configured
+        if self._alias_exists():
+            return
+
+        # Don't prompt if we've asked before
+        if self.MARKER_FILE.exists():
+            return
+
+        # Don't prompt for certain commands
+        if "--help" in sys.argv or "-h" in sys.argv:
+            return
+
+        # Mark that we've asked (do this first so we don't ask again even if they Ctrl+C)
+        self.MARKER_FILE.parent.mkdir(parents=True, exist_ok=True)
+        self.MARKER_FILE.touch()
+
+        click.echo()
+        click.secho("💡 Tip: ", fg="yellow", bold=True, nl=False)
+        click.echo(
+            f"Set up `{self.ALIAS_NAME}` as an alias to run commands faster (e.g., `{self.ALIAS_NAME} dev` instead of `uv run plain dev`)."
+        )
+        click.echo()
+
+        # Check if shell is supported
+        if not self.shell or not self.shell_config_file:
+            click.echo("To set this up manually, add to your shell config:")
+            click.echo(f'  alias {self.ALIAS_NAME}="{self.ALIAS_COMMAND}"')
+            click.echo()
+            return
+
+        # Offer to set it up
+        prompt_text = f"Would you like to add this to {self.shell_config_file.name}?"
+        if click.confirm(prompt_text, default=False):
+            click.echo()
+            if self._add_alias_to_shell():
+                sys.exit(0)  # Completely exit
+
+        click.echo()

plain/dev/cli.py

@@ -9,6 +9,7 @@ import click
 from plain.cli import register_cli
 from plain.runtime import APP_PATH, PLAIN_TEMP_PATH
 
+from .alias import AliasManager
 from .core import ENTRYPOINT_GROUP, DevProcess
 from .services import ServicesProcess
 
@@ -119,7 +120,6 @@ class DevGroup(click.Group):
 )
 def cli(ctx, port, hostname, log_level, start, stop):
     """Start local development"""
-
     if ctx.invoked_subcommand:
         return
 
@@ -170,6 +170,9 @@ def cli(ctx, port, hostname, log_level, start, stop):
         )
         return
 
+    # Check and prompt for alias setup
+    AliasManager().check_and_prompt()
+
     dev.setup(port=port, hostname=hostname, log_level=log_level)
     returncode = dev.run()
     if returncode:

{plain_dev-0.36.0.dist-info → plain_dev-0.38.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: plain.dev
-Version: 0.36.0
+Version: 0.38.0
 Summary: A single command that runs everything you need for local development.
 Author-email: Dave Gaeddert <dave.gaeddert@dropseed.dev>
 License-Expression: BSD-3-Clause

{plain_dev-0.36.0.dist-info → plain_dev-0.38.0.dist-info}/RECORD

@@ -1,7 +1,9 @@
-plain/dev/CHANGELOG.md,sha256=dggY6J2WbzUHeTsf-LG9qdCeTI1gRLjjlxVFhe3vKvU,5649
+plain/dev/AGENTS.md,sha256=WOrdXNog-K3tXm1D_f6ZyyXi_amBGQ2gviKGaW8qtxA,101
+plain/dev/CHANGELOG.md,sha256=sRZlqy0Azg4eaxkGkpKJnHNjXr6_qfXj5Q1mevPpYA4,6377
 plain/dev/README.md,sha256=wsDVPGfvVG1k3CTf-SsGnzvHukhKrwRMgThYHMpdXSc,4802
 plain/dev/__init__.py,sha256=9ByBOIdM8DebChjNz-RH2atdz4vWe8somlwNEsbhwh4,40
-plain/dev/cli.py,sha256=l2h0C1TZuHUweCYhfsJBC3nx6BmwaREFQVaJLlcltro,8392
+plain/dev/alias.py,sha256=LWG01nUzu_4FFwg0jAVie7fwEwOiZD_6Q3xs7Krmjoo,4944
+plain/dev/cli.py,sha256=HbN1Lc7Wfs5JC1iKUyIqin2m9UF0Iyirg4b4JLXBbOo,8501
 plain/dev/core.py,sha256=OX5tUez2ac2q3ha9ylgU5y44USJc9mkn11J6o5AozXk,11496
 plain/dev/debug.py,sha256=Ka84K8zUdF0kMYNyqiLYDrdzU1jU8LSOkts3hcw_Gok,1005
 plain/dev/default_settings.py,sha256=uXWYORWP_aRDwXIFXdu5kHyiBFUZzARIJdhPeFaX35c,75
@@ -23,8 +25,8 @@ plain/dev/poncho/printer.py,sha256=1LhaQx55ujxmo-SSwQtzsh0bO6HL5q2_kiA0jLWEB-o,2
 plain/dev/poncho/process.py,sha256=JJOKy-C6vMCg7-6JMCtu6C649h7HmOBSJqDP_hnX49I,2637
 plain/dev/precommit/__init__.py,sha256=9ByBOIdM8DebChjNz-RH2atdz4vWe8somlwNEsbhwh4,40
 plain/dev/precommit/cli.py,sha256=eAqe7rQGKJRbsICLrAabvNtRyTmWHkRo8XDo7I1DTkc,3285
-plain_dev-0.36.0.dist-info/METADATA,sha256=ueO1OEd5-Z_ax1XtL3n5EIAa-HdVbxtgYF7ipXkJd9I,5304
-plain_dev-0.36.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-plain_dev-0.36.0.dist-info/entry_points.txt,sha256=zrcTOiFk_MLKsnYVlwVP7aMm1XLEqq7w4EBkJ-3ge-g,114
-plain_dev-0.36.0.dist-info/licenses/LICENSE,sha256=Cx4Dq9yR2fLHthf8Ke36B8QJvE1bZFXVzDIGE8wGzsY,4132
-plain_dev-0.36.0.dist-info/RECORD,,
+plain_dev-0.38.0.dist-info/METADATA,sha256=XqQi4Cl9wkiOgaMEA1MpVmKbsS_yGthrhbZhPP8YUmA,5304
+plain_dev-0.38.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+plain_dev-0.38.0.dist-info/entry_points.txt,sha256=zrcTOiFk_MLKsnYVlwVP7aMm1XLEqq7w4EBkJ-3ge-g,114
+plain_dev-0.38.0.dist-info/licenses/LICENSE,sha256=Cx4Dq9yR2fLHthf8Ke36B8QJvE1bZFXVzDIGE8wGzsY,4132
+plain_dev-0.38.0.dist-info/RECORD,,