test_symbol_library_adapter.cpp

Go to the documentation of this file.

/*
 * This program source code file is part of KiCad, a free EDA CAD application.
 *
 * Copyright The KiCad Developers, see AUTHORS.txt for contributors.
 *
 * This program is free software: you can redistribute it and/or modify it
 * under the terms of the GNU General Public License as published by the
 * Free Software Foundation, either version 3 of the License, or (at your
 * option) any later version.
 *
 * This program is distributed in the hope that it will be useful, but
 * WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 * General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program.  If not, see <https://www.gnu.org/licenses/>.
 */
 
#include <qa_utils/wx_utils/unit_test_utils.h>
 
#include <libraries/symbol_library_adapter.h>
#include <libraries/library_manager.h>
 
#include <wx/textfile.h>
 
#include <filesystem>
 
 
namespace
{

class TEST_SYMBOL_LIBRARY_ADAPTER : public SYMBOL_LIBRARY_ADAPTER
{
public:
    using SYMBOL_LIBRARY_ADAPTER::SYMBOL_LIBRARY_ADAPTER;
 
    void SeedLoadError( const wxString& aNickname )
    {
        m_libraries[aNickname].status.load_status = LOAD_STATUS::LOAD_ERROR;
    }

    void SeedLoadError( const wxString& aNickname, const wxString& aMessage )
    {
        m_libraries[aNickname].status.load_status = LOAD_STATUS::LOAD_ERROR;
        m_libraries[aNickname].status.error = LIBRARY_ERROR( aMessage );
    }

    void SeedLoaded( const wxString& aNickname )
    {
        m_libraries[aNickname].status.load_status = LOAD_STATUS::LOADED;
    }
};
 

class SCOPED_SYM_LIB_TABLE
{
public:
    SCOPED_SYM_LIB_TABLE( const std::vector<wxString>& aNicknamesInTableOrder )
    {
        std::error_code ec;
        m_dir = std::filesystem::temp_directory_path( ec )
                / std::filesystem::path( wxString::Format( wxS( "kicad_qa_symlibtbl_%p" ), (void*) this )
                                                 .ToStdString() );
        std::filesystem::create_directories( m_dir, ec );
 
        wxTextFile file( wxString( ( m_dir / "sym-lib-table" ).string() ) );
        file.Create();
        file.AddLine( wxS( "(sym_lib_table" ) );
        file.AddLine( wxS( "  (version 7)" ) );
 
        for( const wxString& nickname : aNicknamesInTableOrder )
        {
            file.AddLine( wxString::Format(
                    wxS( "  (lib (name \"%s\")(type \"KiCad\")(uri \"${KIPRJMOD}/%s.kicad_sym\")(options \"\")(descr \"\"))" ),
                    nickname, nickname ) );
        }
 
        file.AddLine( wxS( ")" ) );
        file.Write();
        file.Close();
    }
 
    ~SCOPED_SYM_LIB_TABLE()
    {
        std::error_code ec;
        std::filesystem::remove_all( m_dir, ec );
    }
 
    wxString Path() const { return wxString( m_dir.string() ); }
 
private:
    std::filesystem::path m_dir;
};
 
} // namespace
 
 
BOOST_AUTO_TEST_SUITE( SymbolLibraryAdapter )
 
 

BOOST_AUTO_TEST_CASE( IsSymbolLibWritableHandlesFailedLoad )
{
    LIBRARY_MANAGER             manager;
    TEST_SYMBOL_LIBRARY_ADAPTER adapter( manager );
 
    adapter.SeedLoadError( wxS( "BadLib" ) );
 
    BOOST_CHECK_EQUAL( adapter.IsSymbolLibWritable( wxS( "BadLib" ) ), false );
 
    // A library that was never even attempted must also be safe.
    BOOST_CHECK_EQUAL( adapter.IsSymbolLibWritable( wxS( "NeverSeen" ) ), false );
}
 

BOOST_AUTO_TEST_CASE( GetLibraryNamesSortedRegardlessOfTableOrder )
{
    const std::vector<wxString> tableOrder = { wxS( "Zebra" ), wxS( "amplifier" ), wxS( "Device" ),
                                               wxS( "Board_2" ), wxS( "Board_10" ) };
 
    SCOPED_SYM_LIB_TABLE tableFile( tableOrder );
 
    LIBRARY_MANAGER manager;
    manager.LoadProjectTables( tableFile.Path(), { LIBRARY_TABLE_TYPE::SYMBOL } );
 
    TEST_SYMBOL_LIBRARY_ADAPTER adapter( manager );
 
    for( const wxString& nickname : tableOrder )
        adapter.SeedLoaded( nickname );
 
    const std::vector<wxString> names = adapter.GetLibraryNames();
 
    const std::vector<wxString> expected = { wxS( "amplifier" ), wxS( "Board_2" ), wxS( "Board_10" ),
                                             wxS( "Device" ), wxS( "Zebra" ) };
 
    BOOST_CHECK_EQUAL_COLLECTIONS( names.begin(), names.end(), expected.begin(), expected.end() );
}
 

BOOST_AUTO_TEST_CASE( PartiallyLoadedTableReportsNoSpuriousErrors )
{
    const std::vector<wxString> tableOrder = { wxS( "Device" ), wxS( "Connector" ), wxS( "Amplifier" ),
                                               wxS( "Regulator" ), wxS( "BadLib" ) };
 
    SCOPED_SYM_LIB_TABLE tableFile( tableOrder );
 
    LIBRARY_MANAGER manager;
    manager.LoadProjectTables( tableFile.Path(), { LIBRARY_TABLE_TYPE::SYMBOL } );
 
    TEST_SYMBOL_LIBRARY_ADAPTER adapter( manager );
 
    // Simulate a preload caught mid-flight: two libraries resolved, one genuinely failed,
    // and the remaining table rows have no entry yet because loading has not reached them.
    adapter.SeedLoaded( wxS( "Device" ) );
    adapter.SeedLoaded( wxS( "Connector" ) );
    adapter.SeedLoadError( wxS( "BadLib" ), wxS( "File is corrupt" ) );
 
    const wxString errors = adapter.GetLibraryLoadErrors();
 
    // The unloaded-but-present rows must not masquerade as missing-from-table errors.
    BOOST_CHECK( !errors.Contains( wxS( "not found in library table" ) ) );
    BOOST_CHECK( !errors.Contains( wxS( "Amplifier" ) ) );
    BOOST_CHECK( !errors.Contains( wxS( "Regulator" ) ) );
 
    // The genuine failure must still be reported.
    BOOST_CHECK( errors.Contains( wxS( "BadLib" ) ) );
    BOOST_CHECK( errors.Contains( wxS( "File is corrupt" ) ) );
}
 
 
BOOST_AUTO_TEST_SUITE_END()