Разработка и Git

Аудит виртуальных окружений

Находит каталоги venv, показывает размер, версию Python и дату изменения, удаляет только по флагу.

PowerShell Windows Средний
Скачать Venv-Audit.ps1
Описание

Что делает скрипт

Скрипт ищет каталоги с файлом 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 60
  • powershell -File Venv-Audit.ps1 -Path D:\Projects -Remove -Force
Зависимости

Что понадобится

PowerShell 5.1+ Встроен в Windows 10 и 11
Windows Встроен в 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"

Скрипты работают с файлами и настройками системы. Перед запуском прочитайте код и проверьте пути. Особенно если скрипт удаляет, перезаписывает или перемещает данные.

CLI 1.0.0

Скачать без браузера

Команда скачает этот файл в текущую папку. CLI работает на Windows, macOS и Linux.

scriptdock get dev-venv-audit
  • Поиск по всему каталогу
  • Python 3.10+
  • Без внешних пакетов
Скачать CLI

GUI-версия готовится. Подробнее

Категория

Разработка и Git

Git, сборка, тесты, зависимости, логи и обслуживание проектов.