delta/cpython-git.git/Doc/library/contextlib.rst, branch dependabot/github_actions/actions/cache-v2.1.5

Use the zero argument form of super() in examples for Python3 docs. (GH-22314)

2021-04-26T22:13:54+00:00

bpo-41543: contextlib.nullcontext can fill in for an async context manager (GH-21870)

2020-11-09T12:34:07+00:00

Co-authored-by: Andrew Svetlov

[docs] fix wrongly named AsyncContextDecorator (GH-23164)

2020-11-05T16:16:27+00:00

Also added versionchanged.

bpo-40816 Add AsyncContextDecorator class (GH-20516)

2020-11-05T08:52:24+00:00

Co-authored-by: Yury Selivanov

bpo-41229: Update docs for explicit aclose()-required cases and add contextlib.aclosing() method (GH-21545)

2020-11-02T08:02:48+00:00

This is a PR to:

 * Add `contextlib.aclosing` which ia analogous to `contextlib.closing` but for async-generators with an explicit test case for [bpo-41229]()
 * Update the docs to describe when we need explicit `aclose()` invocation.

which are motivated by the following issues, articles, and examples:

 * [bpo-41229]()
 * https://github.com/njsmith/async_generator
 * https://vorpus.org/blog/some-thoughts-on-asynchronous-api-design-in-a-post-asyncawait-world/#cleanup-in-generators-and-async-generators
 * https://www.python.org/dev/peps/pep-0533/
 * https://github.com/achimnol/aiotools/blob/ef7bf0cea7af/src/aiotools/context.py#L152

Particuarly regarding [PEP-533](https://www.python.org/dev/peps/pep-0533/), its acceptance (`__aiterclose__()`) would make this little addition of `contextlib.aclosing()` unnecessary for most use cases, but until then this could serve as a good counterpart and analogy to `contextlib.closing()`. The same applies for `contextlib.closing` with `__iterclose__()`.
Also, still there are other use cases, e.g., when working with non-generator objects with `aclose()` methods.

[3.9] bpo-37116: Use PEP 570 syntax for positional-only parameters. (GH-12620)

2019-06-05T15:22:31+00:00

Turn deprecation warnings added in 3.8 into TypeError.

bpo-37116: Use PEP 570 syntax for positional-only parameters. (GH-13700)

2019-06-01T08:00:15+00:00

bpo-35506: Remove redundant and incorrect links from keywords. (GH-11174)

2018-12-19T06:09:46+00:00

Clarify that AsyncExitStack works with coroutine functions (GH-9405)

2018-09-18T21:27:59+00:00

The docs were ambiguous about whether you pass in a coroutine function
or a coroutine object, e.g. is it:

  aestack.push_async_exit(some_async_func)

or

  aestack.push_async_exit(some_async_func())

(It's the first one.)

Fixed typo with asynccontextmanager code example (GH-8845)

2018-08-25T02:38:11+00:00

`yield conn`, instead of just `yield`.