devstuff 2.5.0__tar.gz → 2.6.0__tar.gz

{devstuff-2.5.0 → devstuff-2.6.0}/CHANGELOG.md

@@ -1,3 +1,9 @@
+## v2.6.0 (2026-09-09)
+
+### Features
+
+- **functions**: add pids-of username lookup
+
 ## v2.5.0 (2026-09-09)
 
 ### Features

{devstuff-2.5.0 → devstuff-2.6.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: devstuff
-Version: 2.5.0
+Version: 2.6.0
 Summary: Development environment setup CLI for Linux
 Project-URL: Repository, https://github.com/thesawdawg/dev-setup-py
 Author-email: Sawyer <sawyerksu@gmail.com>
@@ -1176,6 +1176,7 @@ ones tools already have — for now, custom functions are hand-edited YAML at
 
 | Key | Category | Type | Description | Args |
 |-----|----------|------|--------------|------|
+| `pids-of` | system | script | List process IDs owned by a user, one per line | `username` |
 | `ssh-agent-key` | auth | shell-eval (bashrc) | Start ssh-agent in the current shell and add a key to it | `key_path` |
 | `validate-docker-compose` | validation | script | Validate a docker-compose.yml file in the current directory | — |
 | `validate-yaml` | validation | script | Validate a YAML file's syntax using `yq` | `file` |
@@ -1184,6 +1185,16 @@ ones tools already have — for now, custom functions are hand-edited YAML at
 | `aws-saml-reauth` | web-dev | script | Reauthorize the AWS CLI via `saml2aws login --force` | `profile` (optional) |
 | `which-ansible` | validation | script | Show which ansible a directory will actually use — the project's uv venv or the global one | `path` (optional) |
 
+#### `pids-of`
+
+```bash
+devstuff run pids-of sawyer
+```
+
+Prints one PID per line for processes whose effective user matches `username`.
+Requires `pgrep` (the `procps` package). A user with no visible processes returns
+an empty result successfully; an unknown user produces an error.
+
 #### `whats-on-port`
 
 ```bash

{devstuff-2.5.0 → devstuff-2.6.0}/README.md

@@ -1149,6 +1149,7 @@ ones tools already have — for now, custom functions are hand-edited YAML at
 
 | Key | Category | Type | Description | Args |
 |-----|----------|------|--------------|------|
+| `pids-of` | system | script | List process IDs owned by a user, one per line | `username` |
 | `ssh-agent-key` | auth | shell-eval (bashrc) | Start ssh-agent in the current shell and add a key to it | `key_path` |
 | `validate-docker-compose` | validation | script | Validate a docker-compose.yml file in the current directory | — |
 | `validate-yaml` | validation | script | Validate a YAML file's syntax using `yq` | `file` |
@@ -1157,6 +1158,16 @@ ones tools already have — for now, custom functions are hand-edited YAML at
 | `aws-saml-reauth` | web-dev | script | Reauthorize the AWS CLI via `saml2aws login --force` | `profile` (optional) |
 | `which-ansible` | validation | script | Show which ansible a directory will actually use — the project's uv venv or the global one | `path` (optional) |
 
+#### `pids-of`
+
+```bash
+devstuff run pids-of sawyer
+```
+
+Prints one PID per line for processes whose effective user matches `username`.
+Requires `pgrep` (the `procps` package). A user with no visible processes returns
+an empty result successfully; an unknown user produces an error.
+
 #### `whats-on-port`
 
 ```bash

{devstuff-2.5.0 → devstuff-2.6.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "devstuff"
-version = "2.5.0"
+version = "2.6.0"
 description = "Development environment setup CLI for Linux"
 readme = "README.md"
 requires-python = ">=3.11"

{devstuff-2.5.0 → devstuff-2.6.0}/src/dev_setup/functions.yaml

@@ -1,6 +1,33 @@
 # yaml-language-server: $schema=./functions.schema.json
 version: 1
 functions:
+  pids-of:
+    name: PIDs Of User
+    description: List process IDs owned by a user, one per line
+    category: system
+    type: script
+    params:
+      - name: username
+        description: User whose processes to list
+        required: true
+    script: |
+      set -uo pipefail
+      if ! command -v pgrep >/dev/null 2>&1; then
+        echo "pgrep is required (install the procps package)." >&2
+        exit 1
+      fi
+      if ! uid="$(id -u -- "$username" 2>/dev/null)"; then
+        echo "Unknown user: $username" >&2
+        exit 2
+      fi
+      pgrep -u "$uid"
+      status=$?
+      # pgrep returns 1 for no matches, which is a successful empty lookup.
+      if [ "$status" -eq 1 ]; then
+        exit 0
+      fi
+      exit "$status"
+
   ssh-agent-key:
     name: SSH Agent + Add Key
     description: Start ssh-agent in the current shell and add a key to it

{devstuff-2.5.0 → devstuff-2.6.0}/uv.lock

@@ -167,7 +167,7 @@ wheels = [
 
 [[package]]
 name = "devstuff"
-version = "2.5.0"
+version = "2.6.0"
 source = { editable = "." }
 dependencies = [
     { name = "click" },