Add __match_args__ to support match case destructuring in Python 3.10 #815

tirkarthi · 2021-05-14T05:30:27Z

Pull Request Check List

This is just a friendly reminder about the most common mistakes. Please make sure that you tick all boxes. But please read our contribution guide at least once, it will save you unnecessary review cycles!

If an item doesn't apply to your pull request, check it anyway to make it apparent that there's nothing left to do. If your pull request is a documentation fix or a trivial typo, feel free to delete the whole thing.

If you have any questions to any of the points above, just submit and ask! This checklist is here to help you, not to deter you from contributing!

tirkarthi · 2021-05-14T16:55:14Z

Sorry for the lint errors. Hopefully it's all fine now.

hynek

Thanks and welcome to the team!

Additionally to the inline comments, please:

needs to be added to _next_gen.py
it would be nice if you could adapt the test docstrings to https://jml.io/pages/test-docstrings.html but I can do it myself too later. Mostly just drop the Test
as Tin mentioned, we need some tests. Please add a new file like test_pattern_matching.py, add your tests, and exclude the file on older Python versions in conftest.py – there's some examples how to do it!

CHANGELOG.rst

hynek · 2021-05-17T11:04:01Z

src/attr/_make.py

@@ -1562,6 +1576,9 @@ def wrap(cls):
                    " init must be True."
                )

+        if match_args and "__match_args__" not in cls.__dict__:


Please use _has_own_attribute for the second check.

I'm aware that the implementation is currently obtuse and depending on how Larry's typing proposal will go, we'll fix it centrally eventually.

This behavior is also somewhat inconsistent with the rest of attrs, where we overwrite unless auto_detect is set to True (default in new APIs). Is this the behavior of dataclasses?

It also doesn't make sense to add it on Pythons older than 3.10, no?

In the initial implementation of the pattern matching PEP there was no flag to disable __match_args__ generation but there was a request raised later on a flag to opt-out though __match_args__ = () being set manually was proposed. Discussion : https://bugs.python.org/issue43764

src/attr/_make.py

changelog.d/815.changes.rst

tirkarthi · 2021-05-17T14:18:32Z

Changes done :

Updated docs. Removed "Test" from docstrings and updated a few. Feel free to makes changes.
Added test_pattern_matching.py on Python 3.10.
Disabled black since black doesn't support formatting pattern matching : Support Python 3.10 pattern matching syntax psf/black#2242
Disabled flake8 since pyflakes has an issue with keyword argument matching : AttributeError in parsing Python 3.10 parsing pattern matching with keyword arguments PyCQA/pyflakes#634

needs to be added to _next_gen.py

I am not sure about the changes to be made here since match_args is not a signature change in define and field

hynek · 2021-05-17T14:22:38Z

define, mutable, and frozen all wrap attr.s, so the argument needs to be added to them (and their type stubs) too?

tirkarthi · 2021-05-17T14:36:39Z

Thanks, added in 0cd51b4

tirkarthi · 2021-05-17T15:08:04Z

It seems pre-commit uses Python 3.8 and interrogate fails to parse the Python 3.10 syntax. Excluding the file in pyproject.toml for interrogate doesn't seem to ignore it. debug_statement action of pre-commit also uses the syntax and fails.

black seems not to exclude the files as per pre-commit pinned version. Upgrading black gives some more formatting changes on unrelated files as it seems black has changed the formatting.

hynek · 2021-05-17T15:31:40Z

I think you'll have to block the match tests to black and interrogate in .pre-commit-config.yaml.

tirkarthi · 2021-05-17T15:35:46Z

As noted in https://stackoverflow.com/questions/61032281/exclude-some-files-on-running-black-using-pre-commit, it seems that pre-commit gets all python files and just passes it to the command and using --exclude for black doesn't help. I have bumped to Python 3.10 for interrogate and debug_statement. For black I have added exclude from pre-commit end. tox -e lint seems to pass.

tox -e lint
lint installed: appdirs==1.4.4,cfgv==3.2.0,distlib==0.3.1,filelock==3.0.12,identify==2.2.4,nodeenv==1.6.0,pre-commit==2.12.1,PyYAML==5.4.1,six==1.16.0,toml==0.10.2,virtualenv==20.4.6
lint run-test-pre: PYTHONHASHSEED='2125636111'
lint run-test: commands[0] | pre-commit run --all-files
black....................................................................Passed
isort....................................................................Passed
flake8...................................................................Passed
interrogate..............................................................Passed
Trim Trailing Whitespace.................................................Passed
Fix End of Files.........................................................Passed
Debug Statements (Python)................................................Passed
Check Toml...............................................................Passed
_______________________________________________________________________________ summary ________________________________________________________________________________
  lint: commands succeeded
  congratulations :)

tirkarthi · 2021-05-17T15:43:02Z

codecov gives me 403, I am not sure about the code coverage error.

hynek · 2021-05-17T16:06:07Z

codecov is probably failing, because python 3.8 fails and doesn't upload.

now we have the problem, that the linter needs python 3.10 and that's not present in the 3.8 container

I guess there's two options:

block match from interrogate
move lint to py310

I guess you could try option 2 (change the [gh-actions] section in tox.ini) but if that fails for other reasons (or you don't want to deal with it), just go with 1.

tirkarthi · 2021-05-17T16:15:22Z

Thanks, I guess option 2 makes more sense since eventually the python version has to be upgraded to support parsing. I have pushed commit to bump basepython to 3.10 in lint step.

tirkarthi · 2021-05-17T16:25:41Z

tox and gh-actions are slightly new to me so I got confused. I pushed the lint job from py38 to py310 and also made basepython 3.10 in lint step. I guess this should run link in python 3.10 container with python 3.10 as base. Please correct me if I am wrong.

hynek · 2021-05-17T17:38:10Z

Looks good, but I think you still add the tuple on Python <3.10? (On my phone for the rest of the day)

tirkarthi · 2021-05-17T17:53:10Z

Yes, I am adding __match_args__ tuple always. I don't see any backwards compatibility issues with the same. I will be curious how dataclasses backport also deals with the change too. I can add a version check to add tuple only for Python 3.10+ if you want. In that case I guess match_args=True will always be there in signature and it's just that tuple generation becomes python 3.10+?

hynek · 2021-05-17T18:49:25Z

Yeah I don’t have any comparability problems in mind – it just seems wasteful to set an attribute on all classes even tho they can’t use it.

And yes, just add something to the tune of “this argument is ignored on Python versions before 3.10” to the doc string and call it a day.

hynek

You've suffered enough and I have to approve every CI run so I'd rather do the small stuff myself than shooing you around.

Thanks for playing along!

tirkarthi · 2021-05-18T07:58:26Z

Thanks @hynek for the review and merge :)

Signed-off-by: Hynek Schlawack <hs@ox.cx>

