Metadata-Version: 2.1
Name: sans
Version: 0.0.1a1
Summary: Synchronous / Asynchronous NationStates API wrapper for Python
Home-page: https://github.com/zephyrkul/sans
Author: Zephyrkul
Author-email: zephyrkul@outlook.com
License: MIT
Description: # sans
        
        [![pypi](https://img.shields.io/pypi/v/sans.svg)](https://pypi.python.org/pypi/sans)
        [![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/ambv/black)
        [![Build Status](https://travis-ci.com/zephyrkul/sans.svg?branch=master)](https://travis-ci.com/zephyrkul/sans)
        
        Synchronous / Asynchronous NationStates (Python wrapper for the NationStates API)
        
        ## Installing
        
        ```
        python3 -m pip install -U sans
        ```
        
        Development version:
        ```
        python3 -m pip install -U https://github.com/zephyrkul/sans/archive/master.zip#egg=sans
        ```
        
        ## Examples
        
        ### Asynchronous
        ```py
        import asyncio
        import sans
        from lxml import etree
        
        async def main():
            sans.Api.agent = "Darcania"
            request = sans.Api(
                "fullname population flag census",
                nation="darcania",
                mode="score",
                scale="65 66",
            )
            root = await request
            pretty = root.to_pretty_string()
            print(pretty)
        
            request = sans.Dumps.REGIONS
            async for region in request:
                pretty = region.to_pretty_string()
                print(pretty)
        
        
        asyncio.run(main())  # Python 3.7+ only
        ```
        
        ### Synchronous
        ```py
        import sans
        from lxml import etree
        
        def main():
            sans.run_in_thread()
            sans.Api.agent = "Darcania"
            request = sans.Api(
                "fullname population flag census",
                nation="darcania",
                mode="score",
                scale="65 66",
            )
            root = request.threadsafe()
            pretty = root.to_pretty_string()
            print(pretty)
        
            request = sans.Dumps.REGIONS
            for region in request.threadsafe:
                pretty = region.to_pretty_string()
                print(pretty)
        
        
        main()
        ```
        
        ## Command Line
        ```
        python3 -m sans --nation darcania census --scale "65 66" --mode score
        User Agent: Darcania
        <NATION>...</NATION>
        >>> --nation testlandia fullname
        <NATION>...</NATION>
        >>> --region "the north pacific" numnations lastupdate
        <REGION>...</REGION>
        >>>
        Exiting...
        ```
        
        ## Requirements
        - Python 3.6+
        - aiohttp
        - lxml
        
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: License :: OSI Approved :: MIT License
Classifier: Intended Audience :: Developers
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Topic :: Software Development :: Libraries
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Utilities
Requires-Python: >=3.6.0,<3.8
Description-Content-Type: text/markdown
