From c1c51e3432ebd8801cd0736fe17ff457e6840dd9 Mon Sep 17 00:00:00 2001 From: Andrew Kuchling Date: Mon, 15 Oct 2012 10:01:06 -0400 Subject: [PATCH 01/14] Rename base template file from base.mako to site.mako --- site/_templates/{base.mako => site.mako} | 0 site/index.html.mako | 2 +- 2 files changed, 1 insertion(+), 1 deletion(-) rename site/_templates/{base.mako => site.mako} (100%) diff --git a/site/_templates/base.mako b/site/_templates/site.mako similarity index 100% rename from site/_templates/base.mako rename to site/_templates/site.mako diff --git a/site/index.html.mako b/site/index.html.mako index f2b1d6d..fc257c4 100644 --- a/site/index.html.mako +++ b/site/index.html.mako @@ -1,4 +1,4 @@ -<%inherit file="_templates/base.mako" /> +<%inherit file="_templates/site.mako" />

Note: We have mirrored Mark Pilgrim's excellent Dive into From c505eacd728a81ebee2e77a54f01c51dbd679107 Mon Sep 17 00:00:00 2001 From: Andrew Kuchling Date: Mon, 15 Oct 2012 10:08:33 -0400 Subject: [PATCH 02/14] Update URL for fork-me ribbon --- site/_templates/header.mako | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/site/_templates/header.mako b/site/_templates/header.mako index f5e2fb0..1404089 100644 --- a/site/_templates/header.mako +++ b/site/_templates/header.mako @@ -2,7 +2,7 @@ Fork me on GitHub From 289ac7a9936297146bc60f8cf6545b8d662f853e Mon Sep 17 00:00:00 2001 From: Andrew Kuchling Date: Mon, 15 Oct 2012 10:13:28 -0400 Subject: [PATCH 03/14] Shorten last sentence of introduction --- site/_templates/sections/introduction.mako | 8 +++----- 1 file changed, 3 insertions(+), 5 deletions(-) diff --git a/site/_templates/sections/introduction.mako b/site/_templates/sections/introduction.mako index e6477cb..54895eb 100644 --- a/site/_templates/sections/introduction.mako +++ b/site/_templates/sections/introduction.mako @@ -3,8 +3,6 @@ - this site aims to be a resource for Python 3 for developers. This includes guides, videos, tutorials and other resources to help you and your team achieve a successful Python 3 port of -your application, library, framework or tool. Also included is -information on Python Software Foundation financial grants for -porting to Python 3, other significant projects working on -Python 3, as well as potential information on companies willing -to fund or provide grants for Python 3 porting.

+your application, library, framework or tool. It also covers +Python Software Foundation financial grants for +porting to Python 3.

From 73310c3bec5553b782556b59b47dad71532e31e2 Mon Sep 17 00:00:00 2001 From: Andrew Kuchling Date: Mon, 15 Oct 2012 10:26:39 -0400 Subject: [PATCH 04/14] Revise the what-is-Python-3 section --- site/_templates/sections/whatispython.mako | 46 ++++++++++++++-------- 1 file changed, 29 insertions(+), 17 deletions(-) diff --git a/site/_templates/sections/whatispython.mako b/site/_templates/sections/whatispython.mako index b0576ca..7af4d3e 100644 --- a/site/_templates/sections/whatispython.mako +++ b/site/_templates/sections/whatispython.mako @@ -1,36 +1,48 @@

What is Python 3?

-

Short version: Although most Python code is written for Python +

Short summary

+ +

Although most Python code is currently written for Python 2.x, Python 3.x is the present and future of the language.

-

At the time of writing (Sept 28, 2011), the final 2.7 release -is out, with a statement of extended support for this end-of-life -release. The 2.x branch will see no new major releases after that. -3.x is under active development and has already seen stable -releases, such as the recent 3.2. This means that all recent -standard library improvements, for example, are only available -in Python 3.x.

+

Python 2.7.3 was released in April 2012. +The 2.x branch will have no further major releases, +though this end-of-life release will have an extended period of bug +and security fixes. + +

Python 3.x continues to be actively developed and has already seen stable +releases. The most recent is Python 3.3, released in September +2012. This means that all recent standard library improvements, for +example, are only available in Python 3.x.

