Skip to main content

Determine what projects are blocking you from porting to Python 3

Project description

This script takes in a set of dependencies and then figures out which of them are holding you up from porting to Python 3.

Command-line/Web Usage

You can specify your dependencies in multiple ways:

caniusepython3 -r requirements.txt test-requirement.txt
caniusepython3 -m PKG-INFO
caniusepython3 -p numpy scipy ipython
# If your project's setup.py uses setuptools ...
python setup.py caniusepython3

The output of the script will tell you how many (implicit) dependencies you need to transition to Python 3 in order to allow you to make the same transition. It will also list what projects have no dependencies blocking their transition so you can ask them to start a port to Python 3.

If you prefer a web interface you can use https://caniusepython3.com by Jannis Leidel.

Integrating With Your Tests

If you want to check for Python 3 availability as part of your tests, you can use icanusepython3.check():

def check(requirements_paths=[], metadata=[], projects=[]):
    """Return True if all of the specified dependencies have been ported to Python 3.

    The requirements_paths argument takes a sequence of file paths to
    requirements files. The 'metadata' argument takes a sequence of strings
    representing metadata. The 'projects' argument takes a sequence of project
    names.

    Any project that is not listed on PyPI will be considered ported.
    """

You can then integrate it into your tests like so:

import unittest

import caniusepython3


class DependenciesOnPython3(unittest.TestCase):

def test_dependencies(self):
  # Will begin to fail when dependencies are no longer blocking you
  # from using Python 3.
  self.assertFalse(caniusepython3.check(projects=['ipython']))

For the change log, how to tell if a project has been ported, as well as help on how to port a project, please see the project website.

Secret, bonus feature

If you would like to use a different name for the script and setuptools command then set the environment variable CIU_ALT_NAME to what you would like the alternative name to be. Reddit suggests “icanhazpython3”.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

caniusepython3-2.0.1.tar.gz (14.1 kB view details)

Uploaded Source

Built Distribution

caniusepython3-2.0.1-py2.py3-none-any.whl (23.6 kB view details)

Uploaded Python 2 Python 3

File details

Details for the file caniusepython3-2.0.1.tar.gz.

File metadata

File hashes

Hashes for caniusepython3-2.0.1.tar.gz
Algorithm Hash digest
SHA256 a58a31bad6633b28a327913df8ab8364e789c0b00e59a1d445195b40eb21728e
MD5 50b68f1ca0cdde6a75044951ce1cf317
BLAKE2b-256 94cfdc4e292c04aab89a370d73cf2211efb79375bc361210d030512e700386bd

See more details on using hashes here.

Provenance

File details

Details for the file caniusepython3-2.0.1-py2.py3-none-any.whl.

File metadata

File hashes

Hashes for caniusepython3-2.0.1-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 5249c26dfe46e0e77ff9fe732c2dc9db4f04a9caca59abd42a890491c4908cec
MD5 201c60b0cadf17d3615c9eb5ee952225
BLAKE2b-256 d6ace157261d3115e6b756c0e68b95f638eeb20436fa360e0fca0a3e70b17a8b

See more details on using hashes here.

Provenance

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page