pythonfinder

A cross-platform python discovery tool to help locate python on any system.

These details have not been verified by PyPI

Project links

Homepage

Project description

https://img.shields.io/pypi/v/pythonfinder.svg

https://img.shields.io/pypi/l/pythonfinder.svg

https://img.shields.io/pypi/pyversions/pythonfinder.svg

https://img.shields.io/badge/Say%20Thanks-!-1EAEDB.svg

Installation

Install from PyPI:

$ pipenv install --pre pythonfinder

Install from Github:

$ pipenv install -e git+https://github.com/sarugaku/pythonfinder.git#egg=pythonfinder

Usage

Using PythonFinder is easy. Simply import it and ask for a python:

>>> from pythonfinder.pythonfinder import PythonFinder
>>> PythonFinder.from_line('python3')
'/home/techalchemy/.pyenv/versions/3.6.5/python3'

>>> from pythonfinder import Finder
>>> f = Finder()
>>> f.find_python_version(3, minor=6)
PathEntry(path=PosixPath('/home/hawk/.pyenv/versions/3.6.5/bin/python'), _children={}, is_root=False, only_python=False, py_version=PythonVersion(major=3, minor=6, patch=5, is_prerelease=False, is_postrelease=False, is_devrelease=False, version=<Version('3.6.5')>, architecture='64bit', comes_from=PathEntry(path=PosixPath('/home/hawk/.pyenv/versions/3.6.5/bin/python'), _children={}, is_root=True, only_python=False, py_version=None, pythons=None), executable=None), pythons=None)

>>> f.find_python_version(2)
PathEntry(path=PosixPath('/home/hawk/.pyenv/shims/python2'), _children={}, is_root=False, only_python=False, py_version=PythonVersion(major=2, minor=7, patch=15, is_prerelease=False, is_postrelease=False, is_devrelease=False, version=<Version('2.7.15')>, architecture='64bit', comes_from=PathEntry(path=PosixPath('/home/hawk/.pyenv/shims/python2'), _children={}, is_root=True, only_python=False, py_version=None, pythons=None), executable=None), pythons=None)

PythonFinder can even find beta releases!

>>> f.find_python_version(3, minor=7)
PathEntry(path=PosixPath('/home/hawk/.pyenv/versions/3.7.0b1/bin/python'), _children={}, is_root=False, only_python=False, py_version=PythonVersion(major=3, minor=7, patch=0, is_prerelease=True, is_postrelease=False, is_devrelease=False, version=<Version('3.7.0b1')>, architecture='64bit', comes_from=PathEntry(path=PosixPath('/home/hawk/.pyenv/versions/3.7.0b1/bin/python'), _children={}, is_root=True, only_python=False, py_version=None, pythons=None), executable=None), pythons=None)

>>> f.which('python')
PathEntry(path=PosixPath('/home/hawk/.pyenv/versions/3.6.5/bin/python'), _children={}, is_root=False, only_python=False, py_version=PythonVersion(major=3, minor=6, patch=5, is_prerelease=False, is_postrelease=False, is_devrelease=False, version=<Version('3.6.5')>, architecture='64bit', comes_from=PathEntry(path=PosixPath('/home/hawk/.pyenv/versions/3.6.5/bin/python'), _children={}, is_root=True, only_python=False, py_version=None, pythons=None), executable=None), pythons=None)

Windows Support

PythonFinder natively supports windows via both the PATH environment variable and PEP-514 compliant finder which comes by default with python 3. Usage on windows becomes:

>>> from pythonfinder import Finder
>>> f = Finder()
>>> f.find_python_version(3, minor=6)
PythonVersion(major=3, minor=6, patch=4, is_prerelease=False, is_postrelease=False, is_devrelease=False, version=<Version('3.6.4')>, architecture='64bit', comes_from=PathEntry(path=WindowsPath('C:/Program Files/Python36/python.exe'), _children={}, is_root=False, only_python=True, py_version=None, pythons=None), executable=WindowsPath('C:/Program Files/Python36/python.exe'))

>>> f.find_python_version(3, minor=7, pre=True)
PythonVersion(major=3, minor=7, patch=0, is_prerelease=True, is_postrelease=False, is_devrelease=False, version=<Version('3.7.0b5')>, architecture='64bit', comes_from=PathEntry(path=WindowsPath('C:/Program Files/Python37/python.exe'), _children={}, is_root=False, only_python=True, py_version=None, pythons=None), executable=WindowsPath('C:/Program Files/Python37/python.exe'))

>>> f.which('python')
PathEntry(path=WindowsPath('C:/Python27/python.exe'), _children={}, is_root=False, only_python=False, py_version=None, pythons=None)

Finding Executables

PythonFinder also provides which functionality across platforms, and it uses lazy loading and fast-returns to be performant at this task.

>>> f.which('cmd')
PathEntry(path=WindowsPath('C:/windows/system32/cmd.exe'), _children={}, is_root=False, only_python=False, py_version=None, pythons=None)

>>> f.which('code')
PathEntry(path=WindowsPath('C:/Program Files/Microsoft VS Code/bin/code'), _children={}, is_root=False, only_python=False, py_version=None, pythons=None)

 >>> f.which('vim')
