Metadata-Version: 1.2
Name: aioec
Version: 0.6.1
Summary: async client library for the Emote Collector API
Home-page: https://github.com/EmoteCollector/aioec
Author: io mintz
Author-email: io@mintz.cc
License: MIT
Description: aioec
        =====
        
        An aiohttp-based client for the `Emote Collector API <https://emote-collector.python-for.life/api/v0/docs>`_.
        
        
        Usage
        -----
        
        .. code-block:: python3
        
        	import aioec
        
        	anonymous_client = aioec.Client()
        	authenticated_client = aioec.Client(token='your token here')
        	local_client = aioec.Client(base_url='http://ec.localhost:2018/api/v0')  # no trailing slash!
        
        	# this step isn't necessary but makes sure that your token is correct
        	my_user_id = await client.login()
        	# it returns the user ID associated with your token
        
        	# in a coroutine...
        	emote = await client.emote('Think')
        	emote.name  # Think
        
        	await emote.edit(name='Think_', description='a real happy thinker')
        	# remove the description:
        	await emote.edit(description=None)
        
        	for gamewisp_emote in await client.search('GW'):
        		await gamewisp_emote.delete()
        
        	all_emotes = [emote async for emote in client.emotes()]
        	popular_emotes = await client.popular()
        
        	await client.close()
        
        	# it's also a context manager:
        	async with aioec.Client(token=my_token) as client:
        		await client.delete('Think_')
        	# this will automatically close the client
        
        With the Tor hidden services
        ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
        
        You'll need to install `aiohttp_socks <https://github.com/romis2012/aiohttp-socks>`_ first.
        
        .. code-block:: python3
        
        	from aiohttp_socks import SocksConnector
        	import aioec
        
        	connector = SocksConnector(port=9050, rdns=True)  # without rdns, the connector will fail to resolve onions
        	client = aioec.Client(
        		connector=connector,
        		base_url='http://emotesdikhisgxdcmh7wtlvzfw2yxp4vmkyy6mu5wixzgqfmxvuotryd.onion/api/v0',
        	)
        
        License
        -------
        
        MIT/X11
        
        Copyright © 2018–2019 Io Mintz <io@mintz.cc>
        
Platform: UNKNOWN
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Developers
Classifier: Topic :: Internet
Classifier: Topic :: Software Development :: Libraries
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Operating System :: OS Independent
Classifier: License :: OSI Approved :: MIT License
Requires-Python: >=3.5.3
