ResourceFinder.h

Go to the documentation of this file.

/*
 * Copyright (C) 2006-2020 Istituto Italiano di Tecnologia (IIT)
 * Copyright (C) 2006-2010 RobotCub Consortium
 * All rights reserved.
 *
 * This software may be modified and distributed under the terms of the
 * BSD-3-Clause license. See the accompanying LICENSE file for details.
 */
 
#ifndef YARP_OS_RESOURCEFINDER_H
#define YARP_OS_RESOURCEFINDER_H
 
#include <yarp/os/Bottle.h>
#include <yarp/os/Property.h>
#include <yarp/os/ResourceFinderOptions.h>
#include <yarp/os/Searchable.h>
#include <yarp/os/Value.h>
 
#include <string>
 
namespace yarp {
namespace os {
 
class YARP_os_API ResourceFinder : public Searchable
{
public:
    ResourceFinder();
 
    ResourceFinder(const ResourceFinder& alt);
 
    virtual ~ResourceFinder();
 
    const ResourceFinder& operator=(const ResourceFinder& alt);
 
#ifndef YARP_NO_DEPRECATED // Since YARP 3.4
 
    bool setVerbose(bool verbose = true);
 
    bool setQuiet(bool quiet = true);
#endif // YARP_NO_DEPRECATED
 
    bool configure(int argc, char* argv[], bool skipFirstArgument = true);
 
    bool setDefaultContext(const std::string& contextName)
    {
        clearContext();
        return addContext(contextName);
    }
 
    bool setDefault(const std::string& key, const std::string& val);
 
    bool setDefault(const std::string& key, std::int32_t val);
 
    bool setDefault(const std::string& key, yarp::conf::float64_t val);
 
    bool setDefault(const std::string& key, const yarp::os::Value& val);
 
    bool setDefaultConfigFile(const std::string& fname)
    {
        return setDefault("from", fname);
    }
 
    std::string findFile(const std::string& name);
 
    std::string findFileByName(const std::string& name);
 
    std::string findPath(const std::string& name);
 
    yarp::os::Bottle findPaths(const std::string& name);
 
    std::string findPath();
 
 
    std::string getContext();
 
    yarp::os::Bottle getContexts();
 
    // Searchable interface
    bool check(const std::string& key) const override;
    Value& find(const std::string& key) const override;
    Bottle& findGroup(const std::string& key) const override;
    bool isNull() const override;
    std::string toString() const override;
 
 
    virtual ResourceFinder findNestedResourceFinder(const std::string& key);
 
 
    bool isConfigured() const
    {
        return isConfiguredFlag;
    }
 
    static ResourceFinder& getResourceFinderSingleton();
 
    using Searchable::check;
    using Searchable::findGroup;
 
 
    /* YARP 2.4 changes begin */
 
    static std::string getDataHome()
    {
        return getDataHomeWithPossibleCreation(true);
    }
 
 
    static std::string getDataHomeNoCreate()
    {
        return getDataHomeWithPossibleCreation(false);
    }
 
    static std::string getConfigHome()
    {
        return getConfigHomeWithPossibleCreation(true);
    }
 
    static std::string getConfigHomeNoCreate()
    {
        return getConfigHomeWithPossibleCreation(false);
    }
 
    std::string getHomeContextPath();
 
    std::string getHomeRobotPath();
 
    static Bottle getDataDirs();
 
    static Bottle getConfigDirs();
 
    yarp::os::Bottle findPaths(const std::string& name,
                               const ResourceFinderOptions& options);
 
    std::string findPath(const std::string& name,
                         const ResourceFinderOptions& options);
 
    std::string findFile(const std::string& name,
                         const ResourceFinderOptions& options);
 
    std::string findFileByName(const std::string& name,
                               const ResourceFinderOptions& options);
 
    bool readConfig(Property& config,
                    const std::string& key,
                    const ResourceFinderOptions& options);
 
    /* YARP 2.4 changes end */
 
private:
    // this might be useful, but is not in spec
    bool addContext(const std::string& appName);
 
    // this might be useful, but is not in spec
    bool clearContext();
 
    bool owned;
    bool nullConfig;
    bool isConfiguredFlag;
    yarp::os::Property config;
 
    static std::string getDataHomeWithPossibleCreation(bool mayCreate);
    static std::string getConfigHomeWithPossibleCreation(bool mayCreate);
    static std::string createIfAbsent(bool mayCreate, const std::string& path);
 
#ifndef DOXYGEN_SHOULD_SKIP_THIS
private:
    class Private;
    Private* mPriv;
    ResourceFinder(Searchable& data, Private* altPriv);
#endif // DOXYGEN_SHOULD_SKIP_THIS
};
 
} // namespace os
} // namespace yarp
 
#endif // YARP_OS_RESOURCEFINDER_H