/* * This program source code file is part of KiCad, a free EDA CAD application. * * Copyright (C) 2023 Wayne Stambaugh * 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 . */ /** * @file * Test suite for SYMBOL_LIBRARY_MANAGER object. */ #include // Code under test #include #include #include class SYMBOL_LIBRARY_MANAGER_TEST_FIXTURE { public: SYMBOL_LIBRARY_MANAGER_TEST_FIXTURE() { } }; BOOST_FIXTURE_TEST_SUITE( SymbolLibraryManager, SYMBOL_LIBRARY_MANAGER_TEST_FIXTURE ) /** * Test the SYMBOL_BUFFER object. */ BOOST_AUTO_TEST_CASE( SymbolBuffer ) { std::unique_ptr symbol = std::make_unique( wxS( "Symbol" ) ); std::unique_ptr screen = std::make_unique(); LIB_SYMBOL& symbolRef = *symbol; SYMBOL_BUFFER buffer( std::move( symbol ), std::move( screen ) ); BOOST_CHECK( !buffer.IsModified() ); BOOST_CHECK( &buffer.GetSymbol() == &symbolRef ); BOOST_CHECK( buffer.GetOriginal() == symbolRef ); buffer.GetScreen()->SetContentModified(); BOOST_CHECK( buffer.IsModified() ); std::unique_ptr originalSymbol = std::make_unique( wxS( "OriginalSymbol" ) ); LIB_SYMBOL& originalSymbolRef = *originalSymbol; buffer.SetOriginal( std::move( originalSymbol ) ); BOOST_CHECK( &buffer.GetOriginal() == &originalSymbolRef ); BOOST_CHECK( buffer.GetOriginal() == originalSymbolRef ); BOOST_CHECK( &buffer.GetSymbol() != &buffer.GetOriginal() ); } /** * Test the LIB_BUFFER object. */ BOOST_AUTO_TEST_CASE( LibBuffer ) { wxArrayString symbolNames; LIB_BUFFER libBuffer( wxS( "TestLibrary" ) ); BOOST_CHECK( !libBuffer.IsModified() ); BOOST_CHECK_EQUAL( libBuffer.GetHash(), 1 ); auto parentSymbol1 = std::make_unique( wxS( "Parent1" ) ); // A but clunky, but real code would get symbol from the LIB_BUFFER // via GetSymbol etc, rather than retaining a reference after construction. LIB_SYMBOL& parentSymbol1Ref = *parentSymbol1; BOOST_CHECK_EQUAL( libBuffer.GetSymbol( parentSymbol1->GetName() ), nullptr ); parentSymbol1->GetValueField().SetText( parentSymbol1->GetName() ); libBuffer.CreateBuffer( std::move( parentSymbol1 ), std::make_unique() ); BOOST_CHECK( libBuffer.GetSymbol( parentSymbol1Ref.GetName() ) == &parentSymbol1Ref ); BOOST_CHECK( !libBuffer.HasDerivedSymbols( parentSymbol1Ref.GetName() ) ); BOOST_CHECK_EQUAL( libBuffer.GetHash(), 2 ); libBuffer.GetSymbolNames( symbolNames ); BOOST_CHECK_EQUAL( symbolNames.GetCount(), 1 ); BOOST_CHECK_EQUAL( symbolNames[0], parentSymbol1Ref.GetName() ); symbolNames.Clear(); libBuffer.GetSymbolNames( symbolNames, SYMBOL_NAME_FILTER::ROOT_ONLY ); BOOST_CHECK_EQUAL( symbolNames.GetCount(), 1 ); BOOST_CHECK_EQUAL( symbolNames[0], parentSymbol1Ref.GetName() ); symbolNames.Clear(); libBuffer.GetSymbolNames( symbolNames, SYMBOL_NAME_FILTER::DERIVED_ONLY ); BOOST_CHECK_EQUAL( symbolNames.GetCount(), 0 ); auto childSymbol1 = std::make_unique( wxS( "Child1" ) ); LIB_SYMBOL& childSymbol1Ref = *childSymbol1; childSymbol1->SetParent( &parentSymbol1Ref ); childSymbol1->GetValueField().SetText( childSymbol1->GetName() ); libBuffer.CreateBuffer( std::move( childSymbol1 ), std::make_unique() ); BOOST_CHECK( libBuffer.GetSymbol( childSymbol1Ref.GetName() ) == &childSymbol1Ref ); BOOST_CHECK( libBuffer.HasDerivedSymbols( parentSymbol1Ref.GetName() ) ); BOOST_CHECK_EQUAL( libBuffer.GetHash(), 3 ); symbolNames.Clear(); libBuffer.GetSymbolNames( symbolNames ); BOOST_CHECK_EQUAL( symbolNames.GetCount(), 2 ); BOOST_CHECK_EQUAL( symbolNames[0], parentSymbol1Ref.GetName() ); BOOST_CHECK_EQUAL( symbolNames[1], childSymbol1Ref.GetName() ); symbolNames.Clear(); libBuffer.GetSymbolNames( symbolNames, SYMBOL_NAME_FILTER::DERIVED_ONLY ); BOOST_CHECK_EQUAL( symbolNames.GetCount(), 1 ); BOOST_CHECK_EQUAL( symbolNames[0], childSymbol1Ref.GetName() ); symbolNames.Clear(); BOOST_CHECK_EQUAL( libBuffer.GetDerivedSymbolNames( parentSymbol1Ref.GetName(), symbolNames ), 1 ); BOOST_CHECK_EQUAL( symbolNames[0], childSymbol1Ref.GetName() ); std::shared_ptr buf = libBuffer.GetBuffer( parentSymbol1Ref.GetName() ); LIB_SYMBOL tmp( parentSymbol1Ref ); tmp.GetDescriptionField().SetText( wxS( "Description" ) ); libBuffer.UpdateBuffer( *buf, tmp ); BOOST_CHECK_EQUAL( libBuffer.GetHash(), 4 ); BOOST_CHECK( *libBuffer.GetSymbol( parentSymbol1Ref.GetName() ) == tmp ); const bool deletedOk = libBuffer.DeleteBuffer( *buf ); BOOST_CHECK( deletedOk ); BOOST_CHECK( libBuffer.GetBuffers().empty() ); } /** * Test new symbol creation routines. */ BOOST_AUTO_TEST_CASE( NewSymbolCreation ) { NEW_SYMBOL_PROPERTIES props; props.name = wxS( "Standalone" ); props.reference = wxS( "U" ); props.unitCount = 2; props.pinNameInside = true; props.pinTextPosition = 2; props.powerSymbol = false; props.showPinNumber = true; props.showPinName = true; props.unitsInterchangeable = false; props.includeInBom = true; props.includeOnBoard = true; props.alternateBodyStyle = false; std::unique_ptr standalone = LIB_SYMBOL_LIBRARY_MANAGER::CreateSymbol( props, nullptr ); BOOST_CHECK_EQUAL( standalone->GetReferenceField().GetText(), props.reference ); BOOST_CHECK_EQUAL( standalone->GetUnitCount(), props.unitCount ); BOOST_CHECK( standalone->GetPinNameOffset() > 0 ); auto parent = std::make_unique( wxS( "Parent" ) ); parent->GetValueField().SetText( parent->GetName() ); SCH_FIELD* user = new SCH_FIELD( parent.get(), FIELD_T::USER, wxS( "UF" ) ); user->SetText( wxS( "V" ) ); parent->AddField( user ); props.name = wxS( "Child" ); props.parentSymbolName = parent->GetName(); props.keepFootprint = false; props.keepDatasheet = false; props.transferUserFields = true; props.keepContentUserFields = false; std::unique_ptr child = LIB_SYMBOL_LIBRARY_MANAGER::CreateSymbol( props, parent.get() ); BOOST_CHECK( child->GetParent().lock().get() == parent.get() ); BOOST_CHECK( child->GetFootprintField().GetText().IsEmpty() ); BOOST_CHECK( child->GetDatasheetField().GetText().IsEmpty() ); std::vector childFields; child->GetFields( childFields ); bool found = false; for( SCH_FIELD* field : childFields ) { if( field->GetId() == FIELD_T::USER ) { found = true; BOOST_CHECK( field->GetText().IsEmpty() ); } } BOOST_CHECK( found ); } BOOST_AUTO_TEST_SUITE_END()