class MythXML(XMLConnection):
"""
Provides convenient methods to access the backend XML server.
Parameter 'backend' is either a hostname from 'settings',
an ip address or a hostname in ip-notation.
"""
def __init__(self, backend=None, port=None, db=None):
if backend and port:
XMLConnection.__init__(self, backend, port)
self.db = db
return
self.db = DBCache(db)
self.log = MythLog('Python XML Connection')
if backend is None:
# use master backend
backend = self.db.getMasterBackend()
# assume hostname from settings
host = self.db._getpreferredaddr(backend)
if host:
port = int(self.db.settings[backend].BackendStatusPort)
else:
# assume ip address
hostname = self.db._gethostfromaddr(backend)
host = backend
port = int(self.db.settings[hostname].BackendStatusPort)
# resolve ip address from name
reshost, resport = resolve_ip(host, port)
if not reshost:
raise MythDBError(MythError.DB_SETTING,
backend + ': BackendServerAddr')
if not resport:
raise MythDBError(MythError.DB_SETTING,
backend + ': BackendStatusPort')
self.host = host
self.port = port
def getHosts(self):
"""Returns a list of unique hostnames found in the settings table."""
return self._request('Myth/GetHosts')\
.readJSON()['StringList']
def getKeys(self):
"""Returns a list of unique keys found in the settings table."""
return self._request('Myth/GetKeys')\
.readJSON()['StringList']
def getSetting(self, key, hostname=None, default=None):
"""Retrieves a setting from the backend."""
args = {'Key': key}
if hostname:
args['HostName'] = hostname
if default:
args['Default'] = default
return self._request('Myth/GetSetting', **args)\
.readJSON()['String']
def getProgramGuide(self, starttime, endtime, startchan, numchan=None):
"""
Returns a list of Guide objects corresponding to the given time period.
"""
starttime = datetime.duck(starttime)
endtime = datetime.duck(endtime)
args = {
'StartTime': starttime.utcisoformat().rsplit('.', 1)[0],
'EndTime': endtime.utcisoformat().rsplit('.', 1)[0],
'StartChanId': startchan,
'Details': '1'
}
if numchan:
args['NumOfChannels'] = numchan
else:
args['NumOfChannels'] = '1'
dat = self._request('Guide/GetProgramGuide', **args).readJSON()
for chan in dat['ProgramGuide']['Channels']:
for prog in chan['Programs']:
prog['ChanId'] = chan['ChanId']
yield Guide.fromJSON(prog, self.db)
def getProgramDetails(self, chanid, starttime):
"""
Returns a Program object for the matching show.
"""
starttime = datetime.duck(starttime)
args = {'ChanId': chanid, 'StartTime': starttime.utcisoformat()}
return Program.fromJSON(
self._request('Guide/GetProgramDetails', **args)\
.readJSON()['Program'],
db=self.db)
def getChannelIcon(self, chanid):
"""Returns channel icon as a data string"""
return self._request('Guide/GetChannelIcon', ChanId=chanid).read()
def getRecorded(self, descending=True):
"""
Returns a list of Program objects for recorded shows on the backend.
"""
descendingstr = 'true' if descending else 'false'
for prog in self._request('Dvr/GetRecordedList', Descending=descendingstr)\
.readJSON()['ProgramList']['Programs']:
yield Program.fromJSON(prog, self.db)
def getExpiring(self):
"""
Returns a list of Program objects for expiring shows on the backend.
"""
for prog in self._request('Dvr/GetExpiringList')\
.readJSON()['ProgramList']['Programs']:
yield Program.fromJSON(prog, self.db)
# def getInternetSources(self):
# for grabber in self._queryTree('GetInternetSources').\
# find('InternetContent').findall('grabber'):
# yield InternetSource.fromEtree(grabber, self)
def getInternetContentUrl(self, grabber, videocode):
return "mythflash://%s:%s/InternetContent/GetInternetContent?Grabber=%s&videocode=%s" \
% (self.host, self.port, grabber, videocode)
def getPreviewImage(self, chanid, starttime, width=None, \
height=None, secsin=None):
starttime = datetime.duck(starttime)
args = {'ChanId': chanid, 'StartTime': starttime.utcisoformat()}
if width: args['Width'] = width
if height: args['Height'] = height
if secsin: args['SecsIn'] = secsin
return self._request('Content/GetPreviewImage', **args).read()
class BECache( object ):
"""
BECache(backend=None, noshutdown=False, db=None)
-> MythBackend connection object
Basic class for mythbackend socket connections.
Offers connection caching to prevent multiple connections.
'backend' allows a hostname or IP address to connect to. If not provided,
connect will be made to the master backend. Port is always
taken from the database.
'db' allows an existing database object to be supplied.
'noshutdown' specified whether the backend will be allowed to go into
automatic shutdown while the connection is alive.
Available methods:
backendCommand() - Sends a formatted command to the backend
and returns the response.
"""
class _ConnHolder( object ):
blockshutdown = 0
command = None
event = None
logmodule = 'Python Backend Connection'
_shared = weakref.WeakValueDictionary()
_reip = re.compile(r'(?:\d{1,3}\.){3}\d{1,3}')
def __repr__(self):
return "<%s 'myth://%s:%d/' at %s>" % \
(str(self.__class__).split("'")[1].split(".")[-1],
self.hostname, self.port, hex(id(self)))
def __init__(self, backend=None, blockshutdown=False, events=False, db=None):
self.db = DBCache(db)
self.log = MythLog(self.logmodule, db=self.db)
self.hostname = None
self.sendcommands = True
self.blockshutdown = blockshutdown
self.receiveevents = events
if backend is None:
# use master backend
backend = self.db.getMasterBackend()
else:
backend = backend.strip('[]')
# assume backend is hostname from settings
host = self.db._getpreferredaddr(backend)
if host:
port = int(self.db.settings[backend].BackendServerPort)
self.hostname = backend
else:
# assume ip address
self.hostname = self.db._gethostfromaddr(backend)
host = backend
port = int(self.db.settings[self.hostname].BackendServerPort)
# resolve ip address from name
reshost, resport = resolve_ip(host,port)
if not reshost:
raise MythDBError(MythError.DB_SETTING,
backend+': BackendServerAddr')
if not resport:
raise MythDBError(MythError.DB_SETTING,
backend+': BackendServerPort')
self.host = host
self.port = port
self._ident = '%s:%d' % (self.host, self.port)
if self._ident in self._shared:
# existing connection found
self._conn = self._shared[self._ident]
if self.sendcommands:
if self._conn.command is None:
self._conn.command = self._newcmdconn()
elif self.blockshutdown:
# upref block of shutdown
# issue command to backend if needed
self._conn.blockshutdown += 1
if self._conn.blockshutdown == 1:
self._conn.command.blockShutdown()
if self.receiveevents:
if self._conn.event is None:
self._conn.event = self._neweventconn()
else:
# no existing connection, create new
self._conn = self._ConnHolder()
if self.sendcommands:
self._conn.command = self._newcmdconn()
if self.blockshutdown:
self._conn.blockshutdown = 1
if self.receiveevents:
self._conn.event = self._neweventconn()
self._shared[self._ident] = self._conn
self._events = self._listhandlers()
for func in self._events:
self.registerevent(func)
def __del__(self):
# downref block of shutdown
# issue command to backend if needed
#print 'destructing BECache'
if self.blockshutdown:
self._conn.blockshutdown -= 1
if not self._conn.blockshutdown:
self._conn.command.unblockShutdown()
def _newcmdconn(self):
return BEConnection(self.host, self.port, self.db.gethostname(),
self.blockshutdown)
def _neweventconn(self):
return BEEventConnection(self.host, self.port, self.db.gethostname())
def backendCommand(self, data):
"""
obj.backendCommand(data) -> response string
Sends a formatted command via a socket to the mythbackend.
"""
if self._conn.command is None:
return ""
return self._conn.command.backendCommand(data)
def _listhandlers(self):
return []
def registerevent(self, func, regex=None):
if self._conn.event is None:
return
if regex is None:
regex = func()
self._conn.event.registerevent(regex, func)
def clearevents(self):
self._events = []