aio-libs / aiomysql

aiomysql is a library for accessing a MySQL database from the asyncio
https://aiomysql.rtfd.io
MIT License
1.72k stars 254 forks source link

Add namedtuple `Description` #981

Open trim21 opened 3 months ago

trim21 commented 3 months ago

What do these changes do?

add a class Description(typing.NamedTuple) for cursor.description

Are there changes in behavior for the user?

yes, cursor.description now return a tuple[Description] instead of tuple[tuple[...]]

Related issue number

Checklist

codecov[bot] commented 3 months ago

Codecov Report

All modified and coverable lines are covered by tests :white_check_mark:

Project coverage is 93.65%. Comparing base (83aa96e) to head (ed82a84).

Additional details and impacted files ```diff @@ Coverage Diff @@ ## master #981 +/- ## ========================================== - Coverage 93.68% 93.65% -0.03% ========================================== Files 36 37 +1 Lines 5538 5550 +12 Branches 895 895 ========================================== + Hits 5188 5198 +10 - Misses 260 262 +2 Partials 90 90 ``` | [Flag](https://app.codecov.io/gh/aio-libs/aiomysql/pull/981/flags?src=pr&el=flags&utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=aio-libs) | Coverage Δ | | |---|---|---| | [CI-GHA](https://app.codecov.io/gh/aio-libs/aiomysql/pull/981/flags?src=pr&el=flag&utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=aio-libs) | `93.26% <100.00%> (-0.03%)` | :arrow_down: | | [DB-mariadb-10.10](https://app.codecov.io/gh/aio-libs/aiomysql/pull/981/flags?src=pr&el=flag&utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=aio-libs) | `90.30% <100.00%> (+0.02%)` | :arrow_up: | | [DB-mariadb-10.11](https://app.codecov.io/gh/aio-libs/aiomysql/pull/981/flags?src=pr&el=flag&utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=aio-libs) | `90.30% <100.00%> (+0.02%)` | :arrow_up: | | [DB-mariadb-10.4](https://app.codecov.io/gh/aio-libs/aiomysql/pull/981/flags?src=pr&el=flag&utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=aio-libs) | `90.32% <100.00%> (+0.02%)` | :arrow_up: | | [DB-mariadb-10.5](https://app.codecov.io/gh/aio-libs/aiomysql/pull/981/flags?src=pr&el=flag&utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=aio-libs) | `90.30% <100.00%> (+0.02%)` | :arrow_up: | | [DB-mariadb-10.6](https://app.codecov.io/gh/aio-libs/aiomysql/pull/981/flags?src=pr&el=flag&utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=aio-libs) | `90.30% <100.00%> (+0.02%)` | :arrow_up: | | [DB-mariadb-10.9](https://app.codecov.io/gh/aio-libs/aiomysql/pull/981/flags?src=pr&el=flag&utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=aio-libs) | `90.30% <100.00%> (+0.02%)` | :arrow_up: | | [DB-mysql-5.7](https://app.codecov.io/gh/aio-libs/aiomysql/pull/981/flags?src=pr&el=flag&utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=aio-libs) | `91.00% <100.00%> (+0.01%)` | :arrow_up: | | [DB-mysql-8.0](https://app.codecov.io/gh/aio-libs/aiomysql/pull/981/flags?src=pr&el=flag&utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=aio-libs) | `92.39% <100.00%> (-0.02%)` | :arrow_down: | | [OS-Linux](https://app.codecov.io/gh/aio-libs/aiomysql/pull/981/flags?src=pr&el=flag&utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=aio-libs) | `93.26% <100.00%> (-0.03%)` | :arrow_down: | | [Py-3.10.11](https://app.codecov.io/gh/aio-libs/aiomysql/pull/981/flags?src=pr&el=flag&utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=aio-libs) | `?` | | | [Py-3.10.13](https://app.codecov.io/gh/aio-libs/aiomysql/pull/981/flags?src=pr&el=flag&utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=aio-libs) | `93.17% <100.00%> (?)` | | | [Py-3.11.3](https://app.codecov.io/gh/aio-libs/aiomysql/pull/981/flags?src=pr&el=flag&utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=aio-libs) | `?` | | | [Py-3.11.8](https://app.codecov.io/gh/aio-libs/aiomysql/pull/981/flags?src=pr&el=flag&utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=aio-libs) | `93.17% <100.00%> (?)` | | | [Py-3.7.16](https://app.codecov.io/gh/aio-libs/aiomysql/pull/981/flags?src=pr&el=flag&utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=aio-libs) | `?` | | | [Py-3.7.17](https://app.codecov.io/gh/aio-libs/aiomysql/pull/981/flags?src=pr&el=flag&utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=aio-libs) | `92.80% <100.00%> (?)` | | | [Py-3.8.16](https://app.codecov.io/gh/aio-libs/aiomysql/pull/981/flags?src=pr&el=flag&utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=aio-libs) | `?` | | | [Py-3.8.18](https://app.codecov.io/gh/aio-libs/aiomysql/pull/981/flags?src=pr&el=flag&utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=aio-libs) | `93.19% <100.00%> (?)` | | | [Py-3.9.16](https://app.codecov.io/gh/aio-libs/aiomysql/pull/981/flags?src=pr&el=flag&utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=aio-libs) | `?` | | | [Py-3.9.18](https://app.codecov.io/gh/aio-libs/aiomysql/pull/981/flags?src=pr&el=flag&utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=aio-libs) | `93.03% <100.00%> (?)` | | | [VM-ubuntu-latest](https://app.codecov.io/gh/aio-libs/aiomysql/pull/981/flags?src=pr&el=flag&utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=aio-libs) | `93.26% <100.00%> (-0.03%)` | :arrow_down: | | [ubuntu-latest_3.10_mariadb-10.10](https://app.codecov.io/gh/aio-libs/aiomysql/pull/981/flags?src=pr&el=flag&utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=aio-libs) | `90.21% <100.00%> (+0.02%)` | :arrow_up: | | [ubuntu-latest_3.10_mariadb-10.11](https://app.codecov.io/gh/aio-libs/aiomysql/pull/981/flags?src=pr&el=flag&utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=aio-libs) | `90.21% <100.00%> (+0.02%)` | :arrow_up: | | [ubuntu-latest_3.10_mariadb-10.4](https://app.codecov.io/gh/aio-libs/aiomysql/pull/981/flags?src=pr&el=flag&utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=aio-libs) | `90.23% <100.00%> (+0.02%)` | :arrow_up: | | [ubuntu-latest_3.10_mariadb-10.5](https://app.codecov.io/gh/aio-libs/aiomysql/pull/981/flags?src=pr&el=flag&utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=aio-libs) | `90.21% <100.00%> (+0.02%)` | :arrow_up: | | [ubuntu-latest_3.10_mariadb-10.6](https://app.codecov.io/gh/aio-libs/aiomysql/pull/981/flags?src=pr&el=flag&utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=aio-libs) | `90.21% <100.00%> (+0.02%)` | :arrow_up: | | [ubuntu-latest_3.10_mariadb-10.9](https://app.codecov.io/gh/aio-libs/aiomysql/pull/981/flags?src=pr&el=flag&utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=aio-libs) | `90.21% <100.00%> (+0.02%)` | :arrow_up: | | [ubuntu-latest_3.10_mysql-5.7](https://app.codecov.io/gh/aio-libs/aiomysql/pull/981/flags?src=pr&el=flag&utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=aio-libs) | `90.91% <100.00%> (+0.01%)` | :arrow_up: | | [ubuntu-latest_3.10_mysql-8.0](https://app.codecov.io/gh/aio-libs/aiomysql/pull/981/flags?src=pr&el=flag&utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=aio-libs) | `92.30% <100.00%> (+0.01%)` | :arrow_up: | | [ubuntu-latest_3.11_mariadb-10.10](https://app.codecov.io/gh/aio-libs/aiomysql/pull/981/flags?src=pr&el=flag&utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=aio-libs) | `90.21% <100.00%> (+0.02%)` | :arrow_up: | | [ubuntu-latest_3.11_mariadb-10.11](https://app.codecov.io/gh/aio-libs/aiomysql/pull/981/flags?src=pr&el=flag&utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=aio-libs) | `90.21% <100.00%> (+0.02%)` | :arrow_up: | | [ubuntu-latest_3.11_mariadb-10.4](https://app.codecov.io/gh/aio-libs/aiomysql/pull/981/flags?src=pr&el=flag&utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=aio-libs) | `90.23% <100.00%> (+0.02%)` | :arrow_up: | | [ubuntu-latest_3.11_mariadb-10.5](https://app.codecov.io/gh/aio-libs/aiomysql/pull/981/flags?src=pr&el=flag&utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=aio-libs) | `90.21% <100.00%> (+0.02%)` | :arrow_up: | | [ubuntu-latest_3.11_mariadb-10.6](https://app.codecov.io/gh/aio-libs/aiomysql/pull/981/flags?src=pr&el=flag&utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=aio-libs) | `90.21% <100.00%> (+0.02%)` | :arrow_up: | | [ubuntu-latest_3.11_mariadb-10.9](https://app.codecov.io/gh/aio-libs/aiomysql/pull/981/flags?src=pr&el=flag&utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=aio-libs) | `90.21% <100.00%> (+0.02%)` | :arrow_up: | | [ubuntu-latest_3.11_mysql-5.7](https://app.codecov.io/gh/aio-libs/aiomysql/pull/981/flags?src=pr&el=flag&utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=aio-libs) | `90.91% <100.00%> (+0.01%)` | :arrow_up: | | [ubuntu-latest_3.11_mysql-8.0](https://app.codecov.io/gh/aio-libs/aiomysql/pull/981/flags?src=pr&el=flag&utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=aio-libs) | `92.30% <100.00%> (-0.02%)` | :arrow_down: | | [ubuntu-latest_3.7_mariadb-10.10](https://app.codecov.io/gh/aio-libs/aiomysql/pull/981/flags?src=pr&el=flag&utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=aio-libs) | `89.66% <100.00%> (+0.02%)` | :arrow_up: | | [ubuntu-latest_3.7_mariadb-10.11](https://app.codecov.io/gh/aio-libs/aiomysql/pull/981/flags?src=pr&el=flag&utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=aio-libs) | `89.66% <100.00%> (+0.02%)` | :arrow_up: | | [ubuntu-latest_3.7_mariadb-10.4](https://app.codecov.io/gh/aio-libs/aiomysql/pull/981/flags?src=pr&el=flag&utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=aio-libs) | `89.68% <100.00%> (+0.02%)` | :arrow_up: | | [ubuntu-latest_3.7_mariadb-10.5](https://app.codecov.io/gh/aio-libs/aiomysql/pull/981/flags?src=pr&el=flag&utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=aio-libs) | `89.66% <100.00%> (+0.02%)` | :arrow_up: | | [ubuntu-latest_3.7_mariadb-10.6](https://app.codecov.io/gh/aio-libs/aiomysql/pull/981/flags?src=pr&el=flag&utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=aio-libs) | `89.66% <100.00%> (+0.02%)` | :arrow_up: | | [ubuntu-latest_3.7_mariadb-10.9](https://app.codecov.io/gh/aio-libs/aiomysql/pull/981/flags?src=pr&el=flag&utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=aio-libs) | `89.66% <100.00%> (+0.02%)` | :arrow_up: | | [ubuntu-latest_3.7_mysql-5.7](https://app.codecov.io/gh/aio-libs/aiomysql/pull/981/flags?src=pr&el=flag&utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=aio-libs) | `90.41% <100.00%> (+0.02%)` | :arrow_up: | | [ubuntu-latest_3.7_mysql-8.0](https://app.codecov.io/gh/aio-libs/aiomysql/pull/981/flags?src=pr&el=flag&utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=aio-libs) | `91.88% <100.00%> (+0.02%)` | :arrow_up: | | [ubuntu-latest_3.8_mariadb-10.10](https://app.codecov.io/gh/aio-libs/aiomysql/pull/981/flags?src=pr&el=flag&utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=aio-libs) | `90.25% <100.00%> (+0.02%)` | :arrow_up: | | [ubuntu-latest_3.8_mariadb-10.11](https://app.codecov.io/gh/aio-libs/aiomysql/pull/981/flags?src=pr&el=flag&utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=aio-libs) | `90.25% <100.00%> (+0.02%)` | :arrow_up: | | [ubuntu-latest_3.8_mariadb-10.4](https://app.codecov.io/gh/aio-libs/aiomysql/pull/981/flags?src=pr&el=flag&utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=aio-libs) | `90.27% <100.00%> (+0.02%)` | :arrow_up: | | [ubuntu-latest_3.8_mariadb-10.5](https://app.codecov.io/gh/aio-libs/aiomysql/pull/981/flags?src=pr&el=flag&utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=aio-libs) | `90.25% <100.00%> (+0.02%)` | :arrow_up: | | [ubuntu-latest_3.8_mariadb-10.6](https://app.codecov.io/gh/aio-libs/aiomysql/pull/981/flags?src=pr&el=flag&utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=aio-libs) | `90.25% <100.00%> (+0.02%)` | :arrow_up: | | [ubuntu-latest_3.8_mariadb-10.9](https://app.codecov.io/gh/aio-libs/aiomysql/pull/981/flags?src=pr&el=flag&utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=aio-libs) | `90.25% <100.00%> (+0.02%)` | :arrow_up: | | [ubuntu-latest_3.8_mysql-5.7](https://app.codecov.io/gh/aio-libs/aiomysql/pull/981/flags?src=pr&el=flag&utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=aio-libs) | `90.96% <100.00%> (+0.01%)` | :arrow_up: | | [ubuntu-latest_3.8_mysql-8.0](https://app.codecov.io/gh/aio-libs/aiomysql/pull/981/flags?src=pr&el=flag&utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=aio-libs) | `92.33% <100.00%> (+0.01%)` | :arrow_up: | | [ubuntu-latest_3.9_mariadb-10.10](https://app.codecov.io/gh/aio-libs/aiomysql/pull/981/flags?src=pr&el=flag&utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=aio-libs) | `90.09% <100.00%> (+0.02%)` | :arrow_up: | | [ubuntu-latest_3.9_mariadb-10.11](https://app.codecov.io/gh/aio-libs/aiomysql/pull/981/flags?src=pr&el=flag&utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=aio-libs) | `90.09% <100.00%> (+0.02%)` | :arrow_up: | | [ubuntu-latest_3.9_mariadb-10.4](https://app.codecov.io/gh/aio-libs/aiomysql/pull/981/flags?src=pr&el=flag&utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=aio-libs) | `90.11% <100.00%> (+0.02%)` | :arrow_up: | | [ubuntu-latest_3.9_mariadb-10.5](https://app.codecov.io/gh/aio-libs/aiomysql/pull/981/flags?src=pr&el=flag&utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=aio-libs) | `90.09% <100.00%> (+0.02%)` | :arrow_up: | | [ubuntu-latest_3.9_mariadb-10.6](https://app.codecov.io/gh/aio-libs/aiomysql/pull/981/flags?src=pr&el=flag&utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=aio-libs) | `90.09% <100.00%> (+0.02%)` | :arrow_up: | | [ubuntu-latest_3.9_mariadb-10.9](https://app.codecov.io/gh/aio-libs/aiomysql/pull/981/flags?src=pr&el=flag&utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=aio-libs) | `90.09% <100.00%> (+0.02%)` | :arrow_up: | | [ubuntu-latest_3.9_mysql-5.7](https://app.codecov.io/gh/aio-libs/aiomysql/pull/981/flags?src=pr&el=flag&utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=aio-libs) | `90.79% <100.00%> (+0.01%)` | :arrow_up: | | [ubuntu-latest_3.9_mysql-8.0](https://app.codecov.io/gh/aio-libs/aiomysql/pull/981/flags?src=pr&el=flag&utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=aio-libs) | `92.17% <100.00%> (+0.01%)` | :arrow_up: | Flags with carried forward coverage won't be shown. [Click here](https://docs.codecov.io/docs/carryforward-flags?utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=aio-libs#carryforward-flags-in-the-pull-request-comment) to find out more.

:umbrella: View full report in Codecov by Sentry.
:loudspeaker: Have feedback on the report? Share it here.