Moving from Python 2 to Python 3: A 4 page "cheat sheet"

[Mark Summerfield]

On Dec 2, 8:53 am, Mark Dickinson <dicki... at gmail.com> wrote:
> On Dec 2, 8:01 am, MarkSummerfield<l... at qtrac.plus.com> wrote:
>
> > On 1 Dec, 17:50, Mark Dickinson <dicki... at gmail.com> wrote:
> > > My only quibble is with the statement on the first page that
> > > the 'String % operator is deprecated'.  I'm not sure that's
> > > true, for all values of 'deprecated'.  There don't appear
> > > to be any definite plans for getting rid of it just yet.
>
> > I didn't make this up:-)
>
> No, I didn't imagine for a second that you had!
>
> > According tohttp://docs.python.org/dev/3.0/whatsnew/3.0.html
> > "The plan is to eventually make this the only API for string
> > formatting, and to start deprecating the % operator in Python 3.1."
>
> I think that's a doc bug.  "The plan is to ..." should read: "The plan
> was
> originally to ...".  (Well, at least in the 3.1 version of the
> "what's new in 3.0" documentation;  the 3.0 version that you linked to
> isn't even autogenerated any more, AFAIK, so fixes to the ReST source
> for that file never make it to the web site.)
>
> I'm a little confused myself about what's actually happening with
> % formatting, but here's a fairly recent python-dev posting from
> the BDFL:
>
> http://mail.python.org/pipermail/python-dev/2009-September/092399.html

Well it seems clear to me that the BDFL wants to kill of % formatting,
but wasn't able to for Python 3... So I still think it is reasonable
(1) to describe it as deprecated and (2) to only teach and use
str.format().