/* ============================================================================== This file is part of the JUCE library. Copyright (c) 2015 - ROLI Ltd. Permission is granted to use this software under the terms of either: a) the GPL v2 (or any later version) b) the Affero GPL v3 Details of these licenses can be found at: www.gnu.org/licenses JUCE 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. ------------------------------------------------------------------------------ To release a closed-source product which uses JUCE, commercial licenses are available: visit www.juce.com for more information. ============================================================================== */ #pragma once //============================================================================== /** Manipulates a cross-platform partial file path. (Needed because File is designed for absolute paths on the active OS) */ class RelativePath { public: //============================================================================== enum RootFolder { unknown, projectFolder, buildTargetFolder }; //============================================================================== RelativePath() : root (unknown) {} RelativePath (const String& relPath, const RootFolder rootType) : path (FileHelpers::unixStylePath (relPath)), root (rootType) { } RelativePath (const File& file, const File& rootFolder, const RootFolder rootType) : path (FileHelpers::unixStylePath (FileHelpers::getRelativePathFrom (file, rootFolder))), root (rootType) { } RootFolder getRoot() const { return root; } String toUnixStyle() const { return FileHelpers::unixStylePath (path); } String toWindowsStyle() const { return FileHelpers::windowsStylePath (path); } String getFileName() const { return getFakeFile().getFileName(); } String getFileNameWithoutExtension() const { return getFakeFile().getFileNameWithoutExtension(); } String getFileExtension() const { return getFakeFile().getFileExtension(); } bool hasFileExtension (juce::StringRef extension) const { return getFakeFile().hasFileExtension (extension); } bool isAbsolute() const { return FileHelpers::isAbsolutePath (path); } RelativePath withFileExtension (const String& extension) const { return RelativePath (path.upToLastOccurrenceOf (".", ! extension.startsWithChar ('.'), false) + extension, root); } RelativePath getParentDirectory() const { String p (path); if (path.endsWithChar ('/')) p = p.dropLastCharacters (1); return RelativePath (p.upToLastOccurrenceOf ("/", false, false), root); } RelativePath getChildFile (const String& subpath) const { if (FileHelpers::isAbsolutePath (subpath)) return RelativePath (subpath, root); String p (toUnixStyle()); if (! p.endsWithChar ('/')) p << '/'; return RelativePath (p + subpath, root); } RelativePath rebased (const File& originalRoot, const File& newRoot, const RootFolder newRootType) const { if (isAbsolute()) return RelativePath (path, newRootType); return RelativePath (FileHelpers::getRelativePathFrom (originalRoot.getChildFile (toUnixStyle()), newRoot), newRootType); } private: //============================================================================== String path; RootFolder root; File getFakeFile() const { // This method gets called very often, so we'll cache this directory. static const File currentWorkingDirectory (File::getCurrentWorkingDirectory()); return currentWorkingDirectory.getChildFile (path); } };