+ +

Detailed discussion

Guido van Rossum (the original creator of the Python language), -in conjunction with other python-core developers decided to -clean up Python 2.x properly, with less regard for backwards -compatibility than is the case for new releases in the 2.x range. -The most drastic improvement is the better unicode support (with -all text strings being unicode by default) as well as saner +in conjunction with other python-core developers decided to use Python 3.x to +clean up Python 2.x. Python 2.x releases were careful to preserve backwards +compatibility with older versions, but Python 3.x was freed of this requirement. +The most drastic improvement is better Unicode support (with +all text strings being Unicode by default) as well as saner bytes/unicode separation.

-

Besides, several aspects of the core language (such as print -and exec being statements, integers using floor division) have been +

Several other aspects of the core language (such as print +and exec being statements, integers using floor division) were adjusted to be easier for newcomers to learn and to be more consistent with the rest of the language, and old cruft has been removed (for -example, all classes are now new-style, range() returns a memory -efficient iterable, not a list as in 2.x).

+example, all classes are now new-style, range() returns a memory +efficient iterable and not a list as in 2.x).

The What's New in Python 3.0 document provides a good overview of the major language changes and likely sources of incompatibility with existing Python 2.x code.

+

The What's +New in Python 3.1, +Python 3.2, +and Python 3.3 +documents describes the new features added to each Python 3 release.

+

Cribbed from Python2orPython3 on the Python wiki.

From 232b8a3d20dcf7d38c3f78d449abf4789feb7f1c Mon Sep 17 00:00:00 2001 From: Andrew Kuchling Date: Mon, 15 Oct 2012 10:46:43 -0400 Subject: [PATCH 05/14] Update for Python 3.3 --- site/_templates/sections/download.mako | 41 ++++++++++++-------------- 1 file changed, 19 insertions(+), 22 deletions(-) diff --git a/site/_templates/sections/download.mako b/site/_templates/sections/download.mako index eba8e66..8823830 100644 --- a/site/_templates/sections/download.mako +++ b/site/_templates/sections/download.mako @@ -1,32 +1,29 @@

Download Information

-

The most current version of Python 3 is 3.2.2 - here's a list of -new things: +

The most current version of Python 3 is 3.3.2 - here's a list of +new things added:

    -
  • numerous improvements to the unittest module
  • -
  • PEP 3147, support for .pyc repository directories
  • -
  • PEP 3149, support for version tagged dynamic libraries
  • -
  • PEP 3148, a new futures library for concurrent programming
  • -
  • PEP 384, a stable ABI for extension modules
  • -
  • PEP 391, dictionary-based logging configuration
  • -
  • an overhauled GIL implementation that reduces contention
  • -
  • an extended email package that handles bytes messages
  • -
  • a much improved ssl module with support for SSL contexts and certificate hostname matching
  • -
  • a sysconfig module to access configuration information
  • -
  • additions to the shutil module, among them archive file support
  • -
  • many enhancements to configparser, among them mapping protocol support
  • -
  • improvements to pdb, the Python debugger
  • -
  • countless fixes regarding bytes/string issues; among them full support for a bytes environment (filenames, environment variables)
  • -
  • many consistency and behavior fixes for numeric operations
  • +
  • yield from expression for delegating to a generator (PEP 380) +
  • new library modules for LZMA compression, mock objects for unit tests, + and representing IP addresses +
  • the decimal type has been re-implemented in C, making it much faster +
  • PEP 393, Flexible String Representation, which reduces memory usage + and removes the distinction between narrow and wide builds of Python. +
  • PEP 397, a Windows® launcher for *.py files. +
  • PEP 405, Python Virtual Environments
  • +
  • PEP 3118, new implementation of the memoryview type.
  • +
  • PEP 3151, reworked hierarchy of OS and I/O exceptions
  • +
  • the import statement is now build atop the importlib module
  • +
  • for easier porting to Python 3, the u'' syntax is now accepted again
  • +
  • security fix: hash randomization is now enabled by default.

