plain 0.50.0__tar.gz → 0.52.0__tar.gz

{plain-0.50.0 → plain-0.52.0}/PKG-INFO

@@ -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.52.0/plain/CHANGELOG.md

@@ -0,0 +1,58 @@
+# 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
+
+- The URL inspection command has moved; run `plain urls list` instead of the old `plain urls` command ([6146fcb](https://github.com/dropseed/plain/commit/6146fcba536c551277d625bd750c385431ea18eb))
+- `plain preflight` gains a simpler `--database` flag that enables database checks for your default database. The previous behaviour that accepted one or more database aliases has been removed ([d346d81](https://github.com/dropseed/plain/commit/d346d81567d2cc45bbed93caba18a195de10c572))
+- Settings overhaul: use a single `DATABASE` setting instead of `DATABASES`/`DATABASE_ROUTERS` ([d346d81](https://github.com/dropseed/plain/commit/d346d81567d2cc45bbed93caba18a195de10c572))
+
+### Upgrade instructions
+
+- Update any scripts or documentation that call `plain urls …`:
+    - 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`
+- 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.

plain-0.52.0/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-0.50.0 → plain-0.52.0}/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-0.50.0 → plain-0.52.0}/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-0.52.0/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 → plain-0.52.0}/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 → plain-0.52.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "plain"
-version = "0.50.0"
+version = "0.52.0"
 description = "A web framework for building products with Python."
 authors = [{name = "Dave Gaeddert", email = "dave.gaeddert@dropseed.dev"}]
 readme = "README.md"
@@ -13,6 +13,10 @@ requires-python = ">=3.11"
 [project.scripts]
 plain = "plain.cli.core:cli"
 
+# Make this directly available without loading Plain,
+# for use in upgrade scripts.
+plain-changelog = "plain.cli.changelog:changelog"
+
 [tool.uv]
 dev-dependencies = [
     "pytest>=8.0.0",

{plain-0.50.0 → plain-0.52.0}/tests/test_cli.py

@@ -23,3 +23,22 @@ def test_plain_help_command():
     assert result.exit_code == 0
     assert "Usage: plain build" in result.output
     assert "Usage: plain shell" in result.output
+
+
+def test_plain_changelog_plain():
+    runner = CliRunner()
+    result = runner.invoke(cli, ["changelog", "plain"], prog_name="plain")
+    assert result.exit_code == 0
+    assert "0.50.0" in result.output
+
+
+def test_plain_changelog_range_warning():
+    runner = CliRunner()
+    result = runner.invoke(
+        cli,
+        ["changelog", "plain", "--from", "0.49.0", "--to", "0.50.0"],
+        prog_name="plain",
+    )
+    assert result.exit_code == 0
+    assert "0.50.0" in result.output
+    assert "Warning" in result.output

plain-0.50.0/plain/CHANGELOG.md

@@ -1,33 +0,0 @@
-# plain changelog
-
-## [0.50.0](https://github.com/dropseed/plain/releases/plain@0.50.0) (2025-06-23)
-
-### What's changed
-
-- The URL inspection command has moved; run `plain urls list` instead of the old `plain urls` command ([6146fcb](https://github.com/dropseed/plain/commit/6146fcba536c551277d625bd750c385431ea18eb))
-- `plain preflight` gains a simpler `--database` flag that enables database checks for your default database. The previous behaviour that accepted one or more database aliases has been removed ([d346d81](https://github.com/dropseed/plain/commit/d346d81567d2cc45bbed93caba18a195de10c572))
-- Settings overhaul: use a single `DATABASE` setting instead of `DATABASES`/`DATABASE_ROUTERS` ([d346d81](https://github.com/dropseed/plain/commit/d346d81567d2cc45bbed93caba18a195de10c572))
-
-### Upgrade instructions
-
-- Update any scripts or documentation that call `plain urls …`:
-  - 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`
-- 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.