Opened 10 years ago

Last modified 9 years ago

#3040 enhancement new

Set version information in new deprecations to the version number actually associated with a release

Reported by: Jean-Paul Calderone Owned by:
Priority: normal Milestone: totally automated release infrastructure
Component: release management Keywords:
Cc: Thijs Triemstra Branch:
Author:

Description

Some APIs (eg twisted.python.deprecate.deprecated) accept version information. This information can't be known for sure until a release is actually done (eg, a lot of deprecations, though they mostly don't use the API mentioned above, talk about Twisted 2.6, which presumably will not be the next version of Twisted). We should represent "the next version of Twisted" symbolically and part of the release process should be to replace this with an actual value.

Here's one humble suggestion:

  • twisted.something is a Version instance set to a reasonable guess for the next Twisted release. Any new deprecations import and use it.
  • When a release is about to happen, all imports of twisted.something are replaced with imports of twisted.somethingElse. twisted.somethingElse is the Version number which is actually associated with the release.
  • twisted.something is updated to give a reasonable guess for the next Twisted release.

This way, it's always the same to deprecate an API (and particularly, it doesn't require much thinking about releases and such). It also gives deprecations a uniformity which should make the release update job straightforward.

Change History (5)

comment:1 Changed 10 years ago by Jean-Paul Calderone

(In [22677]) Merge deprecated-enterprise-3022

Author: exarkun Reviewer: therve, dreid Fixes #3022 Refs #3040

Deprecate twisted.enterprise.util and everything in it.

comment:2 Changed 10 years ago by radix

Milestone: twisted-8.0

comment:3 Changed 10 years ago by radix

Milestone: twisted-8.0regular-releases

comment:4 Changed 9 years ago by Thijs Triemstra

Cc: Thijs Triemstra added

Also see #3838 where a 8.2 vs 9.0 trunk issue is described.

comment:5 Changed 7 years ago by <automation>

Owner: radix deleted
Note: See TracTickets for help on using tickets.