1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
|
# moosic/client/factory.py - Factory functions for creating Moosic server proxies.
#
# Copyright (C) 2001-2003 Daniel Pearson <daniel@nanoo.org>
#
# 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
"""Factory functions for creating Moosic server proxies.
This module contains functions that make it very quick and easy to create a
proxy object that exposes all the methods of a Moosic server. These proxy
objects are instances of xmlrpclib.ServerProxy, so you should refer to the
documentation for the xmlrpclib module for more detailed information about
ServerProxy objects. These factory functions are not necessary for creating
proper Moosic server proxies, but they are a very convenient way of doing so.
This module also contains a subclass of xmlrpclib.Transport that adapts the
XML-RPC client implementation for use with Unix sockets.
It is safe to "import *" from this module.
"""
import xmlrpclib, urllib, httplib, socket, os, os.path
import moosic.server.main
# Define the True and False constants if they don't already exist.
try: True
except NameError: True = 1
try: False
except NameError: False = 0
__all__ = ('startServer', 'LocalMoosicProxy', 'UnixMoosicProxy',
'InetMoosicProxy', 'UnixStreamTransport')
class UnixStreamTransport(xmlrpclib.Transport):
'''An adapter for speaking HTTP over a Unix socket instead of a TCP/IP socket.
This class mainly exists to serve as a helper for implementing the
LocalMoosicProxy class, and will not be directly useful for most Moosic
client developers.
'''
def make_connection(self, host):
class HTTPConnection(httplib.HTTPConnection):
def connect(self):
host = urllib.unquote(self.host)
try:
self.sock = socket.socket(socket.AF_UNIX, socket.SOCK_STREAM)
if self.debuglevel > 0:
print "connect: (%s)" % host
self.sock.connect(host)
except socket.error, msg:
if self.debuglevel > 0:
print 'connect fail:', host
if self.sock:
self.sock.close()
self.sock = None
raise
class HTTP(httplib.HTTP):
_connection_class = HTTPConnection
return HTTP(host)
def LocalMoosicProxy(filename=None):
'''Creates a proxy to a Moosic server that is listening to a local (Unix
address family) socket.
The optional "filename" argument is the location of the socket file that the
Moosic server is using as its address.
'''
if not filename:
filename = os.path.join(os.getenv('HOME', '/tmp'), '.moosic', 'socket')
server_address = 'http://%s/' % urllib.quote(filename, safe='')
return xmlrpclib.ServerProxy(uri=server_address,
transport=UnixStreamTransport(),
verbose=False)
def UnixMoosicProxy(filename=None):
'''An alias for the LocalMoosicProxy function.
'''
return LocalMoosicProxy(filename)
def InetMoosicProxy(host, port):
'''Creates a proxy to a Moosic server that is listening to a TCP/IP socket.
The first argument, "host", is the hostname or IP address where the server
is located. The second argument, "port", is the TCP port that the server is
listening to.
'''
return xmlrpclib.ServerProxy(uri='http://%s:%d/' % (host, port),
verbose=False)
def startServer(*argv):
'''Attempts to start an instance of the Moosic server.
The parameters given to this function are used verbatim to form the argument
vector that will be passed to the server process (i.e. sys.argv). See the
moosicd(1) man page for a description of valid arguments.
If the server can't be started, a string describing why is returned.
Otherwise, None is returned.
'''
status = None
try:
moosic.server.main.main(argv)
except SystemExit, e:
status = e[0]
if not status:
status = None
elif type(status) == int:
status = "The server exited with an exit status of %d." % status
else:
status = str(status)
return status
|
