#include <qa_utils/wx_utils/unit_test_utils.h>
#include <board.h>
#include <local_history.h>
#include <pgm_base.h>
#include <project.h>
#include <settings/common_settings.h>
#include <settings/settings_manager.h>
#include <git2.h>
#include <vector>
#include <wx/dir.h>
#include <wx/ffile.h>
#include <wx/filefn.h>
#include <wx/filename.h>
#include <wx/stdpaths.h>

Functions
	BOOST_AUTO_TEST_CASE (SaveToHistoryWithNullProjectDoesNotCrash)
	Regression test for https://gitlab.com/kicad/code/kicad/-/issues/23737.

	BOOST_AUTO_TEST_CASE (SaveToHistoryUnsavedBoardProducesNothing)
	SaveToHistory with a real project but no board filename should not produce any file data (the board is unsaved).

	BOOST_AUTO_TEST_CASE (NoSnapshotWithoutProjectFile)
	When pcbnew runs standalone with no project loaded, saving a board can land anywhere on the filesystem.

	BOOST_AUTO_TEST_CASE (CommitFullProjectSnapshotHandlesSubdirectories)
	CommitFullProjectSnapshot collects files recursively.

	BOOST_AUTO_TEST_CASE (RestoreCommitPreservesZipBackupsDirectory)

	BOOST_AUTO_TEST_CASE (RestoreCommitPreservesNestedProject)
	Regression test: a user reported that opening a project containing a nested project and accepting "restore previous version" deleted the entire nested project.

	BOOST_AUTO_TEST_CASE (RestoreCommitRetainsTimestampedBackup)
	The retained backup directory must be timestamped (Windows-safe, no colons) and survive the success path of RestoreCommit so the user can recover any displaced file.

	BOOST_AUTO_TEST_CASE (CommitFullProjectSnapshotExcludesNonKiCadFiles)
	Snapshots must only commit KiCad managed files and user files in the project dir stay out.

	BOOST_AUTO_TEST_CASE (FirstAutosaveSkipsCommitWhenStagedMatchesDisk)
	Idle autosave on a fresh project (saver output == disk) must not create an untagged HEAD.

	BOOST_AUTO_TEST_CASE (FirstManualSaveAlwaysCommitsOnFreshProject)
	Manual save on a fresh project (saver output == disk) must still commit, so the user's first explicit save shows up in the history dialog.

Function Documentation

◆ BOOST_AUTO_TEST_CASE() [1/10]

BOOST_AUTO_TEST_CASE ( CommitFullProjectSnapshotExcludesNonKiCadFiles )

Snapshots must only commit KiCad managed files and user files in the project dir stay out.

Definition at line 437 of file test_history_autosave.cpp.

References BOOST_CHECK_MESSAGE(), BOOST_REQUIRE(), LOCAL_HISTORY::CommitFullProjectSnapshot(), COMMON_SETTINGS::AUTO_BACKUP::enabled, PGM_BASE::GetCommonSettings(), COMMON_SETTINGS::m_Backup, path, Pgm(), and project.

◆ BOOST_AUTO_TEST_CASE() [2/10]

BOOST_AUTO_TEST_CASE ( CommitFullProjectSnapshotHandlesSubdirectories )

CommitFullProjectSnapshot collects files recursively.

CommitSnapshot's legacy path derives the project root from aFiles[0], so when the first file ends up in a subdirectory the project root would be misidentified. CommitFullProjectSnapshot must commit using the explicitly supplied project path regardless of what the recursive walk happens to return first.

Definition at line 192 of file test_history_autosave.cpp.

References BOOST_REQUIRE(), LOCAL_HISTORY::CommitFullProjectSnapshot(), COMMON_SETTINGS::AUTO_BACKUP::enabled, PGM_BASE::GetCommonSettings(), LOCAL_HISTORY::GetHeadHash(), COMMON_SETTINGS::m_Backup, path, Pgm(), and project.

◆ BOOST_AUTO_TEST_CASE() [3/10]

BOOST_AUTO_TEST_CASE ( FirstAutosaveSkipsCommitWhenStagedMatchesDisk )

Idle autosave on a fresh project (saver output == disk) must not create an untagged HEAD.

Real edits (saver output != disk) must commit.

Definition at line 516 of file test_history_autosave.cpp.

References BOOST_CHECK_MESSAGE(), BOOST_REQUIRE(), HISTORY_FILE_DATA::content, COMMON_SETTINGS::AUTO_BACKUP::enabled, PGM_BASE::GetCommonSettings(), LOCAL_HISTORY::GetHeadHash(), COMMON_SETTINGS::m_Backup, path, Pgm(), project, LOCAL_HISTORY::RegisterSaver(), HISTORY_FILE_DATA::relativePath, LOCAL_HISTORY::RunRegisteredSaversAndCommit(), LOCAL_HISTORY::UnregisterSaver(), and LOCAL_HISTORY::WaitForPendingSave().

◆ BOOST_AUTO_TEST_CASE() [4/10]

BOOST_AUTO_TEST_CASE ( FirstManualSaveAlwaysCommitsOnFreshProject )

Manual save on a fresh project (saver output == disk) must still commit, so the user's first explicit save shows up in the history dialog.

Counterpart to FirstAutosaveSkipsCommitWhenStagedMatchesDisk.

Definition at line 574 of file test_history_autosave.cpp.

