File: //snap/google-cloud-cli/396/lib/googlecloudsdk/command_lib/code/dataobject.py
# -*- coding: utf-8 -*- #
# Copyright 2022 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.
"""Simple immutable data object."""
from __future__ import absolute_import
from __future__ import division
from __future__ import print_function
from __future__ import unicode_literals
import six
class _DataType(type):
"""Dumb immutable data type."""
# TODO(b/154131605): This a type that is an immutable data object. Can't use
# attrs because it's not part of googlecloudsdk and can't use namedtuple
# because it's not efficient on python 2 (it generates code, which needs
# to be parsed and interpretted). Remove this code when we get support
# for attrs or another dumb data object in gcloud.
def __new__(cls, classname, bases, class_dict):
class_dict = class_dict.copy()
names = class_dict.get('NAMES', tuple())
class_dict.update(
(name, cls._CreateAccessor(i)) for i, name in enumerate(names))
return super(_DataType, cls).__new__(cls, classname, bases, class_dict)
@staticmethod
def _CreateAccessor(i):
"""Create an tuple accessor property."""
return property(lambda tpl: tpl[i]) # pylint: disable=unused-variable
class DataObject(six.with_metaclass(_DataType, tuple)):
"""Parent class of dumb data object."""
def __new__(cls, **kwargs):
names = getattr(cls, 'NAMES', tuple())
invalid_names = set(kwargs) - set(names)
if invalid_names:
raise ValueError('Invalid names: ' + repr(invalid_names))
tpl = tuple(kwargs[name] if name in kwargs else None for name in names)
return super(DataObject, cls).__new__(cls, tpl)
def replace(self, **changes): # pylint: disable=invalid-name
# https://docs.python.org/3/library/dataclasses.html#dataclasses.replace
out = dict((n, changes.get(n, getattr(self, n, None))) for n in self.NAMES)
return self.__class__(**out)