rootiest
1341e2559e
Replace all ad-hoc inline comments between license headers and function declarations with consistent SYNOPSIS / DESCRIPTION / ARGUMENTS / RETURNS / EXAMPLE blocks across all 99 project-owned functions/ files. No executable logic, variable names, or exit codes were modified. Completes Task #6 from AGENTS.md (Retroactive Function Documentation Standardization).
39 lines
1.4 KiB
Fish
39 lines
1.4 KiB
Fish
# Copyright (C) 2026 Rootiest
|
|
# SPDX-License-Identifier: AGPL-3.0-or-later
|
|
|
|
# SYNOPSIS
|
|
# __auto_source_fallback_venv
|
|
#
|
|
# DESCRIPTION
|
|
# Event handler that auto-activates a .venv Python virtual environment when
|
|
# entering a directory. Deactivates when leaving the project tree. Skipped
|
|
# when direnv is already managing the directory.
|
|
#
|
|
# EXAMPLE
|
|
# # Triggered automatically on directory change; not called directly.
|
|
# cd ~/myproject # activates .venv if present
|
|
function __auto_source_fallback_venv --on-variable PWD
|
|
status --is-command-substitution; and return
|
|
|
|
# 1. Skip if direnv is already managing this directory
|
|
if set -q DIRENV_DIR; or test -e ".envrc"
|
|
return
|
|
end
|
|
|
|
# 2. If we are already in a venv, check if we've left its tree
|
|
if set -q VIRTUAL_ENV
|
|
# Check if the current PWD is still within the directory that owns the venv
|
|
# (Assuming the venv is at the root of the project)
|
|
set -l venv_root (string replace -r '/.venv$' '' $VIRTUAL_ENV)
|
|
if not string match -q "$venv_root*" "$PWD"
|
|
type -q deactivate; and deactivate
|
|
end
|
|
return
|
|
end
|
|
|
|
# 3. Only source the venv if we aren't already in one
|
|
if test -e ".venv/bin/activate.fish"
|
|
source .venv/bin/activate.fish
|
|
end
|
|
end
|