To help you get started, we've collected the most common ways that shellingham is being used within popular public projects.

sarugaku / shellingham / tests / test_ps.py View on Github

F S UID      PID     PPID   C PRI NI ADDR  SZ  RSS   WCHAN    TTY  TIME CMD
240001 A 203 14549132  8192226   1  60 20 96aaf7590 2620 2552          pts/0  0:00 -bash
200001 A 203  6384118 14549132   3  61 20 8aaeeb590 1440 1468          pts/0  0:00 ps wwl
    """,    # noqa
    """\
     F S      UID    PID   PPID   C PRI NI ADDR  SZ  RSS   WCHAN    TTY  TIME CMD
240000 A      105 932687 932686   0  20 20    0 7516    0          pts/0  0:00 -bash
200000 A      105 932807 932687   0  20 20    0 16504    0          pts/0  0:00 python3
200000 A      105 932808 932807   0  20 20    0 6792    0          pts/0  0:00 ps wwl
    """,    # noqa
]

PS_EXPECTED = [
    {
        '90585': Process(pid='90585', ppid='90584', args=('-bash',)),
        '96095': Process(pid='96095', ppid='90585', args=('pbcopy',)),
        '82490': Process(pid='82490', ppid='82489', args=('-bash',)),
        '82557': Process(pid='82557', ppid='82556', args=('-bash',)),
    },
    {
        '14549132': Process(pid='14549132', ppid='8192226', args=('-bash',)),
        '6384118': Process(pid='6384118', ppid='14549132', args=('ps', 'wwl')),
    },
    {
        '932687': Process(pid='932687', ppid='932686', args=('-bash',)),
        '932807': Process(pid='932807', ppid='932687', args=('python3')),
        '932808': Process(pid='932808', ppid='932807', args=('ps', 'wwl')),
    },
]


@pytest.mark.parametrize(

View more ways to use shellingham

Shellingham: Tool to Detect Surrounding Shell

Shellingham detects what shell the current Python executable is running in.

Usage

>>> import shellingham
>>> shellingham.detect_shell()
('bash', '/bin/bash')

detect_shell pokes around the process's running environment to determine what shell it is run in. It returns a 2-tuple:

• The shell name, always lowercased.
• The command used to run the shell.

ShellDetectionFailure is raised if detect_shell fails to detect the surrounding shell.

Notes

• The shell name is always lowercased.
• On Windows, the shell name is the name of the executable, minus the file extension.

Notes for Application Developers

Remember, your application's user is not necessarily using a shell. Shellingham raises ShellDetectionFailure if there is no shell to detect, but your application should almost never do this to your user.

A practical approach to this is to wrap detect_shell in a try block, and provide a sane default on failure

try:
    shell = shellingham.detect_shell()
except shellingham.ShellDetectionFailure:
    shell = provide_default()

There are a few choices for you to choose from.

• The POSIX standard mandates the environment variable SHELL to refer to "the user's preferred command language interpreter". This is always available (even if the user is not in an interactive session), and likely the correct choice to launch an interactive sub-shell with.
• A command sh is almost guaranteed to exist, likely at /bin/sh, since several POSIX tools rely on it. This should be suitable if you want to run a (possibly non-interactive) script.
• All versions of DOS and Windows have an environment variable COMSPEC. This can always be used to launch a usable command prompt (e.g. cmd.exe on Windows).

Here's a simple implementation to provide a default shell

import os

def provide_default():
    if os.name == 'posix':
        return os.environ['SHELL']
    elif os.name == 'nt':
        return os.environ['COMSPEC']
    raise NotImplementedError(f'OS {os.name!r} support not available')