plain.observer 0.3.2__py3-none-any.whl → 0.3.4__py3-none-any.whl

plain/observer/CHANGELOG.md

@@ -1,5 +1,28 @@
 # plain-observer changelog
 
+## [0.3.4](https://github.com/dropseed/plain/releases/plain-observer@0.3.4) (2025-07-30)
+
+### What's changed
+
+- Fixed URL configuration examples in installation documentation to use `ObserverRouter` instead of string path ([f55ac7d](https://github.com/dropseed/plain/commit/f55ac7d491))
+- Enhanced README with table of contents, PyPI installation link, and post-installation usage instructions ([4ebecd1](https://github.com/dropseed/plain/commit/4ebecd1856))
+
+### Upgrade instructions
+
+- No changes required
+
+## [0.3.3](https://github.com/dropseed/plain/releases/plain-observer@0.3.3) (2025-07-25)
+
+### What's changed
+
+- Added `--print` option to the `plain observer diagnose` command to print prompts without running agents ([9721331](https://github.com/dropseed/plain/commit/9721331e40))
+- The `plain observer diagnose` command now uses the shared `prompt_agent` utility for better consistency ([de1fa72](https://github.com/dropseed/plain/commit/de1fa7253a))
+- Added comprehensive installation instructions to the README including package installation, URL configuration, and migration steps ([950939b](https://github.com/dropseed/plain/commit/950939b619))
+
+### Upgrade instructions
+
+- No changes required
+
 ## [0.3.2](https://github.com/dropseed/plain/releases/plain-observer@0.3.2) (2025-07-25)
 
 ### What's changed

plain/observer/README.md

@@ -1,3 +1,46 @@
 # plain.observer
 
-**Monitor.**
+**On-page telemetry and observability tools for Plain.**
+
+- [Installation](#installation)
+
+## Installation
+
+Install the `plain.observer` package from [PyPI](https://pypi.org/project/plain.observer/):
+
+```bash
+uv add plain.observer
+```
+
+Add `plain.observer` to your `INSTALLED_PACKAGES`:
+
+```python
+# app/settings.py
+INSTALLED_PACKAGES = [
+    # ...
+    "plain.observer",
+]
+```
+
+Include the observer URLs in your URL configuration:
+
+```python
+# app/urls.py
+from plain.observer.urls import ObserverRouter
+from plain.urls import Router, include
+
+class AppRouter(Router):
+    namespace = ""
+    urls = [
+        # ...
+        include("observer/", ObserverRouter),
+    ]
+```
+
+Run migrations to create the necessary database tables:
+
+```bash
+plain migrate
+```
+
+After installation, Observer will automatically integrate with your application's toolbar (if using `plain.admin`). You can access the web interface at `/observer/traces/` or use the CLI commands to analyze traces.

plain/observer/cli.py

@@ -1,12 +1,11 @@
 import json
-import shlex
-import subprocess
 import sys
 import urllib.request
 
 import click
 
 from plain.cli import register_cli
+from plain.cli.agent import prompt_agent
 from plain.observer.models import Span, Trace
 
 
@@ -497,7 +496,13 @@ def format_trace_output(trace):
     envvar="PLAIN_AGENT_COMMAND",
     help="Run command with generated prompt",
 )
-def diagnose(trace_id, url, json_input, agent_command):
+@click.option(
+    "--print",
+    "print_only",
+    is_flag=True,
+    help="Print the prompt without running the agent",
+)
+def diagnose(trace_id, url, json_input, agent_command, print_only):
     """Generate a diagnostic prompt for analyzing a trace.
 
     By default, provide a trace ID from the database. Use --url for a shareable
@@ -556,21 +561,6 @@ def diagnose(trace_id, url, json_input, agent_command):
 
     prompt = "\n".join(prompt_lines)
 
-    if agent_command:
-        cmd = shlex.split(agent_command)
-        cmd.append(prompt)
-        result = subprocess.run(cmd, check=False)
-        if result.returncode != 0:
-            click.secho(
-                f"Agent command failed with exit code {result.returncode}",
-                fg="red",
-                err=True,
-            )
-    else:
-        click.echo(prompt)
-        click.secho(
-            "\nCopy the prompt above to a coding agent. To run an agent automatically, use --agent-command or set the PLAIN_AGENT_COMMAND environment variable.",
-            dim=True,
-            italic=True,
-            err=True,
-        )
+    success = prompt_agent(prompt, agent_command, print_only)
+    if not success:
+        raise click.Abort()

plain_observer-0.3.4.dist-info/METADATA

@@ -0,0 +1,59 @@
+Metadata-Version: 2.4
+Name: plain.observer
+Version: 0.3.4
+Summary: On-page telemetry and observability tools for Plain.
+Author-email: Dave Gaeddert <dave.gaeddert@dropseed.dev>
+License-Expression: BSD-3-Clause
+License-File: LICENSE
+Requires-Python: >=3.11
+Requires-Dist: opentelemetry-sdk>=1.34.1
+Requires-Dist: plain-admin<1.0.0
+Requires-Dist: plain<1.0.0
+Description-Content-Type: text/markdown
+
+# plain.observer
+
+**On-page telemetry and observability tools for Plain.**
+
+- [Installation](#installation)
+
+## Installation
+
+Install the `plain.observer` package from [PyPI](https://pypi.org/project/plain.observer/):
+
+```bash
+uv add plain.observer
+```
+
+Add `plain.observer` to your `INSTALLED_PACKAGES`:
+
+```python
+# app/settings.py
+INSTALLED_PACKAGES = [
+    # ...
+    "plain.observer",
+]
+```
+
+Include the observer URLs in your URL configuration:
+
+```python
+# app/urls.py
+from plain.observer.urls import ObserverRouter
+from plain.urls import Router, include
+
+class AppRouter(Router):
+    namespace = ""
+    urls = [
+        # ...
+        include("observer/", ObserverRouter),
+    ]
+```
+
+Run migrations to create the necessary database tables:
+
+```bash
+plain migrate
+```
+
+After installation, Observer will automatically integrate with your application's toolbar (if using `plain.admin`). You can access the web interface at `/observer/traces/` or use the CLI commands to analyze traces.

{plain_observer-0.3.2.dist-info → plain_observer-0.3.4.dist-info}/RECORD

@@ -1,8 +1,8 @@
-plain/observer/CHANGELOG.md,sha256=Q7gKwSL1kcjuBtccwnXArsdjNFwuyafBUcfw-JA3Rks,3348
-plain/observer/README.md,sha256=5wM48-iE8i7xOjIK8KCgZ-Vmp2xpDtX73UnE5QeNnd4,31
+plain/observer/CHANGELOG.md,sha256=j1BKNuG5ejEPh5mCJ0h9AMHSdA9QwNjihvnWtjv1AJ0,4557
+plain/observer/README.md,sha256=39RA17fgcyOkqeIWBOAg4Be6YZjoiDzK5PVOG-nseuY,988
 plain/observer/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 plain/observer/admin.py,sha256=Csvd5V9F5u0zksWpbpISY_NlBJa-0TptSX_Kn652WRc,2719
-plain/observer/cli.py,sha256=-wNAYhChMsO_cxNLOvbFI_bpMWjlEetzGuK9lR47iS8,21026
+plain/observer/cli.py,sha256=oP_aeno-xYQ2YemQVNFwhmLevDdkf1uLRk-wpOUxqdU,20640
 plain/observer/config.py,sha256=FuJi1jiDSvOTcmP-6Ea4OlGZt5cRf4iTp1e0dgpJ45E,1494
 plain/observer/core.py,sha256=D9vX0GP8JBB8-NFAKrOwPSHl_wdZo1h0A5C6xKsJVjA,2245
 plain/observer/default_settings.py,sha256=JN2jT2wfa6f80EqU0p4Ox_47xyxL-Ym5-_pftY7xj2U,197
@@ -19,7 +19,7 @@ plain/observer/templates/observer/trace_share.html,sha256=HrYLti5BpX96-6Bm_37OOb
 plain/observer/templates/observer/traces.html,sha256=cFnlIuCf6XJEpHRD2_yfVmPDGZfiqMq6Cg-iMlT3CWY,22184
 plain/observer/templates/toolbar/observer.html,sha256=uaDKiWR7EYqC1kEXE-uHDlE7nfFEMR_zmOgvlKwQHJ4,1365
 plain/observer/templates/toolbar/observer_button.html,sha256=xsHJSuOjW6ddnxlPlPKek22WrWnuVYGIcBfFdkb76pk,1199
-plain_observer-0.3.2.dist-info/METADATA,sha256=Ljo4eyqmz5vPoxf1Lmgm32Om9S_gdRwGKrvFrRF_0lw,429
-plain_observer-0.3.2.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-plain_observer-0.3.2.dist-info/licenses/LICENSE,sha256=YZdq6Pz8ivjs97eSVLRmoGDI1hjEikX6N49DfM0DWio,1500
-plain_observer-0.3.2.dist-info/RECORD,,
+plain_observer-0.3.4.dist-info/METADATA,sha256=_z5gkIjRtiMiS7GelTKAwY1Xce1cSC8abmVnekHvpxo,1386
+plain_observer-0.3.4.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+plain_observer-0.3.4.dist-info/licenses/LICENSE,sha256=YZdq6Pz8ivjs97eSVLRmoGDI1hjEikX6N49DfM0DWio,1500
+plain_observer-0.3.4.dist-info/RECORD,,

plain_observer-0.3.2.dist-info/METADATA

@@ -1,16 +0,0 @@
-Metadata-Version: 2.4
-Name: plain.observer
-Version: 0.3.2
-Summary: On-page telemetry and observability tools for Plain.
-Author-email: Dave Gaeddert <dave.gaeddert@dropseed.dev>
-License-Expression: BSD-3-Clause
-License-File: LICENSE
-Requires-Python: >=3.11
-Requires-Dist: opentelemetry-sdk>=1.34.1
-Requires-Dist: plain-admin<1.0.0
-Requires-Dist: plain<1.0.0
-Description-Content-Type: text/markdown
-
-# plain.observer
-
-**Monitor.**