File: //snap/google-cloud-cli/current/lib/googlecloudsdk/command_lib/storage/paths.py
# -*- coding: utf-8 -*- #
# Copyright 2016 Google LLC. All Rights Reserved.
#
# Licensed 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.
"""Utilities for computing copy operations from command arguments."""
from __future__ import absolute_import
from __future__ import division
from __future__ import unicode_literals
import os
import re
class Path(object):
"""Wrapper to help with dealing with local and GCS paths uniformly."""
_INVALID_PATH_FORMAT = r'{sep}\.+({sep}|$)'
def __init__(self, path):
self.path = path
@property
def is_remote(self):
return self.path.startswith('gs://')
@property
def is_dir_like(self):
if self.is_remote:
return self.path.endswith('/')
return self.path.endswith(os.sep)
def Join(self, part):
if self.is_remote:
return Path(self.path.rstrip('/') + '/' + part.lstrip('/'))
return Path(os.path.join(self.path, part))
def IsPathSafe(self):
if self.is_remote:
sep = '/'
else:
# Need \\\\ for the regex to work with nt (Windows) paths as intended.
sep = os.sep * 2 if os.name == 'nt' else os.sep
return not bool(re.search(
Path._INVALID_PATH_FORMAT.format(sep=sep),
self.path))
def __str__(self):
return self.path
def __repr__(self):
return self.path