Skip to content

Repository files navigation

Python Social Auth - Core

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

Description

This is the core component of the python-social-auth ecosystem, it implements the common interface to define new authentication backends to third parties services, implement integrations with web frameworks and storage solutions.

Documentation

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

Security

See the current threat model for the supported security boundaries and the security policy for private vulnerability reporting. When a release includes a threat model, the copy in its source distribution or repository tag records the boundaries applicable to that release.

Setup

pip install social-auth-core

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 document for details.

Versioning

This project follows Semantic Versioning 2.0.0.

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.

License

This project follows the BSD license. See the 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:

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

Releases

Sponsor this project

Used by

Contributors

Languages