A small wrapper around lib2to3 to help write Python 3 compatible code.
Project description
py3kwarn is a small wrapper around lib2to3 to help write Python3 compatible code. It provides flake8-style warning messages.
See the lib2to3 documentation for information on warning messages.
Pull requests are welcome!
Installation
Supports Python 2.6, 2.7, and 3.3+
$ pip install py3kwarn
…or to install from the git repository:
$ pip install -e git+git://github.com/liamcurry/py3kwarn.git#egg=py3kwarn
Usage with vim
You can use py3kwarn with syntastic. If you want to use py3kwarn with another syntax checker (like flake8), then you will have to add this to your vim config:
let g:syntastic_python_checkers=['flake8', 'py3kwarn']
Usage from the command line
$ py3kwarn example.py example.py:2:1: PY3K (FixApply) apply(hello, args, kwargs) -> hello(*args, **kwargs) example.py:5:1: PY3K (FixBasestring) basestring -> str example.py:11:1: PY3K (FixCallable) callable('hello') -> isinstance('hello', collections.Callable) example.py:14:1: PY3K (FixDict) d.keys() -> list(d.keys()) example.py:15:1: PY3K (FixDict) d.iteritems(); -> iter(d.items()); example.py:16:1: PY3K (FixDict) d.viewvalues(); -> d.values(); example.py:19:1: PY3K (FixExcept) try:import asdf;except E, T:pass; -> try:import asdf;except E as T:pass; example.py:25:1: PY3K (FixExec) exec code in ns1, ns2; -> exec(code, ns1, ns2); example.py:28:1: PY3K (FixExecfile) execfile('test.py') -> exec(compile(open('test.py').read(), 'test.py', 'exec')) example.py:31:1: PY3K (FixFilter) filter(lambda x: x, [1, 2, 3]) -> [x for x in [1, 2, 3] if x] example.py:41:1: PY3K (FixFuture) from __future__ import absolute_import -> example.py:44:1: PY3K (FixHasKey) d.has_key('foobar') -> 'foobar' in d example.py:56:1: PY3K (FixInput) input('FixInput') -> eval(input('FixInput')) example.py:59:1: PY3K (FixIntern) intern(s) -> sys.intern(s)
Testing
Testing can be done with make test. py3kwarn also supports tox, which assumes pythonbrew is installed. This enables quickly testing changes in many versions of python. Take a look at the tox.ini file for more details.
Contributing
To contribute, fork the repo and clone to your local machine.
Create a virtual environment and
pip install -r requirements_dev.txt
Then just make a pull request with the issues you’ve fixed!
TODO
Friendlier messages.
Use argparse to add smarter options.
Flags to ignore certain errors
Compatibility mode, where warning messages provide suggestions to write forwards compatible code. Make this the default.
Make it faster. Right now it is quite slow compared to other syntax checkers. Major refactoring may be necessary.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
File details
Details for the file py3kwarn-0.2.3.tar.gz
.
File metadata
- Download URL: py3kwarn-0.2.3.tar.gz
- Upload date:
- Size: 89.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | a92c1dfcd2cd5b29f960607eef5de9ca08cfbab02f17ab1e28933c68cc9eddc7 |
|
MD5 | a78cb83a321c01f0ba3bfddc5ec3de8c |
|
BLAKE2b-256 | 47357e03588eb6d89ed22afa8049d87aca7df57488b6a1d3df161af25150c6d6 |