text: #
  # -*- coding: utf-8 -*-
  # Copyright 2019 Red Hat
  # GNU General Public License v3.0+
  # (see COPYING or https://www.gnu.org/licenses/gpl-3.0.txt)
  """
  The junos_lacp class
  It is in this file where the current configuration (as dict)
  is compared to the provided configuration (as dict) and the command set
  necessary to bring the current configuration to it's desired end-state is
  created
  """
  from __future__ import absolute_import, division, print_function
  
  __metaclass__ = type
  
  from ansible_collections.ansible.netcommon.plugins.module_utils.network.common.cfg.base import (
      ConfigBase,
  )
  from ansible_collections.ansible.netcommon.plugins.module_utils.network.common.netconf import (
      build_root_xml_node,
      build_child_xml_node,
      build_subtree,
  )
  from ansible_collections.ansible.netcommon.plugins.module_utils.network.common.utils import (
      to_list,
  )
  from ansible_collections.junipernetworks.junos.plugins.module_utils.network.junos.facts.facts import (
      Facts,
  )
  from ansible_collections.junipernetworks.junos.plugins.module_utils.network.junos.junos import (
      locked_config,
      load_config,
      commit_configuration,
      discard_changes,
      tostring,
  )
  
  
  class Lacp(ConfigBase):
      """
      The junos_lacp class
      """
  
      gather_subset = ["!all", "!min"]
  
      gather_network_resources = ["lacp"]
  
      def __init__(self, module):
          super(Lacp, self).__init__(module)
  
      def get_lacp_facts(self, data=None):
          """ Get the 'facts' (the current configuration)
  
          :rtype: A dictionary
          :returns: The current configuration as a dictionary
          """
          facts, _warnings = Facts(self._module).get_facts(
              self.gather_subset, self.gather_network_resources, data=data
          )
          lacp_facts = facts["ansible_network_resources"].get("lacp")
          if not lacp_facts:
              return {}
          return lacp_facts
  
      def execute_module(self):
          """ Execute the module
  
          :rtype: A dictionary
          :returns: The result from module execution
          """
          result = {"changed": False}
          state = self._module.params["state"]
          warnings = list()
  
          if self.state in self.ACTION_STATES:
              existing_lacp_facts = self.get_lacp_facts()
          else:
              existing_lacp_facts = {}
          if state == "gathered":
              existing_lacp_facts = self.get_lacp_facts()
              result["gathered"] = existing_lacp_facts
          elif self.state == "parsed":
              running_config = self._module.params["running_config"]
              if not running_config:
                  self._module.fail_json(
                      msg="value of running_config parameter must not be empty for state parsed"
                  )
              result["parsed"] = self.get_lacp_facts(data=running_config)
          elif self.state == "rendered":
              config_xmls = self.set_config(existing_lacp_facts)
              if config_xmls:
                  result["rendered"] = config_xmls[0]
              else:
                  result["rendered"] = ""
  
          else:
              config_xmls = self.set_config(existing_lacp_facts)
              with locked_config(self._module):
                  for config_xml in to_list(config_xmls):
                      diff = load_config(self._module, config_xml, [])
  
                  commit = not self._module.check_mode
                  if diff:
                      if commit:
                          commit_configuration(self._module)
                      else:
                          discard_changes(self._module)
                      result["changed"] = True
  
                      if self._module._diff:
                          result["diff"] = {"prepared": diff}
  
              result["commands"] = config_xmls
  
              changed_lacp_facts = self.get_lacp_facts()
  
              result["before"] = existing_lacp_facts
              if result["changed"]:
                  result["after"] = changed_lacp_facts
  
              result["warnings"] = warnings
  
          return result
  
      def set_config(self, existing_lacp_facts):
          """ Collect the configuration from the args passed to the module,
              collect the current configuration (as a dict from facts)
  
          :rtype: A list
          :returns: the commands necessary to migrate the current configuration
                    to the desired configuration
          """
          want = self._module.params["config"]
          have = existing_lacp_facts
          resp = self.set_state(want, have)
          return to_list(resp)
  
      def set_state(self, want, have):
          """ Select the appropriate function based on the state provided
          :param want: the desired configuration as a dictionary
          :param have: the current configuration as a dictionary
          :rtype: A list
          :returns: the list xml configuration necessary to migrate the current configuration
                    to the desired configuration
          """
          root = build_root_xml_node("chassis")
          ethernet_ele = build_subtree(root, "aggregated-devices/ethernet")
          state = self._module.params["state"]
          if state in ("merged", "replaced", "rendered") and not want:
              self._module.fail_json(
                  msg="value of config parameter must not be empty for state {0}".format(
                      state
                  )
              )
          if state == "overridden":
              config_xmls = self._state_overridden(want, have)
          elif state == "deleted":
              config_xmls = self._state_deleted(want, have)
          elif state in ("merged", "rendered"):
              config_xmls = self._state_merged(want, have)
          elif state == "replaced":
              config_xmls = self._state_replaced(want, have)
  
          for xml in config_xmls:
              ethernet_ele.append(xml)
          return tostring(root)
  
      def _state_replaced(self, want, have):
          """ The xml configuration generator when state is merged
           :rtype: A list
           :returns: the xml configuration necessary to merge the provided into
                     the current configuration
           """
          lacp_xml = []
          lacp_xml.extend(self._state_deleted(want, have))
          lacp_xml.extend(self._state_merged(want, have))
  
          return lacp_xml
  
      def _state_overridden(self, want, have):
          """ The command generator when state is overridden
  
          :rtype: A list
          :returns: the commands necessary to migrate the current configuration
                    to the desired configuration
          """
          lacp_xml = []
          lacp_xml.extend(self._state_deleted(want, have))
          lacp_xml.extend(self._state_merged(want, have))
  
          return lacp_xml
  
      def _state_merged(self, want, have):
          """ Select the appropriate function based on the state provided
          :param want: the desired configuration as a dictionary
          :param have: the current configuration as a dictionary
          :rtype: A list
          :returns: the list xml configuration necessary to migrate the current configuration
                    to the desired configuration
          """
          lacp_xml = []
  
          lacp_root = build_root_xml_node("lacp")
          build_child_xml_node(
              lacp_root, "system-priority", want.get("system_priority")
          )
          if want.get("link_protection") == "non-revertive":
              build_subtree(lacp_root, "link-protection/non-revertive")
          elif want.get("link_protection") == "revertive":
              link_root = build_child_xml_node(lacp_root, "link-protection")
              build_child_xml_node(
                  link_root, "non-revertive", None, {"delete": "delete"}
              )
          lacp_xml.append(lacp_root)
          return lacp_xml
  
      def _state_deleted(self, want, have):
          """ The command generator when state is deleted
  
          :rtype: A list
          :returns: the commands necessary to remove the current configuration
                    of the provided objects
          """
          lacp_xml = []
  
          lacp_root = build_root_xml_node("lacp")
          build_child_xml_node(
              lacp_root, "system-priority", None, {"delete": "delete"}
          )
          element = build_child_xml_node(
              lacp_root, "link-protection", None, {"delete": "delete"}
          )
          build_child_xml_node(
              element, "non-revertive", None, {"delete": "delete"}
          )
  
          lacp_xml.append(lacp_root)
          return lacp_xml
  