Server : Apache/2.4.6 (CentOS) OpenSSL/1.0.2k-fips PHP/7.4.20 System : Linux st2.domain.com 3.10.0-1127.10.1.el7.x86_64 #1 SMP Wed Jun 3 14:28:03 UTC 2020 x86_64 User : apache ( 48) PHP Version : 7.4.20 Disable Function : NONE Directory : /proc/self/root/usr/share/mysqlsh/oci_sdk/oci/ |
# coding: utf-8
# Copyright (c) 2016, 2020, Oracle and/or its affiliates. All rights reserved.
import base64
import datetime
import json
import os.path
import pytz
from oci._vendor import six
try:
# PY3+
import collections.abc as abc
except ImportError:
# PY2
import collections as abc
missing_attr = object()
def to_dict(obj):
"""Helper to flatten models into dicts for rendering.
The following conversions are applied:
* datetime.date, datetime.datetime, datetime.time
are converted into ISO8601 UTC strings
"""
# Shortcut strings so they don't count as Iterables
if isinstance(obj, six.string_types):
return obj
elif obj is NONE_SENTINEL:
return None
elif isinstance(obj, (datetime.datetime, datetime.time)):
# always use UTC
if not obj.tzinfo:
obj = pytz.utc.localize(obj)
if isinstance(obj, datetime.datetime):
# only datetime.datetime takes a separator
return obj.isoformat(sep="T")
return obj.isoformat()
elif isinstance(obj, datetime.date):
# datetime.date doesn't have a timezone
return obj.isoformat()
elif isinstance(obj, abc.Mapping):
return {filter_key(k): to_dict(v) for k, v in six.iteritems(obj)}
elif isinstance(obj, abc.Iterable):
return [to_dict(v) for v in obj]
# Not a string, datetime, dict, list, or model - return directly
elif not hasattr(obj, "swagger_types"):
return obj
# Collect attrs from obj according to swagger_types into a dict
as_dict = {}
for key in six.iterkeys(obj.swagger_types):
value = getattr(obj, key, missing_attr)
if value is not missing_attr:
as_dict[filter_key(key)] = to_dict(value)
return as_dict
# Serialize on the wire as 'self' because self is a reserved word in Python
def filter_key(key):
# Note 'self_uri' is used by oci.dns.models.Zone
return 'self' if key in ['_self', 'self_uri'] else key
def formatted_flat_dict(model):
"""Returns a string of the model flattened as a dict, sorted"""
as_dict = to_dict(model)
return json.dumps(
as_dict,
indent=2,
sort_keys=True
)
def value_allowed_none_or_none_sentinel(value_to_test, allowed_values):
return value_to_test is None or value_to_test is NONE_SENTINEL or value_to_test in allowed_values
def file_content_as_launch_instance_user_data(file_path):
"""
Takes a file path and returns a Base64-encoded string which can be provided as the value of the ``user_data`` key
in the ``metadata`` dictionary when launching an instance(see :py:class`~oci.core.models.LaunchInstanceDetails`
for more information).
:param str file_path:
The path to the file whose contents will be Base64-encoded
:return: The Base64-encoded string
:rtype: str
"""
full_path = os.path.expandvars(os.path.expanduser(file_path))
with open(full_path, 'rb') as f:
file_contents = f.read()
return base64.b64encode(file_contents).decode('utf-8')
class Sentinel(object):
"""Named singletons for clear docstrings.
Also used to differentiate an explicit param of None from a lack of argument.
.. code-block:: pycon
>>> missing = Sentinel("Missing", False)
>>> also_missing = Sentinel("Missing", False)
>>> assert missing is also_missing
>>> repr(missing)
<Missing>
>>> assert bool(missing) is False
"""
_symbols = {}
def __new__(cls, name, truthy=True):
sentinel = Sentinel._symbols.get(name, None)
if sentinel is None:
sentinel = Sentinel._symbols[name] = super(Sentinel, cls).__new__(cls)
elif sentinel.truthy is not truthy:
raise ValueError("Tried to get existing Sentinel {!r} with wrong truthy value".format(sentinel))
return sentinel
def __init__(self, name, truthy=True):
self.name = name
self.truthy = truthy
def __repr__(self):
# Sentinel("Missing") -> <Missing>
return "<{}>".format(self.name)
def __bool__(self):
return self.truthy
# PY2 Compatibility
__nonzero__ = __bool__
NONE_SENTINEL = Sentinel(name='None', truthy=False)
WAIT_RESOURCE_NOT_FOUND = Sentinel(name='WaitResourceNotFound', truthy=False)