test_altium_parser_utils.cpp

Go to the documentation of this file.

/*
 * This program source code file is part of KiCad, a free EDA CAD application.
 *
 * Copyright (C) 2021 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 2
 * 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, you may find one here:
 * http://www.gnu.org/licenses/old-licenses/gpl-2.0.html
 * or you may search the http://www.gnu.org website for the version 2 license,
 * or you may write to the Free Software Foundation, Inc.,
 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA
 */
 
#include <qa_utils/wx_utils/unit_test_utils.h>
 
#include <common/io/altium/altium_parser_utils.h>
 
struct ALTIUM_PARSER_UTILS_FIXTURE
{
 ALTIUM_PARSER_UTILS_FIXTURE() {}
};
 
 
BOOST_FIXTURE_TEST_SUITE( AltiumParserUtils, ALTIUM_PARSER_UTILS_FIXTURE )
 
 
struct SPECIAL_STRINGS_TO_KICAD
{
 wxString input;
 wxString exp_result;
 std::map<wxString, wxString> override;
};
 
static const std::vector<SPECIAL_STRINGS_TO_KICAD> sch_special_string_to_kicad_property = {
 // Empty
 { "", "", {} },
 // No Special Strings
 { "A", "A", {} },
 { " A", " A", {} },
 { "A ", "A ", {} },
 { "A=B", "A=B", {} },
 { "A=B+C", "A=B+C", {} },
 { "A\nB", "A\nB", {} },
 { "A\tB", "A\tB", {} },
 { "This is a long text with spaces", "This is a long text with spaces", {} },
 // Text format (underscore,...), TODO: add
 // Escaping, TODO: add
 { "+", "+", {} },
 { "'", "'", {} },
 { "'A'", "'A'", {} },
 { "A+B", "A+B", {} },
 { "A=B", "A=B", {} },
 { "$", "$", {} },
 { "{", "{", {} },
 { "}", "}", {} },
 { "${A}", "${A}", {} }, // TODO: correct substitution
 // Simple special strings
 { "=A", "${A}", {} },
 { "=A", "${C}", { { "A", "C" } } },
 { "=A_B", "${A_B}", {} },
 // Combined special strings
 { "=A+B", "${A}${B}", {} },
 { "=A+B", "${A}${B}", {} },
 { "=A+B", "${C}${B}", { { "A", "C" } } },
 { "=A+B", "${C}${D}", { { "A", "C" }, { "B", "D" } } },
 // Case-insensitive special strings
 { "=A", "${C}", { { "A", "C" } } },
 { "=a", "${C}", { { "A", "C" } } },
 { "=AB", "${C}", { { "AB", "C" } } },
 { "=aB", "${C}", { { "AB", "C" } } },
 { "=Ab", "${C}", { { "AB", "C" } } },
 { "=ab", "${C}", { { "AB", "C" } } },
 // Special strings with text
 { "='A'", "A", {} },
 { "='This is a long text with spaces'", "This is a long text with spaces", {} },
 { "='='", "=", {} },
 { "='+'", "+", {} },
 { "='$'", "$", {} },
 { "='{'", "{", {} },
 { "='}'", "}", {} },
 { "='${A}'", "${A}", {} }, // TODO: correct substitution
 { "='A'+'B'", "AB", {} },
 { "='A'+' '", "A ", {} },
 { "=' '+'B'", " B", {} },
 { "='A'+B", "A${B}", {} },
 { "='A'+\"B\"", "A${B}", {} },
 { "='A' + \"B\"", "A${B}", {} },
 { "=\"A\"+'B'", "${A}B", {} },
 { "=\"A\" + 'B'", "${A}B", {} },
 { "=A+'B'", "${A}B", {} },
 { "=A+' '+B", "${A} ${B}", {} },
 { "='A'+B+'C'+D", "A${B}C${D}", {} },
 // Some special cases we do not know yet how to handle correctly. But we should not crash ;)
 { "=+", "", {} },
 { "=++", "", {} },
 { "=+++", "", {} },
 { "=B+", "${B}", {} },
 { "=+B", "${B}", {} },
 { "=B++", "${B}", {} },
 { "=+B+", "${B}", {} },
 { "=++B", "${B}", {} },
 { " =", " =", {} },
 { "= ", "", {} },
 { "= A", "${A}", {} },
 { "=A ", "${A}", {} },
 { "='A'B", "A", {} },
 { "=A'B'", "B", {} },
 { "=A'B", "B", {} },
 { "=A+ 'B'", "${A}B", {} },
};
 
 
BOOST_AUTO_TEST_CASE( AltiumSchSpecialStringsToKiCadVariablesProperties )
{
 for( const auto& c : sch_special_string_to_kicad_property )
 {
 BOOST_TEST_CONTEXT( wxString::Format( wxT( "'%s' -> '%s'" ), c.input, c.exp_result ) )
 {
 wxString result = AltiumSchSpecialStringsToKiCadVariables( c.input, c.override );
 
 // These are all valid
 BOOST_CHECK_EQUAL( result, c.exp_result );
 }
 }
}
 
