Metadata-Version: 2.1
Name: mwoauth
Version: 0.3.7
Summary: A generic MediaWiki OAuth handshake helper.
Home-page: https://github.com/mediawiki-utilities/python-mwoauth
Author: Aaron Halfaker / Filippo Valsorda
Author-email: aaron.halfaker@gmail.com
License: MIT
Description: MediaWiki OAuth Library
        =======================
        
        ``mwoauth`` is an open licensed (MIT) library designed to provide a simple means to performing an OAuth handshake with a MediaWiki installation with the `OAuth Extension <https://www.mediawiki.org/wiki/Extension:OAuth>`_ installed.  
        
        **Compatible with python 2.7 and 3.x**
        
        **Install with pip:** ``pip install mwoauth``
        
        **Documentation:** http://pythonhosted.org/mwoauth
        
        Usage
        =====
        
        .. code-block:: python
        
        	from mwoauth import ConsumerToken, Handshaker
        	from six.moves import input # For compatibility between python 2 and 3
        	
        	# Consruct a "consumer" from the key/secret provided by MediaWiki
        	import config
        	consumer_token = ConsumerToken(config.consumer_key, config.consumer_secret)
        	
        	# Construct handshaker with wiki URI and consumer
        	handshaker = Handshaker("https://en.wikipedia.org/w/index.php",
        	                        consumer_token)
        	
        	# Step 1: Initialize -- ask MediaWiki for a temporary key/secret for user
        	redirect, request_token = handshaker.initiate()
        	
        	# Step 2: Authorize -- send user to MediaWiki to confirm authorization
        	print("Point your browser to: %s" % redirect) # 
        	response_qs = input("Response query string: ")
        	
        	# Step 3: Complete -- obtain authorized key/secret for "resource owner"
        	access_token = handshaker.complete(request_token, response_qs)
        	print(str(access_token))
        	
        	# Step 4: Identify -- (optional) get identifying information about the user
        	identity = handshaker.identify(access_token)
        	print("Identified as {username}.".format(**identity))
        
        
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Topic :: Security
Classifier: License :: OSI Approved :: MIT License
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Provides-Extra: flask
