azure/aria/aria-extension-cloudify/src/aria/aria/parser/presentation/null.py

   1 # Licensed to the Apache Software Foundation (ASF) under one or more
   2 # contributor license agreements.  See the NOTICE file distributed with
   3 # this work for additional information regarding copyright ownership.
   4 # The ASF licenses this file to You under the Apache License, Version 2.0
   5 # (the "License"); you may not use this file except in compliance with
   6 # the License.  You may obtain a copy of the License at
   7 #
   8 #     http://www.apache.org/licenses/LICENSE-2.0
   9 #
  10 # Unless required by applicable law or agreed to in writing, software
  11 # distributed under the License is distributed on an "AS IS" BASIS,
  12 # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  13 # See the License for the specific language governing permissions and
  14 # limitations under the License.
  15
  16 from ...utils.collections import deepcopy_with_locators
  17
  18
  19 class Null(object):
  20     """
  21     Represents an explicit null value provided by the user, which is different from
  22     not supplying a value at all.
  23
  24     It is a singleton.
  25     """
  26
  27     @property
  28     def as_raw(self):
  29         return None
  30
  31 NULL = Null()
  32
  33
  34 def none_to_null(value):
  35     """
  36     Convert ``None`` to ``NULL``, recursively.
  37     """
  38
  39     if value is None:
  40         return NULL
  41     if isinstance(value, list):
  42         value = deepcopy_with_locators(value)
  43         for i, _ in enumerate(value):
  44             value[i] = none_to_null(value[i])
  45     elif isinstance(value, dict):
  46         value = deepcopy_with_locators(value)
  47         for k, v in value.iteritems():
  48             value[k] = none_to_null(v)
  49     return value
  50
  51
  52 def null_to_none(value):
  53     """
  54     Convert ``NULL`` to ``None``, recursively.
  55     """
  56
  57     if value is NULL:
  58         return None
  59     if isinstance(value, list):
  60         value = deepcopy_with_locators(value)
  61         for i, _ in enumerate(value):
  62             value[i] = none_to_null(value[i])
  63     elif isinstance(value, dict):
  64         value = deepcopy_with_locators(value)
  65         for k, v in value.iteritems():
  66             value[k] = none_to_null(v)
  67     return value