plain 0.50.0__py3-none-any.whl → 0.52.0__py3-none-any.whl

plain/CHANGELOG.md

@@ -1,5 +1,28 @@
 # plain changelog
 
+## [0.52.0](https://github.com/dropseed/plain/releases/plain@0.52.0) (2025-06-26)
+
+### What's changed
+
+- Added `plain-changelog` as a standalone executable so you can view changelogs without importing the full framework ([e4e7324](https://github.com/dropseed/plain/commit/e4e7324cd284c800ff957933748d6639615cbea6))
+- Removed the runtime dependency on the `packaging` library by replacing it with an internal version-comparison helper ([e4e7324](https://github.com/dropseed/plain/commit/e4e7324cd284c800ff957933748d6639615cbea6))
+- Improved the error message when a package changelog cannot be found, now showing the path that was looked up ([f3c82bb](https://github.com/dropseed/plain/commit/f3c82bb59e07c1bddbdb2557f2043e039c1cd1e9))
+- Fixed an f-string issue that broke `plain.debug.dd` on Python 3.11 ([ed24276](https://github.com/dropseed/plain/commit/ed24276a12191e4c8903369002dd32b69eb358b3))
+
+### Upgrade instructions
+
+- No changes required
+
+## [0.51.0](https://github.com/dropseed/plain/releases/plain@0.51.0) (2025-06-24)
+
+### What's changed
+
+- New `plain changelog` CLI sub-command to quickly view a package’s changelog from the terminal. Supports `--from`/`--to` flags to limit the version range ([50f0de7](https://github.com/dropseed/plain/commit/50f0de721f263ec6274852bd8838f4e5037b27dc)).
+
+### Upgrade instructions
+
+- No changes required
+
 ## [0.50.0](https://github.com/dropseed/plain/releases/plain@0.50.0) (2025-06-23)
 
 ### What's changed
@@ -11,23 +34,25 @@
 ### Upgrade instructions
 
 - Update any scripts or documentation that call `plain urls …`:
-  - Replace `plain urls --flat` with `plain urls list --flat`
+    - Replace `plain urls --flat` with `plain urls list --flat`
 - If you invoke preflight checks in CI or locally:
-  - Replace `plain preflight --database <alias>` (or multiple aliases) with the new boolean flag: `plain preflight --database`
+    - Replace `plain preflight --database <alias>` (or multiple aliases) with the new boolean flag: `plain preflight --database`
 - In `settings.py` migrate to the new database configuration:
-  ```python
-  # Before
-  DATABASES = {
-      "default": {
-          "ENGINE": "plain.backends.sqlite3",
-          "NAME": BASE_DIR / "db.sqlite3",
-      }
-  }
-
-  # After
-  DATABASE = {
-      "ENGINE": "plain.backends.sqlite3",
-      "NAME": BASE_DIR / "db.sqlite3",
-  }
-  ```
-  Remove any `DATABASES` and `DATABASE_ROUTERS` settings – they are no longer read.
+
+    ```python
+    # Before
+    DATABASES = {
+        "default": {
+            "ENGINE": "plain.backends.sqlite3",
+            "NAME": BASE_DIR / "db.sqlite3",
+        }
+    }
+
+    # After
+    DATABASE = {
+        "ENGINE": "plain.backends.sqlite3",
+        "NAME": BASE_DIR / "db.sqlite3",
+    }
+    ```
+
+    Remove any `DATABASES` and `DATABASE_ROUTERS` settings – they are no longer read.

plain/cli/changelog.py

@@ -0,0 +1,109 @@
+import re
+from importlib.util import find_spec
+from pathlib import Path
+
+import click
+
+from .output import style_markdown
+
+
+def parse_version(version_str):
+    """Parse a version string into a tuple of integers for comparison."""
+    # Remove 'v' prefix if present and split by dots
+    clean_version = version_str.lstrip("v")
+    parts = []
+    for part in clean_version.split("."):
+        # Extract numeric part from each segment
+        numeric_part = re.match(r"\d+", part)
+        if numeric_part:
+            parts.append(int(numeric_part.group()))
+        else:
+            parts.append(0)
+    return tuple(parts)
+
+
+def compare_versions(v1, v2):
+    """Compare two version strings. Returns -1 if v1 < v2, 0 if equal, 1 if v1 > v2."""
+    parsed_v1 = parse_version(v1)
+    parsed_v2 = parse_version(v2)
+
+    # Pad shorter version with zeros
+    max_len = max(len(parsed_v1), len(parsed_v2))
+    parsed_v1 += (0,) * (max_len - len(parsed_v1))
+    parsed_v2 += (0,) * (max_len - len(parsed_v2))
+
+    if parsed_v1 < parsed_v2:
+        return -1
+    elif parsed_v1 > parsed_v2:
+        return 1
+    else:
+        return 0
+
+
+@click.command("changelog")
+@click.argument("package_label")
+@click.option("--from", "from_version", help="Show entries from this version onwards")
+@click.option("--to", "to_version", help="Show entries up to this version")
+def changelog(package_label, from_version, to_version):
+    """Show changelog entries for a package."""
+    module_name = package_label.replace("-", ".")
+    spec = find_spec(module_name)
+    if not spec:
+        raise click.ClickException(f"Package {package_label} not found")
+
+    if spec.origin:
+        package_path = Path(spec.origin).resolve().parent
+    elif spec.submodule_search_locations:
+        package_path = Path(list(spec.submodule_search_locations)[0]).resolve()
+    else:
+        raise click.ClickException(f"Package {package_label} not found")
+
+    changelog_path = package_path / "CHANGELOG.md"
+    if not changelog_path.exists():
+        raise click.ClickException(
+            f"Changelog not found for {package_label} ({changelog_path})"
+        )
+
+    content = changelog_path.read_text()
+
+    entries = []
+    current_version = None
+    current_lines = []
+    version_re = re.compile(r"^## \[([^\]]+)\]")
+
+    for line in content.splitlines(keepends=True):
+        m = version_re.match(line)
+        if m:
+            if current_version is not None:
+                entries.append((current_version, current_lines))
+            current_version = m.group(1)
+            current_lines = [line]
+        else:
+            if current_version is not None:
+                current_lines.append(line)
+
+    if current_version is not None:
+        entries.append((current_version, current_lines))
+
+    def version_found(version):
+        return any(compare_versions(v, version) == 0 for v, _ in entries)
+
+    if from_version and not version_found(from_version):
+        click.secho(
+            f"Warning: version {from_version} not found in changelog",
+            fg="yellow",
+            err=True,
+        )
+
+    selected_lines = []
+    for version, lines in entries:
+        if from_version and compare_versions(version, from_version) <= 0:
+            continue
+        if to_version and compare_versions(version, to_version) > 0:
+            continue
+        selected_lines.extend(lines)
+
+    if not selected_lines:
+        return
+
+    click.echo(style_markdown("".join(selected_lines)))

plain/cli/core.py

@@ -7,6 +7,7 @@ import plain.runtime
 from plain.exceptions import ImproperlyConfigured
 
 from .build import build
+from .changelog import changelog
 from .chores import chores
 from .docs import docs
 from .formatting import PlainContext
@@ -32,6 +33,7 @@ plain_cli.add_command(chores)
 plain_cli.add_command(build)
 plain_cli.add_command(utils)
 plain_cli.add_command(urls)
+plain_cli.add_command(changelog)
 plain_cli.add_command(setting)
 plain_cli.add_command(shell)
 plain_cli.add_command(run)

plain/cli/docs.py

@@ -7,6 +7,8 @@ import click
 
 from plain.packages import packages_registry
 
+from .output import iterate_markdown
+
 
 @click.command()
 @click.option("--llm", "llm", is_flag=True)
@@ -59,43 +61,7 @@ def docs(module, llm, open):
         if open:
             click.launch(str(readme_path))
         else:
-
-            def _iterate_markdown(content):
-                """
-                Iterator that does basic markdown for a Click pager.
-
-                Headings are yellow and bright, code blocks are indented.
-                """
-
-                in_code_block = False
-                for line in content.splitlines():
-                    if line.startswith("```"):
-                        in_code_block = not in_code_block
-
-                    if in_code_block:
-                        yield click.style(line, dim=True)
-                    elif line.startswith("# "):
-                        yield click.style(line, fg="yellow", bold=True)
-                    elif line.startswith("## "):
-                        yield click.style(line, fg="yellow", bold=True)
-                    elif line.startswith("### "):
-                        yield click.style(line, fg="yellow", bold=True)
-                    elif line.startswith("#### "):
-                        yield click.style(line, fg="yellow", bold=True)
-                    elif line.startswith("##### "):
-                        yield click.style(line, fg="yellow", bold=True)
-                    elif line.startswith("###### "):
-                        yield click.style(line, fg="yellow", bold=True)
-                    elif line.startswith("**") and line.endswith("**"):
-                        yield click.style(line, bold=True)
-                    elif line.startswith("> "):
-                        yield click.style(line, italic=True)
-                    else:
-                        yield line
-
-                    yield "\n"
-
-            click.echo_via_pager(_iterate_markdown(readme_path.read_text()))
+            click.echo_via_pager(iterate_markdown(readme_path.read_text()))
 
 
 class LLMDocs:

plain/cli/output.py

@@ -0,0 +1,41 @@
+import click
+
+
+def style_markdown(content):
+    return "".join(iterate_markdown(content))
+
+
+def iterate_markdown(content):
+    """
+    Iterator that does basic markdown for a Click pager.
+
+    Headings are yellow and bright, code blocks are indented.
+    """
+
+    in_code_block = False
+    for line in content.splitlines():
+        if line.startswith("```"):
+            in_code_block = not in_code_block
+
+        if in_code_block:
+            yield click.style(line, dim=True)
+        elif line.startswith("# "):
+            yield click.style(line, fg="yellow", bold=True)
+        elif line.startswith("## "):
+            yield click.style(line, fg="yellow", bold=True)
+        elif line.startswith("### "):
+            yield click.style(line, fg="yellow", bold=True)
+        elif line.startswith("#### "):
+            yield click.style(line, fg="yellow", bold=True)
+        elif line.startswith("##### "):
+            yield click.style(line, fg="yellow", bold=True)
+        elif line.startswith("###### "):
+            yield click.style(line, fg="yellow", bold=True)
+        elif line.startswith("**") and line.endswith("**"):
+            yield click.style(line, bold=True)
+        elif line.startswith("> "):
+            yield click.style(line, italic=True)
+        else:
+            yield line
+
+        yield "\n"

plain/debug.py

@@ -13,13 +13,14 @@ def dd(*objs):
     Dump the object and raise a ResponseException with the dump as the response content.
     """
 
-    print(f"Dumping objects:\n{'\n'.join([pformat(obj) for obj in objs])}")
+    print_objs = "\n".join([pformat(obj) for obj in objs])
+    print(f"Dumping objects:\n{print_objs}")
 
-    dump_strs = [
+    html_objs = [
         Markup("<pre><code>") + escape(pformat(obj)) + Markup("</code></pre>")
         for obj in objs
     ]
-    combined_dump_str = Markup("\n\n").join(dump_strs)
+    combined_dump_str = Markup("\n\n").join(html_objs)
 
     response = Response()
     response.status_code = 500

{plain-0.50.0.dist-info → plain-0.52.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: plain
-Version: 0.50.0
+Version: 0.52.0
 Summary: A web framework for building products with Python.
 Author-email: Dave Gaeddert <dave.gaeddert@dropseed.dev>
 License-File: LICENSE

{plain-0.50.0.dist-info → plain-0.52.0.dist-info}/RECORD

@@ -1,7 +1,7 @@
-plain/CHANGELOG.md,sha256=Bl0GLzelbqK3Tyg-dAGBcHG49JwXtH3g6GHFCl-LEpk,1554
+plain/CHANGELOG.md,sha256=G6FJgX85XVgzIKKIvEYLQ_f4Fzp6R0FsEesEpzgPGRE,2945
 plain/README.md,sha256=gik6DBZcJAITcm4WRq_L53AxkjY45eQLafyTCSf0CKE,3986
 plain/__main__.py,sha256=GK39854Lc_LO_JP8DzY9Y2MIQ4cQEl7SXFJy244-lC8,110
-plain/debug.py,sha256=abPkJY4aSbBYGEYSZST_ZY3ohXPGDdz9uWQBYRqfd3M,730
+plain/debug.py,sha256=XdjnXcbPGsi0J2SpHGaLthhYU5AjhBlkHdemaP4sbYY,758
 plain/exceptions.py,sha256=Z9cbPE5im_Y-bjVq8cqC85gBoqOr80rLFG5wTKixrwE,5894
 plain/json.py,sha256=McJdsbMT1sYwkGRG--f2NSZz0hVXPMix9x3nKaaak2o,1262
 plain/paginator.py,sha256=iXiOyt2r_YwNrkqCRlaU7V-M_BKaaQ8XZElUBVa6yeU,5844
@@ -21,11 +21,13 @@ plain/chores/registry.py,sha256=V3WjuekRI22LFvJbqSkUXQtiOtuE2ZK8gKV1TRvxRUI,1866
 plain/cli/README.md,sha256=GzBry6mEilhM80SfVUg02ydGwAk0m-s6FAqQR1nRsMM,2022
 plain/cli/__init__.py,sha256=6w9T7K2WrPwh6DcaMb2oNt_CWU6Bc57nUTO2Bt1p38Y,63
 plain/cli/build.py,sha256=dKUYBNegvb6QNckR7XZ7CJJtINwZcmDvbUdv2dWwjf8,3226
+plain/cli/changelog.py,sha256=j-k1yZk9mpm-fLZgeWastiyIisxNSuAJfXTQ2B6WQmk,3457
 plain/cli/chores.py,sha256=xXSSFvr8T5jWfLWqe6E8YVMw1BkQxyOHHVuY0x9RH0A,2412
-plain/cli/core.py,sha256=h8gjeBYQzYTzpmeDMAJTdVDOEoNCNcvnxml-KIsiRPo,2925
-plain/cli/docs.py,sha256=2CpTv5k-TNWf593tPiglvUVXWBGdfPmbGf8vl5AfJwU,8995
+plain/cli/core.py,sha256=D3t83ujjjHayblM-RuttrGoNf8hMV9-l3zQsbhVAjWU,2991
+plain/cli/docs.py,sha256=KCJCP_OVFb34zOkA6x7X6-iGFzx2tv4ZgXAM99TjWNg,7443
 plain/cli/formatting.py,sha256=1hZH13y1qwHcU2K2_Na388nw9uvoeQH8LrWL-O9h8Yc,2207
 plain/cli/help.py,sha256=otRSGxOJ5V8JMjpdZ8XYqUbdlYdJvxOMzQroLOWw-l0,801
+plain/cli/output.py,sha256=Fe3xS6Va4Bi1ZNrqi0nh09THTsdCyMW2b9SPY5I4n-o,1318
 plain/cli/preflight.py,sha256=FWFwMZ0W_t8ObTTRMnBmaiGN8PqdEAWgmSEPGDwZFpA,4148
 plain/cli/print.py,sha256=XraUYrgODOJquIiEv78wSCYGRBplHXtXSS9QtFG5hqY,217
 plain/cli/registry.py,sha256=yKVMSDjW8g10nlV9sPXFGJQmhC_U-k4J4kM7N2OQVLA,1467
@@ -147,8 +149,8 @@ plain/views/forms.py,sha256=ESZOXuo6IeYixp1RZvPb94KplkowRiwO2eGJCM6zJI0,2400
 plain/views/objects.py,sha256=GGbcfg_9fPZ-PiaBwIHG2e__8GfWDR7JQtQ15wTyiHg,5970
 plain/views/redirect.py,sha256=daq2cQIkdDF78bt43sjuZxRAyJm_t_SKw6tyPmiXPIc,1985
 plain/views/templates.py,sha256=ivkI7LU7BXDQ0d4Geab96Is4-Cp03KbIntXRT1J8e6I,2139
-plain-0.50.0.dist-info/METADATA,sha256=GLcRDpS06XPtx52qLG5bIfrROE3g8CFffLNSz6Mdxt8,4297
-plain-0.50.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-plain-0.50.0.dist-info/entry_points.txt,sha256=1Ys2lsSeMepD1vz8RSrJopna0RQfUd951vYvCRsvl6A,45
-plain-0.50.0.dist-info/licenses/LICENSE,sha256=m0D5O7QoH9l5Vz_rrX_9r-C8d9UNr_ciK6Qwac7o6yo,3175
-plain-0.50.0.dist-info/RECORD,,
+plain-0.52.0.dist-info/METADATA,sha256=9Be3llzAmN2bZO2s_UPhej77hxsHZEntBmYbOarzbQw,4297
+plain-0.52.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+plain-0.52.0.dist-info/entry_points.txt,sha256=nn4uKTRRZuEKOJv3810s3jtSMW0Gew7XDYiKIvBRR6M,93
+plain-0.52.0.dist-info/licenses/LICENSE,sha256=m0D5O7QoH9l5Vz_rrX_9r-C8d9UNr_ciK6Qwac7o6yo,3175
+plain-0.52.0.dist-info/RECORD,,

plain-0.52.0.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+plain = plain.cli.core:cli
+plain-changelog = plain.cli.changelog:changelog

plain-0.50.0.dist-info/entry_points.txt

@@ -1,2 +0,0 @@
-[console_scripts]
-plain = plain.cli.core:cli