plain.oauth 0.29.0__py3-none-any.whl → 0.29.2__py3-none-any.whl

plain/oauth/CHANGELOG.md

@@ -1,5 +1,26 @@
 # plain-oauth changelog
 
+## [0.29.2](https://github.com/dropseed/plain/releases/plain-oauth@0.29.2) (2025-10-06)
+
+### What's changed
+
+- Added type annotations to improve IDE and type checker friendliness ([35fb8c4](https://github.com/dropseed/plain/commit/35fb8c4))
+- Updated provider examples (Bitbucket, GitHub, GitLab) with proper type annotations ([50463b0](https://github.com/dropseed/plain/commit/50463b0))
+
+### Upgrade instructions
+
+- No changes required
+
+## [0.29.1](https://github.com/dropseed/plain/releases/plain-oauth@0.29.1) (2025-10-02)
+
+### What's changed
+
+- Updated documentation examples to use `get_current_user()` instead of `request.user` ([f6278d9](https://github.com/dropseed/plain/commit/f6278d9bb4))
+
+### Upgrade instructions
+
+- No changes required
+
 ## [0.29.0](https://github.com/dropseed/plain/releases/plain-oauth@0.29.0) (2025-10-02)
 
 ### What's changed

plain/oauth/README.md

@@ -182,11 +182,11 @@ Here's an very basic example:
 {% extends "base.html" %}
 
 {% block content %}
-Hello {{ request.user }}!
+Hello {{ get_current_user() }}!
 
 <h2>Existing connections</h2>
 <ul>
-    {% for connection in request.user.oauth_connections.all %}
+    {% for connection in get_current_user().oauth_connections.all %}
     <li>
         {{ connection.provider_key }} [ID: {{ connection.provider_user_id }}]
         <form action="{% url 'oauth:disconnect' connection.provider_key %}" method="post">

plain/oauth/models.py

@@ -1,4 +1,4 @@
-from typing import TYPE_CHECKING
+from typing import TYPE_CHECKING, Any
 
 from plain import models
 from plain.auth import get_user_model
@@ -50,7 +50,7 @@ class OAuthConnection(models.Model):
         ]
         ordering = ("provider_key",)
 
-    def __str__(self):
+    def __str__(self) -> str:
         return f"{self.provider_key}[{self.user}:{self.provider_user_id}]"
 
     def refresh_access_token(self) -> None:
@@ -69,13 +69,13 @@ class OAuthConnection(models.Model):
         self.set_token_fields(refreshed_oauth_token)
         self.save()
 
-    def set_token_fields(self, oauth_token: "OAuthToken"):
+    def set_token_fields(self, oauth_token: "OAuthToken") -> None:
         self.access_token = oauth_token.access_token
         self.refresh_token = oauth_token.refresh_token
         self.access_token_expires_at = oauth_token.access_token_expires_at
         self.refresh_token_expires_at = oauth_token.refresh_token_expires_at
 
-    def set_user_fields(self, oauth_user: "OAuthUser"):
+    def set_user_fields(self, oauth_user: "OAuthUser") -> None:
         self.provider_user_id = oauth_user.provider_id
 
     def access_token_expired(self) -> bool:
@@ -125,7 +125,7 @@ class OAuthConnection(models.Model):
     def connect(
         cls,
         *,
-        user,
+        user: Any,
         provider_key: str,
         oauth_token: "OAuthToken",
         oauth_user: "OAuthUser",
@@ -155,7 +155,7 @@ class OAuthConnection(models.Model):
         return connection
 
     @classmethod
-    def preflight(cls):
+    def preflight(cls) -> list[PreflightResult]:
         """
         A system check for ensuring that provider_keys in the database are also present in settings.
         """

plain/oauth/providers.py

@@ -40,7 +40,7 @@ class OAuthUser:
         self.provider_id = provider_id  # ID on the provider's system
         self.user_model_fields = user_model_fields or {}
 
-    def __str__(self):
+    def __str__(self) -> str:
         if "email" in self.user_model_fields:
             return self.user_model_fields["email"]
         if "username" in self.user_model_fields:

plain/oauth/views.py

@@ -2,7 +2,7 @@ import logging
 
 from plain.auth.requests import get_request_user
 from plain.auth.views import AuthViewMixin
-from plain.http import ResponseRedirect
+from plain.http import Response, ResponseRedirect
 from plain.views import TemplateView, View
 
 from .exceptions import (
@@ -14,7 +14,7 @@ logger = logging.getLogger(__name__)
 
 
 class OAuthLoginView(View):
-    def post(self):
+    def post(self) -> Response:
         request = self.request
         provider = self.url_kwargs["provider"]
         if get_request_user(request):
@@ -31,7 +31,7 @@ class OAuthCallbackView(TemplateView):
 
     template_name = "oauth/callback.html"
 
-    def get(self):
+    def get(self) -> Response:
         provider = self.url_kwargs["provider"]
         provider_instance = get_oauth_provider_instance(provider_key=provider)
         try:
@@ -51,7 +51,7 @@ class OAuthCallbackView(TemplateView):
 
 
 class OAuthConnectView(AuthViewMixin, View):
-    def post(self):
+    def post(self) -> Response:
         request = self.request
         provider = self.url_kwargs["provider"]
         provider_instance = get_oauth_provider_instance(provider_key=provider)
@@ -59,7 +59,7 @@ class OAuthConnectView(AuthViewMixin, View):
 
 
 class OAuthDisconnectView(AuthViewMixin, View):
-    def post(self):
+    def post(self) -> Response:
         request = self.request
         provider = self.url_kwargs["provider"]
         provider_instance = get_oauth_provider_instance(provider_key=provider)

{plain_oauth-0.29.0.dist-info → plain_oauth-0.29.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: plain.oauth
-Version: 0.29.0
+Version: 0.29.2
 Summary: Let users log in with OAuth providers.
 Author-email: Dave Gaeddert <dave.gaeddert@dropseed.dev>
 License-Expression: BSD-3-Clause
@@ -196,11 +196,11 @@ Here's an very basic example:
 {% extends "base.html" %}
 
 {% block content %}
-Hello {{ request.user }}!
+Hello {{ get_current_user() }}!
 
 <h2>Existing connections</h2>
 <ul>
-    {% for connection in request.user.oauth_connections.all %}
+    {% for connection in get_current_user().oauth_connections.all %}
     <li>
         {{ connection.provider_key }} [ID: {{ connection.provider_user_id }}]
         <form action="{% url 'oauth:disconnect' connection.provider_key %}" method="post">

{plain_oauth-0.29.0.dist-info → plain_oauth-0.29.2.dist-info}/RECORD

@@ -1,18 +1,18 @@
-plain/oauth/CHANGELOG.md,sha256=qdYHdliRCnHcenmsZ_xHntdUmDg4A-b14Y1hCrjorTQ,5667
-plain/oauth/README.md,sha256=m3RRb01DLnoxBtzuYzESSe49OmsZ8P1R5_QsfCSRQgo,11077
+plain/oauth/CHANGELOG.md,sha256=qylweVHAeginfzazOVY53pbo_Ug0KZ_fATie7RPI9D0,6416
+plain/oauth/README.md,sha256=5wWECig99tV7g5Hkqmd0ClSH0KpXgu0TRBkY0c_dH3o,11089
 plain/oauth/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 plain/oauth/admin.py,sha256=s259OnTWGeOv3nVl4hAV-lNAIE4d2ObbG_97ENC6TuY,1308
 plain/oauth/config.py,sha256=0Q4IILBKQbIaxqeL9WRTH5Cka-BO3c3SOj1AdQIAJgc,167
 plain/oauth/default_settings.py,sha256=dlN1J9vSOjjxPNLp-0qe-cLTqwM4E69ZAx_8lpxMhaM,28
 plain/oauth/exceptions.py,sha256=yoZsq8XgzstuwbE2ihoet0nzpw_sVZgDrwUauh6hhUs,546
-plain/oauth/models.py,sha256=BKeJrfm93E1W5Zzf7z41hk0WvJe6p-EjZcZavmkGkRs,6668
-plain/oauth/providers.py,sha256=koT6Ohp9wMG7hjXrncCJV07HwrSs-NZ2yVmsgVo_-1s,7954
+plain/oauth/models.py,sha256=dIlRzRCAAU3gy46ks8bkV9JkznuMNreC3avkKcUTicU,6726
+plain/oauth/providers.py,sha256=I9YAZgvkueFZb0fquhF85qNQDnZMkuTgj1YuVPiPUno,7961
 plain/oauth/urls.py,sha256=FYzpQwhvZdcat8n3f7RyA-1Q21finKb8JEyakSOjXXg,696
-plain/oauth/views.py,sha256=LO7raeMkUrV9epVzIe6wNML3a22MDW41eeGDVPZIhM8,2472
+plain/oauth/views.py,sha256=_u4qIo4DtZ6x1YH3Byhh20sC4ZwVGlIXcLwWBzSFPxI,2530
 plain/oauth/migrations/0001_initial.py,sha256=0NjfF7F3szhUXkpK3JvN10Xkat1QR-VvnX6Oed9iFmo,1940
 plain/oauth/migrations/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 plain/oauth/templates/oauth/callback.html,sha256=4CJG0oAN0xYjw2IPkjaL7B4hwlf9um9LI4CTu50E-yE,173
-plain_oauth-0.29.0.dist-info/METADATA,sha256=Ht_lap9gWq1mEoDO8zDdCoqpkhKi1CLXpoG9H5t2eGg,11482
-plain_oauth-0.29.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-plain_oauth-0.29.0.dist-info/licenses/LICENSE,sha256=cvKM3OlqHx3ijD6e34zsSUkPvzl-ya3Dd63A6EHL94U,1500
-plain_oauth-0.29.0.dist-info/RECORD,,
+plain_oauth-0.29.2.dist-info/METADATA,sha256=V4-MnVxCLd-I3XpkFRggr8mNvKAJ2wxwptm1YPJu_BI,11494
+plain_oauth-0.29.2.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+plain_oauth-0.29.2.dist-info/licenses/LICENSE,sha256=cvKM3OlqHx3ijD6e34zsSUkPvzl-ya3Dd63A6EHL94U,1500
+plain_oauth-0.29.2.dist-info/RECORD,,