# -*- coding: utf-8 -*-
# Copyright (C) 2015  Red Hat, Inc.
#
# This copyrighted material is made available to anyone wishing to use,
# modify, copy, or redistribute it subject to the terms and conditions of
# the GNU General Public License v.2, or (at your option) any later version.
# This program is distributed in the hope that it will be useful, but WITHOUT
# ANY WARRANTY expressed or implied, including the implied warranties of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General
# Public License for more details.  You should have received a copy of the
# GNU General Public License along with this program; if not, write to the
# Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
# 02110-1301, USA.  Any Red Hat trademarks that are incorporated in the
# source code or documentation are not subject to the GNU General Public
# License and may only be used or replicated with the express permission of
# Red Hat, Inc.
#
# Red Hat Author(s): Anne Mulhern <amulhern@redhat.com>

"""
    pydevDAG._decorations._decorations
    ==================================

    Tools to decorate networkx graphs in situ, i.e., as
    constructed rather than as read from a textual file.

    .. moduleauthor::  mulhern <amulhern@redhat.com>
"""

from __future__ import absolute_import
from __future__ import division
from __future__ import print_function
from __future__ import unicode_literals

import networkx as nx


class Decorator(object):
    """
    Decorate graph elements with attributes.
    """

    @staticmethod
    def _decorate(graph, properties, setter=nx.set_node_attributes):
        """
        Decorate the graph.

        :param `DiGraph` graph: the graph
        :param properties: a dict of properties
        :type properties: dict of property name -> graph element -> value
        :param setter: a function to set the attributes
        :type setter: function (one of networkx.set_{node, edge}_attributes)
        """
        for property_name, value in properties.items():
            setter(graph, property_name, value)

    @classmethod
    def decorate_nodes(cls, graph, properties):
        """
        Decorate the graph.

        :param `DiGraph` graph: the graph
        :param properties: a dict of properties
        :type properties: dict of property name -> graph element -> value
        """
        cls._decorate(graph, properties, nx.set_node_attributes)

    @classmethod
    def decorate_edges(cls, graph, properties):
        """
        Decorate the graph.

        :param `DiGraph` graph: the graph
        :param properties: a dict of properties
        :type properties: dict of property name -> graph element -> value
        """
        cls._decorate(graph, properties, nx.set_edge_attributes)
