Add note about `parse_*` function in options.py

Add note about `parse_command_line` function

Merge pull request #3074 from tornadoweb/dependabot/pip/docs/babel-2.9.1

build(deps): bump babel from 2.8.0 to 2.9.1 in /docs

build(deps): bump babel from 2.8.0 to 2.9.1 in /docs

Bumps [babel](https://github.com/python-babel/babel) from 2.8.0 to 2.9.1.
- [Release notes](https://github.com/python-babel/babel/releases)
- [Changelog](https://github.com/python-babel/babel/blob/master/CHANGES)
- [Commits](https://github.com/python-babel/babel/compare/v2.8.0...v2.9.1)

---
updated-dependencies:
- dependency-name: babel
  dependency-type: indirect
...

Signed-off-by: dependabot[bot] <support@github.com>

Merge pull request #3053 from bfis/patch-2

Avoid 2GB write limitation on SSLIOStream

iostream: Fix copy/pasted comment

Co-authored-by: Pierce Lopez <pierce.lopez@gmail.com>

Merge pull request #3052 from hugovk/replace-deprecated-unittest-aliases

Replace deprecated unittest aliases

Merge pull request #3048 from mivade/httpfile-type-hints

Type hint HTTPFile attributes

Avoid 2GB write limitation on SSLIOStream

Replace deprecated unittest aliases

Type hint HTTPFile attributes

Merge pull request #3041 from samm0ss/sam/feat/encoding-gzip-case-insensitive

Fix case-sensitivity for Content-Encoding: gzip. as per rfc7231 the C…

Fix case-sensitivity for Content-Encoding: gzip. as per rfc7231 the Content-Encoding values are case-insensitive https://datatracker.ietf.org/doc/html/rfc7231#section-3.1.2.1

PeriodicCallback: support async/coroutine callback (#2924)

ISSUE: https://github.com/tornadoweb/tornado/issues/2828

* ioloop: call_later() and call_at() take any Callable coroutine or plain, returning any type

Co-authored-by: agnewee <agnewee@gmail.com>

Merge pull request #3010 from alexmv/is_valid_ip

is_valid_ip: Do not raise exceptions on too-long input.

is_valid_ip: Do not raise exceptions on too-long input.

is_valid_ip calls `socket.getaddrinfo` with `socket.AI_NUMERICHOST` on
the potential "ip"; even though IP addresses are not hostnames and do
not use the `idna` encoding, `socket.getaddrinfo` will raise
UnicodeError if the potential "ip" is longer than 63 characters long,
the RFC-mandated max hostname length.

Catch these UnicodeErrors and return false for too-long IPs, rather
than raising an exception.

Merge pull request #3025 from mivade/periodic-callback-timedelta

Accept timedelta objects in PeriodicCallback

Update docstring

Optionally accept a timedelta in PeriodicCallback

Merge pull request #3015 from tornadoweb/dependabot/pip/maint/py-1.10.0

build(deps): bump py from 1.9.0 to 1.10.0 in /maint

build(deps): bump py from 1.9.0 to 1.10.0 in /maint

Bumps [py](https://github.com/pytest-dev/py) from 1.9.0 to 1.10.0.
- [Release notes](https://github.com/pytest-dev/py/releases)
- [Changelog](https://github.com/pytest-dev/py/blob/master/CHANGELOG.rst)
- [Commits](https://github.com/pytest-dev/py/compare/1.9.0...1.10.0)

Signed-off-by: dependabot[bot] <support@github.com>

Merge pull request #3006 from tornadoweb/dependabot/pip/docs/pygments-2.7.4

build(deps): bump pygments from 2.7.2 to 2.7.4 in /docs

build(deps): bump pygments from 2.7.2 to 2.7.4 in /docs

Bumps [pygments](https://github.com/pygments/pygments) from 2.7.2 to 2.7.4.
- [Release notes](https://github.com/pygments/pygments/releases)
- [Changelog](https://github.com/pygments/pygments/blob/master/CHANGES)
- [Commits](https://github.com/pygments/pygments/compare/2.7.2...2.7.4)

Signed-off-by: dependabot[bot] <support@github.com>

Merge pull request #3000 from GeekDuanLian/patch-1

Allowed set max_body_size to 0

Merge pull request #3003 from tornadoweb/dependabot/pip/docs/jinja2-2.11.3

build(deps): bump jinja2 from 2.11.2 to 2.11.3 in /docs

Merge pull request #2996 from madsbk/typed_memoryviews

BaseIOStream.write(): support typed memoryviews

build(deps): bump jinja2 from 2.11.2 to 2.11.3 in /docs

Bumps [jinja2](https://github.com/pallets/jinja) from 2.11.2 to 2.11.3.
- [Release notes](https://github.com/pallets/jinja/releases)
- [Changelog](https://github.com/pallets/jinja/blob/master/CHANGES.rst)
- [Commits](https://github.com/pallets/jinja/compare/2.11.2...2.11.3)

Signed-off-by: dependabot[bot] <support@github.com>

Is this okay

But this is not beautiful

what

fix E127

fix line too long

Allowed set max_body_size to 0

BaseIOStream.write(): support typed memoryview

Making sure that ``len(data) == data.nbytes`` by casting
memoryviews to bytes.

Merge pull request #2948 from eltoder/feature/websocket-handler-stream-cleanup

Remove WebSocketHandler.stream.

Merge pull request #2974 from youguanxinqing/issue-2969

testing: Add 'address' keyword to control bound address #2969

Merge pull request #2983 from kriskros341/changes

Dict support for WebSocketClientConnection.write_message method

Fixes #2982

Merge pull request #2970 from bfis/patch-1

Avoid 2GB read limitation on SSLIOStream

Uppercase A in Any

write_message method of WebSocketClientConnection now accepts dict as input

write_message method of WebSocketClientConnection now accepts dict as input

Merge pull request #2978 from youguanxinqing/issue-2977

should use python3 unicode in 'blog' demo #2977

leave previous versionchanged

leave previous versionchanged

should use python3 unicode in 'blog' demo #2977

change comment

Add comment explaining workaround

format code according to result of flake8 check

Add 'address' keyword control binded address #2969

Remove WebSocketHandler.stream.

It was no longer used and always set to None.

Merge pull request #2965 from timgates42/bugfix_typo_authenticate

docs: fix simple typo, authentiate -> authenticate

Merge pull request #2972 from bdarnell/wsgi-docstring

wsgi: Update docstring example for python 3

Merge pull request #2963 from sk1p/issue-2034

WaitIterator: don't re-use _running_future

wsgi: Update docstring example for python 3

Fixes #2960

Merge pull request #2971 from bdarnell/only-initialize-existing-locales

locale: Only try to load locales that exist

locale: Format with black

Remove trailing whitespace

Avoid 2GB read limitation on SSLIOStream

docs: fix simple typo, authentiate -> authenticate

There is a small typo in tornado/netutil.py.

Should read `authenticate` rather than `authentiate`.

Fix return type of _return_result

WaitIterator: don't re-use _running_future

When used with asyncio.Future, WaitIterator may skip indices in some
cases. This is caused by multiple _return_result calls after another,
without having the chain_future call finish in between. This is fixed
here by not hanging on to the _running_future anymore, which forces
subsequent _return_result calls to add to _finished, instead of causing
the previous result to be silently dropped.

Fixes #2034

Issue #2954: prevent logging error messages for not existing translation files

Every not existing translation file for the existing locales logged an error message:
Cannot load translation for 'ps': [Errno 2] No such file or directory: '/usr/share/locale/ps/LC_MESSAGES/foo.mo'

Merge pull request #2932 from novanauliazami/auth

Update how to register application with Google

Merge pull request #2936 from eltoder/patch-1

Fix await vs yield in the example

Merge pull request #2946 from bdarnell/deps

Multiple dependency-related updates

platform: Deprecate twisted and cares resolvers

These were most interesting when the default resolver blocked
the main thread. Now that the default is to use a thread pool,
there is little if any demand for alternative resolvers just to
avoid threads.

docs: Stop using autodoc for t.p.twisted

This way we don't have to install twisted into the docs build
environment. Add some more detail while I'm here.

docs: Pin specific versions of requirements

docs: Upgrade to latest version of sphinx

This version attempts to resolve types found in type annotations,
but in many cases it can't find them so silence a bunch of warnings.
(Looks like deferred annotation processing will make this better but
we won't be able to use that until we drop Python 3.6)

Update mypy to latest version

*: Update black to newest version

maint: Prune requirements lists

Remove dependencies that are rarely used outside of tox. The main
motivation is to give dependabot less to worry about when an indirect
dependency has a security vulnerability.

iostream: Add platform assertion for mypy

Without this mypy would fail when run on windows.

Merge pull request #2945 from bdarnell/start6.2

Bump main branch to 6.2.dev1; drop py35

Drop support for python 3.5

Remove appveyor configs

Bump main branch to 6.2.dev1

Merge pull request #2944 from bdarnell/bump6.1

Set version to 6.1 final

ci: Work around outdated windows root certificates

Set version to 6.1 final

Merge pull request #2940 from bdarnell/bump6.1b2

Bump version to 6.1b2

Bump version to 6.1b2

Merge pull request #2931 from bdarnell/py39

ci,setup: Add python 3.9 to tox, cibuildwheel and setup.py

ci,setup: Add python 3.9 to tox, cibuildwheel and setup.py

Merge pull request #2934 from bdarnell/manual-thread

asyncio: Manage our own thread instead of an executor

asyncio: Manage our own thread instead of an executor

Python 3.9 changed the behavior of ThreadPoolExecutor at interpreter
shutdown (after the already-tricky import-order issues around
atexit hooks). Avoid these issues by managing the thread by hand.

test: Add a timeout to SyncHTTPClient test

Merge pull request #2938 from bdarnell/contextvars

gen: Expliclty track contextvars, fixing contextvars.reset

gen: Expliclty track contextvars, fixing contextvars.reset

The asyncio event loop provides enough contextvars support out of the
box for basic contextvars functionality to work in tornado coroutines,
but not `contextvars.reset`. Prior to this change, each yield created
a new "level" of context, when an entire coroutine should be on the
same level. This is necessary for the reset method to work.

Fixes #2731

Fix await vs yield in the example

Update how to register application with Google

Merge pull request #2930 from bdarnell/deprecate35

Add deprecation notice for Python 3.5

Add deprecation notice for Python 3.5

ci: Switch from testpypi to real pypi

Merge pull request #2928 from bdarnell/relnotes61

Add release notes for 6.1, bump version to 6.1b1

Add release notes for 6.1, bump version to 6.1b1

Merge pull request #2923 from bdarnell/ci-refactor

test: Refactor CI configuration

test: Refactor CI configuration

- Add osx and windows builds on travis
- Stop running -full test suites on every python version on arm64
- Use cibuildwheel to build for all python versions in one job per
  platform
- Bring a single test configuration and linters up to a first "quick"
  stage before starting the whole matrix
- Push the resulting wheels (and sdist) to pypi on tag builds

Merge pull request #2921 from ploxiln/gzip_inf_loop

simple_httpclient: fix infinite loop hang with invalid gzip data

http: fix infinite loop hang with invalid gzip data