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

plain/CHANGELOG.md

@@ -1,5 +1,15 @@
 # plain changelog
 
+## [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 +21,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,76 @@
+import re
+from importlib.util import find_spec
+from pathlib import Path
+
+import click
+from packaging.version import Version
+
+from .output import style_markdown
+
+
+@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}")
+
+    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(Version(v) == Version(version) 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:
+        v = Version(version)
+        if from_version and v <= Version(from_version):
+            continue
+        if to_version and v > Version(to_version):
+            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-0.50.0.dist-info → plain-0.51.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: plain
-Version: 0.50.0
+Version: 0.51.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.51.0.dist-info}/RECORD

@@ -1,4 +1,4 @@
-plain/CHANGELOG.md,sha256=Bl0GLzelbqK3Tyg-dAGBcHG49JwXtH3g6GHFCl-LEpk,1554
+plain/CHANGELOG.md,sha256=lE0zfshrzDi6rsj59KWtZdcM9cqkCtqf7XrC4Tb7JUA,1996
 plain/README.md,sha256=gik6DBZcJAITcm4WRq_L53AxkjY45eQLafyTCSf0CKE,3986
 plain/__main__.py,sha256=GK39854Lc_LO_JP8DzY9Y2MIQ4cQEl7SXFJy244-lC8,110
 plain/debug.py,sha256=abPkJY4aSbBYGEYSZST_ZY3ohXPGDdz9uWQBYRqfd3M,730
@@ -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=VRcL0v_r8tPSe-6fGGsa-OCgdhLMrwj6TnpmPilQb6Y,2441
 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.51.0.dist-info/METADATA,sha256=xzYeAOLD7gvPsfMUMhQJIR0nsBc6VAUZ08bZ1Hyodao,4297
+plain-0.51.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+plain-0.51.0.dist-info/entry_points.txt,sha256=1Ys2lsSeMepD1vz8RSrJopna0RQfUd951vYvCRsvl6A,45
+plain-0.51.0.dist-info/licenses/LICENSE,sha256=m0D5O7QoH9l5Vz_rrX_9r-C8d9UNr_ciK6Qwac7o6yo,3175
+plain-0.51.0.dist-info/RECORD,,