/usr/lib/python3/dist-packages/sixer-1.6.egg-info/PKG-INFO is in sixer 1.6-2.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 340 341 342 343 344 345 346 347 348 349 350 351 352 353 354 355 356 357 358 359 360 361 362 363 364 365 366 367 368 369 370 371 372 373 374 375 376 377 378 379 380 381 382 383 384 385 386 387 388 389 390 391 392 393 394 395 396 397 398 399 400 401 | Metadata-Version: 1.1
Name: sixer
Version: 1.6
Summary: Add Python 3 support to Python 2 applications using the six module.
Home-page: https://github.com/haypo/sixer
Author: Victor Stinner
Author-email: victor.stinner@gmail.com
License: Apache License 2.0
Description: Sixer
=====
sixer is a tool adding Python 3 support to a Python 2 project. It was written
to produces patches to port OpenStack to Python 3. It is focused on supporting
Python 2.7 and 3.4.
It uses basic regular expressions to find code which needs to be modified. It
emits warnings when code was not patched or looks suspicious.
* `sixer project at Github
<https://github.com/haypo/sixer>`_ (source, bug tracker)
* `sixer in the Python Cheeseshop (PyPI)
<https://pypi.python.org/pypi/sixer>`_
See also the `six module documentation <https://pythonhosted.org/six/>`_.
Usage
-----
::
sixer.py [--write] [options] <all|operation1[,operation2,...]> <directories or filenames>
sixer.py displays the name of patched files. It displays warnings for
suspicious code which may have to be ported manually.
The first parameter can be a list of operations separated by commas. Use
``"all"`` to apply all operations. Operation prefixed by ``-`` are excluded.
For example, ``"all,-iteritems"`` applies all operations except ``iteritems``.
For directories, sixer.py searchs for ``.py`` files in all subdirectories.
By default, sixer uses a dry run: files are not modified. Add ``--write`` (or
``-w``) option to modify files in place. It's better to use sixer in a project
managed by a source control manager (ex: git) to see differences and revert
unwanted changes. The original files are not kept.
Use ``--help`` to see all available options.
See below for the list of available operations.
Operations
----------
- ``all``:
* combine all operations all together
- ``basestring``:
* replace ``basestring`` with ``six.string_types``,
add ``import six``
- ``dict0``:
* replace ``dict.keys()[0]`` with ``list(dict.keys())[0]``
* same for ``dict.values()[0]`` and ``dict.items()[0]``
* note: the pattern matches any integer index, not only ``0``
- ``dict_add``:
* replace ``dict.keys() + list2`` with ``list(dict.keys()) + list2``
* same for ``dict.values() + list2`` and ``dict.items() + list2``
- ``except``:
* Replace ``except ValueError, exc:`` with ``except ValueError as exc:``
* Replace ``except (TypeError, ValueError), exc:`` with
``except (TypeError, ValueError) as exc:``
- ``has_key``:
* Replace ``dict.has_key(key)`` with ``key in dict``
- ``iteritems``:
* replace ``dict.iteritems()`` with ``six.iteritems(dict)``,
add ``import six``
- ``itervalues``:
* replace ``dict.itervalues()`` with ``six.itervalues(dict)``,
add ``import six``
- ``iterkeys``:
* Replace ``for key in dict.iterkeys():`` with ``for key in dict:``
* Replace ``dict.iterkeys()`` with ``six.iterkeys(dict)``,
add ``import six``
- ``itertools``:
* replace ``itertools.ifilter`` with ``six.moves.filter``,
add ``import six``
* similar change for ``ifilterfalse()``, ``imap()``, ``izip()`` and
``izip_longest()`` of the ``itertools`` module
- ``long``:
* replace ``123L`` with ``123`` (decimal)
* replace ``0xABl`` with ``0xAB`` (hexadecimal)
* replace ``0600L`` with ``0o600`` (octal)
* replace ``(int, long)`` with ``six.integer_types``
* replace ``long(1)`` with ``1``
- ``next``:
* replace ``iter.next()`` with ``next(iter)``
- ``print``:
* Replace ``print msg`` with ``print(msg)``
* Replace ``print msg,`` with ``print(msg, end=' ')``
and add ``from __future__ import print_function`` import
* Replace ``print`` with ``print()``
and add ``from __future__ import print_function`` import
* Replace ``print >>sys.stderr, "hello"'``
with ``print("hello", file=sys.stderr)``
and add ``from __future__ import print_function`` import
- ``raise``:
* replace ``raise exc[0], exc[1], exc[2]``
with ``six.reraise(*exc)``, add ``import six``
* replace ``raise exc_type, exc_value, exc_tb``
with ``six.reraise(exc_type, exc_value, exc_tb)``, add ``import six``
* replace ``raise exc, msg`` with ``raise exc(msg)``, add ``import six``
- ``six_moves``:
* replace Python 2 imports with imports from ``six.moves``,
add ``import six``. Python 2 modules:
- ``BaseHTTPServer``
- ``ConfigParser``
- ``Cookie``
- ``HTMLParser``
- ``Queue``
- ``SimpleHTTPServer``
- ``SimpleXMLRPCServer``
- ``__builtin__``
- ``cPickle``
- ``cookielib``
- ``htmlentitydefs``
- ``httplib``
- ``repr``
- ``xmlrpclib``
* replace Python 2 functions with ``six.moves.<function>``,
add ``import six``. Python 2 functions:
- ``raw_input()``
- ``reduce()``
- ``reload()``
* replace ``unichr()`` with ``six.unichr()``, add ``import six``
- ``string``:
* replace ``string.xxx(str, ...)`` with ``str.xxx(...)`` where ``.xxx``
is a string method. For example, replace ``string.upper("abc")`` with
``"abc".upper()``.
* replace ``string.atof(str)`` with ``float(str)``
* replace ``string.atoi(str)`` and ``string.atol(str)`` with ``int(str)``
- ``stringio``:
* replace ``StringIO.StringIO`` with ``six.StringIO``,
add ``import six``
* replace ``cStringIO.StringIO`` with ``moves.cStringIO``,
add ``from six import moves``
* replace ``from StringIO import StringIO`` with ``from six import StringIO``
* replace ``from cStringIO import StringIO``
with ``from six.moves import cStringIO as StringIO``
* later you may have to replace it with ``six.BytesIO`` (or ``io.BytesIO``
if you don't support Python 2.6) when bytes are expected on Python 3
- ``unicode``:
* replace ``unicode`` with ``six.text_type``, add ``import six``
* replace ``(str, unicode)`` with ``six.string_types``, add ``import six``
- ``urllib``:
* replace Python 2 urllib and urllib2 with ``six.moves.urllib``,
add ``import six``
- ``xrange``:
* replace ``xrange()`` with ``range()`` and
add ``from six.moves import range``
* don't add the import if all ranges have 1024 items or less
Installation
------------
To install sixer, type::
pip3 install sixer
sixer requires Python 3, it doesn't work on Python 2.
Adding the six import
---------------------
When an operation uses ``six``, ``import six`` may be added. sixer repects
OpenStack coding style rules to add the import: imports grouped by standard
library, third party and application imports; and imports must be are sorted.
Limitations
-----------
Since the project is implemented with regular expressions, it can produce false
positives (invalid changes). For example, some operations replace patterns in
strings, comments or function names even if it doesn't make sense.
Try also the 2to6 project which may be more reliable.
Tests
-----
To run tests, type ``tox``. Type ``pip install -U tox`` to install or update
the ``tox`` program.
Or run tests manually: type ``python3 tests.py``.
Resources to port code to Python 3
----------------------------------
* `six module documentation <https://pythonhosted.org/six/>`_
* `2to6 <https://github.com/limodou/2to6>`_
* `modernize <https://pypi.python.org/pypi/modernize>`_
* Python 3 porting book: `Language differences and workarounds
<http://python3porting.com/differences.html>`_
* `getpython3 <http://getpython3.com/>`_
Changelog
---------
* Version 1.6 (2016-07-25)
- ``dict0`` now also matches any integer index, not only ``0``
- ``long`` now also replaces ``long(1)`` with ``1``
* Version 1.5 (2016-05-30)
- six_moves: replace ``ConfigParser.ConfigParser`` with
``configparser.ConfigParser``, not with ``configparser.configparser``
- remove the ``octal`` operation, it produces too many false positives
* Version 1.4 (2016-03-11)
- display the name of applied operations in the final summary
- Issue #4: Don't emit warning on ``six.next()``
* Version 1.3 (2016-02-11)
- add ``string`` operation. For example, replace ``string.upper("abc")`` with
``"abc".upper()``.
- ``print`` now also replaces ``print >>sys.stderr, "hello"'``
with ``print("hello", file=sys.stderr)``
* Version 1.2 (2015-11-26)
- add ``octal`` operation: replace ``0123`` with ``0o123``
- add ``print`` operation: replace ``print msg`` with ``print(msg)``,
handle also other print statements (but not all of them yet)
- add ``has_key`` operation: replace ``dict.has_key(key)``
with ``key in dict``
- ``long`` now also handles octal and hexadecimal numbers. For example,
``0xffL`` is replaced with ``0xff``, and ``0600l`` is replace with
``0o600``.
- ``except`` now handles also exception with dots
(ex: ``except select.error, exc:``)
- ``iterkeys`` now replaces ``for key in dict.iterkeys():`` with
``for key in dict:`` to avoid the usage of six.
- Enhance ``except`` and ``raise`` regex to match also expressions without
spaces after commas
* Version 1.1 (2015-10-22)
- add ``--third-party`` command line option
- emit a warning instead of failing with an error if we failed to find the
best place to add an import
- fix also code to detect third-party modules, don't check for the prefix
but the full name (ex: "numpypy" is not detected as third-party if only
"numpy" is known)
* Version 1.0 (2015-10-16)
- sixer doesn't modify files by default anymore. Add ``--write`` to really
modify files inplace.
- ``long`` operation now also replaces ``(int, long)`` with
``six.integer_types``
- ``itertools`` now also replaces ``ifilterfalse()``, ``izip()`` and
``izip_longest()`` of the ``itertools`` module
- ``six_moves`` now also replaces ``unichr(ch)`` with ``six.unichr(ch)``
- command line: it's now possible to exclude an operation using ``-`` prefix.
For example, ``all,-iteritems`` applies all operations except
``iteritems``.
* Version 0.8 (2015-10-03)
- urllib now emits a warning on unknown symbol, instead of raising an
exception
- Write warnings to stderr instead of stdout and exit with error code 1
if a filename doesn't exist or a directory doesn't contain any .py file
- ``unicode`` operation also replaces ``(str, unicode)`` with
``six.string_types``
- When removing an import, don't remove the empty line following the import
if the empty line is followed by a second import
- ``long`` also replaces ``1l`` (lower case L suffix for long numbers)
* Version 0.7 (2015-09-29)
- Add new ``dict0``, ``dict_add`` and ``except`` operations
- Add --app command line option to specify the Python module of the
application, to help sorting imports
- Code adding new imports respect better OpenStack coding style on imports.
For example, it adds two empty lines after imports, instead of a single
line.
- Display the name of the operation which modified files
- Display also the name of the operation in warnings
- ``six_moves`` now also patches ``reduce()`` and ``reload()``. For example,
``reduce()`` is replaced with ``six.moves.reduce()``.
- ``six_moves`` now also patches ``mock.patch()``. For example,
``with mock.patch('__builtin__.open'): ...`` is replaced with
``with mock.patch('six.moves.builtin.open'): ...``
- ``urllib`` now also replaces ``from ... import ...`` imports.
For example, ``from urllib import quote`` is replaced with
``from six.moves.urllib.parse import quote``.
* Version 0.6 (2015-09-11)
- Add "itertools" operation
- Fix xrange() regex to not modify "from six.moves import xrange" and
"moves.xrange(n)"
- Fix urllib for urllib or urlparse module get from the urllib2 module.
For example, ``urllib2.urlparse.urlparse`` (``import urllib2``) is now
replaced with ``urllib.parse.urlparse`` (``from six.moves import urllib``).
* Version 0.5 (2015-07-08)
- six_moves: support "import module as name" syntax and add cPickle module
- Add --to-stdout, --quiet and --max-range command line options
- Emit a warning if the directory does not contain any .py file or
if the path does not exist
- Test also directly the sixer.py program
* Version 0.4 (2015-06-09)
- sixer.py now accepts multiple filenames on the command line, but
operations becomes the first command line parameter
- the ``stringio`` operation now also replaces cStringIO and
``from StringIO import StringIO``
- urllib: replace also urlparse.symbol
- six_moves: support more modules: Cookie, HTMLParser, SimpleHTTPServer,
cookielib, xmlrpclib, etc.
- Refactor operations as classes to cleanup the code
* Version 0.3.1 (2015-05-27)
- Fix the "all" operation
- six_moves knows more modules
- urllib: add pathname2url, don't touch urllib2.parse_http_list()
* Version 0.3 (2015-05-27)
- First command line parameter can now be a filename
- Add "all", "basestring", "iterkeys", "six_moves", "stringio"
and "urllib" operations
- Enhance the knownledge tables for modules (stdlib, third parties,
applications)
- Ignore unparsable import lines when adding an import
* Version 0.2 (2015-05-12):
- First public release
Platform: UNKNOWN
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: Apache Software License
|