Metadata-Version: 2.4
Name: mwoauth2
Version: 0.1.0
Summary: A library to help with authentication against a MediaWiki site using OAuth 2.
Project-URL: Issues, https://phabricator.wikimedia.org/tag/mwoauth2/
Project-URL: Source, https://gitlab.wikimedia.org/toolforge-repos/python-mwoauth2/
Author-email: Lucas Werkmeister <mail@lucaswerkmeister.de>
License-Expression: BSD-3-Clause
License-File: LICENSE
Keywords: mediawiki,oauth2,wikimedia
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.13
Requires-Dist: requests-oauthlib
Provides-Extra: flask
Requires-Dist: flask; extra == 'flask'
Provides-Extra: mwapi
Requires-Dist: mwapi; extra == 'mwapi'
Description-Content-Type: text/markdown

# mwoauth2

<!-- This text partially mirrors docs/index.rst; keep them in sync. -->

**mwoauth2** is a library to help with authentication against a MediaWiki site using OAuth 2.

It is mainly targeted at [Flask](https://flask.palletsprojects.com/) tools
using the [mwapi](https://pythonhosted.org/mwapi/) library,
but can be used in other contexts as well.
Support for other web frameworks or MediaWiki libraries may be added if there is interest.

## Documentation and usage

See the [documentation](https://mwoauth2.readthedocs.io/),
which includes instructions for [Flask tools](https://mwoauth2.readthedocs.io/en/latest/flask.html)
and [non-Flask tools](https://mwoauth2.readthedocs.io/en/latest/other.html).

Please note that the library is still relatively new
and has not been used by many tools yet.
If anything is unclear or there are problems,
feel free to reach out to the maintainer(s)
and/or [file a task on Phabricator](https://phabricator.wikimedia.org/maniphest/task/edit/form/1/?projects=mwoauth2).

## License

BSD-3-Clause.