PathEntry(path=PosixPath('/usr/bin/vim'), _children={}, is_root=False, only_python=False, py_version=None, pythons=None)

>>> f.which('inv')
PathEntry(path=PosixPath('/home/hawk/.pyenv/versions/3.6.5/bin/inv'), _children={}, is_root=False, only_python=False, py_version=None, pythons=None)

Architecture support

PythonFinder supports architecture specific lookups on all platforms (coming soon):

Integrations

Project details

These details have not been verified by PyPI

Project links

Homepage

Release history Release notifications | RSS feed

2.1.0

Jan 28, 2024

2.0.7.dev0 pre-release

Jan 28, 2024

2.0.6

Oct 20, 2023

2.0.5

Jul 23, 2023

2.0.4

May 31, 2023

2.0.3

May 19, 2023

2.0.2

May 19, 2023

2.0.1

May 17, 2023

2.0.0

May 6, 2023

1.3.2

Feb 6, 2023

1.3.1

Aug 24, 2022

1.2.11.dev0 pre-release

Aug 24, 2022

1.2.10

Feb 19, 2022

1.2.9

Nov 8, 2021

1.2.8

Jul 27, 2021

1.2.7

Jun 24, 2021

1.2.6

Apr 1, 2021

1.2.5

Aug 27, 2020

1.2.4

Jun 1, 2020

1.2.3

Apr 21, 2020

1.2.2

Mar 25, 2020

1.2.1

May 14, 2019

1.2.0

Mar 3, 2019

1.1.10

Nov 22, 2018

1.1.9.post1

Nov 14, 2018

1.1.9

Nov 14, 2018

1.1.8

Nov 12, 2018

1.1.7

Nov 4, 2018

1.1.6

Oct 26, 2018

1.1.5

Oct 25, 2018

1.1.4

Oct 25, 2018

1.1.3.post1

Oct 24, 2018

1.1.3

Oct 18, 2018

1.1.2

Oct 12, 2018

This version

1.1.1

Oct 11, 2018

1.1.0

Oct 6, 2018

1.0.2

Aug 16, 2018

1.0.1

Aug 1, 2018

1.0.0

Jul 25, 2018

0.1.2

Jun 5, 2018

0.1.1

Jun 5, 2018

0.1.0

Jun 3, 2018

0.0.5

Apr 27, 2018

0.0.4

Apr 27, 2018

0.0.3

Apr 27, 2018

0.0.2.dev2 pre-release

Apr 9, 2018

0.0.2.dev1 pre-release

Apr 9, 2018

0.0.2.dev0 pre-release

Apr 9, 2018

0.0.1.dev3 pre-release

Apr 9, 2018

0.0.1.dev2 pre-release

Apr 8, 2018

0.0.1.dev1 pre-release

Apr 7, 2018

0.0.1.dev0 pre-release

Apr 7, 2018

Download files

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

Source Distribution

pythonfinder-1.1.1.tar.gz (25.4 kB view details)

Uploaded Oct 11, 2018 Source

Built Distribution

pythonfinder-1.1.1-py2.py3-none-any.whl (24.2 kB view details)

Uploaded Oct 11, 2018 Python 2 Python 3

File details

Details for the file pythonfinder-1.1.1.tar.gz.

File metadata

Download URL: pythonfinder-1.1.1.tar.gz
Upload date: Oct 11, 2018
Size: 25.4 kB
Tags: Source
Uploaded using Trusted Publishing? No
Uploaded via: twine/1.12.1 pkginfo/1.4.2 requests/2.19.1 setuptools/40.2.0 requests-toolbelt/0.8.0 tqdm/4.25.0 CPython/3.7.0

File hashes

Hashes for pythonfinder-1.1.1.tar.gz
Algorithm	Hash digest
SHA256	`58cbeccc36f318230c395af7056635207e4509e26e55fe09fff9ad3f6e6f25c2`
MD5	`0fa0203bd4a4e0ce374531fdd81077a6`
BLAKE2b-256	`d49f4bc068741d16eadcd9a2c057e6b0232fad706cbbd26fdd37537787048904`

See more details on using hashes here.

File details

Details for the file pythonfinder-1.1.1-py2.py3-none-any.whl.

File metadata

Download URL: pythonfinder-1.1.1-py2.py3-none-any.whl
Upload date: Oct 11, 2018
Size: 24.2 kB
Tags: Python 2, Python 3
Uploaded using Trusted Publishing? No
Uploaded via: twine/1.12.1 pkginfo/1.4.2 requests/2.19.1 setuptools/40.2.0 requests-toolbelt/0.8.0 tqdm/4.25.0 CPython/3.7.0

File hashes

Hashes for pythonfinder-1.1.1-py2.py3-none-any.whl
Algorithm	Hash digest
SHA256	`c07f321d0a3bf5bac6df80afdf059eb60eab2268081e1c8ffed02e62bcdb803e`
MD5	`7ca3aadd89a692e43cc7e539958176e8`
BLAKE2b-256	`5d0e894980124d0f85f4fccc715306f6df5bd395dee45a79fdbfd1a2388a262c`