Skip to content

httputil: Deprecate some args to HTTPServerRequest constructor#3646

Merged
bdarnell merged 1 commit into
tornadoweb:masterfrom
bdarnell:httpserverrequest-deprecation
Jun 22, 2026
Merged

httputil: Deprecate some args to HTTPServerRequest constructor#3646
bdarnell merged 1 commit into
tornadoweb:masterfrom
bdarnell:httpserverrequest-deprecation

Conversation

@bdarnell

Copy link
Copy Markdown
Member

HTTPServerRequest has some redundant and/or obsolete constructor arguments. #3542 cleaned this up a bit, but it included a backwards incompatible change with no deprecation warning. This change adds deprecation warnings in anticipation of deleting the old arguments in Tornado 6.7.

In Tornado 6.5, all arguments were officially optional, but things would only partially work without the method and uri arguments. #3542 made either the uri or start_line arguments mandatory.

This change makes the method and uri arguments deprecated. It is also deprecated to use method and uri at the same time as start_line (previously method and uri would be silently ignored). In Tornado 6.7, the method, uri, and version arguments will be removed, and start_line will be required.

Updates #3500
Updates #3542
Fixes #3637

HTTPServerRequest has some redundant and/or obsolete constructor
arguments. tornadoweb#3542 cleaned this up a bit, but it included a backwards
incompatible change with no deprecation warning. This change adds
deprecation warnings in anticipation of deleting the old arguments
in Tornado 6.7.

In Tornado 6.5, all arguments were officially optional, but things would
only partially work without the method and uri arguments. tornadoweb#3542 made
either the uri or start_line arguments mandatory.

This change makes the method and uri arguments deprecated. It is also
deprecated to use method and uri at the same time as start_line
(previously method and uri would be silently ignored). In Tornado 6.7,
the method, uri, and version arguments will be removed, and start_line
will be required.

Updates tornadoweb#3500
Updates tornadoweb#3542
Fixes tornadoweb#3637
@bdarnell bdarnell merged commit affd793 into tornadoweb:master Jun 22, 2026
16 checks passed
@bdarnell bdarnell deleted the httpserverrequest-deprecation branch June 22, 2026 18:57
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

httputil: Clean up HTTPServerRequest uri and start_line

1 participant