HeuJung
487283b33a
targets 에 명시된 {modules,plugins,templates,lang-packs}/_bundled 가
상위 protected(modules 등)에 걸려 3-way apply 목록에서 제외되던 결함 수정.
targets 가 protected 보다 더 구체적이면 오버라이드해 통과시켜, 코어 업데이트로
번들 확장 갱신 파일(composer.json·vendor-bundle.json 등)이 정상 반영되도록 한다.
자동 발견 폴백의 방어 및 prune 롤백 경로는 불변.
아울러 이슈 템플릿의 사용법 문의 링크를 Discussions 에서 sir.kr Q&A 로 전환.
351 lines
13 KiB
PHP
351 lines
13 KiB
PHP
<?php
|
|
|
|
namespace Tests\Unit\Extension;
|
|
|
|
use App\Extension\Helpers\CoreBackupHelper;
|
|
use Illuminate\Support\Facades\File;
|
|
use Tests\TestCase;
|
|
|
|
/**
|
|
* CoreBackupHelper::computeApplyList() 단위 테스트 (공개 #64)
|
|
*
|
|
* `core:update` 기본(증분) 모드의 3-way 판정을 검증합니다:
|
|
* - base == theirs (코어 미변경) → 적용 목록 제외 (사용자 상태 보존)
|
|
* - base 없음 (신규) → added 로 목록 포함
|
|
* - size 다름 / md5 다름 (변경) → changed 로 목록 포함
|
|
* - symlink / excludes / protected → 목록 제외
|
|
*/
|
|
class CoreBackupHelperApplyListTest extends TestCase
|
|
{
|
|
private string $basePath; // 백업 스냅샷 (base = 구버전 원본)
|
|
|
|
private string $theirsPath; // _pending (theirs = 신 버전)
|
|
|
|
protected function setUp(): void
|
|
{
|
|
parent::setUp();
|
|
|
|
$root = storage_path('app/test_apply_list_'.uniqid());
|
|
$this->basePath = $root.DIRECTORY_SEPARATOR.'base';
|
|
$this->theirsPath = $root.DIRECTORY_SEPARATOR.'theirs';
|
|
|
|
File::ensureDirectoryExists($this->basePath);
|
|
File::ensureDirectoryExists($this->theirsPath);
|
|
}
|
|
|
|
protected function tearDown(): void
|
|
{
|
|
$root = dirname($this->basePath);
|
|
if (File::isDirectory($root)) {
|
|
File::deleteDirectory($root);
|
|
}
|
|
|
|
parent::tearDown();
|
|
}
|
|
|
|
/**
|
|
* base == theirs 인 파일은 적용 목록에서 제외됩니다 (코어 미변경 → 보존).
|
|
*/
|
|
public function test_unchanged_file_is_excluded_from_apply_list(): void
|
|
{
|
|
$this->writeBoth('app/Same.php', '<?php // identical', '<?php // identical');
|
|
|
|
$result = CoreBackupHelper::computeApplyList(
|
|
$this->basePath,
|
|
$this->theirsPath,
|
|
['app'],
|
|
[],
|
|
[],
|
|
);
|
|
|
|
$this->assertNotContains('app/Same.php', $result['apply']);
|
|
$this->assertSame(0, $result['added_count']);
|
|
$this->assertSame(0, $result['changed_count']);
|
|
}
|
|
|
|
/**
|
|
* base 에 없고 theirs 에만 있는 파일은 added 로 포함됩니다 (신규).
|
|
*/
|
|
public function test_new_file_is_added_to_apply_list(): void
|
|
{
|
|
File::ensureDirectoryExists($this->theirsPath.DIRECTORY_SEPARATOR.'app');
|
|
File::put($this->theirsPath.DIRECTORY_SEPARATOR.'app'.DIRECTORY_SEPARATOR.'New.php', '<?php // new');
|
|
|
|
$result = CoreBackupHelper::computeApplyList(
|
|
$this->basePath,
|
|
$this->theirsPath,
|
|
['app'],
|
|
[],
|
|
[],
|
|
);
|
|
|
|
$this->assertContains('app/New.php', $result['apply']);
|
|
$this->assertSame(1, $result['added_count']);
|
|
$this->assertSame(0, $result['changed_count']);
|
|
}
|
|
|
|
/**
|
|
* size 가 다른 파일은 md5 계산 없이 changed 로 포함됩니다.
|
|
*/
|
|
public function test_size_differing_file_is_changed(): void
|
|
{
|
|
$this->writeBoth('app/Grown.php', '<?php // small', '<?php // this content is clearly longer than base');
|
|
|
|
$result = CoreBackupHelper::computeApplyList(
|
|
$this->basePath,
|
|
$this->theirsPath,
|
|
['app'],
|
|
[],
|
|
[],
|
|
);
|
|
|
|
$this->assertContains('app/Grown.php', $result['apply']);
|
|
$this->assertSame(1, $result['changed_count']);
|
|
$this->assertSame(0, $result['added_count']);
|
|
}
|
|
|
|
/**
|
|
* size 는 같지만 내용(md5)이 다른 파일은 changed 로 포함됩니다.
|
|
*/
|
|
public function test_same_size_different_content_file_is_changed(): void
|
|
{
|
|
// 동일 길이(12), 내용만 다름
|
|
$this->writeBoth('app/Edited.php', 'AAAAAAAAAAAA', 'BBBBBBBBBBBB');
|
|
|
|
$result = CoreBackupHelper::computeApplyList(
|
|
$this->basePath,
|
|
$this->theirsPath,
|
|
['app'],
|
|
[],
|
|
[],
|
|
);
|
|
|
|
$this->assertContains('app/Edited.php', $result['apply']);
|
|
$this->assertSame(1, $result['changed_count']);
|
|
}
|
|
|
|
/**
|
|
* excludes 패턴에 매칭되는 파일은 목록에서 제외됩니다.
|
|
*/
|
|
public function test_excluded_file_is_not_in_apply_list(): void
|
|
{
|
|
// theirs 에만 존재하지만 node_modules 하위 → 제외
|
|
File::ensureDirectoryExists($this->theirsPath.DIRECTORY_SEPARATOR.'app'.DIRECTORY_SEPARATOR.'node_modules');
|
|
File::put($this->theirsPath.DIRECTORY_SEPARATOR.'app'.DIRECTORY_SEPARATOR.'node_modules'.DIRECTORY_SEPARATOR.'x.js', 'x');
|
|
|
|
$result = CoreBackupHelper::computeApplyList(
|
|
$this->basePath,
|
|
$this->theirsPath,
|
|
['app'],
|
|
[],
|
|
['node_modules'],
|
|
);
|
|
|
|
$this->assertSame([], $result['apply']);
|
|
}
|
|
|
|
/**
|
|
* protected_paths 하위 항목은 목록에서 제외됩니다.
|
|
*/
|
|
public function test_protected_path_file_is_not_in_apply_list(): void
|
|
{
|
|
File::ensureDirectoryExists($this->theirsPath.DIRECTORY_SEPARATOR.'storage'.DIRECTORY_SEPARATOR.'app');
|
|
File::put($this->theirsPath.DIRECTORY_SEPARATOR.'storage'.DIRECTORY_SEPARATOR.'app'.DIRECTORY_SEPARATOR.'runtime.txt', 'data');
|
|
|
|
$result = CoreBackupHelper::computeApplyList(
|
|
$this->basePath,
|
|
$this->theirsPath,
|
|
['storage'],
|
|
['storage'],
|
|
[],
|
|
);
|
|
|
|
$this->assertSame([], $result['apply']);
|
|
}
|
|
|
|
/**
|
|
* targets 에 명시된 `{domain}/_bundled` 경로는 상위 protected(`{domain}`)보다
|
|
* 우선하여 apply 목록에 포함됩니다 (공개 #64 / 내부 #452 회귀).
|
|
*
|
|
* 배경: `config/app.php` 의 update.targets 에는 `modules/_bundled`,
|
|
* `plugins/_bundled`, `templates/_bundled`, `lang-packs/_bundled` 가 있고,
|
|
* protected_paths 에는 부모 `modules`, `plugins`, `templates`, `lang-packs` 가
|
|
* 있다. protected 는 자동 발견 폴백이 활성 서브디렉토리(`modules/sirsoft-*`)를
|
|
* 통째로 삭제하는 회귀(#347)를 막기 위한 것인데, 정상 증분 흐름의 apply 산출에서
|
|
* `{domain}/_bundled/...` 파일이 `{domain}/` 접두사에 걸려 통째로 제외되면
|
|
* 코어 업데이트 시 번들 확장의 새 파일(composer.json·vendor-bundle.*)이
|
|
* 반영되지 않는다. targets 에 더 구체적으로 명시된 경로는 상위 protected 를
|
|
* 오버라이드해야 한다. 4종 확장(모듈/플러그인/템플릿/언어팩) 전수 검증.
|
|
*
|
|
* @dataProvider bundledDomainProvider
|
|
*/
|
|
public function test_bundled_target_overrides_parent_protected_path(string $domain): void
|
|
{
|
|
$bundledTarget = "{$domain}/_bundled";
|
|
|
|
// theirs 에만 존재하는 신규 번들 파일 (added)
|
|
$newRel = "{$bundledTarget}/vendor-ext/composer.json";
|
|
$newAbs = $this->theirsPath.DIRECTORY_SEPARATOR.str_replace('/', DIRECTORY_SEPARATOR, $newRel);
|
|
File::ensureDirectoryExists(dirname($newAbs));
|
|
File::put($newAbs, '{"version":"1.0.1"}');
|
|
|
|
// base·theirs 양쪽에 있지만 내용이 다른 번들 파일 (changed)
|
|
$this->writeBoth(
|
|
"{$bundledTarget}/vendor-ext/vendor-bundle.json",
|
|
'{"composer_json_sha256":"old"}',
|
|
'{"composer_json_sha256":"new-value-differs"}',
|
|
);
|
|
|
|
// 활성 서브디렉토리(=targets 밖, protected 로 보존되어야 함)
|
|
$activeRel = "{$domain}/vendor-ext-active";
|
|
File::ensureDirectoryExists($this->theirsPath.DIRECTORY_SEPARATOR.str_replace('/', DIRECTORY_SEPARATOR, $activeRel));
|
|
File::put(
|
|
$this->theirsPath.DIRECTORY_SEPARATOR.str_replace('/', DIRECTORY_SEPARATOR, "{$activeRel}/active.php"),
|
|
'active',
|
|
);
|
|
|
|
$result = CoreBackupHelper::computeApplyList(
|
|
$this->basePath,
|
|
$this->theirsPath,
|
|
[$bundledTarget], // targets: _bundled 만 명시
|
|
[$domain, 'storage', 'vendor'], // protected: 부모 도메인 포함 (실제 config 반영)
|
|
['node_modules', '.git'],
|
|
);
|
|
|
|
// _bundled 하위 신규/변경 파일은 apply 목록에 포함되어야 한다
|
|
$this->assertContains("{$bundledTarget}/vendor-ext/composer.json", $result['apply']);
|
|
$this->assertContains("{$bundledTarget}/vendor-ext/vendor-bundle.json", $result['apply']);
|
|
$this->assertSame(1, $result['added_count']);
|
|
$this->assertSame(1, $result['changed_count']);
|
|
|
|
// 활성 서브디렉토리(targets 밖)는 순회 대상이 아니므로 목록에 없어야 한다
|
|
$this->assertNotContains("{$activeRel}/active.php", $result['apply']);
|
|
}
|
|
|
|
/**
|
|
* 4종 번들 확장 도메인 (config/app.php 의 targets/protected_paths 실제 조합).
|
|
*
|
|
* @return array<string, array{string}>
|
|
*/
|
|
public static function bundledDomainProvider(): array
|
|
{
|
|
return [
|
|
'modules' => ['modules'],
|
|
'plugins' => ['plugins'],
|
|
'templates' => ['templates'],
|
|
'lang-packs' => ['lang-packs'],
|
|
];
|
|
}
|
|
|
|
/**
|
|
* target 과 protected 가 정확히 동일한 경로면 여전히 제외됩니다 (기존 방어 유지).
|
|
*
|
|
* `_bundled` 오버라이드는 "targets 가 protected 보다 더 구체적(하위)일 때"만
|
|
* 적용된다. target == protected (예: storage) 는 제외가 정상.
|
|
*/
|
|
public function test_target_equal_to_protected_is_still_excluded(): void
|
|
{
|
|
File::ensureDirectoryExists($this->theirsPath.DIRECTORY_SEPARATOR.'storage'.DIRECTORY_SEPARATOR.'app');
|
|
File::put($this->theirsPath.DIRECTORY_SEPARATOR.'storage'.DIRECTORY_SEPARATOR.'app'.DIRECTORY_SEPARATOR.'runtime.txt', 'data');
|
|
|
|
$result = CoreBackupHelper::computeApplyList(
|
|
$this->basePath,
|
|
$this->theirsPath,
|
|
['storage'],
|
|
['storage'],
|
|
[],
|
|
);
|
|
|
|
$this->assertSame([], $result['apply']);
|
|
}
|
|
|
|
/**
|
|
* added 와 changed 가 섞여 있을 때 apply 목록이 정렬되어 둘 다 포함합니다.
|
|
*/
|
|
public function test_apply_list_merges_added_and_changed_sorted(): void
|
|
{
|
|
$this->writeBoth('app/Zeta.php', 'old', 'new-different'); // changed
|
|
File::put($this->theirsPath.DIRECTORY_SEPARATOR.'app'.DIRECTORY_SEPARATOR.'Alpha.php', 'brand-new'); // added
|
|
$this->writeBoth('app/Keep.php', 'same', 'same'); // unchanged → 제외
|
|
|
|
$result = CoreBackupHelper::computeApplyList(
|
|
$this->basePath,
|
|
$this->theirsPath,
|
|
['app'],
|
|
[],
|
|
[],
|
|
);
|
|
|
|
$this->assertSame(['app/Alpha.php', 'app/Zeta.php'], $result['apply']);
|
|
$this->assertSame(1, $result['added_count']);
|
|
$this->assertSame(1, $result['changed_count']);
|
|
}
|
|
|
|
/**
|
|
* 단일 파일 target 도 3-way 판정을 받습니다 (변경 시 changed).
|
|
*/
|
|
public function test_single_file_target_is_classified(): void
|
|
{
|
|
File::put($this->basePath.DIRECTORY_SEPARATOR.'artisan', 'v1');
|
|
File::put($this->theirsPath.DIRECTORY_SEPARATOR.'artisan', 'v2-changed');
|
|
|
|
$result = CoreBackupHelper::computeApplyList(
|
|
$this->basePath,
|
|
$this->theirsPath,
|
|
['artisan'],
|
|
[],
|
|
[],
|
|
);
|
|
|
|
$this->assertContains('artisan', $result['apply']);
|
|
$this->assertSame(1, $result['changed_count']);
|
|
}
|
|
|
|
/**
|
|
* theirs 의 symlink 는 적용 목록에서 제외되고 has_symlink 플래그가 켜집니다.
|
|
* (링크 자체는 copyDirectory 의 별도 링크 처리 경로가 담당 — 목록 산출 대상 아님)
|
|
*/
|
|
public function test_symlink_is_excluded_and_flagged(): void
|
|
{
|
|
// theirs/app/real.php + theirs/app/link.php(→ real.php) 구성
|
|
File::ensureDirectoryExists($this->theirsPath.DIRECTORY_SEPARATOR.'app');
|
|
$realTarget = $this->theirsPath.DIRECTORY_SEPARATOR.'app'.DIRECTORY_SEPARATOR.'real.php';
|
|
File::put($realTarget, '<?php // real');
|
|
|
|
$linkPath = $this->theirsPath.DIRECTORY_SEPARATOR.'app'.DIRECTORY_SEPARATOR.'link.php';
|
|
if (! @symlink($realTarget, $linkPath) || ! is_link($linkPath)) {
|
|
// Windows SeCreateSymbolicLink 권한 부족 등 — 링크 생성 불가 환경은 skip
|
|
$this->markTestSkipped('symlink 생성 불가 환경 (권한 부족)');
|
|
}
|
|
|
|
$result = CoreBackupHelper::computeApplyList(
|
|
$this->basePath,
|
|
$this->theirsPath,
|
|
['app'],
|
|
[],
|
|
[],
|
|
);
|
|
|
|
// real.php 는 added 로 포함되지만 link.php 는 목록에서 제외
|
|
$this->assertContains('app/real.php', $result['apply']);
|
|
$this->assertNotContains('app/link.php', $result['apply']);
|
|
$this->assertTrue($result['has_symlink'], 'symlink 발견 시 has_symlink 플래그가 켜져야 한다');
|
|
}
|
|
|
|
/**
|
|
* base·theirs 양쪽에 동일 파일을 씁니다.
|
|
*/
|
|
private function writeBoth(string $relative, string $baseContent, string $theirsContent): void
|
|
{
|
|
$rel = str_replace('/', DIRECTORY_SEPARATOR, $relative);
|
|
|
|
$baseFile = $this->basePath.DIRECTORY_SEPARATOR.$rel;
|
|
File::ensureDirectoryExists(dirname($baseFile));
|
|
File::put($baseFile, $baseContent);
|
|
|
|
$theirsFile = $this->theirsPath.DIRECTORY_SEPARATOR.$rel;
|
|
File::ensureDirectoryExists(dirname($theirsFile));
|
|
File::put($theirsFile, $theirsContent);
|
|
}
|
|
}
|