Аудит виртуальных окружений
Находит каталоги venv, показывает размер, версию Python и дату изменения, удаляет только по флагу.
Что делает скрипт
Скрипт ищет каталоги с файлом pyvenv.cfg на глубине до трёх уровней и собирает по ним отчёт. По умолчанию ничего не удаляется. С флагом Remove и подтверждением можно удалить выбранные окружения, кроме активного VIRTUAL_ENV.
- Remove удаляет каталоги окружений. Нужны -Force и подтверждение.
Быстрый старт
powershell -File Venv-Audit.ps1 -Path C:\Users\user\src
Скачайте файл, откройте терминал в папке со скриптом и выполните команду. Запускайте в PowerShell 5.1 или PowerShell 7.
Другие варианты
powershell -File Venv-Audit.ps1 -Path .powershell -File Venv-Audit.ps1 -Path D:\Projects -OlderThanDays 60powershell -File Venv-Audit.ps1 -Path D:\Projects -Remove -Force
Что понадобится
Встроен в Windows 10/11 (PowerShell 5.1)
Venv-Audit.ps1
[CmdletBinding(SupportsShouldProcess = $true, ConfirmImpact = 'High')]
param(
[string]$Path = ".",
[ValidateRange(1, 3650)]
[int]$OlderThanDays = 30,
[switch]$Remove,
[switch]$Force
)
$ErrorActionPreference = 'Stop'
$root = (Resolve-Path -LiteralPath $Path -ErrorAction Stop).Path
if (-not (Test-Path -LiteralPath $root -PathType Container)) {
throw "Folder not found: $root"
}
if ($Remove -and -not $Force) {
throw "Remove requires -Force because environment folders will be deleted."
}
$candidates = Get-ChildItem -LiteralPath $root -Directory -Recurse -Depth 3 -ErrorAction SilentlyContinue |
Where-Object { Test-Path -LiteralPath (Join-Path $_.FullName 'pyvenv.cfg') -PathType Leaf }
$rows = @()
foreach ($folder in $candidates) {
$config = Join-Path $folder.FullName 'pyvenv.cfg'
$version = ''
try {
$line = Select-String -LiteralPath $config -Pattern '^version\s*=\s*(.+)$' -ErrorAction SilentlyContinue |
Select-Object -First 1
if ($line) {
$version = $line.Matches[0].Groups[1].Value.Trim()
}
} catch {
$version = ''
}
$size = 0
try {
$sum = Get-ChildItem -LiteralPath $folder.FullName -File -Recurse -ErrorAction SilentlyContinue |
Measure-Object -Property Length -Sum
if ($sum.Sum) {
$size = [double]$sum.Sum
}
} catch {
$size = 0
}
$age = [math]::Floor(((Get-Date) - $folder.LastWriteTime).TotalDays)
$active = ($env:VIRTUAL_ENV -and ([System.IO.Path]::GetFullPath($env:VIRTUAL_ENV) -eq $folder.FullName))
$rows += [pscustomobject]@{
Path = $folder.FullName
Python = $version
SizeMB = [math]::Round($size / 1MB, 1)
AgeDays = $age
Old = ($age -ge $OlderThanDays)
Active = $active
}
}
if ($rows.Count -eq 0) {
Write-Host "No virtual environments found."
exit 0
}
$rows | Sort-Object @{ Expression = 'Old'; Descending = $true }, @{ Expression = 'SizeMB'; Descending = $true } |
Format-Table -AutoSize
if (-not $Remove) {
Write-Host "Report only. Use -Remove -Force to delete selected environments."
exit 0
}
$removed = 0
foreach ($row in $rows) {
if ($row.Active) {
Write-Host "Skip active environment: $($row.Path)"
continue
}
if ($PSCmdlet.ShouldProcess($row.Path, "Remove virtual environment")) {
Remove-Item -LiteralPath $row.Path -Recurse -Force
$removed++
Write-Host "Removed: $($row.Path)"
}
}
Write-Host "Removed environments: $removed"
Скрипты работают с файлами и настройками системы. Перед запуском прочитайте код и проверьте пути. Особенно если скрипт удаляет, перезаписывает или перемещает данные.