465: build(deps): bump attrs from 21.2.0 to 21.3.0 r=ChrisRBe a=dependabot[bot] Bumps [attrs](https://github.com/python-attrs/attrs) from 21.2.0 to 21.3.0. <details> <summary>Release notes</summary> Sourced from <a href="https://github.com/python-attrs/attrs/releases">attrs's releases</a>. <blockquote> <h2>21.3.0</h2> This is a big release in the history of <code>attrs</code> and finishes an arc that took way too long and also delayed this very overdue release. But it's done: <code>import attrs</code> that has been talked about for years[^issue], but fell victim to “just this one more thing” has finally landed. From now on, modern <code>attrs</code> code looks like this: <pre lang="python"><code>from attrs import define <a href="https://github.com/define"><code>`@define</code></a>` class HelloWorld: modern: bool = True </code></pre> The <code>define</code>/<code>field</code> APIs have been around for over a year and were very popular, now the rest of the package followed suit. I'm very excited that <code>attrs</code> remains relevant and keeps evolving over now more than half a decade. If you're curious about some of the background, the docs now contain a short <a href="https://www.attrs.org/en/stable/names.html">explanation and history lesson</a>. As long as our users keep pushing us, we will keep pushing forward class generation in Python! Big thanks to my <a href="https://github.com/sponsors/hynek/dashboard">GitHub Sponsors</a>, <a href="https://tidelift.com/subscription/pkg/pypi-attrs?utm_source=pypi-attrs&utm_medium=referral&utm_campaign=enterprise&utm_term=repo">Tidelift subscribers</a>, and <a href="https://ko-fi.com/the_hynekl">Ko-fi buyers</a> that help me mustering the motivation for such long-running project! <hr /> Since the release took so long, there's more highlights than we can enumerate here, we'd just like to point out a breaking change in the new APIs: converters now run on setting attributes by default. If this is causing problems to you, you can disable that behavior by setting <code>`@define(on_setattr=[])</code>.` [^issue]: I have an issue from 2018 that I wanted to "come back the moment this lands". <h1>Full Changelog</h1> <h2>Backward-incompatible Changes</h2> <ul> <li> When using <code>`@define</code>,` converters are now run by default when setting an attribute on an instance -- additionally to validators. I.e. the new default is <code>on_setattr=[attrs.setters.convert, attrs.setters.validate]</code>. This is unfortunately a breaking change, but it was an oversight, impossible to raise a <code>DeprecationWarning</code> about, and it's better to fix it now while the APIs are very fresh with few users. <a href="https://github-redirect.dependabot.com/python-attrs/attrs/issues/835">#835</a>, <a href="https://github-redirect.dependabot.com/python-attrs/attrs/issues/886">#886</a> </li> <li> <code>import attrs</code> has finally landed! As of this release, you can finally import <code>attrs</code> using its proper name. Not all names from the <code>attr</code> namespace have been transferred; most notably <code>attr.s</code> and <code>attr.ib</code> are missing. See <code>attrs.define</code> and <code>attrs.field</code> if you haven't seen our next-generation APIs yet. A more elaborate explanation can be found <a href="https://www.attrs.org/en/latest/names.html">On The Core API Names</a> This feature is at least for one release provisional. We don't plan on changing anything, but such a big change is unlikely to go perfectly on the first strike. The API docs have been mostly updated, but it will be an ongoing effort to change everything to the new APIs. Please note that we have not moved -- or even removed -- anything from <code>attr</code>! Please do report any bugs or documentation inconsistencies! <a href="https://github-redirect.dependabot.com/python-attrs/attrs/issues/887">#887</a> </li> </ul> <h2>Changes</h2> <ul> <li><code>attr.asdict(retain_collection_types=False)</code> (default) dumps collection-esque keys as tuples. <a href="https://github-redirect.dependabot.com/python-attrs/attrs/issues/646">#646</a>, <a href="https://github-redirect.dependabot.com/python-attrs/attrs/issues/888">#888</a></li> <li><code>__match_args__</code> are now generated to support Python 3.10's <a href="https://docs.python.org/3.10/whatsnew/3.10.html#pep-634-structural-pattern-matching">Structural Pattern Matching</a>. This can be controlled by the <code>match_args</code> argument to the class decorators on Python 3.10 and later. On older versions, it is never added and the argument is ignored. <a href="https://github-redirect.dependabot.com/python-attrs/attrs/issues/815">#815</a></li> <li>If the class-level on_setattr is set to <code>attrs.setters.validate</code> (default in <code>`@define</code>` and <code>`@mutable</code>)` but no field defines a validator, pretend that it's not set. <a href="https://github-redirect.dependabot.com/python-attrs/attrs/issues/817">#817</a></li> <li>The generated <code>__repr__</code> is significantly faster on Pythons with f-strings. <a href="https://github-redirect.dependabot.com/python-attrs/attrs/issues/819">#819</a></li> <li>Attributes transformed via <code>field_transformer</code> are wrapped with <code>AttrsClass</code> again. <a href="https://github-redirect.dependabot.com/python-attrs/attrs/issues/824">#824</a></li> <li>Generated source code is now cached more efficiently for identical classes. <a href="https://github-redirect.dependabot.com/python-attrs/attrs/issues/828">#828</a></li> <li>Added <code>attrs.converters.to_bool()</code>. <a href="https://github-redirect.dependabot.com/python-attrs/attrs/issues/830">#830</a></li> </ul>  </blockquote> ... (truncated) </details> <details> <summary>Changelog</summary> Sourced from <a href="https://github.com/python-attrs/attrs/blob/main/CHANGELOG.rst">attrs's changelog</a>. <blockquote> <h2>21.3.0 (2021-12-28)</h2> Backward-incompatible Changes ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ <ul> <li> When using <code>`@define</code>,` converters are now run by default when setting an attribute on an instance -- additionally to validators. I.e. the new default is <code>on_setattr=[attrs.setters.convert, attrs.setters.validate]</code>. This is unfortunately a breaking change, but it was an oversight, impossible to raise a <code>DeprecationWarning</code> about, and it's better to fix it now while the APIs are very fresh with few users. <code>[#835](python-attrs/attrs#835) <https://github.com/python-attrs/attrs/issues/835></code>, <code>[#886](python-attrs/attrs#886) <https://github.com/python-attrs/attrs/issues/886></code> </li> <li> <code>import attrs</code> has finally landed! As of this release, you can finally import <code>attrs</code> using its proper name. Not all names from the <code>attr</code> namespace have been transferred; most notably <code>attr.s</code> and <code>attr.ib</code> are missing. See <code>attrs.define</code> and <code>attrs.field</code> if you haven't seen our next-generation APIs yet. A more elaborate explanation can be found <code>On The Core API Names <https://www.attrs.org/en/latest/names.html></code>_ This feature is at least for one release provisional. We don't plan on changing anything, but such a big change is unlikely to go perfectly on the first strike. The API docs have been mostly updated, but it will be an ongoing effort to change everything to the new APIs. Please note that we have not moved -- or even removed -- anything from <code>attr</code>! Please do report any bugs or documentation inconsistencies! <code>[#887](python-attrs/attrs#887) <https://github.com/python-attrs/attrs/issues/887></code>_ </li> </ul> Changes ^^^^^^^ <ul> <li><code>attr.asdict(retain_collection_types=False)</code> (default) dumps collection-esque keys as tuples. <code>[#646](python-attrs/attrs#646) <https://github.com/python-attrs/attrs/issues/646></code>, <code>[#888](python-attrs/attrs#888) <https://github.com/python-attrs/attrs/issues/888></code></li> <li><code>__match_args__</code> are now generated to support Python 3.10's <code>Structural Pattern Matching <https://docs.python.org/3.10/whatsnew/3.10.html#pep-634-structural-pattern-matching></code>. This can be controlled by the <code>match_args</code> argument to the class decorators on Python 3.10 and later. On older versions, it is never added and the argument is ignored. <code>[#815](python-attrs/attrs#815) <https://github.com/python-attrs/attrs/issues/815></code></li> <li>If the class-level on_setattr is set to <code>attrs.setters.validate</code> (default in <code>`@define</code>` and <code>`@mutable</code>)` but no field defines a validator, pretend that it's not set. <code>[#817](python-attrs/attrs#817) <https://github.com/python-attrs/attrs/issues/817></code>_</li> <li>The generated <code>__repr__</code> is significantly faster on Pythons with f-strings. <code>[#819](python-attrs/attrs#819) <https://github.com/python-attrs/attrs/issues/819></code>_</li> <li>Attributes transformed via <code>field_transformer</code> are wrapped with <code>AttrsClass</code> again. <code>[#824](python-attrs/attrs#824) <https://github.com/python-attrs/attrs/issues/824></code>_</li> <li>Generated source code is now cached more efficiently for identical classes. <code>[#828](python-attrs/attrs#828) <https://github.com/python-attrs/attrs/issues/828></code>_</li> <li>Added <code>attrs.converters.to_bool()</code>. <code>[#830](python-attrs/attrs#830) <https://github.com/python-attrs/attrs/issues/830></code>_</li> </ul>  </blockquote> ... (truncated) </details> <details> <summary>Commits</summary> <ul> <li><a href="https://github.com/python-attrs/attrs/commit/dd26edd68e12879f716c6554f25d957af299b801"><code>dd26edd</code></a> Prepare 21.3.0</li> <li><a href="https://github.com/python-attrs/attrs/commit/20bf4b6e54a75201b378cff8e6dd9521d2da28f1"><code>20bf4b6</code></a> Go over CONTRIBUTING.md</li> <li><a href="https://github.com/python-attrs/attrs/commit/d528dd425980eff3f43b0e29b0ce4dc81ecd8d84"><code>d528dd4</code></a> Fix more links</li> <li><a href="https://github.com/python-attrs/attrs/commit/fcfb5a692cc8c9f8fde8e39bbd2c5733a47fb1e7"><code>fcfb5a6</code></a> Last pass over changelogs</li> <li><a href="https://github.com/python-attrs/attrs/commit/e09873485e14e9b11d5d590a55280894df367d92"><code>e098734</code></a> Add logo to PyPI description</li> <li><a href="https://github.com/python-attrs/attrs/commit/26c0cef8e48bd131d062d45bdaa0c949d4a2d035"><code>26c0cef</code></a> Streamline workflow</li> <li><a href="https://github.com/python-attrs/attrs/commit/3333e749781a107c829717f7bc0382d33b538b6e"><code>3333e74</code></a> Remove dead achor</li> <li><a href="https://github.com/python-attrs/attrs/commit/2d77d83d4e3ceadbf4414da5963623a20564c415"><code>2d77d83</code></a> Fix dataclass_transform links</li> <li><a href="https://github.com/python-attrs/attrs/commit/b4dc9b07c70c16848960da077fc7ac18fe5e9bc8"><code>b4dc9b0</code></a> Better 2.7 example</li> <li><a href="https://github.com/python-attrs/attrs/commit/d4e32209dc5855796e57c2b08bdc1c1702d051ab"><code>d4e3220</code></a> Use attrs namespace throughout examples.rst</li> <li>Additional commits viewable in <a href="https://github.com/python-attrs/attrs/compare/21.2.0...21.3.0">compare view</a></li> </ul> </details> [![Dependabot compatibility score](https://dependabot-badges.githubapp.com/badges/compatibility_score?dependency-name=attrs&package-manager=pip&previous-version=21.2.0&new-version=21.3.0)](https://docs.github.com/en/github/managing-security-vulnerabilities/about-dependabot-security-updates#about-compatibility-scores) Dependabot will resolve any conflicts with this PR as long as you don't alter it yourself. You can also trigger a rebase manually by commenting ``@dependabot` rebase`. [//]: # (dependabot-automerge-start) [//]: # (dependabot-automerge-end) --- <details> <summary>Dependabot commands and options</summary> You can trigger Dependabot actions by commenting on this PR: - ``@dependabot` rebase` will rebase this PR - ``@dependabot` recreate` will recreate this PR, overwriting any edits that have been made to it - ``@dependabot` merge` will merge this PR after your CI passes on it - ``@dependabot` squash and merge` will squash and merge this PR after your CI passes on it - ``@dependabot` cancel merge` will cancel a previously requested merge and block automerging - ``@dependabot` reopen` will reopen this PR if it is closed - ``@dependabot` close` will close this PR and stop Dependabot recreating it. You can achieve the same result by closing it manually - ``@dependabot` ignore this major version` will close this PR and stop Dependabot creating any more for this major version (unless you reopen the PR or upgrade to it yourself) - ``@dependabot` ignore this minor version` will close this PR and stop Dependabot creating any more for this minor version (unless you reopen the PR or upgrade to it yourself) - ``@dependabot` ignore this dependency` will close this PR and stop Dependabot creating any more for this dependency (unless you reopen the PR or upgrade to it yourself) </details> 466: build(deps): bump identify from 2.4.0 to 2.4.1 r=ChrisRBe a=dependabot[bot] Bumps [identify](https://github.com/pre-commit/identify) from 2.4.0 to 2.4.1. <details> <summary>Commits</summary> <ul> <li><a href="https://github.com/pre-commit/identify/commit/95e30a37bf7c044da3149d85de4a10f5ff494857"><code>95e30a3</code></a> v2.4.1</li> <li><a href="https://github.com/pre-commit/identify/commit/127535d4fb489e5d6e95055b605d9104c526b3b9"><code>127535d</code></a> Merge pull request <a href="https://github-redirect.dependabot.com/pre-commit/identify/issues/261">#261</a> from andreoliwa/add-prettierignore</li> <li><a href="https://github.com/pre-commit/identify/commit/665321fee45f00da0f2002bc203fdd3a54348bb4"><code>665321f</code></a> Target prettierignore specifically</li> <li><a href="https://github.com/pre-commit/identify/commit/08fdc8ef63ffbac7fc76d3270814f7c648959fab"><code>08fdc8e</code></a> Add .prettierignore extension</li> <li><a href="https://github.com/pre-commit/identify/commit/a1d955bf83f8416d0345e4334b8d01df552e3c79"><code>a1d955b</code></a> Merge pull request <a href="https://github-redirect.dependabot.com/pre-commit/identify/issues/260">#260</a> from pre-commit/pre-commit-ci-update-config</li> <li><a href="https://github.com/pre-commit/identify/commit/eec46c02ad339b4b54adbcc2c0414057c0688838"><code>eec46c0</code></a> [pre-commit.ci] pre-commit autoupdate</li> <li><a href="https://github.com/pre-commit/identify/commit/f95fbc36c708419d983e3c210c88f44217eab30d"><code>f95fbc3</code></a> Merge pull request <a href="https://github-redirect.dependabot.com/pre-commit/identify/issues/257">#257</a> from pre-commit/pre-commit-ci-update-config</li> <li><a href="https://github.com/pre-commit/identify/commit/5d5226d203b1551d1c96db73f7a140a2cdca1656"><code>5d5226d</code></a> [pre-commit.ci] pre-commit autoupdate</li> <li><a href="https://github.com/pre-commit/identify/commit/2782f1cabd09df0c3ab4aa4f8c2b822fd4ea8c16"><code>2782f1c</code></a> Merge pull request <a href="https://github-redirect.dependabot.com/pre-commit/identify/issues/256">#256</a> from pre-commit/all-repos_autofix_gh-funding-default</li> <li><a href="https://github.com/pre-commit/identify/commit/761330ab6552e8687bc60d6ecdcad99078e16513"><code>761330a</code></a> Use org-default .github/FUNDING.yml</li> <li>Additional commits viewable in <a href="https://github.com/pre-commit/identify/compare/v2.4.0...v2.4.1">compare view</a></li> </ul> </details> [![Dependabot compatibility score](https://dependabot-badges.githubapp.com/badges/compatibility_score?dependency-name=identify&package-manager=pip&previous-version=2.4.0&new-version=2.4.1)](https://docs.github.com/en/github/managing-security-vulnerabilities/about-dependabot-security-updates#about-compatibility-scores) Dependabot will resolve any conflicts with this PR as long as you don't alter it yourself. You can also trigger a rebase manually by commenting ``@dependabot` rebase`. [//]: # (dependabot-automerge-start) [//]: # (dependabot-automerge-end) --- <details> <summary>Dependabot commands and options</summary> You can trigger Dependabot actions by commenting on this PR: - ``@dependabot` rebase` will rebase this PR - ``@dependabot` recreate` will recreate this PR, overwriting any edits that have been made to it - ``@dependabot` merge` will merge this PR after your CI passes on it - ``@dependabot` squash and merge` will squash and merge this PR after your CI passes on it - ``@dependabot` cancel merge` will cancel a previously requested merge and block automerging - ``@dependabot` reopen` will reopen this PR if it is closed - ``@dependabot` close` will close this PR and stop Dependabot recreating it. You can achieve the same result by closing it manually - ``@dependabot` ignore this major version` will close this PR and stop Dependabot creating any more for this major version (unless you reopen the PR or upgrade to it yourself) - ``@dependabot` ignore this minor version` will close this PR and stop Dependabot creating any more for this minor version (unless you reopen the PR or upgrade to it yourself) - ``@dependabot` ignore this dependency` will close this PR and stop Dependabot creating any more for this dependency (unless you reopen the PR or upgrade to it yourself) </details> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

465: build(deps): bump attrs from 21.2.0 to 21.3.0 r=ChrisRBe a=dependabot[bot] Bumps [attrs](https://github.com/python-attrs/attrs) from 21.2.0 to 21.3.0. <details> <summary>Release notes</summary> Sourced from <a href="https://github.com/python-attrs/attrs/releases">attrs's releases</a>. <blockquote> <h2>21.3.0</h2> This is a big release in the history of <code>attrs</code> and finishes an arc that took way too long and also delayed this very overdue release. But it's done: <code>import attrs</code> that has been talked about for years[^issue], but fell victim to “just this one more thing” has finally landed. From now on, modern <code>attrs</code> code looks like this: <pre lang="python"><code>from attrs import define <a href="https://github.com/define"><code>`@define</code></a>` class HelloWorld: modern: bool = True </code></pre> The <code>define</code>/<code>field</code> APIs have been around for over a year and were very popular, now the rest of the package followed suit. I'm very excited that <code>attrs</code> remains relevant and keeps evolving over now more than half a decade. If you're curious about some of the background, the docs now contain a short <a href="https://www.attrs.org/en/stable/names.html">explanation and history lesson</a>. As long as our users keep pushing us, we will keep pushing forward class generation in Python! Big thanks to my <a href="https://github.com/sponsors/hynek/dashboard">GitHub Sponsors</a>, <a href="https://tidelift.com/subscription/pkg/pypi-attrs?utm_source=pypi-attrs&utm_medium=referral&utm_campaign=enterprise&utm_term=repo">Tidelift subscribers</a>, and <a href="https://ko-fi.com/the_hynekl">Ko-fi buyers</a> that help me mustering the motivation for such long-running project! <hr /> Since the release took so long, there's more highlights than we can enumerate here, we'd just like to point out a breaking change in the new APIs: converters now run on setting attributes by default. If this is causing problems to you, you can disable that behavior by setting <code>`@define(on_setattr=[])</code>.` [^issue]: I have an issue from 2018 that I wanted to "come back the moment this lands". <h1>Full Changelog</h1> <h2>Backward-incompatible Changes</h2> <ul> <li> When using <code>`@define</code>,` converters are now run by default when setting an attribute on an instance -- additionally to validators. I.e. the new default is <code>on_setattr=[attrs.setters.convert, attrs.setters.validate]</code>. This is unfortunately a breaking change, but it was an oversight, impossible to raise a <code>DeprecationWarning</code> about, and it's better to fix it now while the APIs are very fresh with few users. <a href="https://github-redirect.dependabot.com/python-attrs/attrs/issues/835">#835</a>, <a href="https://github-redirect.dependabot.com/python-attrs/attrs/issues/886">#886</a> </li> <li> <code>import attrs</code> has finally landed! As of this release, you can finally import <code>attrs</code> using its proper name. Not all names from the <code>attr</code> namespace have been transferred; most notably <code>attr.s</code> and <code>attr.ib</code> are missing. See <code>attrs.define</code> and <code>attrs.field</code> if you haven't seen our next-generation APIs yet. A more elaborate explanation can be found <a href="https://www.attrs.org/en/latest/names.html">On The Core API Names</a> This feature is at least for one release provisional. We don't plan on changing anything, but such a big change is unlikely to go perfectly on the first strike. The API docs have been mostly updated, but it will be an ongoing effort to change everything to the new APIs. Please note that we have not moved -- or even removed -- anything from <code>attr</code>! Please do report any bugs or documentation inconsistencies! <a href="https://github-redirect.dependabot.com/python-attrs/attrs/issues/887">#887</a> </li> </ul> <h2>Changes</h2> <ul> <li><code>attr.asdict(retain_collection_types=False)</code> (default) dumps collection-esque keys as tuples. <a href="https://github-redirect.dependabot.com/python-attrs/attrs/issues/646">#646</a>, <a href="https://github-redirect.dependabot.com/python-attrs/attrs/issues/888">#888</a></li> <li><code>__match_args__</code> are now generated to support Python 3.10's <a href="https://docs.python.org/3.10/whatsnew/3.10.html#pep-634-structural-pattern-matching">Structural Pattern Matching</a>. This can be controlled by the <code>match_args</code> argument to the class decorators on Python 3.10 and later. On older versions, it is never added and the argument is ignored. <a href="https://github-redirect.dependabot.com/python-attrs/attrs/issues/815">#815</a></li> <li>If the class-level on_setattr is set to <code>attrs.setters.validate</code> (default in <code>`@define</code>` and <code>`@mutable</code>)` but no field defines a validator, pretend that it's not set. <a href="https://github-redirect.dependabot.com/python-attrs/attrs/issues/817">#817</a></li> <li>The generated <code>__repr__</code> is significantly faster on Pythons with f-strings. <a href="https://github-redirect.dependabot.com/python-attrs/attrs/issues/819">#819</a></li> <li>Attributes transformed via <code>field_transformer</code> are wrapped with <code>AttrsClass</code> again. <a href="https://github-redirect.dependabot.com/python-attrs/attrs/issues/824">#824</a></li> <li>Generated source code is now cached more efficiently for identical classes. <a href="https://github-redirect.dependabot.com/python-attrs/attrs/issues/828">#828</a></li> <li>Added <code>attrs.converters.to_bool()</code>. <a href="https://github-redirect.dependabot.com/python-attrs/attrs/issues/830">#830</a></li> </ul>  </blockquote> ... (truncated) </details> <details> <summary>Changelog</summary> Sourced from <a href="https://github.com/python-attrs/attrs/blob/main/CHANGELOG.rst">attrs's changelog</a>. <blockquote> <h2>21.3.0 (2021-12-28)</h2> Backward-incompatible Changes ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ <ul> <li> When using <code>`@define</code>,` converters are now run by default when setting an attribute on an instance -- additionally to validators. I.e. the new default is <code>on_setattr=[attrs.setters.convert, attrs.setters.validate]</code>. This is unfortunately a breaking change, but it was an oversight, impossible to raise a <code>DeprecationWarning</code> about, and it's better to fix it now while the APIs are very fresh with few users. <code>[#835](python-attrs/attrs#835) <https://github.com/python-attrs/attrs/issues/835></code>, <code>[#886](python-attrs/attrs#886) <https://github.com/python-attrs/attrs/issues/886></code> </li> <li> <code>import attrs</code> has finally landed! As of this release, you can finally import <code>attrs</code> using its proper name. Not all names from the <code>attr</code> namespace have been transferred; most notably <code>attr.s</code> and <code>attr.ib</code> are missing. See <code>attrs.define</code> and <code>attrs.field</code> if you haven't seen our next-generation APIs yet. A more elaborate explanation can be found <code>On The Core API Names <https://www.attrs.org/en/latest/names.html></code>_ This feature is at least for one release provisional. We don't plan on changing anything, but such a big change is unlikely to go perfectly on the first strike. The API docs have been mostly updated, but it will be an ongoing effort to change everything to the new APIs. Please note that we have not moved -- or even removed -- anything from <code>attr</code>! Please do report any bugs or documentation inconsistencies! <code>[#887](python-attrs/attrs#887) <https://github.com/python-attrs/attrs/issues/887></code>_ </li> </ul> Changes ^^^^^^^ <ul> <li><code>attr.asdict(retain_collection_types=False)</code> (default) dumps collection-esque keys as tuples. <code>[#646](python-attrs/attrs#646) <https://github.com/python-attrs/attrs/issues/646></code>, <code>[#888](python-attrs/attrs#888) <https://github.com/python-attrs/attrs/issues/888></code></li> <li><code>__match_args__</code> are now generated to support Python 3.10's <code>Structural Pattern Matching <https://docs.python.org/3.10/whatsnew/3.10.html#pep-634-structural-pattern-matching></code>. This can be controlled by the <code>match_args</code> argument to the class decorators on Python 3.10 and later. On older versions, it is never added and the argument is ignored. <code>[#815](python-attrs/attrs#815) <https://github.com/python-attrs/attrs/issues/815></code></li> <li>If the class-level on_setattr is set to <code>attrs.setters.validate</code> (default in <code>`@define</code>` and <code>`@mutable</code>)` but no field defines a validator, pretend that it's not set. <code>[#817](python-attrs/attrs#817) <https://github.com/python-attrs/attrs/issues/817></code>_</li> <li>The generated <code>__repr__</code> is significantly faster on Pythons with f-strings. <code>[#819](python-attrs/attrs#819) <https://github.com/python-attrs/attrs/issues/819></code>_</li> <li>Attributes transformed via <code>field_transformer</code> are wrapped with <code>AttrsClass</code> again. <code>[#824](python-attrs/attrs#824) <https://github.com/python-attrs/attrs/issues/824></code>_</li> <li>Generated source code is now cached more efficiently for identical classes. <code>[#828](python-attrs/attrs#828) <https://github.com/python-attrs/attrs/issues/828></code>_</li> <li>Added <code>attrs.converters.to_bool()</code>. <code>[#830](python-attrs/attrs#830) <https://github.com/python-attrs/attrs/issues/830></code>_</li> </ul>  </blockquote> ... (truncated) </details> <details> <summary>Commits</summary> <ul> <li><a href="https://github.com/python-attrs/attrs/commit/dd26edd68e12879f716c6554f25d957af299b801"><code>dd26edd</code></a> Prepare 21.3.0</li> <li><a href="https://github.com/python-attrs/attrs/commit/20bf4b6e54a75201b378cff8e6dd9521d2da28f1"><code>20bf4b6</code></a> Go over CONTRIBUTING.md</li> <li><a href="https://github.com/python-attrs/attrs/commit/d528dd425980eff3f43b0e29b0ce4dc81ecd8d84"><code>d528dd4</code></a> Fix more links</li> <li><a href="https://github.com/python-attrs/attrs/commit/fcfb5a692cc8c9f8fde8e39bbd2c5733a47fb1e7"><code>fcfb5a6</code></a> Last pass over changelogs</li> <li><a href="https://github.com/python-attrs/attrs/commit/e09873485e14e9b11d5d590a55280894df367d92"><code>e098734</code></a> Add logo to PyPI description</li> <li><a href="https://github.com/python-attrs/attrs/commit/26c0cef8e48bd131d062d45bdaa0c949d4a2d035"><code>26c0cef</code></a> Streamline workflow</li> <li><a href="https://github.com/python-attrs/attrs/commit/3333e749781a107c829717f7bc0382d33b538b6e"><code>3333e74</code></a> Remove dead achor</li> <li><a href="https://github.com/python-attrs/attrs/commit/2d77d83d4e3ceadbf4414da5963623a20564c415"><code>2d77d83</code></a> Fix dataclass_transform links</li> <li><a href="https://github.com/python-attrs/attrs/commit/b4dc9b07c70c16848960da077fc7ac18fe5e9bc8"><code>b4dc9b0</code></a> Better 2.7 example</li> <li><a href="https://github.com/python-attrs/attrs/commit/d4e32209dc5855796e57c2b08bdc1c1702d051ab"><code>d4e3220</code></a> Use attrs namespace throughout examples.rst</li> <li>Additional commits viewable in <a href="https://github.com/python-attrs/attrs/compare/21.2.0...21.3.0">compare view</a></li> </ul> </details> [![Dependabot compatibility score](https://dependabot-badges.githubapp.com/badges/compatibility_score?dependency-name=attrs&package-manager=pip&previous-version=21.2.0&new-version=21.3.0)](https://docs.github.com/en/github/managing-security-vulnerabilities/about-dependabot-security-updates#about-compatibility-scores) Dependabot will resolve any conflicts with this PR as long as you don't alter it yourself. You can also trigger a rebase manually by commenting ``@dependabot` rebase`. [//]: # (dependabot-automerge-start) [//]: # (dependabot-automerge-end) --- <details> <summary>Dependabot commands and options</summary> You can trigger Dependabot actions by commenting on this PR: - ``@dependabot` rebase` will rebase this PR - ``@dependabot` recreate` will recreate this PR, overwriting any edits that have been made to it - ``@dependabot` merge` will merge this PR after your CI passes on it - ``@dependabot` squash and merge` will squash and merge this PR after your CI passes on it - ``@dependabot` cancel merge` will cancel a previously requested merge and block automerging - ``@dependabot` reopen` will reopen this PR if it is closed - ``@dependabot` close` will close this PR and stop Dependabot recreating it. You can achieve the same result by closing it manually - ``@dependabot` ignore this major version` will close this PR and stop Dependabot creating any more for this major version (unless you reopen the PR or upgrade to it yourself) - ``@dependabot` ignore this minor version` will close this PR and stop Dependabot creating any more for this minor version (unless you reopen the PR or upgrade to it yourself) - ``@dependabot` ignore this dependency` will close this PR and stop Dependabot creating any more for this dependency (unless you reopen the PR or upgrade to it yourself) </details> 467: build(deps): bump virtualenv from 20.10.0 to 20.11.0 r=ChrisRBe a=dependabot[bot] Bumps [virtualenv](https://github.com/pypa/virtualenv) from 20.10.0 to 20.11.0. <details> <summary>Changelog</summary> Sourced from <a href="https://github.com/pypa/virtualenv/blob/main/docs/changelog.rst">virtualenv's changelog</a>. <blockquote> <h2>v20.11.0 (2021-12-28)</h2> Features - 20.11.0 <pre><code>- Avoid deprecation warning from py-filelock argument - by :user:`ofek`. (`[#2237](pypa/virtualenv#2237) <https://github.com/pypa/virtualenv/issues/2237>`_) - Upgrade embedded setuptools to ``59.4.0`` from ``58.3.0`` - by :user:`gaborbernat`. (`[#2240](pypa/virtualenv#2240) <https://github.com/pypa/virtualenv/issues/2240>`_) - Drop the runtime dependency of ``backports.entry-points-selectable`` - by :user:`hroncok`. (`[#2246](pypa/virtualenv#2246) <https://github.com/pypa/virtualenv/issues/2246>`_) - Fish: PATH variables should not be quoted when being set - by :user:`hroncok`. (`[#2248](pypa/virtualenv#2248) <https://github.com/pypa/virtualenv/issues/2248>`_) </code></pre> </blockquote> </details> <details> <summary>Commits</summary> <ul> <li><a href="https://github.com/pypa/virtualenv/commit/72106af48f00936b50160ad9f7a921c91508c983"><code>72106af</code></a> release 20.11.0</li> <li><a href="https://github.com/pypa/virtualenv/commit/592420e9011ace2b019ac1d833e507724a0f19aa"><code>592420e</code></a> Add changelog</li> <li><a href="https://github.com/pypa/virtualenv/commit/878c6e09ded9b8e25a18ced1e04ba53075f2b5d2"><code>878c6e0</code></a> Fix the CI (<a href="https://github-redirect.dependabot.com/pypa/virtualenv/issues/2254">#2254</a>)</li> <li><a href="https://github.com/pypa/virtualenv/commit/ba3541c84a28cb03b42725b3e38bd08526e4768a"><code>ba3541c</code></a> Bump embeded wheels (<a href="https://github-redirect.dependabot.com/pypa/virtualenv/issues/2252">#2252</a>)</li> <li><a href="https://github.com/pypa/virtualenv/commit/abc655e428cd9a1070ee6ced2a83afcc3f972aa9"><code>abc655e</code></a> [pre-commit.ci] pre-commit autoupdate (<a href="https://github-redirect.dependabot.com/pypa/virtualenv/issues/2242">#2242</a>)</li> <li><a href="https://github.com/pypa/virtualenv/commit/bb82a73b6dbf577874f6d4bfaf72d2a7f59dfffe"><code>bb82a73</code></a> Use 'selectable' interface for entry points only when available (<a href="https://github-redirect.dependabot.com/pypa/virtualenv/issues/2246">#2246</a>)</li> <li><a href="https://github.com/pypa/virtualenv/commit/12a1fc2860761a9cd47c88a24093455d121570a3"><code>12a1fc2</code></a> Properly hide PEP-632 warning on latest version of <code>setuptools</code> (<a href="https://github-redirect.dependabot.com/pypa/virtualenv/issues/2251">#2251</a>)</li> <li><a href="https://github.com/pypa/virtualenv/commit/1431befa9373225d375d03dcd3aa2b83d51f7a62"><code>1431bef</code></a> fish: PATH variables should not be quoted when being set (<a href="https://github-redirect.dependabot.com/pypa/virtualenv/issues/2248">#2248</a>)</li> <li><a href="https://github.com/pypa/virtualenv/commit/1f1fdc9a0a5b7af0faf5e6c684d34dfcbf69b61f"><code>1f1fdc9</code></a> Avoid a new deprecation warning from filelock dependency (<a href="https://github-redirect.dependabot.com/pypa/virtualenv/issues/2237">#2237</a>)</li> <li><a href="https://github.com/pypa/virtualenv/commit/bf5691502d72fba98b2b65a65116dfe94687ea23"><code>bf56915</code></a> Update check.yml</li> <li>Additional commits viewable in <a href="https://github.com/pypa/virtualenv/compare/20.10.0...20.11.0">compare view</a></li> </ul> </details> [![Dependabot compatibility score](https://dependabot-badges.githubapp.com/badges/compatibility_score?dependency-name=virtualenv&package-manager=pip&previous-version=20.10.0&new-version=20.11.0)](https://docs.github.com/en/github/managing-security-vulnerabilities/about-dependabot-security-updates#about-compatibility-scores) Dependabot will resolve any conflicts with this PR as long as you don't alter it yourself. You can also trigger a rebase manually by commenting ``@dependabot` rebase`. [//]: # (dependabot-automerge-start) [//]: # (dependabot-automerge-end) --- <details> <summary>Dependabot commands and options</summary> You can trigger Dependabot actions by commenting on this PR: - ``@dependabot` rebase` will rebase this PR - ``@dependabot` recreate` will recreate this PR, overwriting any edits that have been made to it - ``@dependabot` merge` will merge this PR after your CI passes on it - ``@dependabot` squash and merge` will squash and merge this PR after your CI passes on it - ``@dependabot` cancel merge` will cancel a previously requested merge and block automerging - ``@dependabot` reopen` will reopen this PR if it is closed - ``@dependabot` close` will close this PR and stop Dependabot recreating it. You can achieve the same result by closing it manually - ``@dependabot` ignore this major version` will close this PR and stop Dependabot creating any more for this major version (unless you reopen the PR or upgrade to it yourself) - ``@dependabot` ignore this minor version` will close this PR and stop Dependabot creating any more for this minor version (unless you reopen the PR or upgrade to it yourself) - ``@dependabot` ignore this dependency` will close this PR and stop Dependabot creating any more for this dependency (unless you reopen the PR or upgrade to it yourself) </details> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

@define

Bumps [attrs](https://github.com/python-attrs/attrs) from 21.2.0 to 21.3.0. <details> <summary>Release notes</summary> Sourced from <a href="https://github.com/python-attrs/attrs/releases">attrs's releases</a>. <blockquote> <h2>21.3.0</h2> This is a big release in the history of <code>attrs</code> and finishes an arc that took way too long and also delayed this very overdue release. But it's done: <code>import attrs</code> that has been talked about for years[^issue], but fell victim to “just this one more thing” has finally landed. From now on, modern <code>attrs</code> code looks like this: <pre lang="python"><code>from attrs import define <a href="https://github.com/define"><code>@define</code></a> class HelloWorld: modern: bool = True </code></pre> The <code>define</code>/<code>field</code> APIs have been around for over a year and were very popular, now the rest of the package followed suit. I'm very excited that <code>attrs</code> remains relevant and keeps evolving over now more than half a decade. If you're curious about some of the background, the docs now contain a short <a href="https://www.attrs.org/en/stable/names.html">explanation and history lesson</a>. As long as our users keep pushing us, we will keep pushing forward class generation in Python! Big thanks to my <a href="https://github.com/sponsors/hynek/dashboard">GitHub Sponsors</a>, <a href="https://tidelift.com/subscription/pkg/pypi-attrs?utm_source=pypi-attrs&utm_medium=referral&utm_campaign=enterprise&utm_term=repo">Tidelift subscribers</a>, and <a href="https://ko-fi.com/the_hynekl">Ko-fi buyers</a> that help me mustering the motivation for such long-running project! <hr /> Since the release took so long, there's more highlights than we can enumerate here, we'd just like to point out a breaking change in the new APIs: converters now run on setting attributes by default. If this is causing problems to you, you can disable that behavior by setting <code>@define(on_setattr=[])</code>. [^issue]: I have an issue from 2018 that I wanted to "come back the moment this lands". <h1>Full Changelog</h1> <h2>Backward-incompatible Changes</h2> <ul> <li> When using <code>@define</code>, converters are now run by default when setting an attribute on an instance -- additionally to validators. I.e. the new default is <code>on_setattr=[attrs.setters.convert, attrs.setters.validate]</code>. This is unfortunately a breaking change, but it was an oversight, impossible to raise a <code>DeprecationWarning</code> about, and it's better to fix it now while the APIs are very fresh with few users. <a href="https://github-redirect.dependabot.com/python-attrs/attrs/issues/835">#835</a>, <a href="https://github-redirect.dependabot.com/python-attrs/attrs/issues/886">#886</a> </li> <li> <code>import attrs</code> has finally landed! As of this release, you can finally import <code>attrs</code> using its proper name. Not all names from the <code>attr</code> namespace have been transferred; most notably <code>attr.s</code> and <code>attr.ib</code> are missing. See <code>attrs.define</code> and <code>attrs.field</code> if you haven't seen our next-generation APIs yet. A more elaborate explanation can be found <a href="https://www.attrs.org/en/latest/names.html">On The Core API Names</a> This feature is at least for one release provisional. We don't plan on changing anything, but such a big change is unlikely to go perfectly on the first strike. The API docs have been mostly updated, but it will be an ongoing effort to change everything to the new APIs. Please note that we have not moved -- or even removed -- anything from <code>attr</code>! Please do report any bugs or documentation inconsistencies! <a href="https://github-redirect.dependabot.com/python-attrs/attrs/issues/887">#887</a> </li> </ul> <h2>Changes</h2> <ul> <li><code>attr.asdict(retain_collection_types=False)</code> (default) dumps collection-esque keys as tuples. <a href="https://github-redirect.dependabot.com/python-attrs/attrs/issues/646">#646</a>, <a href="https://github-redirect.dependabot.com/python-attrs/attrs/issues/888">#888</a></li> <li><code>__match_args__</code> are now generated to support Python 3.10's <a href="https://docs.python.org/3.10/whatsnew/3.10.html#pep-634-structural-pattern-matching">Structural Pattern Matching</a>. This can be controlled by the <code>match_args</code> argument to the class decorators on Python 3.10 and later. On older versions, it is never added and the argument is ignored. <a href="https://github-redirect.dependabot.com/python-attrs/attrs/issues/815">#815</a></li> <li>If the class-level on_setattr is set to <code>attrs.setters.validate</code> (default in <code>@define</code> and <code>@mutable</code>) but no field defines a validator, pretend that it's not set. <a href="https://github-redirect.dependabot.com/python-attrs/attrs/issues/817">#817</a></li> <li>The generated <code>__repr__</code> is significantly faster on Pythons with f-strings. <a href="https://github-redirect.dependabot.com/python-attrs/attrs/issues/819">#819</a></li> <li>Attributes transformed via <code>field_transformer</code> are wrapped with <code>AttrsClass</code> again. <a href="https://github-redirect.dependabot.com/python-attrs/attrs/issues/824">#824</a></li> <li>Generated source code is now cached more efficiently for identical classes. <a href="https://github-redirect.dependabot.com/python-attrs/attrs/issues/828">#828</a></li> <li>Added <code>attrs.converters.to_bool()</code>. <a href="https://github-redirect.dependabot.com/python-attrs/attrs/issues/830">#830</a></li> </ul>  </blockquote> ... (truncated) </details> <details> <summary>Changelog</summary> Sourced from <a href="https://github.com/python-attrs/attrs/blob/main/CHANGELOG.rst">attrs's changelog</a>. <blockquote> <h2>21.3.0 (2021-12-28)</h2> Backward-incompatible Changes ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ <ul> <li> When using <code>@define</code>, converters are now run by default when setting an attribute on an instance -- additionally to validators. I.e. the new default is <code>on_setattr=[attrs.setters.convert, attrs.setters.validate]</code>. This is unfortunately a breaking change, but it was an oversight, impossible to raise a <code>DeprecationWarning</code> about, and it's better to fix it now while the APIs are very fresh with few users. <code>[#835](python-attrs/attrs#835) <https://github.com/python-attrs/attrs/issues/835></code>, <code>[#886](python-attrs/attrs#886) <https://github.com/python-attrs/attrs/issues/886></code> </li> <li> <code>import attrs</code> has finally landed! As of this release, you can finally import <code>attrs</code> using its proper name. Not all names from the <code>attr</code> namespace have been transferred; most notably <code>attr.s</code> and <code>attr.ib</code> are missing. See <code>attrs.define</code> and <code>attrs.field</code> if you haven't seen our next-generation APIs yet. A more elaborate explanation can be found <code>On The Core API Names <https://www.attrs.org/en/latest/names.html></code>_ This feature is at least for one release provisional. We don't plan on changing anything, but such a big change is unlikely to go perfectly on the first strike. The API docs have been mostly updated, but it will be an ongoing effort to change everything to the new APIs. Please note that we have not moved -- or even removed -- anything from <code>attr</code>! Please do report any bugs or documentation inconsistencies! <code>[#887](python-attrs/attrs#887) <https://github.com/python-attrs/attrs/issues/887></code>_ </li> </ul> Changes ^^^^^^^ <ul> <li><code>attr.asdict(retain_collection_types=False)</code> (default) dumps collection-esque keys as tuples. <code>[#646](python-attrs/attrs#646) <https://github.com/python-attrs/attrs/issues/646></code>, <code>[#888](python-attrs/attrs#888) <https://github.com/python-attrs/attrs/issues/888></code></li> <li><code>__match_args__</code> are now generated to support Python 3.10's <code>Structural Pattern Matching <https://docs.python.org/3.10/whatsnew/3.10.html#pep-634-structural-pattern-matching></code>. This can be controlled by the <code>match_args</code> argument to the class decorators on Python 3.10 and later. On older versions, it is never added and the argument is ignored. <code>[#815](python-attrs/attrs#815) <https://github.com/python-attrs/attrs/issues/815></code></li> <li>If the class-level on_setattr is set to <code>attrs.setters.validate</code> (default in <code>@define</code> and <code>@mutable</code>) but no field defines a validator, pretend that it's not set. <code>[#817](python-attrs/attrs#817) <https://github.com/python-attrs/attrs/issues/817></code>_</li> <li>The generated <code>__repr__</code> is significantly faster on Pythons with f-strings. <code>[#819](python-attrs/attrs#819) <https://github.com/python-attrs/attrs/issues/819></code>_</li> <li>Attributes transformed via <code>field_transformer</code> are wrapped with <code>AttrsClass</code> again. <code>[#824](python-attrs/attrs#824) <https://github.com/python-attrs/attrs/issues/824></code>_</li> <li>Generated source code is now cached more efficiently for identical classes. <code>[#828](python-attrs/attrs#828) <https://github.com/python-attrs/attrs/issues/828></code>_</li> <li>Added <code>attrs.converters.to_bool()</code>. <code>[#830](python-attrs/attrs#830) <https://github.com/python-attrs/attrs/issues/830></code>_</li> </ul>  </blockquote> ... (truncated) </details> <details> <summary>Commits</summary> <ul> <li><a href="https://github.com/python-attrs/attrs/commit/dd26edd68e12879f716c6554f25d957af299b801"><code>dd26edd</code></a> Prepare 21.3.0</li> <li><a href="https://github.com/python-attrs/attrs/commit/20bf4b6e54a75201b378cff8e6dd9521d2da28f1"><code>20bf4b6</code></a> Go over CONTRIBUTING.md</li> <li><a href="https://github.com/python-attrs/attrs/commit/d528dd425980eff3f43b0e29b0ce4dc81ecd8d84"><code>d528dd4</code></a> Fix more links</li> <li><a href="https://github.com/python-attrs/attrs/commit/fcfb5a692cc8c9f8fde8e39bbd2c5733a47fb1e7"><code>fcfb5a6</code></a> Last pass over changelogs</li> <li><a href="https://github.com/python-attrs/attrs/commit/e09873485e14e9b11d5d590a55280894df367d92"><code>e098734</code></a> Add logo to PyPI description</li> <li><a href="https://github.com/python-attrs/attrs/commit/26c0cef8e48bd131d062d45bdaa0c949d4a2d035"><code>26c0cef</code></a> Streamline workflow</li> <li><a href="https://github.com/python-attrs/attrs/commit/3333e749781a107c829717f7bc0382d33b538b6e"><code>3333e74</code></a> Remove dead achor</li> <li><a href="https://github.com/python-attrs/attrs/commit/2d77d83d4e3ceadbf4414da5963623a20564c415"><code>2d77d83</code></a> Fix dataclass_transform links</li> <li><a href="https://github.com/python-attrs/attrs/commit/b4dc9b07c70c16848960da077fc7ac18fe5e9bc8"><code>b4dc9b0</code></a> Better 2.7 example</li> <li><a href="https://github.com/python-attrs/attrs/commit/d4e32209dc5855796e57c2b08bdc1c1702d051ab"><code>d4e3220</code></a> Use attrs namespace throughout examples.rst</li> <li>Additional commits viewable in <a href="https://github.com/python-attrs/attrs/compare/21.2.0...21.3.0">compare view</a></li> </ul> </details> [![Dependabot compatibility score](https://dependabot-badges.githubapp.com/badges/compatibility_score?dependency-name=attrs&package-manager=pip&previous-version=21.2.0&new-version=21.3.0)](https://docs.github.com/en/github/managing-security-vulnerabilities/about-dependabot-security-updates#about-compatibility-scores) Dependabot will resolve any conflicts with this PR as long as you don't alter it yourself. You can also trigger a rebase manually by commenting `@dependabot rebase`. [//]: # (dependabot-automerge-start) [//]: # (dependabot-automerge-end) --- <details> <summary>Dependabot commands and options</summary> You can trigger Dependabot actions by commenting on this PR: - `@dependabot rebase` will rebase this PR - `@dependabot recreate` will recreate this PR, overwriting any edits that have been made to it - `@dependabot merge` will merge this PR after your CI passes on it - `@dependabot squash and merge` will squash and merge this PR after your CI passes on it - `@dependabot cancel merge` will cancel a previously requested merge and block automerging - `@dependabot reopen` will reopen this PR if it is closed - `@dependabot close` will close this PR and stop Dependabot recreating it. You can achieve the same result by closing it manually - `@dependabot ignore this major version` will close this PR and stop Dependabot creating any more for this major version (unless you reopen the PR or upgrade to it yourself) - `@dependabot ignore this minor version` will close this PR and stop Dependabot creating any more for this minor version (unless you reopen the PR or upgrade to it yourself) - `@dependabot ignore this dependency` will close this PR and stop Dependabot creating any more for this dependency (unless you reopen the PR or upgrade to it yourself) </details>

3746: Bump types-docutils from 0.17.1 to 0.17.2 r=jenshnielsen a=dependabot[bot] Bumps [types-docutils](https://github.com/python/typeshed) from 0.17.1 to 0.17.2. <details> <summary>Commits</summary> <ul> <li>See full diff in <a href="https://github.com/python/typeshed/commits">compare view</a></li> </ul> </details> [![Dependabot compatibility score](https://dependabot-badges.githubapp.com/badges/compatibility_score?dependency-name=types-docutils&package-manager=pip&previous-version=0.17.1&new-version=0.17.2)](https://docs.github.com/en/github/managing-security-vulnerabilities/about-dependabot-security-updates#about-compatibility-scores) You can trigger a rebase of this PR by commenting ``@dependabot` rebase`. [//]: # (dependabot-automerge-start) [//]: # (dependabot-automerge-end) --- <details> <summary>Dependabot commands and options</summary> You can trigger Dependabot actions by commenting on this PR: - ``@dependabot` rebase` will rebase this PR - ``@dependabot` recreate` will recreate this PR, overwriting any edits that have been made to it - ``@dependabot` merge` will merge this PR after your CI passes on it - ``@dependabot` squash and merge` will squash and merge this PR after your CI passes on it - ``@dependabot` cancel merge` will cancel a previously requested merge and block automerging - ``@dependabot` reopen` will reopen this PR if it is closed - ``@dependabot` close` will close this PR and stop Dependabot recreating it. You can achieve the same result by closing it manually - ``@dependabot` ignore this major version` will close this PR and stop Dependabot creating any more for this major version (unless you reopen the PR or upgrade to it yourself) - ``@dependabot` ignore this minor version` will close this PR and stop Dependabot creating any more for this minor version (unless you reopen the PR or upgrade to it yourself) - ``@dependabot` ignore this dependency` will close this PR and stop Dependabot creating any more for this dependency (unless you reopen the PR or upgrade to it yourself) </details> 3747: Bump attrs from 21.2.0 to 21.3.0 r=jenshnielsen a=dependabot[bot] Bumps [attrs](https://github.com/python-attrs/attrs) from 21.2.0 to 21.3.0. <details> <summary>Release notes</summary> Sourced from <a href="https://github.com/python-attrs/attrs/releases">attrs's releases</a>. <blockquote> <h2>21.3.0</h2> This is a big release in the history of <code>attrs</code> and finishes an arc that took way too long and also delayed this very overdue release. But it's done: <code>import attrs</code> that has been talked about for years[^issue], but fell victim to “just this one more thing” has finally landed. From now on, modern <code>attrs</code> code looks like this: <pre lang="python"><code>from attrs import define <a href="https://github.com/define"><code>`@define</code></a>` class HelloWorld: modern: bool = True </code></pre> The <code>define</code>/<code>field</code> APIs have been around for over a year and were very popular, now the rest of the package followed suit. I'm very excited that <code>attrs</code> remains relevant and keeps evolving over now more than half a decade. If you're curious about some of the background, the docs now contain a short <a href="https://www.attrs.org/en/stable/names.html">explanation and history lesson</a>. As long as our users keep pushing us, we will keep pushing forward class generation in Python! Big thanks to my <a href="https://github.com/sponsors/hynek/dashboard">GitHub Sponsors</a>, <a href="https://tidelift.com/subscription/pkg/pypi-attrs?utm_source=pypi-attrs&utm_medium=referral&utm_campaign=enterprise&utm_term=repo">Tidelift subscribers</a>, and <a href="https://ko-fi.com/the_hynekl">Ko-fi buyers</a> that help me mustering the motivation for such long-running project! <hr /> Since the release took so long, there's more highlights than we can enumerate here, we'd just like to point out a breaking change in the new APIs: converters now run on setting attributes by default. If this is causing problems to you, you can disable that behavior by setting <code>`@define(on_setattr=[])</code>.` [^issue]: I have an issue from 2018 that I wanted to "come back the moment this lands". <h1>Full Changelog</h1> <h2>Backward-incompatible Changes</h2> <ul> <li> When using <code>`@define</code>,` converters are now run by default when setting an attribute on an instance -- additionally to validators. I.e. the new default is <code>on_setattr=[attrs.setters.convert, attrs.setters.validate]</code>. This is unfortunately a breaking change, but it was an oversight, impossible to raise a <code>DeprecationWarning</code> about, and it's better to fix it now while the APIs are very fresh with few users. <a href="https://github-redirect.dependabot.com/python-attrs/attrs/issues/835">#835</a>, <a href="https://github-redirect.dependabot.com/python-attrs/attrs/issues/886">#886</a> </li> <li> <code>import attrs</code> has finally landed! As of this release, you can finally import <code>attrs</code> using its proper name. Not all names from the <code>attr</code> namespace have been transferred; most notably <code>attr.s</code> and <code>attr.ib</code> are missing. See <code>attrs.define</code> and <code>attrs.field</code> if you haven't seen our next-generation APIs yet. A more elaborate explanation can be found <a href="https://www.attrs.org/en/latest/names.html">On The Core API Names</a> This feature is at least for one release provisional. We don't plan on changing anything, but such a big change is unlikely to go perfectly on the first strike. The API docs have been mostly updated, but it will be an ongoing effort to change everything to the new APIs. Please note that we have not moved -- or even removed -- anything from <code>attr</code>! Please do report any bugs or documentation inconsistencies! <a href="https://github-redirect.dependabot.com/python-attrs/attrs/issues/887">#887</a> </li> </ul> <h2>Changes</h2> <ul> <li><code>attr.asdict(retain_collection_types=False)</code> (default) dumps collection-esque keys as tuples. <a href="https://github-redirect.dependabot.com/python-attrs/attrs/issues/646">#646</a>, <a href="https://github-redirect.dependabot.com/python-attrs/attrs/issues/888">#888</a></li> <li><code>__match_args__</code> are now generated to support Python 3.10's <a href="https://docs.python.org/3.10/whatsnew/3.10.html#pep-634-structural-pattern-matching">Structural Pattern Matching</a>. This can be controlled by the <code>match_args</code> argument to the class decorators on Python 3.10 and later. On older versions, it is never added and the argument is ignored. <a href="https://github-redirect.dependabot.com/python-attrs/attrs/issues/815">#815</a></li> <li>If the class-level on_setattr is set to <code>attrs.setters.validate</code> (default in <code>`@define</code>` and <code>`@mutable</code>)` but no field defines a validator, pretend that it's not set. <a href="https://github-redirect.dependabot.com/python-attrs/attrs/issues/817">#817</a></li> <li>The generated <code>__repr__</code> is significantly faster on Pythons with f-strings. <a href="https://github-redirect.dependabot.com/python-attrs/attrs/issues/819">#819</a></li> <li>Attributes transformed via <code>field_transformer</code> are wrapped with <code>AttrsClass</code> again. <a href="https://github-redirect.dependabot.com/python-attrs/attrs/issues/824">#824</a></li> <li>Generated source code is now cached more efficiently for identical classes. <a href="https://github-redirect.dependabot.com/python-attrs/attrs/issues/828">#828</a></li> <li>Added <code>attrs.converters.to_bool()</code>. <a href="https://github-redirect.dependabot.com/python-attrs/attrs/issues/830">#830</a></li> </ul>  </blockquote> ... (truncated) </details> <details> <summary>Changelog</summary> Sourced from <a href="https://github.com/python-attrs/attrs/blob/main/CHANGELOG.rst">attrs's changelog</a>. <blockquote> <h2>21.3.0 (2021-12-28)</h2> Backward-incompatible Changes ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ <ul> <li> When using <code>`@define</code>,` converters are now run by default when setting an attribute on an instance -- additionally to validators. I.e. the new default is <code>on_setattr=[attrs.setters.convert, attrs.setters.validate]</code>. This is unfortunately a breaking change, but it was an oversight, impossible to raise a <code>DeprecationWarning</code> about, and it's better to fix it now while the APIs are very fresh with few users. <code>[#835](python-attrs/attrs#835) <https://github.com/python-attrs/attrs/issues/835></code>, <code>[#886](python-attrs/attrs#886) <https://github.com/python-attrs/attrs/issues/886></code> </li> <li> <code>import attrs</code> has finally landed! As of this release, you can finally import <code>attrs</code> using its proper name. Not all names from the <code>attr</code> namespace have been transferred; most notably <code>attr.s</code> and <code>attr.ib</code> are missing. See <code>attrs.define</code> and <code>attrs.field</code> if you haven't seen our next-generation APIs yet. A more elaborate explanation can be found <code>On The Core API Names <https://www.attrs.org/en/latest/names.html></code>_ This feature is at least for one release provisional. We don't plan on changing anything, but such a big change is unlikely to go perfectly on the first strike. The API docs have been mostly updated, but it will be an ongoing effort to change everything to the new APIs. Please note that we have not moved -- or even removed -- anything from <code>attr</code>! Please do report any bugs or documentation inconsistencies! <code>[#887](python-attrs/attrs#887) <https://github.com/python-attrs/attrs/issues/887></code>_ </li> </ul> Changes ^^^^^^^ <ul> <li><code>attr.asdict(retain_collection_types=False)</code> (default) dumps collection-esque keys as tuples. <code>[#646](python-attrs/attrs#646) <https://github.com/python-attrs/attrs/issues/646></code>, <code>[#888](python-attrs/attrs#888) <https://github.com/python-attrs/attrs/issues/888></code></li> <li><code>__match_args__</code> are now generated to support Python 3.10's <code>Structural Pattern Matching <https://docs.python.org/3.10/whatsnew/3.10.html#pep-634-structural-pattern-matching></code>. This can be controlled by the <code>match_args</code> argument to the class decorators on Python 3.10 and later. On older versions, it is never added and the argument is ignored. <code>[#815](python-attrs/attrs#815) <https://github.com/python-attrs/attrs/issues/815></code></li> <li>If the class-level on_setattr is set to <code>attrs.setters.validate</code> (default in <code>`@define</code>` and <code>`@mutable</code>)` but no field defines a validator, pretend that it's not set. <code>[#817](python-attrs/attrs#817) <https://github.com/python-attrs/attrs/issues/817></code>_</li> <li>The generated <code>__repr__</code> is significantly faster on Pythons with f-strings. <code>[#819](python-attrs/attrs#819) <https://github.com/python-attrs/attrs/issues/819></code>_</li> <li>Attributes transformed via <code>field_transformer</code> are wrapped with <code>AttrsClass</code> again. <code>[#824](python-attrs/attrs#824) <https://github.com/python-attrs/attrs/issues/824></code>_</li> <li>Generated source code is now cached more efficiently for identical classes. <code>[#828](python-attrs/attrs#828) <https://github.com/python-attrs/attrs/issues/828></code>_</li> <li>Added <code>attrs.converters.to_bool()</code>. <code>[#830](python-attrs/attrs#830) <https://github.com/python-attrs/attrs/issues/830></code>_</li> </ul>  </blockquote> ... (truncated) </details> <details> <summary>Commits</summary> <ul> <li><a href="https://github.com/python-attrs/attrs/commit/dd26edd68e12879f716c6554f25d957af299b801"><code>dd26edd</code></a> Prepare 21.3.0</li> <li><a href="https://github.com/python-attrs/attrs/commit/20bf4b6e54a75201b378cff8e6dd9521d2da28f1"><code>20bf4b6</code></a> Go over CONTRIBUTING.md</li> <li><a href="https://github.com/python-attrs/attrs/commit/d528dd425980eff3f43b0e29b0ce4dc81ecd8d84"><code>d528dd4</code></a> Fix more links</li> <li><a href="https://github.com/python-attrs/attrs/commit/fcfb5a692cc8c9f8fde8e39bbd2c5733a47fb1e7"><code>fcfb5a6</code></a> Last pass over changelogs</li> <li><a href="https://github.com/python-attrs/attrs/commit/e09873485e14e9b11d5d590a55280894df367d92"><code>e098734</code></a> Add logo to PyPI description</li> <li><a href="https://github.com/python-attrs/attrs/commit/26c0cef8e48bd131d062d45bdaa0c949d4a2d035"><code>26c0cef</code></a> Streamline workflow</li> <li><a href="https://github.com/python-attrs/attrs/commit/3333e749781a107c829717f7bc0382d33b538b6e"><code>3333e74</code></a> Remove dead achor</li> <li><a href="https://github.com/python-attrs/attrs/commit/2d77d83d4e3ceadbf4414da5963623a20564c415"><code>2d77d83</code></a> Fix dataclass_transform links</li> <li><a href="https://github.com/python-attrs/attrs/commit/b4dc9b07c70c16848960da077fc7ac18fe5e9bc8"><code>b4dc9b0</code></a> Better 2.7 example</li> <li><a href="https://github.com/python-attrs/attrs/commit/d4e32209dc5855796e57c2b08bdc1c1702d051ab"><code>d4e3220</code></a> Use attrs namespace throughout examples.rst</li> <li>Additional commits viewable in <a href="https://github.com/python-attrs/attrs/compare/21.2.0...21.3.0">compare view</a></li> </ul> </details> [![Dependabot compatibility score](https://dependabot-badges.githubapp.com/badges/compatibility_score?dependency-name=attrs&package-manager=pip&previous-version=21.2.0&new-version=21.3.0)](https://docs.github.com/en/github/managing-security-vulnerabilities/about-dependabot-security-updates#about-compatibility-scores) You can trigger a rebase of this PR by commenting ``@dependabot` rebase`. [//]: # (dependabot-automerge-start) [//]: # (dependabot-automerge-end) --- <details> <summary>Dependabot commands and options</summary> You can trigger Dependabot actions by commenting on this PR: - ``@dependabot` rebase` will rebase this PR - ``@dependabot` recreate` will recreate this PR, overwriting any edits that have been made to it - ``@dependabot` merge` will merge this PR after your CI passes on it - ``@dependabot` squash and merge` will squash and merge this PR after your CI passes on it - ``@dependabot` cancel merge` will cancel a previously requested merge and block automerging - ``@dependabot` reopen` will reopen this PR if it is closed - ``@dependabot` close` will close this PR and stop Dependabot recreating it. You can achieve the same result by closing it manually - ``@dependabot` ignore this major version` will close this PR and stop Dependabot creating any more for this major version (unless you reopen the PR or upgrade to it yourself) - ``@dependabot` ignore this minor version` will close this PR and stop Dependabot creating any more for this minor version (unless you reopen the PR or upgrade to it yourself) - ``@dependabot` ignore this dependency` will close this PR and stop Dependabot creating any more for this dependency (unless you reopen the PR or upgrade to it yourself) </details> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

465: build(deps): bump attrs from 21.2.0 to 21.3.0 r=ChrisRBe a=dependabot[bot] Bumps [attrs](https://github.com/python-attrs/attrs) from 21.2.0 to 21.3.0. <details> <summary>Release notes</summary> Sourced from <a href="https://github.com/python-attrs/attrs/releases">attrs's releases</a>. <blockquote> <h2>21.3.0</h2> This is a big release in the history of <code>attrs</code> and finishes an arc that took way too long and also delayed this very overdue release. But it's done: <code>import attrs</code> that has been talked about for years[^issue], but fell victim to “just this one more thing” has finally landed. From now on, modern <code>attrs</code> code looks like this: <pre lang="python"><code>from attrs import define <a href="https://github.com/define"><code>`@define</code></a>` class HelloWorld: modern: bool = True </code></pre> The <code>define</code>/<code>field</code> APIs have been around for over a year and were very popular, now the rest of the package followed suit. I'm very excited that <code>attrs</code> remains relevant and keeps evolving over now more than half a decade. If you're curious about some of the background, the docs now contain a short <a href="https://www.attrs.org/en/stable/names.html">explanation and history lesson</a>. As long as our users keep pushing us, we will keep pushing forward class generation in Python! Big thanks to my <a href="https://github.com/sponsors/hynek/dashboard">GitHub Sponsors</a>, <a href="https://tidelift.com/subscription/pkg/pypi-attrs?utm_source=pypi-attrs&utm_medium=referral&utm_campaign=enterprise&utm_term=repo">Tidelift subscribers</a>, and <a href="https://ko-fi.com/the_hynekl">Ko-fi buyers</a> that help me mustering the motivation for such long-running project! <hr /> Since the release took so long, there's more highlights than we can enumerate here, we'd just like to point out a breaking change in the new APIs: converters now run on setting attributes by default. If this is causing problems to you, you can disable that behavior by setting <code>`@define(on_setattr=[])</code>.` [^issue]: I have an issue from 2018 that I wanted to "come back the moment this lands". <h1>Full Changelog</h1> <h2>Backward-incompatible Changes</h2> <ul> <li> When using <code>`@define</code>,` converters are now run by default when setting an attribute on an instance -- additionally to validators. I.e. the new default is <code>on_setattr=[attrs.setters.convert, attrs.setters.validate]</code>. This is unfortunately a breaking change, but it was an oversight, impossible to raise a <code>DeprecationWarning</code> about, and it's better to fix it now while the APIs are very fresh with few users. <a href="https://github-redirect.dependabot.com/python-attrs/attrs/issues/835">#835</a>, <a href="https://github-redirect.dependabot.com/python-attrs/attrs/issues/886">#886</a> </li> <li> <code>import attrs</code> has finally landed! As of this release, you can finally import <code>attrs</code> using its proper name. Not all names from the <code>attr</code> namespace have been transferred; most notably <code>attr.s</code> and <code>attr.ib</code> are missing. See <code>attrs.define</code> and <code>attrs.field</code> if you haven't seen our next-generation APIs yet. A more elaborate explanation can be found <a href="https://www.attrs.org/en/latest/names.html">On The Core API Names</a> This feature is at least for one release provisional. We don't plan on changing anything, but such a big change is unlikely to go perfectly on the first strike. The API docs have been mostly updated, but it will be an ongoing effort to change everything to the new APIs. Please note that we have not moved -- or even removed -- anything from <code>attr</code>! Please do report any bugs or documentation inconsistencies! <a href="https://github-redirect.dependabot.com/python-attrs/attrs/issues/887">#887</a> </li> </ul> <h2>Changes</h2> <ul> <li><code>attr.asdict(retain_collection_types=False)</code> (default) dumps collection-esque keys as tuples. <a href="https://github-redirect.dependabot.com/python-attrs/attrs/issues/646">#646</a>, <a href="https://github-redirect.dependabot.com/python-attrs/attrs/issues/888">#888</a></li> <li><code>__match_args__</code> are now generated to support Python 3.10's <a href="https://docs.python.org/3.10/whatsnew/3.10.html#pep-634-structural-pattern-matching">Structural Pattern Matching</a>. This can be controlled by the <code>match_args</code> argument to the class decorators on Python 3.10 and later. On older versions, it is never added and the argument is ignored. <a href="https://github-redirect.dependabot.com/python-attrs/attrs/issues/815">#815</a></li> <li>If the class-level on_setattr is set to <code>attrs.setters.validate</code> (default in <code>`@define</code>` and <code>`@mutable</code>)` but no field defines a validator, pretend that it's not set. <a href="https://github-redirect.dependabot.com/python-attrs/attrs/issues/817">#817</a></li> <li>The generated <code>__repr__</code> is significantly faster on Pythons with f-strings. <a href="https://github-redirect.dependabot.com/python-attrs/attrs/issues/819">#819</a></li> <li>Attributes transformed via <code>field_transformer</code> are wrapped with <code>AttrsClass</code> again. <a href="https://github-redirect.dependabot.com/python-attrs/attrs/issues/824">#824</a></li> <li>Generated source code is now cached more efficiently for identical classes. <a href="https://github-redirect.dependabot.com/python-attrs/attrs/issues/828">#828</a></li> <li>Added <code>attrs.converters.to_bool()</code>. <a href="https://github-redirect.dependabot.com/python-attrs/attrs/issues/830">#830</a></li> </ul>  </blockquote> ... (truncated) </details> <details> <summary>Changelog</summary> Sourced from <a href="https://github.com/python-attrs/attrs/blob/main/CHANGELOG.rst">attrs's changelog</a>. <blockquote> <h2>21.3.0 (2021-12-28)</h2> Backward-incompatible Changes ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ <ul> <li> When using <code>`@define</code>,` converters are now run by default when setting an attribute on an instance -- additionally to validators. I.e. the new default is <code>on_setattr=[attrs.setters.convert, attrs.setters.validate]</code>. This is unfortunately a breaking change, but it was an oversight, impossible to raise a <code>DeprecationWarning</code> about, and it's better to fix it now while the APIs are very fresh with few users. <code>[#835](python-attrs/attrs#835) <https://github.com/python-attrs/attrs/issues/835></code>, <code>[#886](python-attrs/attrs#886) <https://github.com/python-attrs/attrs/issues/886></code> </li> <li> <code>import attrs</code> has finally landed! As of this release, you can finally import <code>attrs</code> using its proper name. Not all names from the <code>attr</code> namespace have been transferred; most notably <code>attr.s</code> and <code>attr.ib</code> are missing. See <code>attrs.define</code> and <code>attrs.field</code> if you haven't seen our next-generation APIs yet. A more elaborate explanation can be found <code>On The Core API Names <https://www.attrs.org/en/latest/names.html></code>_ This feature is at least for one release provisional. We don't plan on changing anything, but such a big change is unlikely to go perfectly on the first strike. The API docs have been mostly updated, but it will be an ongoing effort to change everything to the new APIs. Please note that we have not moved -- or even removed -- anything from <code>attr</code>! Please do report any bugs or documentation inconsistencies! <code>[#887](python-attrs/attrs#887) <https://github.com/python-attrs/attrs/issues/887></code>_ </li> </ul> Changes ^^^^^^^ <ul> <li><code>attr.asdict(retain_collection_types=False)</code> (default) dumps collection-esque keys as tuples. <code>[#646](python-attrs/attrs#646) <https://github.com/python-attrs/attrs/issues/646></code>, <code>[#888](python-attrs/attrs#888) <https://github.com/python-attrs/attrs/issues/888></code></li> <li><code>__match_args__</code> are now generated to support Python 3.10's <code>Structural Pattern Matching <https://docs.python.org/3.10/whatsnew/3.10.html#pep-634-structural-pattern-matching></code>. This can be controlled by the <code>match_args</code> argument to the class decorators on Python 3.10 and later. On older versions, it is never added and the argument is ignored. <code>[#815](python-attrs/attrs#815) <https://github.com/python-attrs/attrs/issues/815></code></li> <li>If the class-level on_setattr is set to <code>attrs.setters.validate</code> (default in <code>`@define</code>` and <code>`@mutable</code>)` but no field defines a validator, pretend that it's not set. <code>[#817](python-attrs/attrs#817) <https://github.com/python-attrs/attrs/issues/817></code>_</li> <li>The generated <code>__repr__</code> is significantly faster on Pythons with f-strings. <code>[#819](python-attrs/attrs#819) <https://github.com/python-attrs/attrs/issues/819></code>_</li> <li>Attributes transformed via <code>field_transformer</code> are wrapped with <code>AttrsClass</code> again. <code>[#824](python-attrs/attrs#824) <https://github.com/python-attrs/attrs/issues/824></code>_</li> <li>Generated source code is now cached more efficiently for identical classes. <code>[#828](python-attrs/attrs#828) <https://github.com/python-attrs/attrs/issues/828></code>_</li> <li>Added <code>attrs.converters.to_bool()</code>. <code>[#830](python-attrs/attrs#830) <https://github.com/python-attrs/attrs/issues/830></code>_</li> </ul>  </blockquote> ... (truncated) </details> <details> <summary>Commits</summary> <ul> <li><a href="https://github.com/python-attrs/attrs/commit/dd26edd68e12879f716c6554f25d957af299b801"><code>dd26edd</code></a> Prepare 21.3.0</li> <li><a href="https://github.com/python-attrs/attrs/commit/20bf4b6e54a75201b378cff8e6dd9521d2da28f1"><code>20bf4b6</code></a> Go over CONTRIBUTING.md</li> <li><a href="https://github.com/python-attrs/attrs/commit/d528dd425980eff3f43b0e29b0ce4dc81ecd8d84"><code>d528dd4</code></a> Fix more links</li> <li><a href="https://github.com/python-attrs/attrs/commit/fcfb5a692cc8c9f8fde8e39bbd2c5733a47fb1e7"><code>fcfb5a6</code></a> Last pass over changelogs</li> <li><a href="https://github.com/python-attrs/attrs/commit/e09873485e14e9b11d5d590a55280894df367d92"><code>e098734</code></a> Add logo to PyPI description</li> <li><a href="https://github.com/python-attrs/attrs/commit/26c0cef8e48bd131d062d45bdaa0c949d4a2d035"><code>26c0cef</code></a> Streamline workflow</li> <li><a href="https://github.com/python-attrs/attrs/commit/3333e749781a107c829717f7bc0382d33b538b6e"><code>3333e74</code></a> Remove dead achor</li> <li><a href="https://github.com/python-attrs/attrs/commit/2d77d83d4e3ceadbf4414da5963623a20564c415"><code>2d77d83</code></a> Fix dataclass_transform links</li> <li><a href="https://github.com/python-attrs/attrs/commit/b4dc9b07c70c16848960da077fc7ac18fe5e9bc8"><code>b4dc9b0</code></a> Better 2.7 example</li> <li><a href="https://github.com/python-attrs/attrs/commit/d4e32209dc5855796e57c2b08bdc1c1702d051ab"><code>d4e3220</code></a> Use attrs namespace throughout examples.rst</li> <li>Additional commits viewable in <a href="https://github.com/python-attrs/attrs/compare/21.2.0...21.3.0">compare view</a></li> </ul> </details> [![Dependabot compatibility score](https://dependabot-badges.githubapp.com/badges/compatibility_score?dependency-name=attrs&package-manager=pip&previous-version=21.2.0&new-version=21.3.0)](https://docs.github.com/en/github/managing-security-vulnerabilities/about-dependabot-security-updates#about-compatibility-scores) Dependabot will resolve any conflicts with this PR as long as you don't alter it yourself. You can also trigger a rebase manually by commenting ``@dependabot` rebase`. [//]: # (dependabot-automerge-start) [//]: # (dependabot-automerge-end) --- <details> <summary>Dependabot commands and options</summary> You can trigger Dependabot actions by commenting on this PR: - ``@dependabot` rebase` will rebase this PR - ``@dependabot` recreate` will recreate this PR, overwriting any edits that have been made to it - ``@dependabot` merge` will merge this PR after your CI passes on it - ``@dependabot` squash and merge` will squash and merge this PR after your CI passes on it - ``@dependabot` cancel merge` will cancel a previously requested merge and block automerging - ``@dependabot` reopen` will reopen this PR if it is closed - ``@dependabot` close` will close this PR and stop Dependabot recreating it. You can achieve the same result by closing it manually - ``@dependabot` ignore this major version` will close this PR and stop Dependabot creating any more for this major version (unless you reopen the PR or upgrade to it yourself) - ``@dependabot` ignore this minor version` will close this PR and stop Dependabot creating any more for this minor version (unless you reopen the PR or upgrade to it yourself) - ``@dependabot` ignore this dependency` will close this PR and stop Dependabot creating any more for this dependency (unless you reopen the PR or upgrade to it yourself) </details> 467: build(deps): bump virtualenv from 20.10.0 to 20.11.0 r=ChrisRBe a=dependabot[bot] Bumps [virtualenv](https://github.com/pypa/virtualenv) from 20.10.0 to 20.11.0. <details> <summary>Changelog</summary> Sourced from <a href="https://github.com/pypa/virtualenv/blob/main/docs/changelog.rst">virtualenv's changelog</a>. <blockquote> <h2>v20.11.0 (2021-12-28)</h2> Features - 20.11.0 <pre><code>- Avoid deprecation warning from py-filelock argument - by :user:`ofek`. (`[#2237](pypa/virtualenv#2237) <https://github.com/pypa/virtualenv/issues/2237>`_) - Upgrade embedded setuptools to ``59.4.0`` from ``58.3.0`` - by :user:`gaborbernat`. (`[#2240](pypa/virtualenv#2240) <https://github.com/pypa/virtualenv/issues/2240>`_) - Drop the runtime dependency of ``backports.entry-points-selectable`` - by :user:`hroncok`. (`[#2246](pypa/virtualenv#2246) <https://github.com/pypa/virtualenv/issues/2246>`_) - Fish: PATH variables should not be quoted when being set - by :user:`hroncok`. (`[#2248](pypa/virtualenv#2248) <https://github.com/pypa/virtualenv/issues/2248>`_) </code></pre> </blockquote> </details> <details> <summary>Commits</summary> <ul> <li><a href="https://github.com/pypa/virtualenv/commit/72106af48f00936b50160ad9f7a921c91508c983"><code>72106af</code></a> release 20.11.0</li> <li><a href="https://github.com/pypa/virtualenv/commit/592420e9011ace2b019ac1d833e507724a0f19aa"><code>592420e</code></a> Add changelog</li> <li><a href="https://github.com/pypa/virtualenv/commit/878c6e09ded9b8e25a18ced1e04ba53075f2b5d2"><code>878c6e0</code></a> Fix the CI (<a href="https://github-redirect.dependabot.com/pypa/virtualenv/issues/2254">#2254</a>)</li> <li><a href="https://github.com/pypa/virtualenv/commit/ba3541c84a28cb03b42725b3e38bd08526e4768a"><code>ba3541c</code></a> Bump embeded wheels (<a href="https://github-redirect.dependabot.com/pypa/virtualenv/issues/2252">#2252</a>)</li> <li><a href="https://github.com/pypa/virtualenv/commit/abc655e428cd9a1070ee6ced2a83afcc3f972aa9"><code>abc655e</code></a> [pre-commit.ci] pre-commit autoupdate (<a href="https://github-redirect.dependabot.com/pypa/virtualenv/issues/2242">#2242</a>)</li> <li><a href="https://github.com/pypa/virtualenv/commit/bb82a73b6dbf577874f6d4bfaf72d2a7f59dfffe"><code>bb82a73</code></a> Use 'selectable' interface for entry points only when available (<a href="https://github-redirect.dependabot.com/pypa/virtualenv/issues/2246">#2246</a>)</li> <li><a href="https://github.com/pypa/virtualenv/commit/12a1fc2860761a9cd47c88a24093455d121570a3"><code>12a1fc2</code></a> Properly hide PEP-632 warning on latest version of <code>setuptools</code> (<a href="https://github-redirect.dependabot.com/pypa/virtualenv/issues/2251">#2251</a>)</li> <li><a href="https://github.com/pypa/virtualenv/commit/1431befa9373225d375d03dcd3aa2b83d51f7a62"><code>1431bef</code></a> fish: PATH variables should not be quoted when being set (<a href="https://github-redirect.dependabot.com/pypa/virtualenv/issues/2248">#2248</a>)</li> <li><a href="https://github.com/pypa/virtualenv/commit/1f1fdc9a0a5b7af0faf5e6c684d34dfcbf69b61f"><code>1f1fdc9</code></a> Avoid a new deprecation warning from filelock dependency (<a href="https://github-redirect.dependabot.com/pypa/virtualenv/issues/2237">#2237</a>)</li> <li><a href="https://github.com/pypa/virtualenv/commit/bf5691502d72fba98b2b65a65116dfe94687ea23"><code>bf56915</code></a> Update check.yml</li> <li>Additional commits viewable in <a href="https://github.com/pypa/virtualenv/compare/20.10.0...20.11.0">compare view</a></li> </ul> </details> [![Dependabot compatibility score](https://dependabot-badges.githubapp.com/badges/compatibility_score?dependency-name=virtualenv&package-manager=pip&previous-version=20.10.0&new-version=20.11.0)](https://docs.github.com/en/github/managing-security-vulnerabilities/about-dependabot-security-updates#about-compatibility-scores) Dependabot will resolve any conflicts with this PR as long as you don't alter it yourself. You can also trigger a rebase manually by commenting ``@dependabot` rebase`. [//]: # (dependabot-automerge-start) [//]: # (dependabot-automerge-end) --- <details> <summary>Dependabot commands and options</summary> You can trigger Dependabot actions by commenting on this PR: - ``@dependabot` rebase` will rebase this PR - ``@dependabot` recreate` will recreate this PR, overwriting any edits that have been made to it - ``@dependabot` merge` will merge this PR after your CI passes on it - ``@dependabot` squash and merge` will squash and merge this PR after your CI passes on it - ``@dependabot` cancel merge` will cancel a previously requested merge and block automerging - ``@dependabot` reopen` will reopen this PR if it is closed - ``@dependabot` close` will close this PR and stop Dependabot recreating it. You can achieve the same result by closing it manually - ``@dependabot` ignore this major version` will close this PR and stop Dependabot creating any more for this major version (unless you reopen the PR or upgrade to it yourself) - ``@dependabot` ignore this minor version` will close this PR and stop Dependabot creating any more for this minor version (unless you reopen the PR or upgrade to it yourself) - ``@dependabot` ignore this dependency` will close this PR and stop Dependabot creating any more for this dependency (unless you reopen the PR or upgrade to it yourself) </details> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

tirkarthi added 4 commits May 13, 2021 14:55

Add support to generate __match_args__ for Python 3.10.

452b09a

Add versionadded directive.

530e85f

Update stubs.

9d8b441

Update changelog and add a test to typing examples.

e13c92d

tirkarthi mentioned this pull request May 14, 2021

Support match case destructuring in Python 3.10 using __match_args__ #814

Closed

wsanchez added the Feature label May 14, 2021

wsanchez linked an issue May 14, 2021 that may be closed by this pull request

Support match case destructuring in Python 3.10 using __match_args__ #814

Closed

tirkarthi added 3 commits May 14, 2021 10:19

Fix error regarding new-style classes in Python 2.

69d0928

Fix lint error regarding line length.

918c1b4

Fix lint error regarding trailing whitespace.

4c0a339

tirkarthi and others added 2 commits May 15, 2021 05:23

Add docstrings for interrogate.

1c246db

Merge branch 'main' into match-args

a2afba6

hynek requested changes May 17, 2021

View reviewed changes

tirkarthi added 5 commits May 17, 2021 13:42

Use _has_own_attribute instead of cls.__dict__ contains check.

590e31e

Update docs as per review comments.

69bfe66

Revert mistaken changelog update.

753811b

Add Python 3.10 pattern matching syntax test cases.

b9d6b60

Merge branch 'match-args' of github.com:tirkarthi/attrs into match-args

778d296

Update define signature with match_args.

0cd51b4

tirkarthi added 2 commits May 17, 2021 14:55

Fix conftest formatting.

3793bcd

Fix isort formatting.

075db99

Bump to Python 3.10 to parse syntax.

a0f426d

Bump basepython of lint to Python 3.10 for parsing.

db4fc7d

Move lint to py310

e3a8036

hynek approved these changes May 18, 2021

View reviewed changes

hynek merged commit 8613af9 into python-attrs:main May 18, 2021

hynek added a commit that referenced this pull request May 18, 2021

Minor polish to #815

8c9a796

Signed-off-by: Hynek Schlawack <hs@ox.cx>

tirkarthi mentioned this pull request Jun 1, 2021

Python 3.10 pattern matching biqqles/dataclassy#47

Open

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Add __match_args__ to support match case destructuring in Python 3.10 #815

Add __match_args__ to support match case destructuring in Python 3.10 #815

tirkarthi commented May 14, 2021

tirkarthi commented May 14, 2021

hynek left a comment

hynek May 17, 2021

hynek May 17, 2021

hynek May 17, 2021

tirkarthi May 17, 2021

tirkarthi commented May 17, 2021

hynek commented May 17, 2021

tirkarthi commented May 17, 2021

tirkarthi commented May 17, 2021

hynek commented May 17, 2021

tirkarthi commented May 17, 2021

tirkarthi commented May 17, 2021

hynek commented May 17, 2021

tirkarthi commented May 17, 2021

tirkarthi commented May 17, 2021

hynek commented May 17, 2021

tirkarthi commented May 17, 2021

hynek commented May 17, 2021

hynek left a comment

tirkarthi commented May 18, 2021

Add __match_args__ to support match case destructuring in Python 3.10 #815

Add __match_args__ to support match case destructuring in Python 3.10 #815

Conversation

tirkarthi commented May 14, 2021

Pull Request Check List

tirkarthi commented May 14, 2021

hynek left a comment

Choose a reason for hiding this comment

hynek May 17, 2021

Choose a reason for hiding this comment

hynek May 17, 2021

Choose a reason for hiding this comment

hynek May 17, 2021

Choose a reason for hiding this comment

tirkarthi May 17, 2021

Choose a reason for hiding this comment

tirkarthi commented May 17, 2021

hynek commented May 17, 2021

tirkarthi commented May 17, 2021

tirkarthi commented May 17, 2021

hynek commented May 17, 2021

tirkarthi commented May 17, 2021

tirkarthi commented May 17, 2021

hynek commented May 17, 2021

tirkarthi commented May 17, 2021

tirkarthi commented May 17, 2021

hynek commented May 17, 2021

tirkarthi commented May 17, 2021

hynek commented May 17, 2021

hynek left a comment

Choose a reason for hiding this comment

tirkarthi commented May 18, 2021