Merge branch 'master' into adding-missing-audit-log-fields

Author: davfsa

.flake8

@@ -10,7 +10,7 @@ count = true
 # D105: Magic methods not having a docstring.
 # D412: No blank lines allowed between a section header and its content
 # E402: Module level import not at top of file (isn't compatible with our import style).
-# E701, E704: Multiple statements on one line (conflicts with black, but it will be enforced by it anyways).
+# E701, E704: Multiple statements on one line (conflicts with ruff, but it will be enforced by it anyways).
 # T101: TO-DO comment detection (T102 is FIX-ME and T103 is XXX).
 # S101: Use of assert detected. The enclosed code will be removed when compiling to optimised byte code.
 # W503: line break before binary operator (too many false positives and doesnt match our style)
@@ -49,7 +49,7 @@ per-file-ignores =
 
 max-complexity = 20
 max-function-length = 130
-# Technically this is 120, but black has a policy of "1 or 2 over is fine if it is tidier", so we have to raise this.
+# Technically this is 120, but ruff has a policy of "1 or 2 over is fine if it is tidier", so we have to raise this.
 max-line-length = 130
 show_source = False
 statistics = False

.github/workflows/ci.yml

@@ -17,7 +17,7 @@ jobs:
       fail-fast: false
       matrix:
         os: [ubuntu-latest, macos-latest, windows-latest]
-        python-version: [3.8, 3.9, "3.10", 3.11, 3.12]
+        python-version: [3.9, "3.10", 3.11, 3.12, 3.13]
 
     runs-on: ${{ matrix.os }}
 
@@ -31,7 +31,6 @@ jobs:
           python-version: ${{ matrix.python-version }}
 
       - name: Test Installation
-        shell: bash
         run: |
           pip install -r dev-requirements/build.txt
 
@@ -42,7 +41,6 @@ jobs:
           pip uninstall -y hikari
 
       - name: Run tests
-        shell: bash
         run: |
           pip install -r dev-requirements.txt
           nox -s pytest
@@ -57,6 +55,7 @@ jobs:
           path: .coverage
           retention-days: 1
           if-no-files-found: error
+          include-hidden-files: true
 
   upload-coverage:
     needs: [test]
@@ -101,7 +100,7 @@ jobs:
           coverage report
 
       - name: Upload coverage to codeclimate
-        uses: paambaati/codeclimate-action@v8.0.0
+        uses: paambaati/codeclimate-action@v9.0.0
         env:
           CC_TEST_REPORTER_ID: d40e64ea0ff74713f79365fea4378ab51a2141ad4fcf0fb118496bbf560d4192
         with:
@@ -117,7 +116,7 @@ jobs:
       - name: Setup python
         uses: actions/setup-python@v5
         with:
-          python-version: 3.8
+          python-version: 3.9
 
       - name: Check stubs
         if: always()
@@ -149,6 +148,12 @@ jobs:
         run: |
           nox -s flake8
 
+      # Temporary until we use ruff for linting too
+      - name: Ruff format check
+        if: always()
+        run: |
+          nox -s check-reformat-code
+
       - name: Slotscheck
         if: always()
         run: |
@@ -174,7 +179,7 @@ jobs:
       - name: Setup python
         uses: actions/setup-python@v5
         with:
-          python-version: 3.8
+          python-version: 3.9
 
       - name: Test twemoji mapping
         run: |

.github/workflows/fragments-check.yml

@@ -22,7 +22,7 @@ jobs:
       - name: Setup python
         uses: actions/setup-python@v5
         with:
-          python-version: 3.8
+          python-version: 3.9
 
       - name: Check if changelog fragment was added
         run: |

.github/workflows/prepare-release.yml

@@ -34,7 +34,7 @@ jobs:
       - name: Setup python
         uses: actions/setup-python@v5
         with:
-          python-version: 3.8
+          python-version: 3.9
 
       - name: Run prepare script
         env:

.github/workflows/release.yml

@@ -29,7 +29,7 @@ jobs:
       - name: Setup python
         uses: actions/setup-python@v5
         with:
-          python-version: 3.8
+          python-version: 3.9
 
       - name: Temporarily disable "include administrators" branch protection
         uses: benjefferies/branch-protection-bot@v1.1.2

