#shell #running #utility #install #api-bindings

pshell

Works out if this is running from inside a shell, and if so, which one

13 stable releases

1.0.14 Feb 5, 2025
1.0.12 Feb 17, 2024
1.0.11 Dec 21, 2023
1.0.10 May 21, 2023
1.0.1 Apr 13, 2022

#717 in Filesystem

Download history 101/week @ 2025-02-12 43/week @ 2025-02-19 33/week @ 2025-02-26 96/week @ 2025-03-05 22/week @ 2025-03-12 6/week @ 2025-03-19 73/week @ 2025-03-26 51/week @ 2025-04-02 19/week @ 2025-04-09 17/week @ 2025-04-16 6/week @ 2025-04-23 8/week @ 2025-04-30 31/week @ 2025-05-07 52/week @ 2025-05-14 63/week @ 2025-05-21 40/week @ 2025-05-28

187 downloads per month
Used in bookmark-cd

Apache-2.0

12KB

pshell

Crates.io Crates.io Build Status docs.rs dependency status

pshell answers the question "Is my application running in a shell, and if so, which one?".

Example: you are installing something and want to make changes to the shell and you want to know what changes are required to which shell script.

Usage

Just a simple function that tells you whether the application is run from inside a shell:

use pshell;

fn main() {
    // `find` returns the name of the shell in a string and the pid as a u32
    let (sh, pid) = pshell::find().unwrap_or(("unknown".to_string(), 0));
    println!("This application has been run from pid `{}`, which is a {} shell", pid, sh);
}

To try this out, and check it works OK on your OS/shell combination run the following from your shell:

cargo run --example what_shell

Why should you use this crate?

It is a small, simple crate that adds very little to your application size for discovering what shell this is running under by inspecting the name of the parent processes against a limited list of known shells.

Why should you not use this crate?

You want an all-singing, all-dancing crate that identifies any knowns shell.

Contribute

I have created a list of shells where this could be run from, it is not exhaustive, if your shell is not supported, feel free to raise an issue or a PR.

Dependencies

~1MB
~18K SLoC