Client for Chat Wars API for Python3

Currently, based on pika and aio-pika.

Version 1!2021.12.5b1

{implementation version}!{date when it was work}{sub releases}

Installing

Build on your machine:

pip install git+https://github.com/LandgrafHomyak/cwapi-python@v1!2021.12.5b1

or

pip install https://github.com/LandgrafHomyak/cwapi-python/archive/refs/tags/v1!2021.12.5b1.tar.gz

or go to release page and download wheel package directly.

Using

Synchronous client:

from cwapi import ChatWarsApiClient, Server
from cwapi.requests import *
from cwapi.types import Operation
from cwapi.responses import ForbiddenError

# Allowed servers:
Server.CW3
Server.International  # castles enum not initialized yet, will raise ValueError if response contains it's value

with ChatWarsApiClient(Server.CW3, "your instance name", PASSWORD) as c:
    print(
        c.ask(
            GetInfoRequest()
        ).balance
    )

    try:
        profile = c.ask(
            RequestProfileRequest(token="1234567890abcdef")
        )

        print(profile.castle.icon + profile.userName)
        # or
        print(profile.full_name)
        
        print(
            (profile.castle.icon if profile.guild.emoji is None else profile.guild.emoji) + str(profile.guild)
        )
        # or
        print(profile.guild.full_name(profile.castle))
    except ForbiddenError:
        req = c.ask(
            AuthAdditionalOperationRequest(token="1234567890abcdef", operation=Operation.GetUserProfile)
        )
        c.ask(
            GrantAdditionalOperationRequest(token="1234567890abcdef", requestId=req.requestId, authCode=input("auth code: "))
        )

Asyncio client:

from cwapi import AsyncChatWarsApiClient, Server

...


async def main():
    async with AsyncChatWarsApiClient(Server.CW3, "your instance name", PASSWORD) as c:
        ...

Alternative connection variant (works with both clients):

c = ...
c.connect()

...

c.disconnect()

Info about message types and classes read in API reference and *.pyi files in the package.

Some features like .dump() method on responses are not implemented