KiCad PCB EDA Suite
Loading...
Searching...
No Matches
command_sch_erc.cpp
Go to the documentation of this file.
1/*
2 * This program source code file is part of KiCad, a free EDA CAD application.
3 *
4 * Copyright (C) 2022 Mark Roszko <[email protected]>
5 * Copyright (C) 1992-2023 KiCad Developers, see AUTHORS.txt for contributors.
6 *
7 * This program is free software: you can redistribute it and/or modify it
8 * under the terms of the GNU General Public License as published by the
9 * Free Software Foundation, either version 3 of the License, or (at your
10 * option) any later version.
11 *
12 * This program is distributed in the hope that it will be useful, but
13 * WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
15 * General Public License for more details.
16 *
17 * You should have received a copy of the GNU General Public License along
18 * with this program. If not, see <http://www.gnu.org/licenses/>.
19 */
20
21#include "command_sch_erc.h"
22#include <cli/exit_codes.h>
23#include "jobs/job_sch_erc.h"
24#include <kiface_base.h>
25#include <layer_ids.h>
26#include <string_utils.h>
27#include <wx/crt.h>
28
29#include <macros.h>
30#include <wx/tokenzr.h>
31
32#define ARG_FORMAT "--format"
33#define ARG_UNITS "--units"
34#define ARG_SEVERITY_ALL "--severity-all"
35#define ARG_SEVERITY_ERROR "--severity-error"
36#define ARG_SEVERITY_WARNING "--severity-warning"
37#define ARG_SEVERITY_EXCLUSIONS "--severity-exclusions"
38#define ARG_EXIT_CODE_VIOLATIONS "--exit-code-violations"
39
41{
42 addCommonArgs( true, true, false, false );
44
45 m_argParser.add_description( UTF8STDSTR( _( "Runs the Electrical Rules Check (ERC) on the schematic and creates a report" ) ) );
46
47 m_argParser.add_argument( ARG_FORMAT )
48 .default_value( std::string( "report" ) )
49 .help( UTF8STDSTR( _( "Output file format, options: json, report" ) ) );
50
51 m_argParser.add_argument( ARG_UNITS )
52 .default_value( std::string( "mm" ) )
53 .help( UTF8STDSTR(
54 _( "Report units; valid options: in, mm, mils" ) ) );
55
56 m_argParser.add_argument( ARG_SEVERITY_ALL )
57 .help( UTF8STDSTR( _( "Report all ERC violations, this is equivalent to including all the other severity arguments" ) ) )
58 .implicit_value( true )
59 .default_value( false );
60
61 m_argParser.add_argument( ARG_SEVERITY_ERROR )
62 .help( UTF8STDSTR( _( "Report all ERC error level violations, this can be combined with the other severity arguments" ) ) )
63 .implicit_value( true )
64 .default_value( false );
65
66 m_argParser.add_argument( ARG_SEVERITY_WARNING )
67 .help( UTF8STDSTR( _( "Report all ERC warning level violations, this can be combined with the other severity arguments" ) ) )
68 .implicit_value( true )
69 .default_value( false );
70
72 .help( UTF8STDSTR( _( "Report all excluded ERC violations, this can be combined with the other severity arguments" ) ) )
73 .implicit_value( true )
74 .default_value( false );
75
77 .help( UTF8STDSTR( _( "Return a exit code depending on whether or not violations exist" ) ) )
78 .implicit_value( true )
79 .default_value( false );
80}
81
82
84{
85 std::unique_ptr<JOB_SCH_ERC> ercJob( new JOB_SCH_ERC( true ) );
86
87 ercJob->m_outputFile = m_argOutput;
88 ercJob->m_filename = m_argInput;
89 ercJob->m_exitCodeViolations = m_argParser.get<bool>( ARG_EXIT_CODE_VIOLATIONS );
90 ercJob->SetVarOverrides( m_argDefineVars );
91
92 if( m_argParser.get<bool>( ARG_SEVERITY_ALL ) )
93 {
95 }
96
97 if( m_argParser.get<bool>( ARG_SEVERITY_ERROR ) )
98 {
99 ercJob->m_severity |= RPT_SEVERITY_ERROR;
100 }
101
102 if( m_argParser.get<bool>( ARG_SEVERITY_WARNING ) )
103 {
104 ercJob->m_severity |= RPT_SEVERITY_WARNING;
105 }
106
107 if( m_argParser.get<bool>( ARG_SEVERITY_EXCLUSIONS ) )
108 {
109 ercJob->m_severity |= RPT_SEVERITY_EXCLUSION;
110 }
111 wxString units = From_UTF8( m_argParser.get<std::string>( ARG_UNITS ).c_str() );
112
113 if( units == wxS( "mm" ) )
114 {
115 ercJob->m_units = JOB_SCH_ERC::UNITS::MILLIMETERS;
116 }
117 else if( units == wxS( "in" ) )
118 {
119 ercJob->m_units = JOB_SCH_ERC::UNITS::INCHES;
120 }
121 else if( units == wxS( "mils" ) )
122 {
123 ercJob->m_units = JOB_SCH_ERC::UNITS::MILS;
124 }
125 else if( !units.IsEmpty() )
126 {
127 wxFprintf( stderr, _( "Invalid units specified\n" ) );
129 }
130
131 wxString format = From_UTF8( m_argParser.get<std::string>( ARG_FORMAT ).c_str() );
132 if( format == "report" )
133 {
134 ercJob->m_format = JOB_SCH_ERC::OUTPUT_FORMAT::REPORT;
135 }
136 else if( format == "json" )
137 {
138 ercJob->m_format = JOB_SCH_ERC::OUTPUT_FORMAT::JSON;
139 }
140 else
141 {
142 wxFprintf( stderr, _( "Invalid report format\n" ) );
144 }
145
146 int exitCode = aKiway.ProcessJob( KIWAY::FACE_SCH, ercJob.get() );
147
148 return exitCode;
149}
argparse::ArgumentParser m_argParser
Definition: command.h:98
void addDefineArg()
Sets up the drawing sheet arg used by many of the export commands.
Definition: command.cpp:168
void addCommonArgs(bool aInput, bool aOutput, bool aInputIsDir, bool aOutputIsDir)
Sets up the most common of args used across cli.
Definition: command.cpp:115
int doPerform(KIWAY &aKiway) override
The internal handler that should be overloaded to implement command specific processing and work.
A minimalistic software bus for communications between various DLLs/DSOs (DSOs) within the same KiCad...
Definition: kiway.h:279
int ProcessJob(KIWAY::FACE_T aFace, JOB *job)
Definition: kiway.cpp:729
@ FACE_SCH
eeschema DSO
Definition: kiway.h:286
#define UTF8STDSTR(s)
Definition: command.h:27
#define ARG_SEVERITY_EXCLUSIONS
#define ARG_SEVERITY_ERROR
#define ARG_UNITS
#define ARG_SEVERITY_WARNING
#define ARG_EXIT_CODE_VIOLATIONS
#define ARG_SEVERITY_ALL
#define ARG_FORMAT
#define _(s)
This file contains miscellaneous commonly used macros and functions.
static const int ERR_ARGS
Definition: exit_codes.h:31
@ RPT_SEVERITY_WARNING
@ RPT_SEVERITY_ERROR
@ RPT_SEVERITY_EXCLUSION
wxString From_UTF8(const char *cstring)