Metadata-Version: 2.1
Name: muffin-oauth
Version: 2.2.0
Summary: Support OAuth authentication for Muffin Framework.
Home-page: https://github.com/klen/muffin-oauth
Author: Kirill Klenov
Author-email: horneds@gmail.com
License: MIT
Project-URL: Documentation, https://github.com/klen/muffin-oauth
Project-URL: Source code, https://github.com/klen/muffin-oauth
Project-URL: Issue tracker, https://github.com/klen/muffin-oauth/issues
Keywords: asgi,asyncio,authorization,muffin,oauth,trio
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Framework :: AsyncIO
Classifier: Framework :: Trio
Requires-Python: >=3.7
Provides-Extra: tests
Provides-Extra: build
Provides-Extra: example
License-File: LICENSE

Muffin-OAuth
############

.. _description:

**Muffin-OAuth** -- Support OAuth authentication for Muffin_ Framework.

.. _badges:

.. image:: https://github.com/klen/muffin-oauth/workflows/tests/badge.svg
    :target: https://github.com/klen/muffin-oauth/actions
    :alt: Tests Status

.. image:: https://img.shields.io/pypi/v/muffin-oauth
    :target: https://pypi.org/project/muffin-oauth/
    :alt: PYPI Version

.. image:: https://img.shields.io/pypi/pyversions/muffin-oauth
    :target: https://pypi.org/project/muffin-oauth/
    :alt: Python Versions

.. _contents:

.. contents::

.. _requirements:

Requirements
=============

- python >= 3.7

.. _installation:

Installation
=============

**Muffin-OAuth** should be installed using pip: ::

    pip install muffin-oauth

.. _usage:

Usage
=====

Get OAuth Access/Refresh Tokens
-------------------------------

See an example application in `example.py`.
Run the example with command: ::

    $ make example

And open http://localhost:5000 in your browser.

Load resouces with access tokens
--------------------------------

.. code:: python

    # OAuth2
    client = oauth.client('github', access_token='...')
    resource = await client.request('GET', 'user')

.. _bugtracker:

Bug tracker
===========

If you have any suggestions, bug reports or
annoyances please report them to the issue tracker
at https://github.com/klen/muffin-oauth/issues

.. _contributing:

Contributing
============

Development of Muffin-OAuth happens at: https://github.com/klen/muffin-oauth


Contributors
=============

* klen_ (Kirill Klenov)

.. _license:

License
========

Licensed under a `MIT license`_.
.. _links:

.. _Muffin: https://github.com/klen/muffin
.. _klen: https://github.com/klen
.. _MIT license: http://opensource.org/licenses/MIT


