Skip to content

v0.1.0

Choose a tag to compare

View all tags
@mathsman5133 mathsman5133 released this 21 Apr 14:20
· 1328 commits to master since this release
v0.1.0
b0d643c

v0.1.0

BugFixes

- Fixed bug with loops breaking when reloading the client in a discord cog.
- A more specific error, `aiohttp.ContentTypeError` is raised when parsing non-json responses.

Important

  • Big thanks to Jab for some of these.

  • Big one! Client now only accepts an email/password pair rather than tokens.
    This pair is what you use to login to https://developer.clashofclans.com/#/login
    and will allow the client to automatically use, create, reset and find tokens,
    making it a much more streamlined process.

  • As such, the following parameters to client have been added:

    • key_count: int: the number of tokens to rotate between when making API requests.
      This defaults to 1, and can be between 1 and 10

    • key_names: str: The name to use when creating tokens on the developer page.
      This defaults to Created with coc.py Client

  • Email and Password are now mandatory parameters and must be passed

  • update_tokens parameter has been removed. The client will automatically reset bad tokens.

  • In order to keep consistency with the official API docs, token has been renamed to key.
    This affects the following method/parameters:

    • on_token_reset(new_token) --> on_key_reset(new_key)
    • HTTPClient.login() --> HTTPClient.get_keys()

    and otherwise consistent use of key during internals, docs, code and examples.

  • pytz and python-dateutil have both been removed as dependencies due to the ability to
    parse timestamps manually. This has been added to utils as a function: from_timestamp(ts),
    returning a utc-datetime object.

  • Dataclasses have received a makeover! Many new attributes are present, these are listed below.
    Most importantly, any property beginning with an underscore (_) use and return iterator objects.
    These are not lists, and relevant python documentation is here:
    https://docs.python.org/3/glossary.html#term-iterator.

    These are up to 12x faster than lists, and
    as such for those who are concerned about speed, performance and memory should use these, while
    for the majority, calling the regular property should be fine (usually returning a list rather than iter).

    • :attr:SearchClan._members
    • :attr:WarClan._members
    • :attr:WarClan._attacks
    • :attr:WarClan._defenses
    • :attr:WarMember._attacks
    • :attr:WarMember._defenses
    • :attr:SearchPlayer._achievements
    • :attr:CurrentWar._attacks
    • :attr:CurrentWar._members
    • :attr:LeagueClan._members
    • :attr:LeagueGroup._clans

  • The following new attributes were added:

    • :attr:SearchClan.member_dict
    • :attr:WarClan.member_dict
    • :attr:WarClan.attacks
    • :attr:WarClan.defenses
    • :attr:WarMember.attacks
    • :attr:WarMember.defenses
    • :attr:SearchPlayer.achievements_dict
    • :attr:SearchPlayer.troops_dict
    • :attr:SearchPlayer.heroes_dict
    • :attr:SearchPlayer.spells_dict
    • :attr:Timestamp.time

  • The folowwing new methods were added:

    • SearchClan.get_member(tag)
    • CurrentWar.get_member(tag)

  • New utility functions:

    • utils.get(iterable, **attrs)

      • Searches the iterable until a value with the given attribute is found.
        Unlike filter(), this will return when the first value is found.

    • utils.find(function, iterable)

      • Searches through the iterable until a value which satisfies the function is found.

    • from_timestamp(ts)

      • Parses an ISO8601 timestamp as returned by the COC API into a datetime object

Documentation:

- Many docstrings were reformatted or worded, with punctuation and other typo's fixed
- All new properties, attributes and methods have been documented.
- Update some examples, including a `clan_info` function in discord bots (Thanks, Tuba).
Assets 2
Loading