repository·master·Indexed 20 days ago
https://github.com/dvarrazzo/py-setproctitleA Python C extension that allows processes and threads to customize their titles as displayed in system monitoring tools like ps, top, and htop. Supports GNU/Linux, BSD, MacOS X, and Windows. Provides APIs for setting and getting process and thread titles, and configurable behavior via SPT_NOENV and SPT_DEBUG environment variables.
The module is compatible with the following platforms:
Process Explorer rather than changing a process string.)To install setproctitle, use pip. Because this is a C extension, you must have a C compiler and Python development headers (e.g., python-dev or python3-dev on Linux) installed on your system before running the installation command.
pip install setproctitleYou can customize the behavior of the setproctitle module using the following environment variables:
| Variable | Description |
|---|---|
SPT_NOENV | If set to any non-empty value, the module avoids clobbering /proc/PID/environ. Note that this limits the maximum title length to the length of the command line. |
SPT_DEBUG | If set to any non-empty value, the module prints debug information to stderr. Most useful information is printed during module import. |
The setproctitle module allows you to change how your process and its threads appear in system monitoring tools like ps, top, or htop.
Important: Import and use the module as early as possible in your program's lifecycle. Writing environment variables later in your code may interfere with the module's initialization.
setproctitle(title): Sets the title for the current process.getproctitle(): Returns the current process title.setthreadtitle(title): Sets the title for the current thread.getthreadtitle(): Returns the current thread title.import setproctitle
# Set and get process title
setproctitle.setproctitle("my_custom_process_name")
print(setproctitle.getproctitle())
# Set and get thread title
setproctitle.setthreadtitle("my_worker_thread")
print(setproctitle.getthreadtitle())