kicad-source/eeschema/sim/sim_model_serializer.cpp
John Beard 3d6d8b9946 Strip richio.h from headers that don't need them
Like the DSNLEXER header, this has visibility in over 700
files, whereas well under half actually use any of it
(quite a bit, but not all, of it actually via DSNLEXER)

Many places already forward-declare the OUTPUTFORMATTER type,
by doing that for the others, it still possible to use the
non-IO methods without having to see richio.h.
2024-10-04 18:06:18 +01:00

320 lines
10 KiB
C++

/*
* This program source code file is part of KiCad, a free EDA CAD application.
*
* Copyright (C) 2022 Mikolaj Wielgus
* Copyright (C) 2022-2023 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, you may find one here:
* https://www.gnu.org/licenses/gpl-3.0.html
* or you may search the http://www.gnu.org website for the version 3 license,
* or you may write to the Free Software Foundation, Inc.,
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA
*/
#include "sim/sim_model_serializer.h"
#include <ki_exception.h>
#include <fmt/core.h>
#include <pegtl.hpp>
#include <pegtl/contrib/parse_tree.hpp>
#include <boost/algorithm/string/replace.hpp>
#include <boost/algorithm/string/case_conv.hpp>
#include <boost/algorithm/string/predicate.hpp>
#include <string_utils.h>
namespace SIM_MODEL_SERIALIZER_PARSER
{
using namespace SIM_MODEL_SERIALIZER_GRAMMAR;
template <typename Rule> struct fieldParamValuePairsSelector : std::false_type {};
template <> struct fieldParamValuePairsSelector<param> : std::true_type {};
template <> struct fieldParamValuePairsSelector<flagParam> : std::true_type {};
template <> struct fieldParamValuePairsSelector<quotedStringContent> : std::true_type {};
template <> struct fieldParamValuePairsSelector<unquotedString> : std::true_type {};
template <typename Rule> struct pinSequenceSelector : std::false_type {};
template <> struct pinSequenceSelector<pinAssignment> : std::true_type {};
template <> struct pinSequenceSelector<pinSymbolPinNumber> : std::true_type {};
template <> struct pinSequenceSelector<pinName> : std::true_type {};
template <typename Rule> struct fieldInferValueSelector : std::false_type {};
template <> struct fieldInferValueSelector<number<SIM_VALUE::TYPE_FLOAT, NOTATION::SI>> : std::true_type {};
}
std::string SIM_MODEL_SERIALIZER::GenerateDevice() const
{
return m_model.GetDeviceInfo().fieldValue;
}
std::string SIM_MODEL_SERIALIZER::GenerateDeviceSubtype() const
{
return m_model.GetTypeInfo().fieldValue;
}
std::string SIM_MODEL_SERIALIZER::GenerateValue() const
{
const SIM_MODEL::PARAM& param = m_model.GetParamOverride( 0 );
std::string result = param.value;
if( result == "" )
result = m_model.GetDeviceInfo().fieldValue;
return result;
}
std::string SIM_MODEL_SERIALIZER::GenerateParams() const
{
std::string result;
bool isFirst = true;
for( int i = 0; i < m_model.GetParamCount(); ++i )
{
if( i == 0 && m_model.IsStoredInValue() )
continue;
const SIM_MODEL::PARAM& param = m_model.GetParamOverride( i );
if( param.value == ""
&& !( i == 0 && m_model.HasPrimaryValue() && !m_model.IsStoredInValue() ) )
{
continue;
}
if( m_model.GetBaseModel() && m_model.GetBaseModel()->GetParam( i ).value == param.value )
continue;
// If the parameter is an enum and the value is default, don't write anything.
if( param.info.enumValues.size() >= 1 && param.value == param.info.defaultValue )
continue;
std::string paramValuePair = generateParamValuePair( param );
if( paramValuePair == "" )
continue; // Prevent adding empty spaces.
if( isFirst ) // Don't add a space at the beginning.
isFirst = false;
else
result.append( " " );
result.append( paramValuePair );
}
return result;
}
std::string SIM_MODEL_SERIALIZER::GeneratePins() const
{
std::string result;
std::vector<std::reference_wrapper<const SIM_MODEL_PIN>> pins = m_model.GetPins();
// m_model.GetPins() returns pins in the order they appear in the model, but the keys in the
// key=value pairs we create here are symbol pin numbers, so we sort the pins so that they are
// ordered by the latter instead.
std::sort( pins.begin(), pins.end(),
[]( const SIM_MODEL_PIN& lhs, const SIM_MODEL_PIN& rhs )
{
return StrNumCmp( lhs.symbolPinNumber, rhs.symbolPinNumber, true ) < 0;
} );
for( const SIM_MODEL_PIN& pin : pins )
{
std::string symbolPinNumber( pin.symbolPinNumber.ToUTF8() );
if( symbolPinNumber != "" )
{
if( !result.empty() )
result.append( " " );
result.append( fmt::format( "{}={}", symbolPinNumber, pin.modelPinName ) );
}
}
return result;
}
std::string SIM_MODEL_SERIALIZER::GenerateEnable() const
{
return m_model.IsEnabled() ? "" : "0";
}
void SIM_MODEL_SERIALIZER::ParseValue( const std::string& aValue )
{
try
{
tao::pegtl::string_input<> in( aValue, "Value field" );
auto root =
tao::pegtl::parse_tree::parse<SIM_MODEL_SERIALIZER_PARSER::fieldInferValueGrammar,
SIM_MODEL_SERIALIZER_PARSER::fieldInferValueSelector,
tao::pegtl::nothing,
SIM_MODEL_SERIALIZER_PARSER::control>
( in );
for( const auto& node : root->children )
{
if( node->is_type<SIM_MODEL_SERIALIZER_PARSER::number<SIM_VALUE::TYPE_FLOAT,
SIM_VALUE::NOTATION::SI>>()
&& node->string() != "" )
{
m_model.SetParamValue( 0, node->string() );
}
}
}
catch( const tao::pegtl::parse_error& e )
{
THROW_IO_ERROR( e.what() );
}
m_model.SetIsStoredInValue( true );
}
bool SIM_MODEL_SERIALIZER::ParseParams( const std::string& aParams )
{
tao::pegtl::string_input<> in( aParams, "Sim.Params field" );
std::unique_ptr<tao::pegtl::parse_tree::node> root;
try
{
// Using parse tree instead of actions because we don't care about performance that much,
// and having a tree greatly simplifies things.
root = tao::pegtl::parse_tree::parse<SIM_MODEL_SERIALIZER_PARSER::fieldParamValuePairsGrammar,
SIM_MODEL_SERIALIZER_PARSER::fieldParamValuePairsSelector,
tao::pegtl::nothing,
SIM_MODEL_SERIALIZER_PARSER::control>
( in );
}
catch( const tao::pegtl::parse_error& e )
{
THROW_IO_ERROR( e.what() );
}
std::string paramName;
bool isPrimaryValueSet = false;
for( const auto& node : root->children )
{
if( node->is_type<SIM_MODEL_SERIALIZER_PARSER::param>() )
{
paramName = node->string();
}
// TODO: Do something with number<SIM_VALUE::TYPE_INT, ...>.
// It doesn't seem too useful?
else if( node->is_type<SIM_MODEL_SERIALIZER_PARSER::quotedStringContent>()
|| node->is_type<SIM_MODEL_SERIALIZER_PARSER::unquotedString>() )
{
wxASSERT( paramName != "" );
m_model.SetParamValue( paramName, node->string(), SIM_VALUE_GRAMMAR::NOTATION::SI );
if( m_model.GetParam( 0 ).Matches( paramName ) )
isPrimaryValueSet = true;
}
else if( node->is_type<SIM_MODEL_SERIALIZER_PARSER::quotedString>() )
{
std::string str = node->string();
// Unescape quotes.
boost::replace_all( str, "\\\"", "\"" );
m_model.SetParamValue( paramName, str, SIM_VALUE_GRAMMAR::NOTATION::SI );
}
else if( node->is_type<SIM_MODEL_SERIALIZER_PARSER::flagParam>() )
{
std::string token = node->string();
m_model.SetParamValue( token, "1", SIM_VALUE_GRAMMAR::NOTATION::SI );
}
else
{
wxFAIL;
}
}
return !m_model.HasPrimaryValue() || m_model.HasAutofill() || isPrimaryValueSet;
}
void SIM_MODEL_SERIALIZER::ParsePins( const std::string& aPins )
{
if( aPins == "" )
return;
tao::pegtl::string_input<> in( aPins, "Sim.Pins field" );
std::unique_ptr<tao::pegtl::parse_tree::node> root;
try
{
root = tao::pegtl::parse_tree::parse<SIM_MODEL_SERIALIZER_PARSER::pinSequenceGrammar,
SIM_MODEL_SERIALIZER_PARSER::pinSequenceSelector,
tao::pegtl::nothing,
SIM_MODEL_SERIALIZER_PARSER::control>
( in );
for( const auto& node : root->children )
{
std::string symbolPinNumber = node->children.at( 0 )->string();
std::string modelPinName = node->children.at( 1 )->string();
m_model.AssignSymbolPinNumberToModelPin( modelPinName, symbolPinNumber );
}
}
catch( const tao::pegtl::parse_error& e )
{
THROW_IO_ERROR( e.what() );
}
}
void SIM_MODEL_SERIALIZER::ParseEnable( const std::string& aEnable )
{
if( aEnable == "" )
return;
char c = boost::to_lower_copy( aEnable )[0];
if( c == 'n' || c == 'f' || c == '0' )
m_model.SetIsEnabled( false );
}
std::string SIM_MODEL_SERIALIZER::generateParamValuePair( const SIM_MODEL::PARAM& aParam ) const
{
std::string name = aParam.info.name;
// Because of collisions with instance parameters, we append some model parameters with "_".
if( boost::ends_with( name, "_" ) )
name = name.substr( 0, aParam.info.name.length() - 1 );
std::string value = aParam.value;
if( aParam.info.category == SIM_MODEL::PARAM::CATEGORY::FLAGS )
return value == "1" ? name : "";
if( value == "" || value.find( ' ' ) != std::string::npos )
value = fmt::format( "\"{}\"", value );
return fmt::format( "{}={}", name, value );
}