text: # Copyright 2012 OpenStack Foundation
  # All Rights Reserved.
  #
  #    Licensed under the Apache License, Version 2.0 (the "License"); you may
  #    not use this file except in compliance with the License. You may obtain
  #    a copy of the License at
  #
  #         http://www.apache.org/licenses/LICENSE-2.0
  #
  #    Unless required by applicable law or agreed to in writing, software
  #    distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
  #    WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
  #    License for the specific language governing permissions and limitations
  #    under the License.
  
  """
  Network interface.
  """
  
  from novaclient import base
  from novaclient import exceptions
  from novaclient.openstack.common.gettextutils import _
  
  
  class Network(base.Resource):
      """
      A network.
      """
      HUMAN_ID = False
      NAME_ATTR = "label"
  
      def __repr__(self):
          return "<Network: %s>" % self.label
  
      def delete(self):
          self.manager.delete(self)
  
  
  class NetworkManager(base.ManagerWithFind):
      """
      Manage :class:`Network` resources.
      """
      resource_class = Network
  
      def list(self):
          """
          Get a list of all networks.
  
          :rtype: list of :class:`Network`.
          """
          return self._list("/os-networks", "networks")
  
      def get(self, network):
          """
          Get a specific network.
  
          :param network: The ID of the :class:`Network` to get.
          :rtype: :class:`Network`
          """
          return self._get("/os-networks/%s" % base.getid(network),
                           "network")
  
      def delete(self, network):
          """
          Delete a specific network.
  
          :param network: The ID of the :class:`Network` to delete.
          """
          self._delete("/os-networks/%s" % base.getid(network))
  
      def create(self, **kwargs):
          """
          Create (allocate) a network. The following parameters are
          optional except for label; cidr or cidr_v6 must be specified, too.
  
          :param label: str
          :param bridge: str
          :param bridge_interface: str
          :param cidr: str
          :param cidr_v6: str
          :param dns1: str
          :param dns2: str
          :param fixed_cidr: str
          :param gateway: str
          :param gateway_v6: str
          :param multi_host: str
          :param priority: str
          :param project_id: str
          :param vlan_start: int
          :param vpn_start: int
  
          :rtype: list of :class:`Network`
          """
          body = {"network": kwargs}
          return self._create('/os-networks', body, 'network')
  
      def disassociate(self, network, disassociate_host=True,
                       disassociate_project=True):
          """
          Disassociate a specific network from project and/or host.
  
          :param network: The ID of the :class:`Network`.
          :param disassociate_host: Whether to disassociate the host
          :param disassociate_project: Whether to disassociate the project
          """
          if disassociate_host and disassociate_project:
              body = {"disassociate": None}
          elif disassociate_project:
              body = {"disassociate_project": None}
          elif disassociate_host:
              body = {"disassociate_host": None}
          else:
              raise exceptions.CommandError(
                  _("Must disassociate either host or project or both"))
  
          self.api.client.post("/os-networks/%s/action" %
                               base.getid(network), body=body)
  
      def associate_host(self, network, host):
          """
          Associate a specific network with a host.
  
          :param network: The ID of the :class:`Network`.
          :param host: The name of the host to associate the network with
          """
          self.api.client.post("/os-networks/%s/action" %
                               base.getid(network),
                               body={"associate_host": host})
  
      def associate_project(self, network):
          """
          Associate a specific network with a project.
  
          The project is defined by the project authenticated against
  
          :param network: The ID of the :class:`Network`.
          """
          self.api.client.post("/os-networks/add", body={"id": network})
  
      def add(self, network=None):
          """
          Associates the current project with a network. Network can be chosen
          automatically or provided explicitly.
  
          :param network: The ID of the :class:`Network` to associate (optional).
          """
          self.api.client.post(
              "/os-networks/add",
              body={"id": base.getid(network) if network else None})
  