You can see details on what's changed by looking at the "What's New in 3.2" -document as well as "What's New in -3.0", and the change log. +href="http://docs.python.org/dev/whatsnew/3.3.html">What's New in 3.3" +document, as well as the earlier What's New articles, and the change log. Builds are available for all major platforms, and OS X users can use homebrew via "brew install python3"

From 72a61afc6647ecfbef850ef4f11e36e7498f151e Mon Sep 17 00:00:00 2001 From: Andrew Kuchling Date: Mon, 15 Oct 2012 10:46:57 -0400 Subject: [PATCH 06/14] Typo fix --- site/_templates/sections/ports.mako | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/site/_templates/sections/ports.mako b/site/_templates/sections/ports.mako index 260adb4..97a1e06 100644 --- a/site/_templates/sections/ports.mako +++ b/site/_templates/sections/ports.mako @@ -16,6 +16,6 @@ major dependencies for other projects and tools:
  • requests
  • You can see a semi-complete list of all Python 3 supporing packages on PyPi +href="http://pypi.python.org/pypi?:action=browse&c=533&show=all">all Python 3 supporting packages on PyPi here.

    From 28c2855659dec04f05ea2a3e9694bd1355b45eeb Mon Sep 17 00:00:00 2001 From: Andrew Kuchling Date: Mon, 15 Oct 2012 10:49:26 -0400 Subject: [PATCH 07/14] Update links for Pyramid, Django --- site/_templates/sections/ports.mako | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/site/_templates/sections/ports.mako b/site/_templates/sections/ports.mako index 97a1e06..7dbade0 100644 --- a/site/_templates/sections/ports.mako +++ b/site/_templates/sections/ports.mako @@ -3,8 +3,8 @@ Python 3 ecosystem. Some of these represent entire frameworks, while others are major dependencies for other projects and tools:
      -
    • Pyramid 1.3a1
    • -
    • Django (Development Branch)
    • +
    • Pyramid 1.3
    • +
    • Django (Experimental)
    • Mako Templates
    • SQLAlchemy
    • Webob
    • From 845af1adbe2bea371d960c9a42786fa27f977c2e Mon Sep 17 00:00:00 2001 From: Andrew Kuchling Date: Mon, 15 Oct 2012 10:50:59 -0400 Subject: [PATCH 08/14] Typo fix --- site/_templates/sections/ports.mako | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/site/_templates/sections/ports.mako b/site/_templates/sections/ports.mako index 7dbade0..15d4205 100644 --- a/site/_templates/sections/ports.mako +++ b/site/_templates/sections/ports.mako @@ -1,5 +1,5 @@

      Notable Ports

      -

      The follow libraries/projects and frameworks are notable additions to the +

      The following libraries/projects and frameworks are notable additions to the Python 3 ecosystem. Some of these represent entire frameworks, while others are major dependencies for other projects and tools:

        From 71ffdf34ee58dfad44a5adfe361c2e722335d3f3 Mon Sep 17 00:00:00 2001 From: Andrew Kuchling Date: Mon, 15 Oct 2012 10:51:15 -0400 Subject: [PATCH 09/14] Remove first sentence --- site/_templates/sections/support.mako | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/site/_templates/sections/support.mako b/site/_templates/sections/support.mako index 1134d22..52dcd84 100644 --- a/site/_templates/sections/support.mako +++ b/site/_templates/sections/support.mako @@ -1,7 +1,6 @@

        Financial support

        -

        In short: yes - there's a bevy of information, videos and -blog posts out there that can help you on your way. Python 3 is +

        Python 3 is the future of the Python language, and entities such as the Python Software Foundation strongly believe in supporting the porting effort.

        From f3c427fc092d932e11f80861bf0a973b4e7ebb1b Mon Sep 17 00:00:00 2001 From: Andrew Kuchling Date: Mon, 15 Oct 2012 10:55:02 -0400 Subject: [PATCH 10/14] Revise some sentences --- site/_templates/sections/findprojects.mako | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/site/_templates/sections/findprojects.mako b/site/_templates/sections/findprojects.mako index 6455890..3b975ea 100644 --- a/site/_templates/sections/findprojects.mako +++ b/site/_templates/sections/findprojects.mako @@ -1,12 +1,12 @@

        How to find projects

        -

        If you are looking to help - but are not the maintainer of a module, library, -etc there are various ways you can help. For example, see Brett Cannon's +

        If you are looking to help — but are not the maintainer of a module, library, +etc. — there are various ways you can help. For example, see Brett Cannon's "Python 3 Support on PyPI" site, -that lists out various projects that support, or do not support Python 3. You -can always find some project there, or elsewhere that can use assistance in +that lists various projects that support, or do not support Python 3. You +can always find a project there that can use assistance in porting.

        -

        Additionally, there are threads and sites out there (such as +

        Additionally, there are threads and sites (such as -Tarek's post on google+) where people have come out and voted for libraries +Tarek's post on google+) where people have voted for libraries they need ported to Python 3 so they can in turn make the transition.

        From 39c13be4baa83277babada5bf8811a90cf0012a2 Mon Sep 17 00:00:00 2001 From: Andrew Kuchling Date: Mon, 15 Oct 2012 10:56:12 -0400 Subject: [PATCH 11/14] Reword sentence --- site/_templates/sections/resources.mako | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/site/_templates/sections/resources.mako b/site/_templates/sections/resources.mako index 23ae215..4f16800 100644 --- a/site/_templates/sections/resources.mako +++ b/site/_templates/sections/resources.mako @@ -1,6 +1,6 @@

        Resources

        -

        There is a wealth of information out there on Porting to, and about -Python 3. There is an entire mailing list (python-porting) +

        There is a wealth of information out there about Python 3 and porting to it. +There is an entire mailing list (python-porting) dedicated to helping people port things to Python 3 - developers experienced in porting should join up, and there is already a good team there to help support you.

        From 22990a4ec9a1cdef8a854c373bf76b5090b97496 Mon Sep 17 00:00:00 2001 From: Andrew Kuchling Date: Mon, 15 Oct 2012 10:57:38 -0400 Subject: [PATCH 12/14] Clarify links --- site/_templates/sections/resources.mako | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/site/_templates/sections/resources.mako b/site/_templates/sections/resources.mako index 4f16800..a46ecab 100644 --- a/site/_templates/sections/resources.mako +++ b/site/_templates/sections/resources.mako @@ -20,8 +20,8 @@ team there to help support you.

        From 01790e922f490be0f5fc84b3f127149ef52b0d5b Mon Sep 17 00:00:00 2001 From: Andrew Kuchling Date: Mon, 15 Oct 2012 11:02:09 -0400 Subject: [PATCH 13/14] Rearrange order of sections, putting resources higher up the page --- site/_templates/topbar.mako | 4 ++-- site/index.html.mako | 6 +++--- 2 files changed, 5 insertions(+), 5 deletions(-) diff --git a/site/_templates/topbar.mako b/site/_templates/topbar.mako index a45d9ff..63705c0 100644 --- a/site/_templates/topbar.mako +++ b/site/_templates/topbar.mako @@ -5,10 +5,10 @@
      • Introduction
      • What is Python 3?
      • Download
      • +
      • Resources
      • Notable Ports
      • -
      • Financial Support
      • Find Projects
      • -
      • Resources
      • +
      • Financial Support
      diff --git a/site/index.html.mako b/site/index.html.mako index fc257c4..5763269 100644 --- a/site/index.html.mako +++ b/site/index.html.mako @@ -38,13 +38,13 @@ ${self.whatispython()} ${self.download()} -${self.ports()} +${self.resources()} -${self.support()} +${self.ports()} ${self.findprojects()} -${self.resources()} +${self.support()}

      Source code to this site available on github.

      From 9fd41380e3533a1579f93a6785151c48cbdea09a Mon Sep 17 00:00:00 2001 From: Andrew Kuchling Date: Mon, 15 Oct 2012 11:02:55 -0400 Subject: [PATCH 14/14] Update download link for Python 3.3 --- site/_templates/sections/download.mako | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/site/_templates/sections/download.mako b/site/_templates/sections/download.mako index 8823830..ef1374b 100644 --- a/site/_templates/sections/download.mako +++ b/site/_templates/sections/download.mako @@ -28,5 +28,5 @@ Builds are available for all major platforms, and OS X users can use homebrew via "brew install python3"

      -

      Go Here to +

      Go Here to Download »