FP_CACHE Class Reference

Public Member Functions
	FP_CACHE (PCB_PLUGIN *aOwner, const wxString &aLibraryPath)
wxString	GetPath () const
bool	IsWritable () const
bool	Exists () const
FOOTPRINT_MAP &	GetFootprints ()
void	Save (FOOTPRINT *aFootprint=nullptr)
	Save the footprint cache or a single footprint from it to disk. More...
void	Load ()
void	Remove (const wxString &aFootprintName)
bool	IsModified ()
	Return true if the cache is not up-to-date. More...
bool	IsPath (const wxString &aPath) const
	Check if aPath is the same as the current cache path. More...

Static Public Member Functions
static long long	GetTimestamp (const wxString &aLibPath)
	Generate a timestamp representing all source files in the cache (including the parent directory). More...

Private Attributes
PCB_PLUGIN *	m_owner
wxFileName	m_lib_path
wxString	m_lib_raw_path
FOOTPRINT_MAP	m_footprints
bool	m_cache_dirty
long long	m_cache_timestamp

Detailed Description

Definition at line 91 of file pcb_plugin.cpp.

Constructor & Destructor Documentation

FP_CACHE()

FP_CACHE::FP_CACHE	(	PCB_PLUGIN *	aOwner,
		const wxString &	aLibraryPath
	)

Definition at line 156 of file pcb_plugin.cpp.

{
 m_owner = aOwner;
 m_lib_raw_path = aLibraryPath;
 m_lib_path.SetPath( aLibraryPath );
 m_cache_timestamp = 0;
 m_cache_dirty = true;
}

References m_cache_dirty, m_cache_timestamp, m_lib_path, m_lib_raw_path, and m_owner.

Member Function Documentation

Exists()

bool FP_CACHE::Exists ( ) const

inline

Definition at line 110 of file pcb_plugin.cpp.

{ return m_lib_path.IsOk() && m_lib_path.DirExists(); }

References m_lib_path.

Referenced by PCB_PLUGIN::FootprintSave().

GetFootprints()

FOOTPRINT_MAP& FP_CACHE::GetFootprints ( )

inline

Definition at line 112 of file pcb_plugin.cpp.

{ return m_footprints; }

References m_footprints.

Referenced by PCB_PLUGIN::FootprintEnumerate(), PCB_PLUGIN::FootprintSave(), and PCB_PLUGIN::getFootprint().

GetPath()

wxString FP_CACHE::GetPath ( ) const

inline

Definition at line 106 of file pcb_plugin.cpp.

{ return m_lib_raw_path; }

References m_lib_raw_path.

GetTimestamp()

long long FP_CACHE::GetTimestamp ( const wxString &  aLibPath )

static

Generate a timestamp representing all source files in the cache (including the parent directory).

Timestamps should not be considered ordered. They either match or they don't.

Definition at line 330 of file pcb_plugin.cpp.

{
 wxString fileSpec = wxT( "*." ) + KiCadFootprintFileExtension;

 return TimestampDir( aLibPath, fileSpec );
}

References KiCadFootprintFileExtension, and TimestampDir().

Referenced by PCB_PLUGIN::GetLibraryTimestamp(), IsModified(), and Load().

IsModified()

bool FP_CACHE::IsModified

(

)

Return true if the cache is not up-to-date.

Definition at line 322 of file pcb_plugin.cpp.

{
 m_cache_dirty = m_cache_dirty || GetTimestamp( m_lib_path.GetFullPath() ) != m_cache_timestamp;

 return m_cache_dirty;
}

References GetTimestamp(), m_cache_dirty, m_cache_timestamp, and m_lib_path.

Referenced by PCB_PLUGIN::validateCache().

IsPath()

bool FP_CACHE::IsPath

(

const wxString &

aPath

)

const

Check if aPath is the same as the current cache path.

This tests paths by converting aPath using the native separators. Internally FP_CACHE stores the current path using native separators. This prevents path miscompares on Windows due to the fact that paths can be stored with / instead of \ in the footprint library table.

Parameters

aPath

is the library path to test against.

Returns

true if aPath is the same as the cache path.

Definition at line 316 of file pcb_plugin.cpp.

{
 return aPath == m_lib_raw_path;
}

References m_lib_raw_path.

