plain 0.58.0__tar.gz → 0.60.0__tar.gz

{plain-0.58.0 → plain-0.60.0}/PKG-INFO

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

{plain-0.58.0 → plain-0.60.0}/plain/CHANGELOG.md

@@ -1,5 +1,29 @@
 # plain changelog
 
+## [0.60.0](https://github.com/dropseed/plain/releases/plain@0.60.0) (2025-08-27)
+
+### What's changed
+
+- Added new `APP_VERSION` setting that defaults to the project version from `pyproject.toml` ([57fb948d46](https://github.com/dropseed/plain/commit/57fb948d46))
+- Updated `get_app_name_from_pyproject()` to `get_app_info_from_pyproject()` to return both name and version ([57fb948d46](https://github.com/dropseed/plain/commit/57fb948d46))
+
+### Upgrade instructions
+
+- No changes required
+
+## [0.59.0](https://github.com/dropseed/plain/releases/plain@0.59.0) (2025-08-22)
+
+### What's changed
+
+- Added new `APP_NAME` setting that defaults to the project name from `pyproject.toml` ([1a4d60e](https://github.com/dropseed/plain/commit/1a4d60e787))
+- Template views now validate that `get_template_names()` returns a list instead of a string ([428a64f](https://github.com/dropseed/plain/commit/428a64f8cc))
+- Object views now use cached properties for `.object` and `.objects` to improve performance ([bd0507a](https://github.com/dropseed/plain/commit/bd0507a72c))
+- Improved `plain upgrade` command to suggest using subagents when there are more than 3 package updates ([497c30d](https://github.com/dropseed/plain/commit/497c30d445))
+
+### Upgrade instructions
+
+- In object views, `self.load_object()` is no longer necessary as `self.object` is now a cached property.
+
 ## [0.58.0](https://github.com/dropseed/plain/releases/plain@0.58.0) (2025-08-19)
 
 ### What's changed

{plain-0.58.0 → plain-0.60.0}/plain/cli/upgrade.py

@@ -158,6 +158,7 @@ def build_prompt(before_after: dict[str, tuple[str | None, str | None]]) -> str:
             "",
             "3. **Available tools:**",
             "   - Python shell: `uv run python`",
+            "   - If you have a subagents feature and there are more than three packages here, use subagents",
             "",
             "4. **Workflow:**",
             "   - Review changelog for each package → Apply changes → Move to next package",

{plain-0.58.0 → plain-0.60.0}/plain/runtime/global_settings.py

@@ -3,10 +3,16 @@ Default Plain settings. Override these with settings in the module pointed to
 by the PLAIN_SETTINGS_MODULE environment variable.
 """
 
+from .utils import get_app_info_from_pyproject
+
 # MARK: Core Settings
 
 DEBUG: bool = False
 
+name, version = get_app_info_from_pyproject()
+APP_NAME: str = name
+APP_VERSION: str = version
+
 # List of strings representing installed packages.
 INSTALLED_PACKAGES: list[str] = []
 

plain-0.60.0/plain/runtime/utils.py

@@ -0,0 +1,23 @@
+import tomllib
+from pathlib import Path
+
+
+def get_app_info_from_pyproject():
+    """Get the project name and version from the nearest pyproject.toml file."""
+    current_path = Path.cwd()
+
+    # Walk up the directory tree looking for pyproject.toml
+    for path in [current_path] + list(current_path.parents):
+        pyproject_path = path / "pyproject.toml"
+        if pyproject_path.exists():
+            try:
+                with pyproject_path.open("rb") as f:
+                    pyproject = tomllib.load(f)
+                    project = pyproject.get("project", {})
+                    name = project.get("name", "App")
+                    version = project.get("version", "dev")
+                    return name, version
+            except (tomllib.TOMLDecodeError, OSError):
+                continue
+
+    return "App", "dev"

{plain-0.58.0 → plain-0.60.0}/plain/views/objects.py

@@ -1,28 +1,55 @@
+from functools import cached_property
+
 from plain.exceptions import ImproperlyConfigured, ObjectDoesNotExist
 from plain.forms import Form
-from plain.http import Http404, Response
+from plain.http import Http404
 
 from .forms import FormView
 from .templates import TemplateView
 
 
+class CreateView(FormView):
+    """
+    View for creating a new object, with a response rendered by a template.
+    """
+
+    # TODO? would rather you have to specify this...
+    def get_success_url(self, form):
+        """Return the URL to redirect to after processing a valid form."""
+        if self.success_url:
+            url = self.success_url.format(**self.object.__dict__)
+        else:
+            try:
+                url = self.object.get_absolute_url()
+            except AttributeError:
+                raise ImproperlyConfigured(
+                    "No URL to redirect to.  Either provide a url or define"
+                    " a get_absolute_url method on the Model."
+                )
+        return url
+
+    def form_valid(self, form):
+        """If the form is valid, save the associated model."""
+        self.object = form.save()
+        return super().form_valid(form)
+
+
 class ObjectTemplateViewMixin:
     context_object_name = ""
 
-    def get(self) -> Response:
-        self.load_object()
-        return self.render_template()
-
-    def load_object(self) -> None:
+    @cached_property
+    def object(self):
         try:
-            self.object = self.get_object()
+            obj = self.get_object()
         except ObjectDoesNotExist:
             raise Http404
 
-        if not self.object:
+        if not obj:
             # Also raise 404 if the object is None
             raise Http404
 
+        return obj
+
     def get_object(self):  # Intentionally untyped... subclasses must override this.
         raise NotImplementedError(
             f"get_object() is not implemented on {self.__class__.__name__}"
@@ -50,55 +77,9 @@ class DetailView(ObjectTemplateViewMixin, TemplateView):
     pass
 
 
-class CreateView(ObjectTemplateViewMixin, FormView):
-    """
-    View for creating a new object, with a response rendered by a template.
-    """
-
-    def post(self) -> Response:
-        """
-        Handle POST requests: instantiate a form instance with the passed
-        POST variables and then check if it's valid.
-        """
-        # Context expects self.object to exist
-        self.load_object()
-        return super().post()
-
-    def load_object(self) -> None:
-        self.object = None
-
-    # TODO? would rather you have to specify this...
-    def get_success_url(self, form):
-        """Return the URL to redirect to after processing a valid form."""
-        if self.success_url:
-            url = self.success_url.format(**self.object.__dict__)
-        else:
-            try:
-                url = self.object.get_absolute_url()
-            except AttributeError:
-                raise ImproperlyConfigured(
-                    "No URL to redirect to.  Either provide a url or define"
-                    " a get_absolute_url method on the Model."
-                )
-        return url
-
-    def form_valid(self, form):
-        """If the form is valid, save the associated model."""
-        self.object = form.save()
-        return super().form_valid(form)
-
-
 class UpdateView(ObjectTemplateViewMixin, FormView):
     """View for updating an object, with a response rendered by a template."""
 
-    def post(self) -> Response:
-        """
-        Handle POST requests: instantiate a form instance with the passed
-        POST variables and then check if it's valid.
-        """
-        self.load_object()
-        return super().post()
-
     def get_success_url(self, form):
         """Return the URL to redirect to after processing a valid form."""
         if self.success_url:
@@ -115,7 +96,7 @@ class UpdateView(ObjectTemplateViewMixin, FormView):
 
     def form_valid(self, form):
         """If the form is valid, save the associated model."""
-        self.object = form.save()
+        form.save()
         return super().form_valid(form)
 
     def get_form_kwargs(self):
@@ -141,14 +122,6 @@ class DeleteView(ObjectTemplateViewMixin, FormView):
 
     form_class = EmptyDeleteForm
 
-    def post(self) -> Response:
-        """
-        Handle POST requests: instantiate a form instance with the passed
-        POST variables and then check if it's valid.
-        """
-        self.load_object()
-        return super().post()
-
     def get_form_kwargs(self):
         """Return the keyword arguments for instantiating the form."""
         kwargs = super().get_form_kwargs()
@@ -169,9 +142,9 @@ class ListView(TemplateView):
 
     context_object_name = ""
 
-    def get(self) -> Response:
-        self.objects = self.get_objects()
-        return super().get()
+    @cached_property
+    def objects(self):
+        return self.get_objects()
 
     def get_objects(self):
         raise NotImplementedError(

{plain-0.58.0 → plain-0.60.0}/plain/views/templates.py

@@ -36,6 +36,12 @@ class TemplateView(View):
     def get_template(self) -> Template:
         template_names = self.get_template_names()
 
+        if isinstance(template_names, str):
+            raise ImproperlyConfigured(
+                f"{self.__class__.__name__}.get_template_names() must return a list of strings, "
+                f"not a string. Did you mean to return ['{template_names}']?"
+            )
+
         if not template_names:
             raise ImproperlyConfigured(
                 f"{self.__class__.__name__} requires a template_name or get_template_names()."

{plain-0.58.0 → plain-0.60.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "plain"
-version = "0.58.0"
+version = "0.60.0"
 description = "A web framework for building products with Python."
 authors = [{name = "Dave Gaeddert", email = "dave.gaeddert@dropseed.dev"}]
 readme = "README.md"