symbol_library_adapter.h

Go to the documentation of this file.

/*
 * This program source code file is part of KiCad, a free EDA CAD application.
 *
 * Copyright The KiCad Developers, see AUTHORS.txt for contributors.
 * @author Jon Evans <[email protected]>
 *
 * 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, see <http://www.gnu.org/licenses/>.
 */
 
 
#ifndef SYMBOL_LIBRARY_MANAGER_ADAPTER_H
#define SYMBOL_LIBRARY_MANAGER_ADAPTER_H
 
#include <future>
#include <lib_id.h>
#include <libraries/library_manager.h>
#include <sch_io/sch_io.h>
 
class LIB_SYMBOL;
class PROJECT;
 

struct SUB_LIBRARY
{
    wxString nickname;
    wxString description;
};
 

class SYMBOL_LIBRARY_ADAPTER : public LIBRARY_MANAGER_ADAPTER
{
public:
    static const char* PropPowerSymsOnly;
    static const char* PropNonPowerSymsOnly;
 
public:
    SYMBOL_LIBRARY_ADAPTER( LIBRARY_MANAGER& aManager );
 
    LIBRARY_TABLE_TYPE Type() const override { return LIBRARY_TABLE_TYPE::SYMBOL; }
 
    static wxString GlobalPathEnvVariableName();
 
    void AsyncLoad() override;

    std::optional<LIB_STATUS> LoadOne( const wxString& aNickname );

    std::optional<LIB_STATUS> GetLibraryStatus( const wxString& aNickname ) const;

    std::vector<std::pair<wxString, LIB_STATUS>> GetLibraryStatuses() const;

    std::vector<wxString> GetAvailableExtraFields( const wxString& aNickname );
 
    bool SupportsSubLibraries( const wxString& aNickname ) const;
 
    std::vector<SUB_LIBRARY> GetSubLibraries( const wxString& aNickname ) const;
 
    bool SupportsConfigurationDialog( const wxString& aNickname ) const override;
 
    void ShowConfigurationDialog( const wxString& aNickname, wxWindow* aParent ) const override;
 
    enum class SYMBOL_TYPE
    {
        ALL_SYMBOLS,
        POWER_ONLY
    };
 
    std::vector<LIB_SYMBOL*> GetSymbols( const wxString& aNickname,
                                         SYMBOL_TYPE aType = SYMBOL_TYPE::ALL_SYMBOLS );
 
    std::vector<wxString> GetSymbolNames( const wxString& aNickname,
                                          SYMBOL_TYPE aType = SYMBOL_TYPE::ALL_SYMBOLS );
    LIB_SYMBOL* LoadSymbol( const wxString& aNickname, const wxString& aName );
 
    LIB_SYMBOL* LoadSymbol( const LIB_ID& aLibId )
    {
        return LoadSymbol( aLibId.GetLibNickname(), aLibId.GetLibItemName() );
    }

    enum SAVE_T
    {
        SAVE_OK,
        SAVE_SKIPPED,
    };

    SAVE_T SaveSymbol( const wxString& aNickname, const LIB_SYMBOL* aSymbol,
                       bool aOverwrite = true );

    void DeleteSymbol( const wxString& aNickname, const wxString& aSymbolName );

    bool IsSymbolLibWritable( const wxString& aNickname );
 
    std::optional<LIBRARY_ERROR> LibraryError( const wxString& aNickname ) const;

    bool CreateLibrary( const wxString& aNickname );
 
    static std::optional<SCH_IO_MGR::SCH_FILE_T> ParseLibType( const wxString& aType );
 
    int GetModifyHash() const;
 
    bool IsWritable( const wxString& aNickname ) const override;
 
protected:
    std::map<wxString, LIB_DATA>& globalLibs() override { return GlobalLibraries; }
    std::map<wxString, LIB_DATA>& globalLibs() const override { return GlobalLibraries; }
    std::mutex& globalLibsMutex() override { return GlobalLibraryMutex; }
 
    LIBRARY_RESULT<IO_BASE*> createPlugin( const LIBRARY_TABLE_ROW* row ) override;
 
private:
    static SCH_IO* plugin( const LIB_DATA* aRow );
 
    // The global libraries, potentially shared between multiple different open
    // projects, each of which has their own instance of this adapter class
    static std::map<wxString, LIB_DATA> GlobalLibraries;
 
    static std::mutex GlobalLibraryMutex;
};
 
#endif //SYMBOL_LIBRARY_MANAGER_ADAPTER_H