Add support for guild time outs.

[Victorsitou]

Summary

Discord has been experimenting with guild time outs lately, so I decided to try to implement it.

A few hours ago they added a new permission to add timeouts, so I guess this will actually be implemented.

TODO:

• Add audit log.
• Guild.timeout(...)?

new permission reference:
Discord-Datamining/Discord-Datamining@35cb2c6

Checklist

• If code changes were made then they have been tested
  • I have updated the documentation to reflect the changes
  • I have formatted the code properly by running black .
• This PR fixes an issue
• This PR adds something new (e.g. new method or parameters)
• This PR is a breaking change (e.g. methods or parameters removed/renamed)
• This PR is not a code change (e.g. documentation, README, ...)

[shiftinv]

Nice!
Made some initial comments, mostly documentation-related.

Member._update also needs to handle the new value, to keep the member cache consistent with the current state.

One change I'd like to propose is to change the (relatively long) name of communication_disabled_until to something like guild_timeout or just timeout, similar to the abstraction of rate_limit_per_user behind slowmode_delay; perhaps others can pitch in regarding this idea.

[Victorsitou]

Member._update also needs to handle the new value, to keep the member cache consistent with the current state.

Done. 27a0241

One change I'd like to propose is to change the (relatively long) name of communication_disabled_until to something like guild_timeout or just timeout, similar to the abstraction of rate_limit_per_user behind slowmode_delay; perhaps others can pitch in regarding this idea.

Hmm, sounds good to me, I would go with timeout, but I would like to hear other suggestions.

Also, regarding the name, I created a poll in the Discord server. So I'm going to wait until it gets some votes.

[Victorsitou]

timeout function is not fully done, I forgot to add some things.

Update: it should be ready for review right now.

[Victorsitou]

It seems that Discord finally added the audit log key.

[Victorsitou]

Okay so, the PR should be ready for review, but I think it's worth to wait until it's released, basically to avoid possibly breaking changes.

[shiftinv]

Looks good! Just have a few more suggestions.
And yea, this shouldn't be merged before the feature is rolled out to more servers/users.

[thesadru]

There's a lot of weird formatting going on due to the stupidly long variable name but we probs won't be able to do much about that.