Skip to main content
Help us improve PyPI by participating in user testing. All experience levels needed!

Detect OS/platforms

Project description

A platform detection library for Python. It uses various methods to attempt to determine the operating system, distribution, release, version, etc., to aid callers in making platform-specific decisions.

lionshead was originally written for “platform-specific wheels” that were a solution to the Linux wheel problem before the creation of manylinux. Rather than be wasted effort, it’s been spun in to a separate library (which would’ve been necessary anyway to be consumed by both pip and wheel).

The development repository can be found at https://github.com/natefoo/lionshead

Documentation is available at http://lionshead.readthedocs.io

The package is published to PyPI at https://pypi.python.org/pypi/lionshead

Quick start

On Debian stretch/sid:

>>> from lionshead import *
>>> get_specific_platform()
SpecificPlatform(dist='debian', major_vers='stretch/sid', full_vers='stretch/sid', stability='unstable')
>>> get_specific_platform_string()
'debian-stretch_sid'
>>> get_platform_stability_string()
'unstable'

On CentOS 7:

>>> from lionshead import *
>>> get_specific_platform()
SpecificPlatform(dist='centos', major_vers='7', full_vers='7', stability='stable')
>>> get_specific_platform_string()
'centos-7'
>>> get_platform_stability_string()
'stable'

Installation of the module also installs lionshead-platform and lionshead-stability commands that return the output of get_specific_platform_string and get_platform_stability_string, respectively.

FAQ

How can I help?

See if your OS/distribution is listed and/or correct in this gist, and if not, follow the instructions and create an issue with your findings.

Does this work on anything other than Linux?

Not currently, but as an avid illumos fan, I plan to add support for other operating systems such as illumos and the BSDs. Here’s the data collection I did for Ansible’s illumos detection to get started.

What is a “stable” vs. “unstable” platform?

“Stable” platforms are operating system releases which commit to a defined, non-changing ABI for the lifetime of the release. This means that the ABI remains consisntent even after OS updates (this typically means that all software is maintained at a specific version). Examples of “stable” releases include:

  • Red Hat Enterprise Linux and derivatives
  • Ubuntu
  • Debian (stable and past stable releases)
  • SUSE Linux Enterprise Server
  • openSUSE (releases)

Conversely, “unstable” platforms are operating systems that use a “rolling release” model where software versions can change with each OS update. Examples of “unstable” releases include:

  • Debian (testing/sid)
  • openSUSE (tumbleweed)
  • Arch

What’s with the name?

The name is a reference to Indiana Jones and the Last Crusade, specifically the scene where Indy takes the “leap of faith” on to the invisible bridge in the Temple of the Sun.

“Only in the leap from the lion’s head will he prove his worth.”

The leap detects the (presence of the) platform underneath… get it? ;P

Code of Conduct

Everyone interacting in the lionshead project’s codebases, issue trackers, chat rooms, and mailing lists is expected to follow the PyPA Code of Conduct.

History

0.1.1 (2017-01-07)

  • Fix detection of Amazon Linux

0.1 (2017-01-03)

  • Yanked platform module out of my pip/wheel forks and adapted as a standalone module for initial version.
  • Wrote a bit of documentation.

Project details


Release history Release notifications

This version
History Node

0.1.1

History Node

0.1

Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date
lionshead-0.1.1-py2-none-any.whl (10.0 kB) Copy SHA256 hash SHA256 Wheel py2 Jan 7, 2017
lionshead-0.1.1.tar.gz (6.7 kB) Copy SHA256 hash SHA256 Source None Jan 7, 2017

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page