Added "autocomplete" function to ResourceLocator and Registry

2 files changed, 94 insertions, 3 deletions

diff --git a/src/core/resource/ResourceLocator.cpp b/src/core/resource/ResourceLocator.cpp
index b19542e..da38cbd 100644
--- a/src/core/resource/ResourceLocator.cpp
+++ b/src/core/resource/ResourceLocator.cpp
@@ -25,6 +25,37 @@ namespace ousia {
 
 /* Class ResourceLocator */
 
+std::vector<std::string> ResourceLocator::autocomplete(
+    const std::string &path, const ResourceType type,
+    const Resource &relativeTo) const
+{
+	// If the locator of the given relative resource is this locator instance,
+	// use the location specified in the resource, otherwise just use no
+	// "relativeTo" path.
+	if (&relativeTo.getLocator() == this) {
+		return autocomplete(path, type, relativeTo.getLocation());
+	}
+	return autocomplete(path, type, "");
+}
+
+std::vector<std::string> ResourceLocator::autocomplete(
+    const std::string &path, const ResourceType type,
+    const std::string &relativeTo) const
+{
+	// Try to locate the resource for the specified type, if not found, use
+	// the "UNKNOWN" type.
+	std::vector<std::string> res = doAutocomplete(path, type, relativeTo);
+	if (!res.empty()) {
+		return res;
+	}
+
+	// Use the "UNKNOWN" type
+	if (type != ResourceType::UNKNOWN) {
+		return doAutocomplete(path, ResourceType::UNKNOWN, relativeTo);
+	}
+	return std::vector<std::string>{};
+}
+
 bool ResourceLocator::locate(Resource &resource, const std::string &path,
                              const ResourceType type,
                              const Resource &relativeTo) const
@@ -59,6 +90,14 @@ std::unique_ptr<std::istream> ResourceLocator::stream(
 	return doStream(location);
 }
 
+std::vector<std::string> ResourceLocator::doAutocomplete(
+    const std::string &path, const ResourceType type,
+    const std::string &relativeTo) const
+{
+	// Default implementation
+	return std::vector<std::string>{};
+}
+
 /* Class StaticResourceLocator */
 
 bool StaticResourceLocator::doLocate(Resource &resource,
diff --git a/src/core/resource/ResourceLocator.hpp b/src/core/resource/ResourceLocator.hpp
index c1d0807..d6a2ffc 100644
--- a/src/core/resource/ResourceLocator.hpp
+++ b/src/core/resource/ResourceLocator.hpp
@@ -21,6 +21,7 @@
 
 #include <istream>
 #include <memory>
+#include <vector>
 
 #include "Resource.hpp"
 
@@ -60,6 +61,23 @@ protected:
 	                      const std::string &relativeTo) const = 0;
 
 	/**
+	 * Tries to autocomplete the given filename by searching for files with this
+	 * basename but different extensions. Returns a list of possible extended
+	 * paths. May return an empty list if this function is not supported.
+	 *
+	 * @param path is the given filename for which versions with extension
+	 * should be searched.
+	 * @param type is the resource type, determining the search paths in which
+	 * the resource is looked up.
+	 * @param relativeTo is an already resolved Resource relative to which the
+	 * file should be searched.
+	 * @return a list of matching, autocompleted file paths.
+	 */
+	virtual std::vector<std::string> doAutocomplete(
+	    const std::string &path, const ResourceType type,
+	    const std::string &relativeTo) const;
+
+	/**
 	 * This method returns a stream containing the data of the resource at the
 	 * given location.
 	 *
@@ -80,6 +98,41 @@ public:
 	virtual ~ResourceLocator() {}
 
 	/**
+	 * Tries to autocomplete the given filename by searching for files with this
+	 * basename but different extensions. Returns a list of possible extended
+	 * paths. May return an empty list if this function is not supported.
+	 *
+	 * @param path is the given filename for which versions with extension
+	 * should be searched.
+	 * @param type is the resource type, determining the search paths in which
+	 * the resource is looked up.
+	 * @param relativeTo is an already resolved Resource relative to which the
+	 * file should be searched.
+	 * @return a list of matching, autocompleted file paths.
+	 */
+	std::vector<std::string> autocomplete(
+	    const std::string &path,
+	    const ResourceType type = ResourceType::UNKNOWN,
+	    const Resource &relativeTo = NullResource) const;
+
+	/**
+	 * Tries to autocomplete the given filename by searching for files with this
+	 * basename but different extensions. Returns a list of possible extended
+	 * paths. May return an empty list if this function is not supported.
+	 *
+	 * @param path is the given filename for which versions with extension
+	 * should be searched.
+	 * @param type is the resource type, determining the search paths in which
+	 * the resource is looked up.
+	 * @param relativeTo is the location of an already resolved resource
+	 * relative to which this resource should be located.
+	 * @return a list of matching, autocompleted file paths.
+	 */
+	std::vector<std::string> autocomplete(const std::string &path,
+	                                      const ResourceType type,
+	                                      const std::string &relativeTo) const;
+
+	/**
 	 * The locate function uses this ResourceLocator to search for a given
 	 * Resource name (path parameter).
 	 *
@@ -109,8 +162,7 @@ public:
 	 * @return true if a resource could be found, false otherwise.
 	 */
 	bool locate(Resource &resource, const std::string &path,
-	            const ResourceType type,
-	            const std::string &relativeTo) const;
+	            const ResourceType type, const std::string &relativeTo) const;
 
 	/**
 	 * This method returns a stream containing the data of the resource at the
@@ -123,7 +175,7 @@ public:
 	 *         C++11 compiler does not yet support move semantics for
 	 *         streams.
 	 */
-	std::unique_ptr<std::istream> stream(const std::string &location) const;	
+	std::unique_ptr<std::istream> stream(const std::string &location) const;
 };
 
 /**