In your document you should have the appropriate trove classifier specifying what versions of Python your supporting. Since your task doesn’t supporting Python 3 yet you really need to no less than bring program coding language :: Python :: 2 :: just specified. Preferably it’s also advisable to indicate each major/minor form of Python that you carry out service, e.g. Programming Language :: Python :: 2.7 .
Posses close examination coverageA¶
After you’ve the signal giving support to the eldest form of Python 2 you need they to, you will need to ensure your test collection have good plans. An effective rule of thumb is that if you wish to become positive enough within examination package that any downfalls that appear after having tools rewrite your own laws become actual insects when you look at the apparatus and not within laws. If you prefer lots to try to get, you will need to conquer 80per cent coverage (plus don’t become bad if mobifriends nГЎvЕЎtД›vnГkЕЇ you learn it tough attain a lot better than 90percent coverage). Unless you actually have something to measure test protection then is preferred.
After you have their laws well-tested you are ready to start porting your signal to Python 3! But to totally know how your own laws could changes and what you need to look out for while you rule, you will need to find out what changes Python 3 produces with respect to Python 2. usually the two top methods for doing definitely checking out the a€?what is actually Newa€? doctor for each discharge of Python 3 together with Porting to Python 3 book (that will be free online). Additionally there is a handy cheat piece from Python-Future project.
Update your codeA¶
After you feel just like do you know what differs in Python 3 versus Python 2, you have to update your signal! You’ve got a choice between two tools in porting their laws immediately: Futurize and Modernize. Which means you select depends on how much like Python 3 you need your rule getting. Futurize do their far better create Python 3 idioms and methods exist in Python 2, e.g. backporting the bytes sort from Python 3 so you have semantic parity between your major versions of Python. Modernize, however, is more conservative and targets a Python 2/3 subset of Python, straight depending on six to assist provide compatibility. As Python 3 may be the future, it may be best to see Futurize to begin adjusting to virtually any newer procedures that Python 3 introduces that you commonly used to yet.
Aside from which appliance you select, they’ll update your signal to perform under Python 3 while keeping compatible with the form of Python 2 your begun with. Dependent on just how traditional you should end up being, you may want to run the instrument over their examination suite very first and aesthetically inspect the diff to be certain the change are precise. Once you’ve transformed the test collection and verified that every the studies nevertheless go needlessly to say, then you can certainly convert the application signal with the knowledge that any assessments which do not succeed are a translation breakdown.
Unfortunately the various tools can not automate every thing to create the laws operate under Python 3 and so you’ll find a few things you should revise by hand to get complete Python 3 help (which of the tips are important vary involving the apparatus). Check the records for all the instrument you choose to used to see what they fixes automatically and exactly what it is capable of doing optionally to know what will (not) getting fixed for your needs and what you may need to correct on your own (e.g. utilizing io.open() during the integrated open() features are down by default in Modernize). Thankfully, however, there are just a couple of things to take into consideration that is certainly regarded as big issues that is hard to debug if not saw for.
