/usr/local/lib64/python3.6/site-packages/pyarrow/include/arrow/filesystem
Edit: /usr/local/lib64/python3.6/site-packages/pyarrow/include/arrow/filesystem/path_util.h (4190B)
// Licensed to the Apache Software Foundation (ASF) under one
// or more contributor license agreements. See the NOTICE file
// distributed with this work for additional information
// regarding copyright ownership. The ASF licenses this file
// to you under the Apache License, Version 2.0 (the
// "License"); you may not use this file except in compliance
// with the License. You may obtain a copy of the License at
//
// http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing,
// software distributed under the License is distributed on an
// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
// KIND, either express or implied. See the License for the
// specific language governing permissions and limitations
// under the License.
#pragma once
#include
#include
#include
#include "arrow/type_fwd.h"
#include "arrow/util/optional.h"
#include "arrow/util/string_view.h"
namespace arrow {
namespace fs {
namespace internal {
constexpr char kSep = '/';
// Computations on abstract paths (not local paths with system-dependent behaviour).
// Abstract paths are typically used in URIs.
// Split an abstract path into its individual components.
ARROW_EXPORT
std::vector SplitAbstractPath(const std::string& s);
// Return the extension of the file
ARROW_EXPORT
std::string GetAbstractPathExtension(const std::string& s);
// Return the parent directory and basename of an abstract path. Both values may be
// empty.
ARROW_EXPORT
std::pair GetAbstractPathParent(const std::string& s);
// Validate the components of an abstract path.
ARROW_EXPORT
Status ValidateAbstractPathParts(const std::vector& parts);
// Append a non-empty stem to an abstract path.
ARROW_EXPORT
std::string ConcatAbstractPath(const std::string& base, const std::string& stem);
// Make path relative to base, if it starts with base. Otherwise error out.
ARROW_EXPORT
Result MakeAbstractPathRelative(const std::string& base,
const std::string& path);
ARROW_EXPORT
std::string EnsureLeadingSlash(util::string_view s);
ARROW_EXPORT
util::string_view RemoveLeadingSlash(util::string_view s);
ARROW_EXPORT
std::string EnsureTrailingSlash(util::string_view s);
ARROW_EXPORT
util::string_view RemoveTrailingSlash(util::string_view s);
ARROW_EXPORT
bool IsAncestorOf(util::string_view ancestor, util::string_view descendant);
ARROW_EXPORT
util::optional RemoveAncestor(util::string_view ancestor,
util::string_view descendant);
/// Return a vector of ancestors between a base path and a descendant.
/// For example,
///
/// AncestorsFromBasePath("a/b", "a/b/c/d/e") -> ["a/b/c", "a/b/c/d"]
ARROW_EXPORT
std::vector AncestorsFromBasePath(util::string_view base_path,
util::string_view descendant);
/// Given a vector of paths of directories which must be created, produce a the minimal
/// subset for passing to CreateDir(recursive=true) by removing redundant parent
/// directories
ARROW_EXPORT
std::vector MinimalCreateDirSet(std::vector dirs);
// Join the components of an abstract path.
template
std::string JoinAbstractPath(StringIt it, StringIt end) {
std::string path;
for (; it != end; ++it) {
if (it->empty()) continue;
if (!path.empty()) {
path += kSep;
}
path += *it;
}
return path;
}
template
std::string JoinAbstractPath(const StringRange& range) {
return JoinAbstractPath(range.begin(), range.end());
}
/// Convert slashes to backslashes, on all platforms. Mostly useful for testing.
ARROW_EXPORT
std::string ToBackslashes(util::string_view s);
/// Ensure a local path is abstract, by converting backslashes to regular slashes
/// on Windows. Return the path unchanged on other systems.
ARROW_EXPORT
std::string ToSlashes(util::string_view s);
ARROW_EXPORT
bool IsEmptyPath(util::string_view s);
} // namespace internal
} // namespace fs
} // namespace arrow