Metadata-Version: 2.4
Name: social-auth-app-django
Version: 8.1.0
Summary: Python Social Authentication, Django integration.
Author-email: Matias Aguirre <matiasaguirre@gmail.com>, Michal Čihař <michal@weblate.org>
License-Expression: BSD-3-Clause
Project-URL: Changelog, https://github.com/python-social-auth/social-app-django/blob/master/CHANGELOG.md
Project-URL: Funding, https://opencollective.com/python-social-auth
Project-URL: Homepage, https://github.com/python-social-auth/social-app-django
Keywords: django,oauth,openid,saml,social auth
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Web Environment
Classifier: Framework :: Django
Classifier: Framework :: Django :: 5.2
Classifier: Framework :: Django :: 6.0
Classifier: Framework :: Django :: 6.1
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Programming Language :: Python :: 3.15
Classifier: Topic :: Internet
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: asgiref>=3.8.1
Requires-Dist: Django>=5.2
Requires-Dist: social-auth-core<8.0.0,>=7.2.0
Provides-Extra: dev
Requires-Dist: coverage>=3.6; extra == "dev"
Requires-Dist: django-stubs-ext==6.0.9; extra == "dev"
Requires-Dist: django-stubs==6.0.9; extra == "dev"
Requires-Dist: mypy==2.4.1; extra == "dev"
Requires-Dist: pre-commit; extra == "dev"
Requires-Dist: pyright==1.1.414; extra == "dev"
Requires-Dist: tox; extra == "dev"
Dynamic: license-file

# Python Social Auth - Django

Python Social Auth is an easy to setup social authentication/registration
mechanism with support for several frameworks and auth providers.

## Description

This is the [Django](https://www.djangoproject.com/) component of the
[python-social-auth ecosystem](https://github.com/python-social-auth/social-core),
it implements the needed functionality to integrate
[social-auth-core](https://github.com/python-social-auth/social-core)
in a Django based project.

## Django version

This project will focus on the currently supported Django releases as
stated on the [Django Project Supported Versions table](https://www.djangoproject.com/download/#supported-versions).

Backward compatibility with unsupported versions won't be enforced.

## Documentation

Project documentation is available at <https://python-social-auth.readthedocs.io/>.

## Setup

Requires Python 3.11 or later, Django 5.2 or later, and social-auth-core 7.2.0 or later (before 8.0).

```shell
pip install social-auth-app-django
```

## Contributing

Contributions are welcome!

Only the core and Django modules are currently in development. All others are in maintenance only mode, and maintainers are especially welcome there.

See the [CONTRIBUTING.md](https://github.com/python-social-auth/.github/blob/main/CONTRIBUTING.md) document for details.

## Versioning

This project follows [Semantic Versioning 2.0.0](https://semver.org/spec/v2.0.0.html).

## Releasing

Update the package version and add a matching version section to `CHANGELOG.md`,
then push the version tag. CI builds and checks the distributions, publishes to
PyPI, and creates the GitHub release with its release notes and assets. Do not
publish an empty GitHub release before CI runs.

GitHub releases are created as drafts and published only after all assets are
uploaded. Existing releases, including drafts, cause the GitHub release job to
fail rather than overwrite assets. Inspect and remove an incomplete draft before
retrying. Asset corrections to a published immutable release require a new version.

## Security

The [threat model](https://github.com/python-social-auth/social-app-django/blob/master/THREAT_MODEL.md)
documents the security properties and assumptions of this Django integration.
To report a vulnerability privately, follow the
[Python Social Auth security policy](https://github.com/python-social-auth/.github/security/policy).

## License

This project follows the BSD license. See the [LICENSE](LICENSE) for details.

## Supporters

Development and maintenance of Python Social Auth are supported by organizations that rely on the project or invest in the sustainability and security of open source.

Current supporters include:

- [Weblate](https://weblate.org/) — funding ongoing development and maintenance
- [GitHub Secure Open Source Fund](https://github.com/open-source/github-secure-open-source-fund) — funding and security education for maintainers

If your organization depends on Python Social Auth, consider joining this effort and helping sustain its development:

- [GitHub Sponsors](https://github.com/sponsors/python-social-auth/)
- [Open Collective](https://opencollective.com/python-social-auth)
