Within file you ought to have the right trove classifier indicating what variations of Python your supporting. As your venture cannot supporting Python 3 yet you really need to at the least have program writing language :: Python :: 2 :: merely given. Essentially its also wise to identify each major/minor version of Python that you create service, e.g. Programming Language :: Python :: 2.7 .
Posses close test coverageA¶
After you’ve their rule supporting the eldest form of Python 2 you want it to, you will need to be sure that examination room features good insurance. An effective guideline is when you need to getting positive sufficient within test room that any failures that look after having hardware rewrite your code are actual bugs inside technology and never in your code. If you would like a number to strive for, attempt to conquer 80per cent plans (and don’t feel worst if you discover it hard to have better than 90per cent insurance). If you don’t actually have an instrument to measure examination insurance next is advised.
After you’ve the laws well-tested you are prepared to begin porting their code to Python 3! But to completely know how the code will probably change and what you need to look out for when you laws, you will need to discover just what changes Python 3 helps make with respect to Python 2. Typically the two greatest methods for performing that will be checking out the a€?what is actually Newa€? doc per release of Python 3 in addition to Porting to Python 3 publication (and that is online). There is also a handy cheat sheet through the Python-Future project.
Improve your codeA¶
After you feel like you know what differs from the others in Python 3 in comparison to Python 2, it is the right time to update your signal! You really have a selection between two equipment in porting your laws immediately: Futurize and Modernize. Which appliance you select is determined by simply how much like Python 3 you need the signal getting. Futurize really does their best to make Python 3 idioms and techniques can be found in Python 2, e.g. backporting the bytes means from Python 3 so you have semantic parity between your major models of Python. Modernize, however, is far more conservative and targets a Python 2/3 subset of Python, directly depending on six to simply help render compatibility. As Python 3 will be the future, it might be far better give consideration to Futurize to start adjusting to your latest ways that Python 3 introduces which you aren’t familiar with however.
No matter what which means you choose, they are going to update your laws to operate under Python 3 while remaining suitable for the form of Python 2 you going with. According to exactly how traditional you need to getting, you might want to operated the tool over their test collection initial and visually examine the diff to make sure the transformation try accurate. After you have altered your own examination collection and verified that every the exams nonetheless move needlessly to say, then you can certainly change mixxxer cena your application rule comprehending that any examinations which fail try a translation problem.
Unfortuitously the various tools are unable to automate every thing to create your own rule work under Python 3 and thus you’ll find a number of items you will need to upgrade manually to have complete Python 3 help (which of these tips are essential fluctuate between your methods). Browse the documents for the means you decide to use to see just what they fixes automagically and exactly what it may do optionally to understand what will (not) become fixed obtainable and what you may need to fix independently (e.g. making use of io.open() within the integral open() purpose try off automagically in Modernize). Thankfully, though, there are just a few things to take into consideration which can be considered big problems that might challenging debug if not seen for.