KiCad PCB EDA Suite
Loading...
Searching...
No Matches
board_file_utils.h
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) 2019 KiCad Developers, see AUTHORS.txt for contributors.
5 *
6 * This program is free software; you can redistribute it and/or
7 * modify it under the terms of the GNU General Public License
8 * as published by the Free Software Foundation; either version 2
9 * of the License, or (at your option) any later version.
10 *
11 * This program is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 * GNU General Public License for more details.
15 *
16 * You should have received a copy of the GNU General Public License
17 * along with this program; if not, you may find one here:
18 * http://www.gnu.org/licenses/old-licenses/gpl-2.0.html
19 * or you may search the http://www.gnu.org website for the version 2 license,
20 * or you may write to the Free Software Foundation, Inc.,
21 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA
22 */
23
24
25#ifndef QA_PCBNEW_UTILS_BOARD_FILE_UTILS__H
26#define QA_PCBNEW_UTILS_BOARD_FILE_UTILS__H
27
28#include <iostream>
29#include <memory>
30#include <string>
31
32class BOARD;
33class BOARD_ITEM;
34class FOOTPRINT;
35
40namespace KI_TEST
41{
45std::string GetPcbnewTestDataDir();
46
59void DumpBoardToFile( BOARD& aBoard, const std::string& aFilename );
60
70std::unique_ptr<BOARD_ITEM> ReadBoardItemFromStream( std::istream& aStream );
71
78template <typename ITEM> std::unique_ptr<ITEM> ReadItemFromStream( std::istream& aStream )
79{
80 auto bi_ptr = ReadBoardItemFromStream( aStream );
81 std::unique_ptr<ITEM> downcast_ptr;
82
83 // if it's the right type, downcast and "steal" (and we'll return ownership)
84 ITEM* const tmp = dynamic_cast<ITEM*>( bi_ptr.get() );
85 if( tmp != nullptr )
86 {
87 bi_ptr.release();
88 downcast_ptr.reset( tmp );
89 }
90
91 return downcast_ptr;
92}
93
101std::unique_ptr<BOARD> ReadBoardFromFileOrStream( const std::string& aFilename,
102 std::istream& aFallback = std::cin );
103
104std::unique_ptr<FOOTPRINT> ReadFootprintFromFileOrStream( const std::string& aFilename,
105 std::istream& aFallback = std::cin );
106
107} // namespace KI_TEST
108
109#endif // QA_PCBNEW_UTILS_BOARD_FILE_UTILS__H
A base class for any item which can be embedded within the BOARD container class, and therefore insta...
Definition: board_item.h:77
Information pertinent to a Pcbnew printed circuit board.
Definition: board.h:281
std::string GetPcbnewTestDataDir()
Utility which returns a path to the data directory where the test board files are stored.
std::unique_ptr< ITEM > ReadItemFromStream(std::istream &aStream)
Read a specific kind of BOARD_ITEM from a stream.
std::unique_ptr< BOARD > ReadBoardFromFileOrStream(const std::string &aFilename, std::istream &aFallback)
Read a board from a file, or another stream, as appropriate.
std::unique_ptr< FOOTPRINT > ReadFootprintFromFileOrStream(const std::string &aFilename, std::istream &aFallback)
void DumpBoardToFile(BOARD &board, const std::string &aFilename)
Utility function to simply write a Board out to a file.
std::unique_ptr< BOARD_ITEM > ReadBoardItemFromStream(std::istream &aStream)
Utility function to read a BOARD_ITEM (probably a FOOTPRINT or a BOARD) from a file.