1 #!/usr/bin/python2.5

     2 #

     3 # Copyright 2008 the Melange authors.

     4 #

     5 # Licensed under the Apache License, Version 2.0 (the "License");

     6 # you may not use this file except in compliance with the License.

     7 # You may obtain a copy of the License at

     8 #

     9 #   http://www.apache.org/licenses/LICENSE-2.0

    10 #

    11 # Unless required by applicable law or agreed to in writing, software

    12 # distributed under the License is distributed on an "AS IS" BASIS,

    13 # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.

    14 # See the License for the specific language governing permissions and

    15 # limitations under the License.

    16 

    17 """Logic related to handling dictionaries

    18 """

    19 

    20 __authors__ = [

    21   '"Sverre Rabbelier" <sverre@rabbelier.nl>',

    22   ]

    23 

    24 

    25 def mergeDicts(target, updates):

    26   """Like the builtin 'update' method but does not overwrite existing values

    27 

    28   Args:

    29     target: The dictionary that is to be updated, may be None

    30     updates: A dictionary containing new values for the original dict

    31 

    32   Returns: the target dictionary 

    33   """

    34 

    35   if not target:

    36     target = {}

    37 

    38   for key, value in updates.iteritems():

    39     if key not in target:

    40       target[key] = value

    41 

    42   return target