plain.oauth 0.7.0__py3-none-any.whl → 0.7.2__py3-none-any.whl

plain/oauth/README.md

@@ -1,3 +1,5 @@
+<!-- This file is compiled from plain-oauth/plain/oauth/README.md. Do not edit this file directly. -->
+
 # plain.oauth
 
 Let users log in with OAuth providers.
@@ -137,36 +139,6 @@ That's pretty much it!
 
 ## Advanced usage
 
-### Email addresses should be unique
-
-When you're integrating with an OAuth provider,
-we think that the user's email address is the best "primary key" when linking to your `User` model in your app.
-Unfortunately in Django, by default an email address is not required to be unique!
-**We strongly recommend you require email addresses to be unique in your app.**
-
-[As suggested by the Django docs](https://docs.djangoproject.com/en/4.0/topics/auth/customizing/#using-a-custom-user-model-when-starting-a-project),
-one way to do this is to have your own `User` model:
-
-```python
-# In an app named "users", for example
-from plain.auth.models import BaseUser
-
-class User(BaseUser):
-    email = models.EmailField(unique=True)
-
-
-# In settings.py
-AUTH_USER_MODEL = 'users.User'
-```
-
-You'll also notice that there are no "email confirmation" or "email verification" flows in this library.
-This is also intentional.
-You can implement something like that yourself if you need to,
-but the easier solution in our opinion is to use an OAuth provider you *trust to have done that already*.
-If you look at our [provider examples](https://github.com/forgepackages/plain-oauth/tree/master/provider_examples) you'll notice how we often use provider APIs to get the email address which is "primary" and "verified" already.
-If they've already done that work,
-then we can just use that information.
-
 ### Handling OAuth errors
 
 The most common error you'll run into is if an existing user clicks a login button,
@@ -275,7 +247,7 @@ python manage.py check --database default
 
 ## FAQs
 
-### How is this different from [other Django OAuth libraries](https://djangopackages.org/grids/g/oauth/)?
+### How is this different from [Django OAuth libraries](https://djangopackages.org/grids/g/oauth/)?
 
 The short answer is that *it does less*.
 

plain/oauth/default_settings.py

@@ -0,0 +1 @@
+OAUTH_LOGIN_PROVIDERS: dict

{plain_oauth-0.7.0.dist-info → plain_oauth-0.7.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: plain.oauth
-Version: 0.7.0
+Version: 0.7.2
 Summary: OAuth login and API access for Plain.
 Home-page: https://plainframework.com
 License: BSD-3-Clause
@@ -21,6 +21,8 @@ Description-Content-Type: text/markdown
 
 <!-- This file is compiled from plain-oauth/plain/oauth/README.md. Do not edit this file directly. -->
 
+<!-- This file is compiled from plain-oauth/plain/oauth/README.md. Do not edit this file directly. -->
+
 # plain.oauth
 
 Let users log in with OAuth providers.
@@ -160,36 +162,6 @@ That's pretty much it!
 
 ## Advanced usage
 
-### Email addresses should be unique
-
-When you're integrating with an OAuth provider,
-we think that the user's email address is the best "primary key" when linking to your `User` model in your app.
-Unfortunately in Django, by default an email address is not required to be unique!
-**We strongly recommend you require email addresses to be unique in your app.**
-
-[As suggested by the Django docs](https://docs.djangoproject.com/en/4.0/topics/auth/customizing/#using-a-custom-user-model-when-starting-a-project),
-one way to do this is to have your own `User` model:
-
-```python
-# In an app named "users", for example
-from plain.auth.models import BaseUser
-
-class User(BaseUser):
-    email = models.EmailField(unique=True)
-
-
-# In settings.py
-AUTH_USER_MODEL = 'users.User'
-```
-
-You'll also notice that there are no "email confirmation" or "email verification" flows in this library.
-This is also intentional.
-You can implement something like that yourself if you need to,
-but the easier solution in our opinion is to use an OAuth provider you *trust to have done that already*.
-If you look at our [provider examples](https://github.com/forgepackages/plain-oauth/tree/master/provider_examples) you'll notice how we often use provider APIs to get the email address which is "primary" and "verified" already.
-If they've already done that work,
-then we can just use that information.
-
 ### Handling OAuth errors
 
 The most common error you'll run into is if an existing user clicks a login button,
@@ -298,7 +270,7 @@ python manage.py check --database default
 
 ## FAQs
 
-### How is this different from [other Django OAuth libraries](https://djangopackages.org/grids/g/oauth/)?
+### How is this different from [Django OAuth libraries](https://djangopackages.org/grids/g/oauth/)?
 
 The short answer is that *it does less*.
 

{plain_oauth-0.7.0.dist-info → plain_oauth-0.7.2.dist-info}/RECORD

@@ -1,6 +1,7 @@
-plain/oauth/README.md,sha256=cMfq_xUk5qBrt1ENOAhsoIjsY-7NwA0upkfOK-vpS8M,11289
+plain/oauth/README.md,sha256=IKgxp_goFYettLZBjHzUHctbavXvhQtg4ZjMWaQCD0I,10010
 plain/oauth/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 plain/oauth/config.py,sha256=jk5l59taT_3Kh7EFrJuuubtrCHLfNBVkD2sWQ_M5_JQ,160
+plain/oauth/default_settings.py,sha256=dlN1J9vSOjjxPNLp-0qe-cLTqwM4E69ZAx_8lpxMhaM,28
 plain/oauth/exceptions.py,sha256=TMGtIGkK3_J4rsEy1oPCmia7BnRSK8N8RMZm4_pNelA,189
 plain/oauth/migrations/0001_initial.py,sha256=8-JR2McXDUNRhMRUrrZPqzRNpdROfCsIo5Qkndkn-pg,1756
 plain/oauth/migrations/0002_alter_oauthconnection_options_and_more.py,sha256=3Mb0IU9KDRQfog0PjVbzuNv_AxCs7UVHnA0F263AKNo,581
@@ -14,7 +15,7 @@ plain/oauth/staff.py,sha256=NtmyFURkKMH6hRp7sjl8FUWYOGSA7M0tLKRyXUciPj4,1288
 plain/oauth/templates/oauth/error.html,sha256=xkkWw57sZ3fz4dDfH30SVtq3okJNnJmrSRPfGxrxjh8,108
 plain/oauth/urls.py,sha256=NyP_yDKayJYrCdw4oNVHUmtjbLNfzdnpdWc-eOsMlDM,676
 plain/oauth/views.py,sha256=G6icfdKkOOOKB00JVN4SCeZmBcGOGUvAgueyvOd9bLI,3042
-plain_oauth-0.7.0.dist-info/LICENSE,sha256=cvKM3OlqHx3ijD6e34zsSUkPvzl-ya3Dd63A6EHL94U,1500
-plain_oauth-0.7.0.dist-info/METADATA,sha256=YYGbxj3FhbZlOpZjf1hiIIzvUfVM7xACPoVMjTkjjcs,12136
-plain_oauth-0.7.0.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
-plain_oauth-0.7.0.dist-info/RECORD,,
+plain_oauth-0.7.2.dist-info/LICENSE,sha256=cvKM3OlqHx3ijD6e34zsSUkPvzl-ya3Dd63A6EHL94U,1500
+plain_oauth-0.7.2.dist-info/METADATA,sha256=yE0Hosfe4lzQkOTuIanmEKKFk2SPLwTMyr2h7EPSDUI,10857
+plain_oauth-0.7.2.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
+plain_oauth-0.7.2.dist-info/RECORD,,