plain 0.58.0__py3-none-any.whl → 0.60.0__py3-none-any.whl

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/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/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/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/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/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.dist-info → plain-0.60.0.dist-info}/METADATA

@@ -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.dist-info → plain-0.60.0.dist-info}/RECORD

@@ -1,4 +1,4 @@
-plain/CHANGELOG.md,sha256=NnYEqRRQ2lTPIgppmEarKtSZRoLq_N80pgXjyGf6c00,9602
+plain/CHANGELOG.md,sha256=D_pNXRYALt2M76lgFw0DsNBweBA3wjnESTQycSEMz68,10968
 plain/README.md,sha256=5BJyKhf0TDanWVbOQyZ3zsi5Lov9xk-LlJYCDWofM6Y,4078
 plain/__main__.py,sha256=GK39854Lc_LO_JP8DzY9Y2MIQ4cQEl7SXFJy244-lC8,110
 plain/debug.py,sha256=XdjnXcbPGsi0J2SpHGaLthhYU5AjhBlkHdemaP4sbYY,758
@@ -37,7 +37,7 @@ plain/cli/scaffold.py,sha256=mcywA9DzfwoBSqWl5-Zpgcy1mTNUGEgdvoxXUrGcEVk,1351
 plain/cli/settings.py,sha256=9cx4bue664I2P7kUedlf4YhCPB0tSKSE4Q8mGyzEv2o,1995
 plain/cli/shell.py,sha256=iIwvlTdTBjLBBUdXMAmIRWSoynszOZI79-mrBg4RegU,1373
 plain/cli/startup.py,sha256=wLaFuyUb4ewWhtehBCGicrRCXIIGCRbeCT3ce9hUv-A,1022
-plain/cli/upgrade.py,sha256=f1rL9M285i4D5UKlEk4ijmAUN3mAMfHCrbDPwBf1ePo,5514
+plain/cli/upgrade.py,sha256=eGVWm0gpn-Pr6uPsfzojRmh_VU5--B0h9dYfQuXSzi8,5625
 plain/cli/urls.py,sha256=ghCW36aRszxmTo06A50FIvYopb6kQ07QekkDzM6_A1o,3824
 plain/cli/utils.py,sha256=VwlIh0z7XxzVV8I3qM2kZo07fkJFPoeeVZa1ODG616k,258
 plain/csrf/README.md,sha256=ApWpB-qlEf0LkOKm9Yr-6f_lB9XJEvGFDo_fraw8ghI,2391
@@ -90,8 +90,9 @@ plain/preflight/security.py,sha256=oxUZBp2M0bpBfUoLYepIxoex2Y90nyjlrL8XU8UTHYY,2
 plain/preflight/urls.py,sha256=cQ-WnFa_5oztpKdtwhuIGb7pXEml__bHsjs1SWO2YNI,1468
 plain/runtime/README.md,sha256=sTqXXJkckwqkk9O06XMMSNRokAYjrZBnB50JD36BsYI,4873
 plain/runtime/__init__.py,sha256=8GtvKROf3HUCtneDYXTbEioPcCtwnV76dP57n2PnjuE,2343
-plain/runtime/global_settings.py,sha256=6vy8SacB4w4x_BAGsJv6zM3Sa7zcvnEcF2VzHfZs8qk,5645
+plain/runtime/global_settings.py,sha256=LX4g0ncNif_STuM83Idcron1j_TnQ9TJwWbVywexyZo,5788
 plain/runtime/user_settings.py,sha256=OzMiEkE6ZQ50nxd1WIqirXPiNuMAQULklYHEzgzLWgA,11027
+plain/runtime/utils.py,sha256=p5IuNTzc7Kq-9Ym7etYnt_xqHw5TioxfSkFeq1bKdgk,832
 plain/signals/README.md,sha256=XefXqROlDhzw7Z5l_nx6Mhq6n9jjQ-ECGbH0vvhKWYg,272
 plain/signals/__init__.py,sha256=eAs0kLqptuP6I31dWXeAqRNji3svplpAV4Ez6ktjwXM,131
 plain/signals/dispatch/__init__.py,sha256=FzEygqV9HsM6gopio7O2Oh_X230nA4d5Q9s0sUjMq0E,292
@@ -148,11 +149,11 @@ plain/views/base.py,sha256=CC9UvMZeAjVvi90vGjoZzsQ0jnhbg3-7qCKQ8-Pb6cg,4184
 plain/views/errors.py,sha256=jbNCJIzowwCsEvqyJ3opMeZpPDqTyhtrbqb0VnAm2HE,1263
 plain/views/exceptions.py,sha256=b4euI49ZUKS9O8AGAcFfiDpstzkRAuuj_uYQXzWNHME,138
 plain/views/forms.py,sha256=ESZOXuo6IeYixp1RZvPb94KplkowRiwO2eGJCM6zJI0,2400
-plain/views/objects.py,sha256=GGbcfg_9fPZ-PiaBwIHG2e__8GfWDR7JQtQ15wTyiHg,5970
+plain/views/objects.py,sha256=YNb8MO1I99HTmQghC5nFk25TQmaB_s45K5yg5BGt4qY,5018
 plain/views/redirect.py,sha256=Xpb3cB7nZYvKgkNqcAxf9Jwm2SWcQ0u2xz4oO5M3vP8,1909
-plain/views/templates.py,sha256=TeVKxfyXwQTmWfWzwjtlZ8GXogcHUDZ1osc--G4YLVw,1588
-plain-0.58.0.dist-info/METADATA,sha256=yNuHnxpkBcNUME3wBUBvYxV-X6brEHQaXUGeMdFC3qc,4488
-plain-0.58.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-plain-0.58.0.dist-info/entry_points.txt,sha256=nn4uKTRRZuEKOJv3810s3jtSMW0Gew7XDYiKIvBRR6M,93
-plain-0.58.0.dist-info/licenses/LICENSE,sha256=m0D5O7QoH9l5Vz_rrX_9r-C8d9UNr_ciK6Qwac7o6yo,3175
-plain-0.58.0.dist-info/RECORD,,
+plain/views/templates.py,sha256=oAlebEyfES0rzBhfyEJzFmgLkpkbleA6Eip-8zDp-yk,1863
+plain-0.60.0.dist-info/METADATA,sha256=w-VNXX3R5YsTPJ_UBnFSzu33jUHnwPHAQdzMJZxILhc,4488
+plain-0.60.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+plain-0.60.0.dist-info/entry_points.txt,sha256=nn4uKTRRZuEKOJv3810s3jtSMW0Gew7XDYiKIvBRR6M,93
+plain-0.60.0.dist-info/licenses/LICENSE,sha256=m0D5O7QoH9l5Vz_rrX_9r-C8d9UNr_ciK6Qwac7o6yo,3175
+plain-0.60.0.dist-info/RECORD,,