Referenced by PCB_PLUGIN::FootprintLibDelete(), and PCB_PLUGIN::validateCache().

IsWritable()

bool FP_CACHE::IsWritable ( ) const

inline

Definition at line 108 of file pcb_plugin.cpp.

{ return m_lib_path.IsOk() && m_lib_path.IsDirWritable(); }

References m_lib_path.

Referenced by PCB_PLUGIN::FootprintDelete(), PCB_PLUGIN::FootprintSave(), and PCB_PLUGIN::IsFootprintLibWritable().

Load()

void FP_CACHE::Load

(

)

Definition at line 233 of file pcb_plugin.cpp.

{
 m_cache_dirty = false;
 m_cache_timestamp = 0;

 wxDir dir( m_lib_raw_path );

 if( !dir.IsOpened() )
 {
 wxString msg = wxString::Format( _( "Footprint library '%s' not found." ),
 m_lib_raw_path );
 THROW_IO_ERROR( msg );
 }

 wxString fullName;
 wxString fileSpec = wxT( "*." ) + KiCadFootprintFileExtension;

 // wxFileName construction is egregiously slow. Construct it once and just swap out
 // the filename thereafter.
 WX_FILENAME fn( m_lib_raw_path, wxT( "dummyName" ) );

 if( dir.GetFirst( &fullName, fileSpec ) )
 {
 wxString cacheError;

 do
 {
 fn.SetFullName( fullName );

 // Queue I/O errors so only files that fail to parse don't get loaded.
 try
 {
 FILE_LINE_READER reader( fn.GetFullPath() );

 m_owner->m_parser->SetLineReader( &reader );

 // For better or worse (mostly worse), the parser is a long-lived object.
 // Make sure we start with a fresh state.
 m_owner->m_parser->InitParserState();
 m_owner->m_parser->SetBoard( nullptr ); // calls PCB_PARSER::init()

 FOOTPRINT* footprint = (FOOTPRINT*) m_owner->m_parser->Parse();
 wxString fpName = fn.GetName();

 footprint->SetFPID( LIB_ID( wxEmptyString, fpName ) );
 m_footprints.insert( fpName, new FP_CACHE_ITEM( footprint, fn ) );
 }
 catch( const IO_ERROR& ioe )
 {
 if( !cacheError.IsEmpty() )
 cacheError += wxT( "\n\n" );

 cacheError += ioe.What();
 }
 } while( dir.GetNext( &fullName ) );

 m_cache_timestamp = GetTimestamp( m_lib_raw_path );

 if( !cacheError.IsEmpty() )
 THROW_IO_ERROR( cacheError );
 }
}

References _, Format(), WX_FILENAME::GetFullPath(), WX_FILENAME::GetName(), GetTimestamp(), KiCadFootprintFileExtension, m_cache_dirty, m_cache_timestamp, m_footprints, m_lib_raw_path, m_owner, PCB_PLUGIN::m_parser, PCB_PARSER::Parse(), PCB_PARSER::SetBoard(), FOOTPRINT::SetFPID(), WX_FILENAME::SetFullName(), PCB_PARSER::SetLineReader(), THROW_IO_ERROR, and IO_ERROR::What().

Referenced by PCB_PLUGIN::validateCache().

Remove()

void FP_CACHE::Remove

(

const wxString &

aFootprintName

)

Definition at line 297 of file pcb_plugin.cpp.

{
 FOOTPRINT_MAP::const_iterator it = m_footprints.find( aFootprintName );

 if( it == m_footprints.end() )
 {
 wxString msg = wxString::Format( _( "Library '%s' has no footprint '%s'." ),
 m_lib_raw_path,
 aFootprintName );
 THROW_IO_ERROR( msg );
 }

 // Remove the footprint from the cache and delete the footprint file from the library.
 wxString fullPath = it->second->GetFileName().GetFullPath();
 m_footprints.erase( aFootprintName );
 wxRemoveFile( fullPath );
}

References _, Format(), m_footprints, m_lib_raw_path, and THROW_IO_ERROR.

Referenced by PCB_PLUGIN::FootprintDelete().

Save()

void FP_CACHE::Save

(

FOOTPRINT *

aFootprint = nullptr

)

Save the footprint cache or a single footprint from it to disk.

Parameters

aFootprint