References BOOST_CHECK_MESSAGE(), BOOST_REQUIRE(), HISTORY_FILE_DATA::content, COMMON_SETTINGS::AUTO_BACKUP::enabled, PGM_BASE::GetCommonSettings(), LOCAL_HISTORY::GetHeadHash(), COMMON_SETTINGS::m_Backup, path, Pgm(), project, LOCAL_HISTORY::RegisterSaver(), HISTORY_FILE_DATA::relativePath, LOCAL_HISTORY::RunRegisteredSaversAndCommit(), and LOCAL_HISTORY::UnregisterSaver().

◆ BOOST_AUTO_TEST_CASE() [5/10]

BOOST_AUTO_TEST_CASE ( NoSnapshotWithoutProjectFile )

When pcbnew runs standalone with no project loaded, saving a board can land anywhere on the filesystem.

CommitFullProjectSnapshot used to recursively walk that directory and call git_status_file on every entry. If the user saved into /tmp (or any directory with millions of files), pcbnew would peg a CPU for hours. Verify that LOCAL_HISTORY refuses to do any work for a directory that is not a real KiCad project.

Definition at line 157 of file test_history_autosave.cpp.

References LOCAL_HISTORY::CommitFullProjectSnapshot(), COMMON_SETTINGS::AUTO_BACKUP::enabled, PGM_BASE::GetCommonSettings(), LOCAL_HISTORY::Init(), COMMON_SETTINGS::m_Backup, path, Pgm(), and LOCAL_HISTORY::TagSave().

◆ BOOST_AUTO_TEST_CASE() [6/10]

BOOST_AUTO_TEST_CASE ( RestoreCommitPreservesNestedProject )

Regression test: a user reported that opening a project containing a nested project and accepting "restore previous version" deleted the entire nested project.

The data-loss path was that LOCAL_HISTORY treated the nested project's files as ordinary subtree contents, captured them in the parent's snapshot, then on restore proposed them for deletion and (because backupCurrentFiles renamed whole top-level entries) wiped the nested directory.

The fix: collectProjectFiles() and findFilesToDelete() must skip subtrees that contain their own .kicad_pro file, and the restore confirmation dialog must enter the non-destructive "Keep All Files" path automatically when a nested project is at risk.

This test exercises the simple reported scenario - nested project as a top-level subdir.

Definition at line 302 of file test_history_autosave.cpp.

References BOOST_CHECK_MESSAGE(), BOOST_REQUIRE(), LOCAL_HISTORY::CommitFullProjectSnapshot(), COMMON_SETTINGS::AUTO_BACKUP::enabled, PGM_BASE::GetCommonSettings(), LOCAL_HISTORY::GetHeadHash(), COMMON_SETTINGS::m_Backup, Pgm(), and LOCAL_HISTORY::RestoreCommit().

◆ BOOST_AUTO_TEST_CASE() [7/10]

BOOST_AUTO_TEST_CASE ( RestoreCommitPreservesZipBackupsDirectory )

Definition at line 240 of file test_history_autosave.cpp.

References BOOST_CHECK_MESSAGE(), BOOST_REQUIRE(), LOCAL_HISTORY::CommitFullProjectSnapshot(), COMMON_SETTINGS::AUTO_BACKUP::enabled, PGM_BASE::GetCommonSettings(), LOCAL_HISTORY::GetHeadHash(), COMMON_SETTINGS::m_Backup, Pgm(), and LOCAL_HISTORY::RestoreCommit().

◆ BOOST_AUTO_TEST_CASE() [8/10]

BOOST_AUTO_TEST_CASE ( RestoreCommitRetainsTimestampedBackup )

The retained backup directory must be timestamped (Windows-safe, no colons) and survive the success path of RestoreCommit so the user can recover any displaced file.

Replaces the old behavior where _restore_backup/ was unconditionally rmdir'd on success.

Definition at line 364 of file test_history_autosave.cpp.

References BOOST_CHECK_MESSAGE(), BOOST_REQUIRE(), LOCAL_HISTORY::CommitFullProjectSnapshot(), COMMON_SETTINGS::AUTO_BACKUP::enabled, PGM_BASE::GetCommonSettings(), LOCAL_HISTORY::GetHeadHash(), COMMON_SETTINGS::m_Backup, name, Pgm(), and LOCAL_HISTORY::RestoreCommit().

◆ BOOST_AUTO_TEST_CASE() [9/10]

BOOST_AUTO_TEST_CASE ( SaveToHistoryUnsavedBoardProducesNothing )

SaveToHistory with a real project but no board filename should not produce any file data (the board is unsaved).

It must also not crash.

Definition at line 126 of file test_history_autosave.cpp.

References BOOST_REQUIRE(), BOARD::ClearProject(), BOARD::GetFileName(), PROJECT::GetProjectPath(), SETTINGS_MANAGER::LoadProject(), SETTINGS_MANAGER::Prj(), BOARD::SaveToHistory(), BOARD::SetProject(), and SETTINGS_MANAGER::UnloadProject().

◆ BOOST_AUTO_TEST_CASE() [10/10]

BOOST_AUTO_TEST_CASE ( SaveToHistoryWithNullProjectDoesNotCrash )

Regression test for https://gitlab.com/kicad/code/kicad/-/issues/23737.

After importing a non-KiCad board, BOARD::SaveToHistory could be invoked from the autosave timer while the board's project pointer was transiently null (between unloading the previous project and linking the new one). The function then dereferenced GetProject() and crashed with EXCEPTION_ACCESS_VIOLATION_READ. SaveToHistory must tolerate a null project and bail out cleanly without crashing.

Definition at line 110 of file test_history_autosave.cpp.

References BOOST_AUTO_TEST_CASE(), BOOST_REQUIRE(), BOARD::GetProject(), and BOARD::SaveToHistory().

Functions