# Copyright 2007 Sam Hart

 #

 # This program is free software; you can redistribute it and/or modify

 # it under the terms of the GNU General Public License as published by

 # the Free Software Foundation; either version 2 of the License, or

 # (at your option) any later version.

 #

 # This program is distributed in the hope that it will be useful,

 # but WITHOUT ANY WARRANTY; without even the implied warranty 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., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA

 #

 # Author: Sam Hart

 """

 The Swarm Hive "super" class

 This class houses the most common Swarm Hive interactions.

 """

 import urlparse

 class Hive(object):

     def __init__(self, url, log, config=None):

         """

         Basic URL parsing wrapper class

         Accessable members:

          .scheme = The scheme in use

          .netloc = The network location

          .path = The path

          .params = Parameters for path element

          .query = Query component

          .fragment = fragment identifier

          .username = username to use (if authentication is needed)

          .password = password to use (if authentication is needed)

          .hostname = hostname

          .port = port

         """

         self.url = url

         self._parsed = urlparse(url)

         self.scheme = self._parsed.scheme.lower()

         self.netloc = self._parsed.netloc

         self.path = self._parsed.path

         self.params = self._parsed.params

         self.query = self._parsed.query

         self.fragment = self._parsed.fragment

         self.username = self._parsed.username

         self.password = self._parsed.password

         self.hostname = self._parsed.hostname

         self.port = self._parsed.port

         self.connected = False

         self.connection = None

         self._log = log

         self._alt_config_file = config

         self._logger = log.get_logger("Hive")

     def init(self, force=False, ):

         """

         Called when a new Hive is to be initialized

         """

     def connect(self):

         """

         Connects to the Hive.

         Returns nothing on success, otherwise raises an exception.

         """

         try:

             self.connection = connect.get_connection(self._parsed, self._log)

         except:

             pass

         self.connected = True