if set, save only this footprint, otherwise, save the full library

Definition at line 166 of file pcb_plugin.cpp.

{
 m_cache_timestamp = 0;

 if( !m_lib_path.DirExists() && !m_lib_path.Mkdir() )
 {
 THROW_IO_ERROR( wxString::Format( _( "Cannot create footprint library '%s'." ),
 m_lib_raw_path ) );
 }

 if( !m_lib_path.IsDirWritable() )
 {
 THROW_IO_ERROR( wxString::Format( _( "Footprint library '%s' is read only." ),
 m_lib_raw_path ) );
 }

 for( FOOTPRINT_MAP::iterator it = m_footprints.begin(); it != m_footprints.end(); ++it )
 {
 if( aFootprint && aFootprint != it->second->GetFootprint() )
 continue;

 WX_FILENAME fn = it->second->GetFileName();

 wxString tempFileName =
#ifdef USE_TMP_FILE
 wxFileName::CreateTempFileName( fn.GetPath() );
#else
 fn.GetFullPath();
#endif
 // Allow file output stream to go out of scope to close the file stream before
 // renaming the file.
 {
 wxLogTrace( traceKicadPcbPlugin, wxT( "Creating temporary library file '%s'." ),
 tempFileName );

 FILE_OUTPUTFORMATTER formatter( tempFileName );

 m_owner->SetOutputFormatter( &formatter );
 m_owner->Format( (BOARD_ITEM*) it->second->GetFootprint() );
 }

#ifdef USE_TMP_FILE
 wxRemove( fn.GetFullPath() ); // it is not an error if this does not exist

 // Even on Linux you can see an _intermittent_ error when calling wxRename(),
 // and it is fully inexplicable. See if this dodges the error.
 wxMilliSleep( 250L );

 if( !wxRenameFile( tempFileName, fn.GetFullPath() ) )
 {
 wxString msg = wxString::Format( _( "Cannot rename temporary file '%s' to '%s'" ),
 tempFileName,
 fn.GetFullPath() );
 THROW_IO_ERROR( msg );
 }
#endif
 m_cache_timestamp += fn.GetTimestamp();
 }

 m_cache_timestamp += m_lib_path.GetModificationTime().GetValue().GetValue();

 // If we've saved the full cache, we clear the dirty flag.
 if( !aFootprint )
 m_cache_dirty = false;
}

References _, Format(), PCB_PLUGIN::Format(), WX_FILENAME::GetFullPath(), WX_FILENAME::GetPath(), WX_FILENAME::GetTimestamp(), m_cache_dirty, m_cache_timestamp, m_footprints, m_lib_path, m_lib_raw_path, m_owner, PCB_PLUGIN::SetOutputFormatter(), THROW_IO_ERROR, and traceKicadPcbPlugin.

Referenced by PCB_PLUGIN::FootprintLibCreate(), and PCB_PLUGIN::FootprintSave().

Member Data Documentation

m_cache_dirty

bool FP_CACHE::m_cache_dirty

private

Definition at line 98 of file pcb_plugin.cpp.

Referenced by FP_CACHE(), IsModified(), Load(), and Save().

m_cache_timestamp

long long FP_CACHE::m_cache_timestamp

private

Definition at line 100 of file pcb_plugin.cpp.

Referenced by FP_CACHE(), IsModified(), Load(), and Save().

m_footprints

FOOTPRINT_MAP FP_CACHE::m_footprints

private

Definition at line 96 of file pcb_plugin.cpp.

Referenced by GetFootprints(), Load(), Remove(), and Save().

m_lib_path

wxFileName FP_CACHE::m_lib_path

private

Definition at line 94 of file pcb_plugin.cpp.

Referenced by Exists(), FP_CACHE(), IsModified(), IsWritable(), and Save().

m_lib_raw_path

wxString FP_CACHE::m_lib_raw_path

private

Definition at line 95 of file pcb_plugin.cpp.

Referenced by FP_CACHE(), GetPath(), IsPath(), Load(), Remove(), and Save().

m_owner

PCB_PLUGIN* FP_CACHE::m_owner

private

Definition at line 93 of file pcb_plugin.cpp.

Referenced by FP_CACHE(), Load(), and Save().

---

The documentation for this class was generated from the following file:

• pcb_plugin.cpp