.gitignore

@@ -64,4 +64,6 @@ prof/
 # Logs
 *.log
 
+# Misc
 Pipfile*
+pyrightconfig.json

CHANGELOG.md

@@ -1,3 +1,71 @@
+## 2.1.1 (2025-02-26)
+
+### Features
+
+- Allow specifying a reason for message deletions ([#2066](https://github.com/hikari-py/hikari/issues/2066))
+- Allow setting `name` and `value` of an `EmbedField` to an empty string. ([#2105](https://github.com/hikari-py/hikari/issues/2105))
+
+### Bugfixes
+
+- Fixed Entitlement `starts_at` and `ends_at` erroring when set to `None`. ([#2149](https://github.com/hikari-py/hikari/issues/2149))
+- Properly handle and error on Cloudflare bans ([#2168](https://github.com/hikari-py/hikari/issues/2168))
+
+### Documentation Improvements
+
+- Added missing documentation for `GatewayShard` and for trait `ShardAware`, adding missing errors which can be thrown. ([#2100](https://github.com/hikari-py/hikari/issues/2100))
+
+---
+## 2.1.0 (2024-09-25)
+
+### Breaking Changes
+
+- `VoiceState.member` can now be `None` in cases where Discord doesn't send the relevant information ([#2038](https://github.com/hikari-py/hikari/issues/2038))
+
+### Features
+
+- Add the optional audit log `reason` argument to `hikari.api.rest.RESTClient.delete_channel` and
+  `hikari.impl.rest.RESTClientImpl.delete_channel`, the same way it already exists for e.g.
+  `edit_channel` ([#2058](https://github.com/hikari-py/hikari/issues/2058))
+
+### Bugfixes
+
+- Fix issue when deserializing voice states with missing member data ([#2038](https://github.com/hikari-py/hikari/issues/2038))
+- Fix `fetch_application_emojis` endpoint deserialization ([#2050](https://github.com/hikari-py/hikari/issues/2050))
+- Fix uploading files when using aiohttp 3.10.6 and onwards ([#2059](https://github.com/hikari-py/hikari/issues/2059))
+
+---
+## 2.0.0 (2024-08-28)
+
+### Breaking Changes
+
+- Drop Python 3.8 support. ([#2008](https://github.com/hikari-py/hikari/issues/2008))
+
+### Features
+
+- Implement stage instances ([#1725](https://github.com/hikari-py/hikari/issues/1725))
+- Add Python 3.13 support ([#1793](https://github.com/hikari-py/hikari/issues/1793))
+- Add `title` and `description` fields to `Attachment`. ([#1945](https://github.com/hikari-py/hikari/issues/1945))
+- Add `display_name` to `PartialUser` ([#1951](https://github.com/hikari-py/hikari/issues/1951))
+- Remove `Optional` type hint from `CommandInteraction.options` - it will now always be an empty sequence when not provided. ([#1965](https://github.com/hikari-py/hikari/issues/1965))
+- Application-bound emojis API support. ([#1990](https://github.com/hikari-py/hikari/issues/1990))
+- Add `Member.guild_flag` and matching `GuildMemberFlags` enum. ([#2004](https://github.com/hikari-py/hikari/issues/2004))
+- Add `Message.thread` field. ([#2012](https://github.com/hikari-py/hikari/issues/2012))
+- Add new voice endpoints (`fetch_my_voice_state` and `fetch_voice_state`) ([#2016](https://github.com/hikari-py/hikari/issues/2016))
+- Add `fetch_role` method to `RESTClient` ([#2020](https://github.com/hikari-py/hikari/issues/2020))
+
+### Bugfixes
+
+- Fix incorrect cleanup when failing to create request with a web reader ([#1946](https://github.com/hikari-py/hikari/issues/1946))
+- Fix serializing JSON dicts with enum values as keys.
+  See [#1955](https://github.com/hikari-py/hikari/issues/1955) ([#1957](https://github.com/hikari-py/hikari/issues/1957))
+- Use Discord Media Proxy instead of CDN for animated stickers urls ([#1982](https://github.com/hikari-py/hikari/issues/1982))
+- Use correct URL route for scheduled event covers. ([#1983](https://github.com/hikari-py/hikari/issues/1983))
+- Perform proper comparison when checking `CustomEmoji` against `KnownCustomEmoji`. ([#1986](https://github.com/hikari-py/hikari/issues/1986))
+- Add `NITRO_BASIC` attribute to `PremiumType` ([#1988](https://github.com/hikari-py/hikari/issues/1988))
+- Fix incorrectly deserialized field `type` in `ChannelOverwriteEntryInfo` ([#1993](https://github.com/hikari-py/hikari/issues/1993))
+- Add missing `AuditLogChangeKey.COMMUNICATION_DISABLED_UNTIL` and matching key deserialization ([#1996](https://github.com/hikari-py/hikari/issues/1996))
+
+---
 ## 2.0.0.dev126 (2024-06-20)
 
 ### Features

README.md

@@ -5,7 +5,7 @@
 <br>
 <a href="https://github.com/hikari-py/hikari/actions"><img height="20" alt="CI status" src="https://github.com/hikari-py/hikari/actions/workflows/ci.yml/badge.svg?branch=master&event=push"></a>
 <a href="https://pypi.org/project/mypy/"><img height="20" alt="Mypy badge" src="https://img.shields.io/badge/mypy-checked-blue"></a>
-<a href="https://pypi.org/project/black"><img height="20" alt="Black badge" src="https://img.shields.io/badge/code%20style-black-000000.svg"></a>
+<a href="https://pypi.org/project/ruff"><img height="20" alt="Ruff badge" src="https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/charliermarsh/ruff/main/assets/badge/v2.json"></a>
 <a href="https://codeclimate.com/github/hikari-py/hikari/test_coverage"><img height="20" alt="Test coverage" src="https://api.codeclimate.com/v1/badges/f95070b25136a69b0589/test_coverage"></a>
 <br>
 <a href="https://discord.gg/Jx4cNGG"><img height="20" alt="Discord invite" src="https://discord.com/api/guilds/574921006817476608/widget.png"></a>
@@ -18,7 +18,7 @@ Gateway APIs.
 Built on good intentions and the hope that it will be extendable and reusable, rather than an obstacle for future
 development.
 
-Python 3.8, 3.9, 3.10, 3.11 and 3.12 are currently supported.
+Python 3.9, 3.10, 3.11, 3.12 and 3.13 are currently supported.
 
 ## Installation
 

changes/1725.feature.md

@@ -1 +1 @@
-nox[uv]==2024.4.15
+nox[uv]==2025.2.9

changes/1945.feature.md

@@ -1,2 +1,2 @@
 setuptools>=65.2.0
-wheel==0.44.0
+wheel==0.45.1

changes/1946.bugfix.md

@@ -1 +1 @@
-coverage[toml]==7.6.0
+coverage[toml]==7.6.12

changes/1951.feature.md

@@ -1,24 +1,21 @@
-flake8==7.1.1
+flake8==7.1.2
 
 # Plugins
 # Ref: https://github.com/DmytroLitvinov/awesome-flake8-extensions
 
 flake8-bandit~=4.1.1                    # runs bandit
-flake8-black==0.3.6                     # runs black
 flake8-builtins==2.5.0                  # builtin shadowing checks
-flake8-coding==1.3.2                    # coding magic-comment detection
-flake8-comprehensions==3.15.0           # comprehension checks
+flake8-comprehensions==3.16.0           # comprehension checks
 flake8-docstrings==1.7.0                # pydocstyle support
 flake8-executable==2.1.3                # shebangs
 flake8-fixme==1.1.1                     # "fix me" counter
 flake8-functions==0.0.8                 # function linting
 flake8-html==0.4.3                      # html output
-flake8-isort==6.1.1                     # runs isort
 flake8-mutable==1.2.0                   # mutable default argument detection
 flake8-pep3101==2.1.0                   # new-style format strings only
 flake8-print==5.0.0                     # complain about print statements in code
 flake8-printf-formatting==1.1.2         # forbey printf-style python2 string formatting
-flake8-pytest-style==2.0.0              # pytest checks
+flake8-pytest-style==2.1.0              # pytest checks
 flake8-raise==0.0.5                     # exception raising linting
 flake8-use-fstring==1.4                 # format string checking
 flake8-noqa==1.4.0                      # validate noqa commands

changes/1965.feature.md

@@ -1,11 +1,11 @@
-mkdocs==1.6.0
+mkdocs==1.6.1
 
 # Mkdocs Material
-mkdocs-material[imaging]==9.5.31
+mkdocs-material[imaging]==9.6.5
 
 # Docstring parsing for API reference
-mkdocstrings[python]==0.25.2
-griffe-inherited-docstrings==1.0.0
+mkdocstrings[python]==0.27.0
+griffe-inherited-docstrings==1.1.1
 
 # Generate API reference pages dynamically
 mkdocs-gen-files==0.5.0
@@ -14,8 +14,8 @@ mkdocs-literate-nav==0.6.1
 # Minify
 mkdocs-minify-plugin==0.8.0
 
-# Formatting signatures
-black==24.8.0
+# Towncrier draft changelogs
+mkdocs-towncrier==0.1.3
 
 # Image viewer ext
 # mkdocs-glightbox==0.3.7

changes/1982.bugfix.md

@@ -1 +1 @@
-mypy==1.10.1
+mypy[faster-cache]==1.15.0

changes/1983.bugfix.md

@@ -1 +1 @@
-pyright==1.1.374
+pyright==1.1.395

changes/1986.bugfix.md

@@ -1,11 +1,11 @@
 # mock in the stdlib changes between versions of Python, so are not consistent in behaviour like the backport is
 mock==5.1.0
 
-pytest==8.3.2
-pytest-asyncio==0.23.8
-pytest-cov==5.0.0
-pytest-randomly==3.15.0
+pytest==8.3.4
+pytest-asyncio==0.25.3
+pytest-cov==6.0.0
+pytest-randomly==3.16.0
 
-async-timeout==4.0.3  # Used for timeouts in some test cases.
+async-timeout==5.0.1  # Used for timeouts in some test cases.
 
 -r coverage.txt  # Consistent coverage version

changes/1988.bugfix.md

@@ -1,3 +1,3 @@
-twine==5.1.1
+twine==6.1.0
 
 -r build.txt

changes/1990.feature.md

@@ -0,0 +1 @@
+ruff==0.9.9

changes/1993.bugfix.md

@@ -1 +1 @@
-slotscheck==0.19.0
+slotscheck==0.19.1

changes/1996.bugfix.md

@@ -1 +1 @@
-towncrier==24.7.1
+towncrier==24.8.0

dev-requirements.txt

@@ -8,5 +8,6 @@ hide:
 !!! warning
     Major and minor releases also include the changes specified in prior development releases.
 
+:: towncrier-draft
 
 --8<-- "CHANGELOG.md"

dev-requirements/build.txt

@@ -1,4 +1,3 @@
-# -*- coding: utf-8 -*-
 # Hikari Examples - A collection of examples for Hikari.
 #
 # To the extent possible under law, the author(s) have dedicated all copyright

dev-requirements/coverage.txt

@@ -1,4 +1,3 @@
-# -*- coding: utf-8 -*-
 # Hikari Examples - A collection of examples for Hikari.
 #
 # To the extent possible under law, the author(s) have dedicated all copyright
@@ -9,6 +8,8 @@
 # If not, see <https://creativecommons.org/publicdomain/zero/1.0/>.
 """A simple bot with only a `!ping` command."""
 
+from __future__ import annotations
+
 import os
 
 import hikari

dev-requirements/flake8.txt

@@ -1,4 +1,3 @@
-# -*- coding: utf-8 -*-
 # Hikari Examples - A collection of examples for Hikari.
 #
 # To the extent possible under law, the author(s) have dedicated all copyright
@@ -13,6 +12,8 @@
 special treatment.
 """
 
+from __future__ import annotations
+
 import os
 import re
 

dev-requirements/formatting.txt

@@ -1,4 +1,3 @@
-# -*- coding: utf-8 -*-
 # Hikari Examples - A collection of examples for Hikari.
 #
 # To the extent possible under law, the author(s) have dedicated all copyright
@@ -8,6 +7,9 @@
 # You should have received a copy of the CC0 Public Domain Dedication along with this software.
 # If not, see <https://creativecommons.org/publicdomain/zero/1.0/>.
 """An example OAuth server."""
+
+from __future__ import annotations
+
 import logging
 import os