static const std::vector<SPECIAL_STRINGS_TO_KICAD> pcb_special_string_to_kicad_property = {
 // Empty
 { "", "", {} },
 // No Special Strings
 { "A", "A", {} },
 { " A", " A", {} },
 { "A ", "A ", {} },
 { "A=B", "A=B", {} },
 { "A=B+C", "A=B+C", {} },
 { "A\nB", "A\nB", {} },
 { "A\tB", "A\tB", {} },
 { "This is a long text with spaces", "This is a long text with spaces", {} },
 // Text format (underscore,...), TODO: add
 // Escaping, TODO: add
 { "'", "'", {} },
 { "'A'", "'A'", {} },
 { "$", "$", {} },
 { "{", "{", {} },
 { "}", "}", {} },
 { "${A}", "${A}", {} }, // TODO: correct substitution
 // Simple special strings starting with dot
 { ".A", "${A}", {} },
 { ".A", "${C}", { { "A", "C" } } },
 { ".A_B", "${A_B}", {} },
 // Concatenated special strings
 /*{ "'.A'", "${A}", {} },
 { "'.A''.B'", "${A}${B}", {} },
 { "'.A''.B'", "${C}${B}", { { "A", "C" } } },
 { "'.A''.B'", "${C}${D}", { { "A", "C" }, { "B", "D" } } },
 { "A='.A', B='.B'", "A=${A}, B=${B}", {} },*/
 // Case-insensitive special strings
 { ".A", "${C}", { { "A", "C" } } },
 { ".a", "${C}", { { "A", "C" } } },
 { ".AB", "${C}", { { "AB", "C" } } },
 { ".aB", "${C}", { { "AB", "C" } } },
 { ".Ab", "${C}", { { "AB", "C" } } },
 { ".ab", "${C}", { { "AB", "C" } } },
 // Some special cases we do not know yet how to handle correctly. But we should not crash ;)
 { "''", "''", {} },
 { " .", " .", {} },
 { ". ", "${ }", {} },
 { ". A", "${ A}", {} },
 { ".A ", "${A }", {} },
 { " .A", " .A", {} },
 { "...", "${..}", {} },
};
 
 
BOOST_AUTO_TEST_CASE( AltiumPcbSpecialStringsToKiCadStringsProperties )
{
 for( const auto& c : pcb_special_string_to_kicad_property )
 {
 BOOST_TEST_CONTEXT( wxString::Format( wxT( "'%s' -> '%s'" ), c.input, c.exp_result ) )
 {
 wxString result = AltiumPcbSpecialStringsToKiCadStrings( c.input, c.override );
 
 // These are all valid
 BOOST_CHECK_EQUAL( result, c.exp_result );
 }
 }
}
 
BOOST_AUTO_TEST_SUITE_END()