412 lines
13 KiB
PowerShell
412 lines
13 KiB
PowerShell
# ============================================================
|
||
# setup-1c-repo.ps1 - Настройка Git-репозитория под выгрузку 1С (конфигуратор)
|
||
#
|
||
# Версия: 1.2.0
|
||
# Автор: Michael BAG <mk@p7net.ru>
|
||
# Репозиторий: https://git.p7net.ru/tools/git_man
|
||
#
|
||
# Платформа: Windows (PowerShell 5.1+ / PowerShell 7+)
|
||
# Для Linux/macOS используйте setup-1c-repo.sh
|
||
#
|
||
# Использование:
|
||
# .\setup-1c-repo.ps1 [-DryRun] [-Force] [-Init] [-Renormalize] [-NoGitignore]
|
||
# [-Verbose] [-Quiet] [-Help] [-Version]
|
||
#
|
||
# Описание:
|
||
# Включает локальные настройки Git в текущей папке (cwd) для проектов
|
||
# с выгрузкой конфигурации/расширения из конфигуратора 1С:
|
||
# - UTF-8 с BOM (как у конфигуратора; BOM хранится как часть содержимого)
|
||
# - CRLF в рабочей копии для *.bsl / *.xml и др. текстовых файлов выгрузки
|
||
# - корректное отображение кириллических путей (core.quotepath=false)
|
||
# - длинные пути (core.longpaths=true)
|
||
# - создаёт/обновляет .gitattributes и .gitignore
|
||
# ============================================================
|
||
|
||
[CmdletBinding()]
|
||
param(
|
||
[switch]$DryRun,
|
||
[Alias('f')]
|
||
[switch]$Force,
|
||
[switch]$Init,
|
||
[switch]$Renormalize,
|
||
[switch]$NoGitignore,
|
||
[Alias('q')]
|
||
[switch]$Quiet,
|
||
[Alias('h')]
|
||
[switch]$Help,
|
||
[Alias('V')]
|
||
[switch]$Version
|
||
)
|
||
|
||
$ErrorActionPreference = 'Stop'
|
||
$ScriptVersion = '1.2.0'
|
||
|
||
function Show-Help {
|
||
@"
|
||
============================================================
|
||
📦 setup-1c-repo.ps1 v$ScriptVersion — настройка репозитория под 1С
|
||
============================================================
|
||
|
||
ОПИСАНИЕ:
|
||
Настраивает локальный Git-репозиторий в ТЕКУЩЕЙ папке под
|
||
выгрузку из конфигуратора 1С (UTF-8 BOM + CRLF).
|
||
|
||
ИСПОЛЬЗОВАНИЕ:
|
||
.\setup-1c-repo.ps1 [ОПЦИИ]
|
||
.\setup-1c-repo.cmd [ОПЦИИ]
|
||
|
||
ОПЦИИ:
|
||
-Help, -h Показать эту справку
|
||
-Version, -V Показать версию скрипта
|
||
-DryRun Только показать, что будет сделано
|
||
-Force, -f Перезаписать существующие .gitattributes / .gitignore
|
||
-Init Выполнить git init, если папка ещё не репозиторий
|
||
-Renormalize После настройки: git add --renormalize .
|
||
-NoGitignore Не создавать/не менять .gitignore
|
||
-Verbose, -v Подробный вывод
|
||
-Quiet, -q Минимальный вывод (только ошибки)
|
||
|
||
ПРИМЕРЫ:
|
||
.\setup-1c-repo.ps1
|
||
.\setup-1c-repo.ps1 -Force -Renormalize
|
||
.\setup-1c-repo.ps1 -Init -DryRun
|
||
|
||
============================================================
|
||
"@ | Write-Host
|
||
exit 0
|
||
}
|
||
|
||
function Show-Version {
|
||
Write-Host "setup-1c-repo.ps1 $ScriptVersion"
|
||
exit 0
|
||
}
|
||
|
||
if ($Help) { Show-Help }
|
||
if ($Version) { Show-Version }
|
||
|
||
function Write-Info([string]$Message) {
|
||
if (-not $Quiet) { Write-Host "ℹ️ $Message" -ForegroundColor Cyan }
|
||
}
|
||
function Write-Success([string]$Message) {
|
||
if (-not $Quiet) { Write-Host "✅ $Message" -ForegroundColor Green }
|
||
}
|
||
function Write-WarnMsg([string]$Message) {
|
||
if (-not $Quiet) { Write-Host "⚠️ $Message" -ForegroundColor Yellow }
|
||
}
|
||
function Write-ErrMsg([string]$Message) {
|
||
Write-Host "❌ $Message" -ForegroundColor Red
|
||
}
|
||
function Write-DebugMsg([string]$Message) {
|
||
if ($VerbosePreference -ne 'SilentlyContinue' -and -not $Quiet) {
|
||
Write-Host "🔍 $Message" -ForegroundColor Blue
|
||
}
|
||
}
|
||
function Write-Step([string]$Message) {
|
||
if (-not $Quiet) { Write-Host "▶ $Message" -ForegroundColor Magenta }
|
||
}
|
||
|
||
$GitAttributesContent = @'
|
||
# .gitattributes — выгрузка конфигуратора 1С (UTF-8 BOM + CRLF)
|
||
# Создано setup-1c-repo.ps1 (git_man). Не удаляйте без необходимости.
|
||
#
|
||
# Правило: текстовые файлы выгрузки — text + eol=crlf (рабочая копия = CRLF,
|
||
# в объекте Git нормализуется к LF). Бинарники — binary (без конвертации EOL).
|
||
|
||
* text=auto
|
||
|
||
# --- Текстовые файлы выгрузки конфигуратора ---
|
||
*.bsl text eol=crlf
|
||
*.os text eol=crlf
|
||
*.xml text eol=crlf
|
||
*.txt text eol=crlf
|
||
*.html text eol=crlf
|
||
*.htm text eol=crlf
|
||
*.xsd text eol=crlf
|
||
*.xslt text eol=crlf
|
||
*.xsl text eol=crlf
|
||
*.Form text eol=crlf
|
||
*.Module text eol=crlf
|
||
*.max text eol=crlf
|
||
|
||
# --- Служебные / документация репозитория (LF) ---
|
||
*.md text eol=lf
|
||
*.json text eol=lf
|
||
*.yml text eol=lf
|
||
*.yaml text eol=lf
|
||
*.sh text eol=lf
|
||
*.gitignore text eol=lf
|
||
*.gitattributes text eol=lf
|
||
.editorconfig text eol=lf
|
||
|
||
# --- Скрипты Windows ---
|
||
*.bat text eol=crlf
|
||
*.cmd text eol=crlf
|
||
*.ps1 text eol=crlf
|
||
|
||
# --- Бинарные артефакты 1С и медиа ---
|
||
*.bin binary
|
||
*.cf binary
|
||
*.cfe binary
|
||
*.cfu binary
|
||
*.epf binary
|
||
*.erf binary
|
||
*.axdt binary
|
||
*.addin binary
|
||
|
||
*.png binary
|
||
*.jpg binary
|
||
*.jpeg binary
|
||
*.gif binary
|
||
*.bmp binary
|
||
*.ico binary
|
||
*.webp binary
|
||
*.tif binary
|
||
*.tiff binary
|
||
*.svg -text
|
||
|
||
*.zip binary
|
||
*.rar binary
|
||
*.7z binary
|
||
*.gz binary
|
||
|
||
*.xls binary
|
||
*.xlsx binary
|
||
*.xlsm binary
|
||
*.doc binary
|
||
*.docx binary
|
||
*.pdf binary
|
||
*.rtf binary
|
||
|
||
*.ttf binary
|
||
*.otf binary
|
||
*.woff binary
|
||
*.woff2 binary
|
||
*.eot binary
|
||
'@
|
||
|
||
$GitIgnoreContent = @'
|
||
# .gitignore — типовые исключения для проектов 1С (конфигуратор)
|
||
# Создано setup-1c-repo.ps1 (git_man)
|
||
|
||
# Бинарные выгрузки конфигурации / расширений / обработок
|
||
*.cf
|
||
*.cfe
|
||
*.cfu
|
||
*.epf
|
||
*.erf
|
||
|
||
# Временные и резервные
|
||
*.tmp
|
||
*.bak
|
||
*.~*
|
||
*~
|
||
*.old
|
||
*.orig
|
||
|
||
# Логи и дампы
|
||
*.log
|
||
*.lgp
|
||
*.lgf
|
||
|
||
# ОС
|
||
Thumbs.db
|
||
ehthumbs.db
|
||
Desktop.ini
|
||
desktop.ini
|
||
.DS_Store
|
||
.AppleDouble
|
||
.LSOverride
|
||
|
||
# IDE / редакторы
|
||
.vs/
|
||
.vscode/
|
||
.idea/
|
||
*.suo
|
||
*.user
|
||
*.userosscache
|
||
*.sln.docstates
|
||
|
||
# Отладка / кэш
|
||
Debug/
|
||
debug/
|
||
cache/
|
||
*.pfl
|
||
'@
|
||
|
||
function Test-GitAvailable {
|
||
try {
|
||
$null = Get-Command git -ErrorAction Stop
|
||
return $true
|
||
} catch {
|
||
return $false
|
||
}
|
||
}
|
||
|
||
function Test-GitRepository {
|
||
if (Test-Path -LiteralPath '.git') { return $true }
|
||
return $false
|
||
}
|
||
|
||
function Set-LocalGitConfig {
|
||
param([string]$Key, [string]$Value)
|
||
if ($DryRun) {
|
||
Write-Host " [DRY-RUN] git config --local $Key $Value"
|
||
return
|
||
}
|
||
& git config --local $Key $Value
|
||
if ($LASTEXITCODE -ne 0) {
|
||
throw "Не удалось установить git config $Key=$Value"
|
||
}
|
||
Write-DebugMsg "config $Key=$Value"
|
||
}
|
||
|
||
function Write-Utf8File {
|
||
param(
|
||
[string]$Path,
|
||
[string]$Content
|
||
)
|
||
# UTF-8 без BOM: для .gitattributes/.gitignore достаточно; BOM у *.bsl
|
||
# — содержимое выгрузки конфигуратора, не этих служебных файлов.
|
||
$normalized = $Content -replace "`r`n", "`n" -replace "`r", "`n"
|
||
$normalized = $normalized.TrimEnd("`n") + "`n"
|
||
$encoding = New-Object System.Text.UTF8Encoding($false)
|
||
[System.IO.File]::WriteAllText((Join-Path (Get-Location) $Path), $normalized, $encoding)
|
||
}
|
||
|
||
function Write-FileSafe {
|
||
param(
|
||
[string]$Path,
|
||
[string]$Content,
|
||
[string]$Label
|
||
)
|
||
|
||
if ((Test-Path -LiteralPath $Path) -and -not $Force) {
|
||
Write-WarnMsg "$Label уже существует — пропуск (используйте -Force)"
|
||
return
|
||
}
|
||
|
||
if ($DryRun) {
|
||
if (Test-Path -LiteralPath $Path) {
|
||
Write-Host " [DRY-RUN] перезаписать $Path (бэкап $Path.bak)"
|
||
} else {
|
||
Write-Host " [DRY-RUN] создать $Path"
|
||
}
|
||
return
|
||
}
|
||
|
||
if (Test-Path -LiteralPath $Path) {
|
||
Copy-Item -LiteralPath $Path -Destination "$Path.bak" -Force
|
||
Write-Info "Бэкап: $Path.bak"
|
||
}
|
||
|
||
Write-Utf8File -Path $Path -Content $Content
|
||
Write-Success "Записан $Path"
|
||
}
|
||
|
||
# ============================================================
|
||
# Основной ход
|
||
# ============================================================
|
||
Write-Step "Проверка окружения (ОС: Windows)..."
|
||
|
||
if (-not (Test-GitAvailable)) {
|
||
Write-ErrMsg "Git не установлен или недоступен в PATH"
|
||
exit 1
|
||
}
|
||
|
||
if (-not (Test-GitRepository)) {
|
||
if ($Init) {
|
||
if ($DryRun) {
|
||
Write-Host " [DRY-RUN] git init"
|
||
} else {
|
||
& git init
|
||
if ($LASTEXITCODE -ne 0) { throw "git init завершился с ошибкой" }
|
||
Write-Success "Выполнен git init"
|
||
}
|
||
} else {
|
||
Write-ErrMsg "Текущая папка не является Git-репозиторием"
|
||
Write-Host " Запустите из корня репозитория или добавьте -Init" -ForegroundColor Red
|
||
exit 1
|
||
}
|
||
}
|
||
|
||
Write-Success "Окружение проверено"
|
||
|
||
Write-Step "Локальные настройки Git..."
|
||
|
||
# Кириллические пути без \320\...
|
||
Set-LocalGitConfig 'core.quotepath' 'false'
|
||
# Длинные пути Windows / глубокие деревья метаданных 1С
|
||
Set-LocalGitConfig 'core.longpaths' 'true'
|
||
# Кодировки UI и коммитов
|
||
Set-LocalGitConfig 'gui.encoding' 'utf-8'
|
||
Set-LocalGitConfig 'i18n.commitEncoding' 'utf-8'
|
||
# EOL полностью через .gitattributes
|
||
Set-LocalGitConfig 'core.autocrlf' 'false'
|
||
Set-LocalGitConfig 'core.safecrlf' 'warn'
|
||
# Рекомендации 1С:ГитКонвертер для крупных деревьев метаданных
|
||
Set-LocalGitConfig 'diff.renames' 'false'
|
||
Set-LocalGitConfig 'diff.renameLimit' '1'
|
||
|
||
if ($DryRun) {
|
||
Write-Info "Локальный git config (dry-run)"
|
||
} else {
|
||
Write-Success "Локальный git config применён"
|
||
}
|
||
|
||
Write-Step "Файл .gitattributes..."
|
||
Write-FileSafe -Path '.gitattributes' -Content $GitAttributesContent -Label '.gitattributes'
|
||
|
||
if (-not $NoGitignore) {
|
||
Write-Step "Файл .gitignore..."
|
||
Write-FileSafe -Path '.gitignore' -Content $GitIgnoreContent -Label '.gitignore'
|
||
} else {
|
||
Write-Info "Пропуск .gitignore (-NoGitignore)"
|
||
}
|
||
|
||
if ($Renormalize) {
|
||
Write-Step "Нормализация индекса (git add --renormalize .)..."
|
||
if ($DryRun) {
|
||
Write-Host " [DRY-RUN] git add --renormalize ."
|
||
} else {
|
||
& git add --renormalize .
|
||
if ($LASTEXITCODE -ne 0) { throw "git add --renormalize завершился с ошибкой" }
|
||
Write-Success "Индекс перенормализован"
|
||
Write-WarnMsg "Проверьте git status — возможны массовые изменения EOL"
|
||
}
|
||
}
|
||
|
||
if (-not $Quiet) {
|
||
Write-Host ""
|
||
Write-Host "============================================================"
|
||
Write-Host "📊 Итог настройки под выгрузку конфигуратора 1С" -ForegroundColor Cyan
|
||
Write-Host "============================================================"
|
||
Write-Host " ОС: Windows"
|
||
Write-Host " Каталог: $(Get-Location)"
|
||
Write-Host " Encoding: UTF-8 (BOM сохраняется в содержимом файлов)"
|
||
Write-Host " EOL (выгрузка): CRLF в рабочей копии (*.bsl, *.xml, …)"
|
||
Write-Host " core.autocrlf: false (управляет .gitattributes)"
|
||
Write-Host " core.quotepath: false"
|
||
Write-Host " core.longpaths: true"
|
||
if ($DryRun) {
|
||
Write-Host ""
|
||
Write-Host "⚠️ Режим -DryRun: изменения НЕ применены" -ForegroundColor Yellow
|
||
} else {
|
||
Write-Host ""
|
||
Write-Host "✅ Готово" -ForegroundColor Green
|
||
Write-Host ""
|
||
Write-Host "Следующие шаги:" -ForegroundColor Cyan
|
||
Write-Host " 1. git status"
|
||
Write-Host " 2. git add .gitattributes .gitignore"
|
||
Write-Host ' 3. git commit -m "Настройки Git для выгрузки конфигуратора 1С"'
|
||
if (-not $Renormalize) {
|
||
Write-Host " 4. При необходимости нормализовать EOL:"
|
||
Write-Host " .\setup-1c-repo.ps1 -Renormalize"
|
||
Write-Host " или: git add --renormalize ."
|
||
}
|
||
}
|
||
Write-Host "============================================================"
|
||
Write-Host ""
|
||
}
|
||
|
||
exit 0
|