Saves DRC panel entries back to .kicad_dru files. More...

#include <drc_re_rule_saver.h>

Public Member Functions
	DRC_RULE_SAVER ()

bool	SaveFile (const wxString &aPath, const std::vector< DRC_RE_LOADED_PANEL_ENTRY > &aEntries, const BOARD *aBoard=nullptr)
	Save all panel entries to a file.

wxString	GenerateRulesText (const std::vector< DRC_RE_LOADED_PANEL_ENTRY > &aEntries, const BOARD *aBoard=nullptr)
	Generate rule text from panel entries.

Private Member Functions
wxString	generateRuleText (const DRC_RE_LOADED_PANEL_ENTRY &aEntry, const BOARD *aBoard)
	Generate the rule text for a single panel entry.

wxString	generateLayerClause (const LSET &aLayers, const BOARD *aBoard)
	Generate a layer clause from an LSET.

wxString	generateSeverityClause (SEVERITY aSeverity)
	Generate a severity clause.

wxString	generateMergedRuleText (const std::vector< const DRC_RE_LOADED_PANEL_ENTRY * > &aEntries, const BOARD *aBoard)
	Generate a merged rule text from multiple panel entries with the same name/condition.

Detailed Description

Saves DRC panel entries back to .kicad_dru files.

This class handles the conversion of graphical panel entries back to text-based DRC rules. It supports round-trip preservation, meaning unedited rules will be saved with their original text intact.

Definition at line 44 of file drc_re_rule_saver.h.

Constructor & Destructor Documentation

◆ DRC_RULE_SAVER()

DRC_RULE_SAVER::DRC_RULE_SAVER ( )

Definition at line 35 of file drc_re_rule_saver.cpp.

Member Function Documentation

◆ generateLayerClause()

wxString DRC_RULE_SAVER::generateLayerClause	(	const LSET &	aLayers,
		const BOARD *	aBoard )

private

Generate a layer clause from an LSET.

Parameters

aLayers	The layer set.
aBoard	The board for layer name resolution.

Returns: Layer clause string like "(layer \"F.Cu\" \"B.Cu\")".

Definition at line 158 of file drc_re_rule_saver.cpp.

References BOARD::GetLayerName(), and LSET::Seq().

Referenced by generateMergedRuleText(), and generateRuleText().

◆ generateMergedRuleText()

wxString DRC_RULE_SAVER::generateMergedRuleText	(	const std::vector< const DRC_RE_LOADED_PANEL_ENTRY * > &	aEntries,
		const BOARD *	aBoard )

private

Generate a merged rule text from multiple panel entries with the same name/condition.

Combines constraint clauses from multiple entries into a single rule.

Parameters

aEntries	Vector of entries to merge (must have same name and condition).
aBoard	Optional board for layer name resolution.

Returns: Merged rule text.

Definition at line 187 of file drc_re_rule_saver.cpp.

References DRC_RE_LOADED_PANEL_ENTRY::condition, RULE_GENERATION_CONTEXT::conditionExpression, RULE_GENERATION_CONTEXT::constraintCode, CTX_QUOTED_STR, EscapeString(), generateLayerClause(), generateSeverityClause(), RULE_GENERATION_CONTEXT::layerClause, RPT_SEVERITY_ERROR, RPT_SEVERITY_UNDEFINED, DRC_RE_LOADED_PANEL_ENTRY::ruleName, RULE_GENERATION_CONTEXT::ruleName, and DRC_RE_BASE_CONSTRAINT_DATA::sanitizeRuleName().

Referenced by GenerateRulesText().

◆ GenerateRulesText()

wxString DRC_RULE_SAVER::GenerateRulesText	(	const std::vector< DRC_RE_LOADED_PANEL_ENTRY > &	aEntries,
		const BOARD *	aBoard = nullptr )

Generate rule text from panel entries.

Parameters

aEntries	Vector of panel entries to convert.
aBoard	Optional board for layer name resolution.

Returns: String containing all rules in DRC file format.

Definition at line 57 of file drc_re_rule_saver.cpp.

References generateMergedRuleText(), generateRuleText(), and result.

Referenced by BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), BOOST_AUTO_TEST_CASE(), and SaveFile().

◆ generateRuleText()

wxString DRC_RULE_SAVER::generateRuleText	(	const DRC_RE_LOADED_PANEL_ENTRY &	aEntry,
		const BOARD *	aBoard )

private

Generate the rule text for a single panel entry.

If the entry has not been edited and has original text, the original text is returned for round-trip fidelity. Otherwise, the rule is regenerated from the panel data.

Parameters